Подключение Coding Agent

Установка Claude Code: API Key, Base URL и модели

Подключите Claude Code через BetterToken API Key, Base URL и Model ID. Настройте модель перед запуском или смените её командой /model в текущем сеансе.

Подключите Claude Code с помощью BetterToken API Key, Base URL https://bettertoken.ai и выбранного Model ID. Скопируйте точный Model ID из model plaza.

Claude Code Anthropic Base URL и API error

Base URL для Claude Code не содержит /v1: приложение само добавляет путь Anthropic Messages. Начните с руководства по Claude Code custom API endpoint, API Key и Base URL, а различия протоколов проверьте в статье OpenAI-compatible и Anthropic-compatible API. Для GPT перейдите к расширенной настройке.

Ключевые параметры

Поле	Значение
API Key	API Key BetterToken
Base URL	`https://bettertoken.ai`
Model	`YOUR_MODEL_ID`

Подготовка

Установите Claude Code
Установите Node.js, если используете скрипт Automatic setup от BetterToken; для установки через npm нужен Node.js 22 или новее
Создайте и скопируйте API Key BetterToken

Зарегистрироваться и получить BetterToken API Key

Уже есть аккаунт? Войдите, пополните баланс и создайте ключ в консоли.

Установка

Anthropic рекомендует нативный установщик, которому не нужен Node.js. Если предпочитаете npm, сначала установите Node.js 22 или новее, затем выполните:

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

Настройка командой

Скрипт Automatic setup от BetterToken записывает конфигурацию provider для Claude Code. Для него нужен Node.js; если API Key не передан параметром, скрипт запросит его интерактивно.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-claudecode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-claudecode-provider.ps1" -OutFile "$env:TEMP\install-claudecode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-claudecode-provider.ps1"

После выполнения проверьте ~/.claude/settings.json (в Windows — %USERPROFILE%\.claude\settings.json) и полностью перезапустите Claude Code. Если нужен контроль каждого поля, используйте ручную настройку ниже.

Ручная настройка

Система	Файл
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

Скопируйте точный Model ID из model plaza.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID"
  }
}

Замените YOUR_MODEL_ID скопированным ID модели. ANTHROPIC_MODEL задаёт основную модель, а три переменные ANTHROPIC_DEFAULT_*_MODEL задают псевдонимы Haiku, Sonnet и Opus. Можно указать одну модель для всех ролей или разные модели.

Примеры содержат необязательный параметр CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1. Он отключает автоматические обновления, отправку отчётов об ошибках, некоторые проверки доступности и функции аккаунта; для авторизации он не нужен. Для ручного обновления выполните claude update или используйте пакетный менеджер, через который установлен клиент. См. инструкцию по обновлению и действие параметра.

Расширение VS Code

Расширение использует settings.json VS Code. Добавьте отдельную настройку claudeCode.environmentVariables:

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "YOUR_MODEL_ID"
    }
  ]
}

Проверка подключения

Запустите Claude Code в проекте:

claude

Отправьте короткое сообщение. Обычный ответ без ошибок 401, соединения или модели подтверждает настройку. В интерактивной сессии выполните /status и проверьте две строки:

Anthropic base URL должна содержать Base URL BetterToken: https://bettertoken.ai. Если строки нет, переменная не попала в текущую сессию. Проверьте путь к settings.json и полностью перезапустите Claude Code.
Строка аутентификации должна показывать ANTHROPIC_AUTH_TOKEN, а не вход через аккаунт claude.ai.

Чтобы проверить подключение из скрипта, отправьте короткий запрос:

claude -p "Reply with only: OK"

Ответ OK без ошибок подтверждает, что подключение работает.

Конфликт с сохранённым входом

Учётные данные из переменных окружения имеют приоритет над сохранённым входом в claude.ai. Если при запуске вы видите предупреждение о двух источниках учётных данных, отключите один из них. Чтобы оставить только BetterToken API Key, выполните /logout. Если в оболочке также задана переменная ANTHROPIC_API_KEY, сначала удалите её.

Смена модели

Измените Model ID в настройках и перезапустите Claude Code. Для переключения в текущей сессии используйте /model YOUR_MODEL_ID.

Для других псевдонимов, например fable с переменной ANTHROPIC_DEFAULT_FABLE_MODEL, используйте официальное сопоставление псевдонимов и доступный Model ID. Если Claude Code неверно определяет размер контекста для нестандартного ID, следуйте инструкции по настройке окна контекста, указав подтверждённый лимит модели.

Модели BetterToken в /model (необязательно)

Используйте актуальную версию Claude Code. Добавьте "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1" в существующий блок env файла ~/.claude/settings.json, затем полностью перезапустите Claude Code. При запуске Claude Code запрашивает доступные модели через /v1/models по адресу https://bettertoken.ai. См. официальное руководство по настройке шлюза.

Для проверки запустите claude --debug и найдите строки [gatewayDiscovery] в файле ~/.claude/debug/<session-id>.txt. Строка о сохранении моделей в кэш подтверждает успешное обнаружение.

Claude Code показывает только модели шлюза, в Model ID которых есть claude или anthropic (без учёта регистра), как описано в протоколе шлюза. Другие модели из ответа /v1/models, включая GPT, не появляются в /model, даже если BetterToken предоставляет к ним доступ. Claude Code всё же может вызвать такую модель, если задать её Model ID напрямую; в тестах с Claude Code 2.1.309 указанная таким способом модель GPT ответила на текстовые запросы и запросы на чтение файлов через Anthropic Messages.

Частые ошибки

Ошибка	Решение
`401` или ошибка авторизации	Проверьте `ANTHROPIC_AUTH_TOKEN` и удалите пробелы вокруг API Key.
`403`	Проверьте, доступна ли выбранная модель для API Key. Не заменяйте Anthropic Base URL адресом OpenAI-compatible API.
`500` или `timeout`	Повторите короткий запрос. Если ошибка сохраняется, выберите другую доступную модель и проверьте запрос в Dashboard.
`ConnectionRefused`	Используйте точно `https://bettertoken.ai`, не добавляя `/v1`.
Model ID	Сверьте точный Model ID с model plaza и укажите его в настройках модели клиента.
Конфигурация не применилась	Проверьте путь, очистите конфликтующие переменные окружения и полностью перезапустите Claude Code.
Предупреждение о конфликте двух источников учётных данных при запуске	Отключите один из источников или выполните `/logout`.
Ошибка сертификата / TLS, часто при корпоративном прокси	Укажите путь к файлу сертификата CA в `NODE_EXTRA_CA_CERTS` и перезапустите Claude Code.
`400` с сообщением о неизвестном поле, например `Extra inputs are not permitted`	Добавьте `"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"` в `env` и полностью перезапустите Claude Code. Если ошибка сохраняется, обратитесь в поддержку.
Превышена длина контекста в долгой сессии	Выполните `/compact`, чтобы сжать сессию.

Функции, недоступные с API Key

Удалённое управление (Remote Control) и голосовой ввод требуют входа через аккаунт claude.ai. Они недоступны при использовании BetterToken API Key и собственного Base URL. Это ограничение клиента Claude Code; оно не влияет на обычные диалоги о коде.

Расширенная настройка

Для управления настройками нескольких инструментов используйте CC Switch.

Связанные FAQ

Технические детали

Протокол и endpoint

Claude Code использует Anthropic Messages. Укажите ANTHROPIC_BASE_URL как https://bettertoken.ai; клиент сам добавляет /v1/messages, поэтому /v1 в Base URL не нужен.