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

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

Claude Code может использовать разные способы authentication. Индивидуальные пользователи часто входят через Claude.ai account. API users или команды могут использовать Claude Console, cloud providers или поддерживаемый third-party provider путь. Claude.ai account и API Key — не одно и то же. Claude.ai login относится к официальному product experience. API Key используется для model API requests и обычно идет вместе с Base URL и provider configuration. Если вы используете third-party API gateway, главные поля — API Key и Base URL. Также нужно понять, ожидает инструмент Anthropic-compatible или OpenAI-compatible protocol.

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

  • Во время настройки Claude Code появляется login prompt
  • Вы не уверены, дает ли Claude Pro или Max API Key
  • Вы хотите направить Claude Code через custom API gateway
  • Нужно выбрать между official login и third-party provider
  • Команда хочет единый способ authentication

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

​
Как выбрать

  1. Если нужен официальный Claude Code experience и у вас есть Claude.ai plan, начните с official login.
  2. Если нужен API billing или team-managed API access, смотрите Claude Console или командный provider.
  3. Если нужен custom API gateway, проверьте, поддерживает ли Claude Code этот provider path, затем настройте API Key и Base URL.
  4. Если нужны official app features и third-party inference provider, решите, нужно ли сохранять official login state.
В этой документации Anthropic-compatible Base URL для Claude Code — https://www.bettertoken.ai.

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

  • Считать Claude.ai subscription API Key.
  • Вставлять ChatGPT Plus или другой subscription credential в Claude Code.
  • Копировать только API Key и забывать поменять Base URL.
  • Вставлять OpenAI-compatible Base URL в Anthropic-compatible configuration Claude Code.
  • Передавать auth.json, refresh tokens или session credentials как будто это API Keys.

​
О BetterToken

Если вы выбираете путь API Key + Base URL, BetterToken может предоставить compatible endpoint и dashboard для API Keys, баланса и usage history. BetterToken не заменяет Claude.ai login и не превращает Claude.ai subscription в API Key. Он работает только на model API layer.

​
References