Claude Code

Claude Code custom API endpoint: API Key и Base URL

Подключите Claude Code с помощью BetterToken API Key, Base URL BetterToken и выбранного Model ID.

Claude Code custom API endpoint: короткий ответ

Claude Code custom API endpoint должен быть Anthropic-compatible. В этой документации Claude Code использует https://bettertoken.ai. Не добавляйте /v1.

Для общего доступа к Claude API, доступных моделей и вариантов начала работы используйте страницу Claude API BetterToken. Эта FAQ предназначена только для уже выбранного BetterToken API Key и настройки Claude Code через Base URL и переменные окружения; она не дублирует описание общего API-доступа.

API Key подтверждает запрос. Base URL говорит Claude Code, куда отправлять model requests. Оба значения должны относиться к одному provider и одному protocol.

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

Когда это важно

Вы хотите использовать Claude Code с custom API gateway
У вас есть API Key, но непонятно, какой Base URL указать
Claude Code показывает auth или endpoint error
Вы выбираете между https://bettertoken.ai и https://bettertoken.ai/v1

Ключевые понятия

Поле	Что означает
API Key	Credential для model API requests
Base URL	API address, куда отправляются requests
Anthropic-compatible API	Endpoint, следующий Anthropic / Claude request conventions
OpenAI-compatible API	Endpoint, следующий OpenAI-style conventions, часто для Codex, Cursor и Cline
Model ID	Имя модели или mapping value, который запрашивает инструмент

Рекомендуемая настройка

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

Скопируйте точный 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. Можно указать одну модель для всех ролей или разные модели.

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

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

Добавлять /v1 к Base URL Claude Code.
Менять API Key, но оставлять requests на default endpoint.
Вставлять OpenAI-compatible endpoint в Anthropic-compatible поля Claude Code.
Оставлять старые environment variables в shell profile, которые перекрывают новую config.

О BetterToken

BetterToken предоставляет два типа endpoint: Anthropic-compatible https://bettertoken.ai для Claude Code и OpenAI-compatible https://bettertoken.ai/v1 для Codex и внешних инструментов.

Это позволяет управлять API Keys, балансом и usage history в одном dashboard, но не меняет требование Claude Code к Anthropic-compatible request format.