> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

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

> Управляйте подключением BeatAPI в Claude Code и Codex CLI из одного приложения и переключайте поставщиков без ручного редактирования файлов.

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

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

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

1. **Хотя бы один поддерживаемый CLI**: [Claude Code](/integrations/claude-code) или [Codex CLI](/integrations/codex-cli).
2. **API-ключ BeatAPI**: создайте его в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

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

#### macOS

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

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

#### Windows

Загрузите установщик `.msi` или переносную версию `.zip` из GitHub Releases. Требуется Windows 10 или новее.

#### Linux

В GitHub Releases доступны `.deb` для Debian и Ubuntu, `.rpm` для Fedora и RHEL и универсальный `.AppImage`. Для Arch: `paru -S cc-switch-bin`.

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

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

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

### Для Claude Code

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

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

4. Нажмите **Add**.

### Для Codex

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

```json
{
  "OPENAI_API_KEY": "<BEATAPI_API_KEY>"
}
```

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

```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
```

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

> **Note**
>
> Адреса различаются намеренно; их путаница — самая частая ошибка настройки. 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](/text-api), тарифы — на [странице цен](https://beatapi.io/pricing).

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

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

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

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

1. Убедитесь, что ключ скопирован полностью, без пробелов в начале и конце.
2. Проверьте его активность в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).
3. Сверьте адрес 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 создаёт резервные копии этих файлов перед каждым переключением. Редактировать их вручную не требуется.

## Поддержка

Создайте обращение в [панели управления](https://beatapi.io/dashboard) и укажите `request_id` из ответа с ошибкой.