Перейти к основному содержанию

​
Короткий ответ

При настройке third-party API в Claude Code сначала убедитесь, что endpoint Anthropic-compatible. В этой документации Claude Code использует https://www.bettertoken.ai. Не добавляйте /v1. 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://www.bettertoken.ai и https://www.bettertoken.ai/v1
  • Нужно понять группы ключей Claude и GPT

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

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

Выберите путь по группе API Key. Группа Claude:
Группа GPT требует дополнительных Claude Code model mappings. Используйте полную инструкцию Claude Code, а не только короткий пример с этой страницы. После редактирования config перезапустите Claude Code и отправьте короткое тестовое сообщение. Если оно не проходит, сначала проверьте, не был ли Base URL случайно заменен на https://www.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://www.bettertoken.ai для Claude Code и OpenAI-compatible https://www.bettertoken.ai/v1 для Codex и внешних инструментов. Это позволяет управлять API Keys, балансом и usage history в одном dashboard, но не меняет требование Claude Code к Anthropic-compatible request format.

​
References