Диагностика · Claude Code

Claude Code API Error 401 authentication_error — решение

Claude Code печатает API Error: 401 authentication_error, когда до эндпоинта не доходит ни один валидный ключ. Правила переменных окружения, которые к этому приводят, и решение.

Что вы видите

API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid or missing API key."}}

Почему возникает

  • ANTHROPIC_BASE_URL не задана в оболочке, из которой запущен claude, поэтому ключ уходит на api.anthropic.com, который о нём никогда не слышал. Тот сервер отвечает invalid x-api-key.
  • Переменная задана не в той оболочке, из которой запущен claude, — export в одном терминале не существует в другом, а GUI-лаунчеры не читают ваш профиль оболочки.
  • ANTHROPIC_AUTH_TOKEN пуста, обрезана или содержит ключ другого провайдера. Этот эндпоинт принимает ключ в x-api-key или в Authorization: Bearer; 401 означает, что ни один полученный ключ не валиден.
  • Ключ отозван или истёк, если выпускался с датой окончания.

Что делать

  • Задайте ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN вместе и снимите ANTHROPIC_API_KEY, чтобы устаревший ключ другого провайдера не мешал.
  • Проверяйте в той же оболочке, которая запускает claude: выведите первые символы переменной прямо перед запуском.
  • Убедитесь, что ключ активен в панели, затем проверьте его через curl на https://router.apitoken.sale/v1/models.

Рабочее окружение для этого шлюза

export ANTHROPIC_BASE_URL="https://router.apitoken.sale"
export ANTHROPIC_AUTH_TOKEN="sk-pool-•••"
export ANTHROPIC_MODEL="openai/gpt-6.1-terra"   # or a google/gemini-* model
export ANTHROPIC_DEFAULT_HAIKU_MODEL="openai/gpt-6-luna"   # background tasks
unset ANTHROPIC_API_KEY   # keep one credential
claude

Похожие запросы

  • API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}
  • claude code 401 custom ANTHROPIC_BASE_URL
  • claude code invalid api key

Вопросы и ответы

Почему Claude Code возвращает 401 сразу после установки своего ANTHROPIC_BASE_URL?+
Обычно переменные не дошли до оболочки, которая запускает claude, или ключ принадлежит другому эндпоинту, чем тот, на который указывает base URL. Проверьте окружение в этой оболочке и сопоставьте ключ с эндпоинтом.
Какая переменная правильная — ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN?+
ANTHROPIC_API_KEY превращается в заголовок x-api-key, ANTHROPIC_AUTH_TOKEN — в Authorization: Bearer. Этот эндпоинт принимает оба, но документированный вариант — ANTHROPIC_AUTH_TOKEN. Оставляйте заданной только одну из них.
Тот же ключ работает в curl, но не в Claude Code — почему?+
У оболочки, которая запускает claude, другое состояние окружения: конкурирующая переменная, устаревшее значение или его полное отсутствие. Проверьте окружение именно в этой оболочке.

Пропустите сломанную настройку

apiToken.sale отдаёт модели GPT и Gemini через OpenAI-совместимые эндпоинты, Messages (формат Anthropic) и нативный Gemini — стандартные SDK, один ключ, один предоплаченный баланс. Направьте base URL вашего инструмента на него, и конфигурация с этой страницы заработает как написано.