Подключение BeatAPI через CC-Switch

CC-Switch — настольное приложение с открытым исходным кодом для настройки поставщиков в нескольких ИИ-инструментах командной строки: Claude Code, Codex CLI и Gemini CLI. Добавьте BeatAPI один раз, чтобы затем переключаться на него и обратно одним нажатием, без редактирования конфигурации.

Что понадобится

Хотя бы один поддерживаемый CLI: Claude Code или Codex CLI.
API-ключ BeatAPI: создайте его в Dashboard → API Keys.

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

macOS

Windows

Linux

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

Подписанный установщик .dmg также доступен в GitHub Releases. Требуется macOS 12 или новее.

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

Шаг 2. Добавьте BeatAPI

Группы инструментов переключаются вверху главного окна. Настройте те CLI, которыми пользуетесь.

Для Claude Code

Выберите группу Claude Code.
Нажмите + справа вверху.
Заполните форму:

Поле	Значение
Name	`BeatAPI`
Endpoint URL	`https://api.beatapi.io`
API Key	Ваш API-ключ BeatAPI
API Format	`Anthropic Messages`

Нажмите Add.

Для Codex

Выберите группу Codex.
Нажмите + справа вверху.
Настройка поставщика Codex состоит из двух блоков. В блоке auth.json укажите:

{
  "OPENAI_API_KEY": "<BEATAPI_API_KEY>"
}

В блоке config.toml укажите:

model = "gpt-5.6-sol"
model_provider = "beatapi"
[model_providers.beatapi]
name = "BeatAPI"
base_url = "https://api.beatapi.io/v1"
wire_api = "responses"
requires_openai_auth = true

Задайте имя BeatAPI и нажмите Add. Перед сохранением CC-Switch проверит корректность JSON и TOML.

Адреса различаются намеренно; их путаница — самая частая ошибка настройки. Claude Code использует формат Anthropic по адресу https://api.beatapi.io без /v1, потому что сам добавляет /v1/messages. Codex использует OpenAI-совместимый формат по адресу https://api.beatapi.io/v1, то есть с /v1.

Шаг 3. Переключите поставщика

В главном окне выберите BeatAPI в списке поставщиков и нажмите Enable. Появится уведомление о подтверждении.

В системном трее нажмите значок CC-Switch и выберите поставщика в меню.

Claude Code подхватит изменение в новой сессии. Для Codex нужно перезапустить терминал или самого агента.

Модели

ID модели	Доступна в	Для каких задач подходит
`claude-fable-5-1`	Claude Code	Новое поколение; основной вариант для разработки с агентом
`claude-opus-5`	Claude Code	Самые сложные задачи с рассуждениями
`claude-sonnet-5`	Claude Code	Баланс возможностей и скорости
`gpt-5.6-sol`	Codex	Самый сильный вариант для программирования
`gpt-6-astra`	Codex	Новое поколение; тариф повышается при входе свыше 272K токенов

Переключайте модели командой /model внутри соответствующего CLI. Полный каталог есть в разделе Text API, тарифы — на странице цен.

Частые вопросы

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

Claude Code: начните новую сессию. Если это не помогло, перезапустите агента.
Codex: перезапустите терминал или сам Codex.

Ключ отклонён

Убедитесь, что ключ скопирован полностью, без пробелов в начале и конце.
Проверьте его активность в Dashboard → API Keys.
Сверьте адрес API с примечанием выше: Claude Code без /v1, Codex — с ним.

Ошибка формата при добавлении поставщика Codex

CC-Switch проверяет auth.json как JSON, а config.toml как TOML. Проверьте скобки, запятые, написание полей и типографские кавычки, которые могли попасть при копировании из документа.

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

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

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

Поддержка

Создайте обращение в панели управления и укажите request_id из ответа с ошибкой.