Использование APIMart в CC-Switch

Введение

CC-Switch — это десктоп-приложение с открытым кодом, которое объединяет управление конфигурациями API-провайдеров для нескольких AI-кодинг CLI инструментов, таких как Claude Code, Codex и Gemini CLI. Оно превращает утомительное редактирование конфигурационных файлов в несколько кликов в GUI — после добавления провайдера вы можете мгновенно переключаться между API-сервисами без необходимости редактировать конфигурационные файлы вручную. Подключив APIMart через CC-Switch, вы можете легко настроить сервис APIMart для Claude Code и Codex и свободно переключаться между несколькими провайдерами.

Предварительные требования

Перед началом убедитесь, что у вас есть:

Установленный поддерживаемый CLI-инструмент Установлен как минимум один поддерживаемый CLI-инструмент, например Claude Code или Codex CLI
Получен API-ключ APIMart Войдите в консоль APIMart для получения API-ключа (начинается с sk-)

Совет: если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на APIMart и получите API-ключ.

Шаг 1: Установите CC-Switch

Выберите метод установки в зависимости от вашей операционной системы:

macOS
Windows
Linux

Установка через Homebrew (рекомендуется):

brew tap farion1231/ccswitch
brew install --cask cc-switch

Вы также можете скачать .dmg установщик с GitHub Releases. CC-Switch подписан и нотариально заверен Apple, поэтому его можно устанавливать напрямую (требуется macOS 12 или новее).

Скачайте .msi установщик или портативный .zip с GitHub Releases.Требуется Windows 10 или новее.

Скачайте подходящий пакет с GitHub Releases:

Debian / Ubuntu: пакет .deb
Fedora / RHEL: пакет .rpm
Универсальный: формат .AppImage
Arch Linux: paru -S cc-switch-bin

При первом запуске CC-Switch автоматически определяет установленные на вашей машине CLI-инструменты и может импортировать существующие конфигурации в качестве провайдеров по умолчанию.

Шаг 2: Добавьте провайдера APIMart

В верхней части главного окна CC-Switch можно переключаться между группами CLI-инструментов. Следуйте шагам ниже в зависимости от инструмента, который вы хотите настроить.

Настройка для Claude Code
Настройка для Codex

1. Переключитесь на группу Claude CodeВыберите Claude Code в верхней части главного окна.2. Откройте панель Add ProviderНажмите кнопку + в правом верхнем углу главного окна.3. Заполните данные провайдераЗаполните форму так:

Поле	Значение	Описание
Name	`APIMart`	Произвольная метка для удобства
Endpoint URL	`https://api.apimart.ai`	Базовый URL API APIMart
API Key	`sk-xxxxxxxxxxxx`	Ваш API-ключ APIMart
API Format	`Anthropic Messages`	Оставьте дефолтный нативный формат Anthropic

4. Сохраните конфигурациюНажмите Add для сохранения. APIMart появится в списке провайдеров.

1. Переключитесь на группу CodexВыберите Codex в верхней части главного окна.2. Откройте панель Add ProviderНажмите кнопку + в правом верхнем углу главного окна.3. Заполните данные провайдераПровайдер Codex настраивается двумя блоками:Заполните API-ключ в блоке auth.json:

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

Заполните конфигурацию провайдера в блоке config.toml:

model = "gpt-5.5"
model_provider = "apimart"

[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true

4. Сохраните конфигурациюНазовите провайдера (например, APIMart) и нажмите Add для сохранения. CC-Switch автоматически проверит JSON и TOML.

О URL эндпоинта: Claude Code использует нативный формат Anthropic с URL https://api.apimart.ai (без /v1); Codex использует OpenAI-совместимый формат с URL https://api.apimart.ai/v1 (с /v1). Не путайте их.

Шаг 3: Переключайте провайдеров

После добавления вы можете в любой момент переключаться между APIMart и другими провайдерами:

Переключение в главном окне

Выберите APIMart в списке провайдеров
Нажмите кнопку Enable (или Use)
Тост «Switched successfully» подтвердит изменение

Переключение из системного трея

CC-Switch остаётся в системном трее, поэтому вы можете переключаться без открытия главного окна:

Кликните на иконку CC-Switch в системном трее
Кликните по имени целевого провайдера в меню — это применится мгновенно

Об активации: Claude Code поддерживает горячее переключение — новые сессии подхватывают новую конфигурацию автоматически. После переключения для Codex нужно перезапустить терминал или Codex, чтобы изменение вступило в силу.

Поддерживаемые модели

После переключения на провайдера APIMart вы можете использовать различные модели в соответствующем CLI-инструменте:

ID модели	Сильные стороны	Рекомендуемые сценарии
`claude-opus-4-6`	Самая мощная в целом	Сложная архитектура, трудная отладка
`claude-sonnet-4-6`	Баланс перф. и скорости	Повседневный кодинг, генерация кода
`gpt-5.5`	Отличные навыки кода	Сложные инженерные задачи
`gpt-4o`	Высокая производительность, быстрая	Повседневный кодинг, быстрая итерация

В Claude Code используйте команду /model для переключения моделей; в Codex также используйте команду /model. Полный список моделей см. в руководстве по Claude Code и руководстве Codex CLI.

Часто задаваемые вопросы

Q1: Переключение провайдеров не вступает в силу?

Claude Code: поддерживает горячее переключение — начните новую сессию; если всё ещё не работает, перезапустите Claude Code
Codex: после переключения перезапустите терминал или Codex

Q2: API-ключ сообщается как недействительный?

Убедитесь, что API-ключ начинается с sk- и скопирован полностью без лишних пробелов
Зайдите в консоль APIMart, чтобы подтвердить, что ключ активен
Проверьте, что URL эндпоинта корректен (Claude Code использует https://api.apimart.ai, Codex использует https://api.apimart.ai/v1)

Q3: Ошибка формата при добавлении провайдера Codex?

CC-Switch проверяет auth.json (синтаксис JSON) и config.toml (синтаксис TOML). Проверьте, что:

Скобки, кавычки и запятые в JSON корректны
Не используются полноширинные / умные кавычки
Имена полей в TOML написаны правильно

Q4: Какие файлы изменяет CC-Switch?

CC-Switch пишет в конфигурационные файлы каждого инструмента:

Claude Code: ~/.claude/settings.json
Codex: ~/.codex/config.toml и ~/.codex/auth.json

CC-Switch автоматически делает резервную копию этих файлов перед переключением, поэтому редактировать их вручную не нужно.

Q5: Как просмотреть использование API и биллинг?

Войдите в консоль APIMart, чтобы посмотреть статистику API-вызовов, детали потребления токенов и тенденции расходов.

Поддержка и помощь

Если у вас возникнут проблемы при использовании CC-Switch:

📚 Документация APIMart
📚 Страница проекта CC-Switch
💬 Сообщество Discord
🐦 Twitter @APIMart_
📧 Техническая поддержка: zhihong@apimart.ai

Начните с APIMart

Зарегистрируйтесь в APIMart прямо сейчас, получите API-ключ и без труда управляйте несколькими AI-кодинг инструментами в CC-Switch!

Documentation Index

​Введение

​Предварительные требования

​Шаг 1: Установите CC-Switch

​Шаг 2: Добавьте провайдера APIMart

​Шаг 3: Переключайте провайдеров

​Переключение в главном окне

​Переключение из системного трея

​Поддерживаемые модели

​Часто задаваемые вопросы

​Q1: Переключение провайдеров не вступает в силу?

​Q2: API-ключ сообщается как недействительный?

​Q3: Ошибка формата при добавлении провайдера Codex?

​Q4: Какие файлы изменяет CC-Switch?

​Q5: Как просмотреть использование API и биллинг?

​Поддержка и помощь

Начните с APIMart

Введение

Предварительные требования

Шаг 1: Установите CC-Switch

Шаг 2: Добавьте провайдера APIMart

Шаг 3: Переключайте провайдеров

Переключение в главном окне

Переключение из системного трея

Поддерживаемые модели

Часто задаваемые вопросы

Q1: Переключение провайдеров не вступает в силу?

Q2: API-ключ сообщается как недействительный?

Q3: Ошибка формата при добавлении провайдера Codex?

Q4: Какие файлы изменяет CC-Switch?

Q5: Как просмотреть использование API и биллинг?

Поддержка и помощь