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

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

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

1. Установленный Claude Code. Если его ещё нет, начните с шага 1.
2. API-ключ BeatAPI: создайте его в Dashboard → API Keys.

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

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

brew install --cask claude-code

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

claude --version

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

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

Способ 1. settings.json

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

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

• macOS / Linux: ~/.claude
• Windows: %userprofile%\.claude

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

Создайте или измените settings.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"
  }
}

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

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

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

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

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

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

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

claude "Hello"

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

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

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

Модели

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

Тарифы указаны на странице цен, формат запросов — в разделе Claude API.

Настройка Sonnet 5.5

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

{
  "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.

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

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

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

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

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

401 или 403

Также проверьте, что 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.

Поддержка

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