Диагностика · 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_URLclaude 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 вашего инструмента на него, и конфигурация с этой страницы заработает как написано.