> 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 к Claude Code

> Направьте запросы Claude Code в BeatAPI и используйте один ключ для всех моделей Claude, доступных аккаунту.

# Подключение BeatAPI к Claude Code

Claude Code — агент для программирования в командной строке: он читает и записывает файлы, запускает команды и выполняет задачи в терминале. Агент использует формат Anthropic Messages, который BeatAPI поддерживает напрямую через `POST /v1/messages`. Для подключения достаточно изменить базовый адрес API; преобразование формата не требуется.

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

1. **Установленный Claude Code**. Если его ещё нет, начните с шага 1.
2. **API-ключ BeatAPI**: создайте его в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

## Шаг 1. Установите Claude Code

#### macOS / Linux

Установите с помощью официального скрипта:

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

Или через Homebrew:

```bash
brew install --cask claude-code
```

#### Windows

PowerShell:

```powershell
irm https://claude.ai/install.ps1 | iex
```

CMD:

```cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

#### npm

При установленном Node.js 18 или новее в любой ОС:

```bash
npm install -g @anthropic-ai/claude-code
```

Проверьте установку:

```bash
claude --version
```

## Шаг 2. Подключите Claude Code к BeatAPI

Выберите один из трёх способов. Они перечислены от наиболее постоянного к временному.

### Способ 1. settings.json

Наиболее надёжный вариант: настройка сохраняется между запусками терминала.

Найдите каталог конфигурации:

* macOS / Linux: `~/.claude`
* Windows: `%userprofile%\.claude`

Если каталога нет, один раз запустите `claude` и выйдите через `Ctrl + C`. Каталог будет создан автоматически.

Создайте или измените `settings.json`:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.beatapi.io",
    "ANTHROPIC_AUTH_TOKEN": "<BEATAPI_API_KEY>",
    "ANTHROPIC_MODEL": "claude-fable-5-1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
```

| Переменная                                 | Значение                                                                |
| ------------------------------------------ | ----------------------------------------------------------------------- |
| `ANTHROPIC_BASE_URL`                       | `https://api.beatapi.io` без `/v1`: клиент сам добавляет `/v1/messages` |
| `ANTHROPIC_AUTH_TOKEN`                     | Ваш API-ключ BeatAPI                                                    |
| `ANTHROPIC_MODEL`                          | ID модели из таблицы ниже                                               |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | `1` уменьшает число фоновых запросов                                    |

Сохраните файл и перезапустите Claude Code.

### Способ 2. Постоянные переменные окружения

#### macOS (zsh)

```bash
echo 'export ANTHROPIC_BASE_URL="https://api.beatapi.io"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<BEATAPI_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-fable-5-1"' >> ~/.zshrc
source ~/.zshrc
```

#### Linux (bash)

```bash
echo 'export ANTHROPIC_BASE_URL="https://api.beatapi.io"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="<BEATAPI_API_KEY>"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-fable-5-1"' >> ~/.bashrc
source ~/.bashrc
```

#### Windows (PowerShell)

```powershell
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.beatapi.io', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '<BEATAPI_API_KEY>', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-fable-5-1', 'User')
```

Затем перезапустите терминал.

### Способ 3. Только для текущего терминала

Удобно для быстрой проверки. После закрытия терминала значения исчезнут.

```bash
export ANTHROPIC_BASE_URL="https://api.beatapi.io"
export ANTHROPIC_AUTH_TOKEN="<BEATAPI_API_KEY>"
export ANTHROPIC_MODEL="claude-fable-5-1"
claude
```

## Шаг 3. Проверьте подключение и начните работу

```bash
claude "Hello"
```

Если модель ответила, настройка применилась. Если появился экран входа, `401` или `403`, подключение не настроено корректно. См. частые вопросы ниже.

В Claude Code есть два режима работы:

* **Интерактивный**: запустите `claude` для длительной сессии с несколькими шагами.
* **Один запрос**: запустите `claude "your question"`, чтобы получить один ответ.

## Модели

Все модели Claude аккаунта доступны с одним ключом. Переключайте их командой `/model` в интерактивной сессии либо измените `ANTHROPIC_MODEL` и перезапустите агент.

| ID модели                   | Для каких задач подходит                                                     |
| --------------------------- | ---------------------------------------------------------------------------- |
| `claude-fable-5-1`          | Новое поколение; основной вариант для разработки с агентом                   |
| `claude-opus-5`             | Самые сложные рассуждения, архитектура и отладка                             |
| `claude-sonnet-5-5`         | Программирование и агентные процессы; контекст 1M и до 128K выходных токенов |
| `claude-sonnet-5`           | Баланс возможностей и скорости для повседневной работы                       |
| `claude-haiku-4-5-20251001` | Самый быстрый и дешёвый вариант для небольших правок и большого числа шагов  |

Тарифы указаны на [странице цен](https://beatapi.io/pricing), формат запросов — в разделе [Claude API](/text-api/claude/messages).

### Настройка Sonnet 5.5

Добавьте эти значения в существующий `~/.claude/settings.json`, замените заглушку ключа и перезапустите Claude Code:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.beatapi.io",
    "ANTHROPIC_AUTH_TOKEN": "<BEATAPI_API_KEY>",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}
```

Sonnet 5.5 по умолчанию использует адаптивное рассуждение. Позвольте Claude Code управлять настройками рассуждения и инструментов. Ограничения и актуальные тарифы за токены приведены в [руководстве Sonnet 5.5](/text-api/claude/messages).

## Основные команды

| Команда             | Назначение                     |
| ------------------- | ------------------------------ |
| `claude`            | Начать интерактивную сессию    |
| `claude "question"` | Отправить один запрос          |
| `claude --version`  | Показать версию                |
| `/model`            | Переключить модель в сессии    |
| `/help`             | Открыть справку                |
| `Ctrl + C`          | Выйти из интерактивного режима |

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

### После настройки всё ещё появляется экран входа

Конфигурация не применилась.

1. Для `settings.json` проверьте путь: `~/.claude/settings.json` (`%userprofile%\.claude\settings.json` в Windows).
2. Для переменных окружения убедитесь, что Claude Code запущен из терминала, в котором они заданы.
3. Проверьте корректность JSON: парные скобки, отсутствие лишней запятой в конце и обычные прямые кавычки вместо типографских.

### 401 или 403

| Статус | Причина                                                                                                                 | Что делать                                                                                |
| ------ | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `401`  | `missing_api_key` или `invalid_api_key`: ключ отсутствует, неверен, просрочен, отключён или его лимит расходов исчерпан | Проверьте активность ключа в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys) |
| `403`  | `forbidden`: ключу или аккаунту недоступна модель, например при оплате бонусом                                          | Проверьте состояние аккаунта и запрошенную модель                                         |

Также проверьте, что `ANTHROPIC_BASE_URL` равен `https://api.beatapi.io`, а не адресу поставщика модели.

### При запуске появляется «Auth conflict»

```
Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set.
```

Одновременно используются вход в аккаунт поставщика и API-ключ. Выполните `/logout` в Claude Code, чтобы выйти из аккаунта и оставить авторизацию по ключу.

### 402 insufficient_credits

Баланс аккаунта равен нулю или меньше стоимости запроса. Пополните его в панели управления; поступающие запросы завершатся ошибкой, а не встанут в очередь.

### 429 rate_limit_exceeded

Ключ превысил лимит частоты запросов. BeatAPI возвращает `Retry-After`: подождите указанное время. Минутный лимит растёт с общей суммой пополнений и отображается в панели управления.

### Ошибки подключения

1. Проверьте подключение к сети.
2. Проверьте `ANTHROPIC_BASE_URL` на опечатки и лишний `/v1`.
3. При корпоративном прокси разрешите доступ к `api.beatapi.io`.

### Где посмотреть использование и расходы

Панель управления показывает вызовы, расход токенов и стоимость по ключам. Те же данные доступны программно через [`GET /v1/usage`](/quick-guide).

## Поддержка

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