Skip to main content

​
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 обычно нужны ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN. С провайдером GPT дополнительно нужны model mappings Claude Code из инструкции по настройке.

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

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

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

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

Выберите путь по провайдеру. провайдер Claude:
провайдер GPT требует дополнительных Claude Code model mappings. Используйте полную инструкцию Claude Code, а не только короткий пример с этой страницы. После редактирования config перезапустите Claude Code и отправьте короткое тестовое сообщение. Если оно не проходит, сначала проверьте, не был ли Base URL случайно заменен на https://bettertoken.ai/v1.

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

  • Добавлять /v1 к Base URL Claude Code.
  • Менять API Key, но оставлять requests на default endpoint.
  • Использовать Model ID провайдера GPT как модель провайдера Claude.
  • Вставлять 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.

​
References