Справочник ошибок · по состоянию на 20 ноября 2026

Claude Code 401 при собственном базовом URL: Invalid API key и AUTH_TOKEN, проверка по порядку

По состоянию на 20 ноября 2026, 401 после того, как вы направили Claude Code на собственный API-адрес, — это одна из четырёх причин: ключ и эндпоинт относятся к разным сервисам, ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN перепутаны, старое значение всё ещё лежит в блоке env файла настроек, или в адресе лишний /v1. Сначала выполните /status и прочитайте строки Anthropic base URL и Auth token, затем оставьте ровно одну переменную с учётными данными, соответствующую им.

Обновлено 2026-11-20

Один ключ для Claude, GPT и ведущих китайских моделей, оплата по токенам, старт за несколько минут.

#401 Invalid API key#ANTHROPIC_BASE_URL#AUTH_TOKEN и API_KEY#устаревший env в настройках

Четыре значения, которые стоит знать сразу

401

Учётные данные отклонены, а не сеть

Справочник ошибок API Anthropic определяет 401 как authentication_error: сам ключ искажён, отозван или истёк. Когда адрес указывает на шлюз, текст после 401 написан этим шлюзом, а не Anthropic.

x-api-key

ANTHROPIC_API_KEY передаётся в этом заголовке

Справочник по аутентификации указывает, что при прямом доступе к API Anthropic он отправляется как заголовок X-Api-Key. Если у вас есть ещё и вход по подписке, одобренный API-ключ имеет приоритет над ним — поэтому сессия со входом может всё равно падать на учётных данных.

Bearer

ANTHROPIC_AUTH_TOKEN передаётся в этом заголовке

Его значение получает префикс Bearer и отправляется как заголовок Authorization — для шлюзов или прокси, которые аутентифицируют по bearer-токенам. Официальный совет: если вам не сказали, какой использовать, начните с этого.

/status

Посмотрите, какой адрес и какие учётные данные действуют

Руководство по шлюзу показывает строку Anthropic base URL только когда задан адрес шлюза. Строка Auth token или API key означает, что активны учётные данные шлюза; строка Login method означает, что активен ваш вход.

Что на самом деле означает 401 на собственном адресе

401 на собственном API-адресе редко бывает сетевой проблемой: учётные данные, приложенные к запросу, не принимаются на той стороне. Официальная страница ошибок объясняет Invalid API key как переменную ANTHROPIC_API_KEY или скрипт apiKeyHelper, вернувший ключ, который API отклонил, либо как блокировку этого ключа Claude Code до отправки.

Второе сообщение, API Error: 401 Invalid authentication credentials, конкретнее: API распознал формат учётных данных, но отклонил аккаунт или организацию за ними, поэтому истёкший токен здесь не причина. Есть и третий случай: когда адрес указывает на шлюз, текст после 401 — это собственная ошибка шлюза, и /login её не изменит, потому что шлюзу нужны другие учётные данные. Все три начинаются одинаково: выполните /status и посмотрите, какой адрес и какие учётные данные действуют.

Два изменения, связанных с этой ошибкой 401, по состоянию на 20 ноября 2026

1. Ещё один источник 401 находится на стороне шлюза: официальная страница ошибок говорит, что если каждый запрос завершается 401, хотя шлюз уже получил ожидаемые учётные данные, проверьте, принимает ли шлюз поля tool search; до v2.1.304 tool search за шлюзом был выключен, если не включить его через ENABLE_TOOL_SEARCH. 2.

Сбои apiKeyHelper теперь выглядят иначе: когда скрипт не возвращает ключ, запрос доходит до API с подстановочными учётными данными и отклоняется с 401, а до v2.1.208 Claude Code тратил весь бюджет повторов на переотправку этого запроса с подстановочными учётными данными и затем сообщал об общей ошибке 401 authentication error вместо сбоя скрипта; начиная с v2.1.208 скрипт, который падает с ошибкой, истекает по таймауту или ничего не выводит, проявляется как Your apiKeyHelper script is failing в пределах трёх попыток.

Три даты: какая переменная куда, способ через файл настроек и 401 на стороне шлюза

2026-07-05

Частый опыт в обсуждениях по диагностике в сообществе: собственный эндпоинт принимает ANTHROPIC_AUTH_TOKEN, прямое подключение к api.anthropic.com принимает ANTHROPIC_API_KEY. При таком разделении адрес шлюза в паре с ключом Anthropic, или прямой адрес в паре с ключом шлюза, не могут совпасть по заголовкам запроса, поэтому та сторона может ответить только 401.

2026-11-11

Частый опыт в обсуждениях по диагностике в сообществе: записывайте адрес и ключ шлюза в блок env файла ~/.claude/settings.json, а не только экспортируйте их в терминале. Повторяются два правила: указывайте адрес только до хоста и не добавляйте /v1, а если одна и та же переменная задана дважды, побеждает файл настроек.

2026-11-20

Когда у шлюза уже есть правильные учётные данные, а каждый запрос всё равно возвращает 401, проверьте, принимает ли шлюз поля tool search; до v2.1.304 эта функция была выключена за шлюзом и её нужно было включать через ENABLE_TOOL_SEARCH. Те же документы отмечают, что строка Anthropic base URL в /status появляется только когда задан адрес шлюза.

Что подтверждают официальные документы, а что — утверждения сообщества и неопубликованные детали

Подтверждено документами Claude Code по ошибкам, аутентификации, переменным окружения, шлюзу и настройкам, а также справочником ошибок API Anthropic

1. Оба сообщения: Invalid API key · Fix external API key означает, что ANTHROPIC_API_KEY или скрипт apiKeyHelper дал ключ, который API отклонил, либо Claude Code заблокировал его до отправки; API Error: 401 Invalid authentication credentials означает, что формат распознан, но аккаунт или организация отклонены, поэтому истёкший токен не причина. 2.

Заголовки: значение AUTH_TOKEN получает префикс Bearer и отправляется как Authorization; API_KEY отправляется как X-Api-Key. 3. Приоритет: AUTH_TOKEN выше API_KEY, а вход ниже обоих; в интерактивном режиме API-ключ требует вашего одобрения один раз, а в режиме -p ключ используется всякий раз, когда он присутствует. 4.

Случай шлюза: когда адрес указывает на шлюз, текст после 401 — это сообщение шлюза, и /login его не меняет; учётные данные должны быть в AUTH_TOKEN, API_KEY или apiKeyHelper — в зависимости от того, что нужно шлюзу. 5. Файлы настроек: блок env действует везде, где запускается Claude Code, пользовательский ~/.claude/settings.json покрывает все ваши проекты, локальный для проекта .claude/settings.local.json покрывает один проект, а .claude/settings.json проекта коммитится, поэтому учётных данных там быть не должно. 6.

Соседние коды: 403 — недостаточно прав, 429 — лимит частоты или расходов, 529 — перегруженный API, и ни один из них не является проблемой учётных данных.

Утверждения сообщества и то, чего официальные документы не говорят

1. Добавлять /v1 в адрес надёжнее: в обсуждениях сообщества говорят, что в конце адреса /v1 оставлять не нужно, потому что /v1/messages дописывается за вас; официальный проверочный запрос записан как $ANTHROPIC_BASE_URL/v1/messages, из чего видно, что /v1 не входит в значение переменной. На QCode значение — https://api.qcode.cc/api, и лишний /v1 в конце всё равно даёт дублированный /v1/v1/messages. 2. export в терминале всегда действует: официальная документация предупреждает, что direnv, плагины dotenv для оболочки и терминалы IDE могут загрузить устаревший ключ из файла .env проекта, а в публикациях сообщества сообщается, что при установке одной и той же переменной в обоих местах побеждает файл настроек, поэтому перед правкой оболочки проверьте /status. 3.

Новый /login заменяет API-ключ: нет. Документация говорит, что одобренный API-ключ имеет приоритет над вашим входом и /login его не заменяет; снимите его через unset или смените ключ.

Два пути: API_KEY напрямую к Anthropic vs AUTH_TOKEN через шлюз

ANTHROPIC_API_KEY: ключ Console для прямого доступа к API Anthropic

Он отправляется как заголовок X-Api-Key и берётся из Claude Console. В интерактивном режиме вы одобряете его один раз, и выбор запоминается; в режиме -p он используется всякий раз, когда присутствует. Он важнее вашего входа по подписке — поэтому активный тариф может продолжать возвращать 401: смените ключ в Console или снимите переменную и вернитесь к подписке.

ANTHROPIC_AUTH_TOKEN: bearer-учётные данные, которых ждёт шлюз

Его значение получает префикс Bearer и отправляется в Authorization — для шлюзов, которые аутентифицируют по bearer-токенам. На QCode адрес — https://api.qcode.cc/api без /v1, а учётные данные — ключ, начинающийся с cr_; выполните unset ANTHROPIC_API_KEY, чтобы два набора учётных данных никогда не сосуществовали. Официальная рекомендация: если шлюз не говорит, какой вариант нужен, начните с AUTH_TOKEN и подтвердите проверочным запросом.

Шесть шагов: от точной строки ошибки до перезапущенного и проверенного клиента

1. Прочитайте точную строку и отнесите её к одному из трёх случаев: Invalid API key · Fix external API key означает, что ключ отклонён или заблокирован до отправки; API Error: 401 Invalid authentication credentials означает, что формат верен, а отклонены аккаунт или организация; если адрес указывает на шлюз, текст после 401 принадлежит шлюзу, поэтому меняйте нужные ему учётные данные, а не запускайте /login. 2.

Выполните /status: проверьте, есть ли строка Anthropic base URL и какой адрес в ней назван, затем посмотрите строку Auth token или API key, чтобы понять, какие учётные данные действуют. 3. Откройте ~/.claude/settings.json и поищите в блоке env устаревший ANTHROPIC_BASE_URL или старый ключ; если та же переменная задана и в файле настроек, значение, изменённое в терминале, может не примениться.

Никогда не кладите учётные данные в проектный .claude/settings.json — он попадает в коммит. 4. Оставьте одну переменную с учётными данными: для шлюза задайте ANTHROPIC_AUTH_TOKEN и выполните unset ANTHROPIC_API_KEY; для прямого доступа к Anthropic сделайте наоборот — оставьте ANTHROPIC_API_KEY и очистите AUTH_TOKEN. 5.

Проверьте адрес: адрес Claude Code на QCode — https://api.qcode.cc/api без /v1, а Codex использует https://api.qcode.cc/openai; не смешивайте их. 6. Перезапустите claude и отправьте один минимальный запрос через curl: POST $ANTHROPIC_BASE_URL/v1/messages с Authorization: Bearer $ANTHROPIC_AUTH_TOKEN и anthropic-version: 2023-06-01. Ответ 401 означает, что нужно переключиться на другую переменную и повторить; тело JSON означает, что и адрес, и учётные данные верны.

Сторона QCode: один адрес, одна переменная

QCode — независимый сервис доступа к API, не связанный с Anthropic, OpenAI и другими вендорами. Модели Claude идут только через эндпоинт Anthropic Messages: задайте ANTHROPIC_BASE_URL как https://api.qcode.cc/api без /v1, задайте ANTHROPIC_AUTH_TOKEN равным ключу, начинающемуся с cr_, и выполните unset ANTHROPIC_API_KEY, чтобы два набора учётных данных никогда не сосуществовали.

Поместите обе строки в блок env файла ~/.claude/settings.json, перезапустите claude, затем проверьте строки Anthropic base URL и Auth token в /status. Codex использует другой адрес, https://api.qcode.cc/openai, поэтому не смешивайте его с Claude Code. Оплата — по токенам; актуальные тарифы по каждой модели — на /models.

Не готовы к месячному тарифу? Разовые пакеты начинаются от $4 за разовую квоту, которую вы используете в течение 7 дней; если у вас уже есть личный тариф, добавьте бустер-пакет, когда нужно больше квоты.

Частые вопросы

Я экспортировал ANTHROPIC_AUTH_TOKEN в терминале, а Claude Code всё равно возвращает 401. Почему?

Сначала выполните /status и посмотрите, какие именно учётные данные названы в строке Auth token или API key и какой адрес показывает строка Anthropic base URL; это официальный способ увидеть действующий источник учётных данных. Обычно три причины. Первая — устаревшее значение в файле настроек: всё, что записано в блок env файла ~/.claude/settings.json, действует везде, где запускается Claude Code, и новое значение в терминале не обязательно его перекрывает. Вторая — ключ, загруженный из другого места: документация предупреждает, что direnv, плагины dotenv для шелла и терминалы IDE могут загрузить ключ, который вы явно не задавали, из проектного файла .env, поэтому выполните env | grep ANTHROPIC в том же шелле. Третья — ключ от другого сервиса, чем эндпоинт: свой эндпоинт в паре с ключом Anthropic или прямой адрес в паре с ключом шлюза.

В чём разница между ANTHROPIC_AUTH_TOKEN и ANTHROPIC_API_KEY?

В заголовке и в назначении. Значение AUTH_TOKEN получает префикс Bearer и отправляется в Authorization — для шлюзов или прокси, аутентифицирующих по bearer-токенам. ANTHROPIC_API_KEY отправляется в X-Api-Key и предназначен для ключа Claude Console при прямом доступе к Anthropic API. Официальный список приоритетов ставит AUTH_TOKEN выше API_KEY, поэтому при наличии обоих используется AUTH_TOKEN: за шлюзом оставьте его и уберите второй, а при прямом доступе — наоборот. Если вы не знаете, какой из них нужен шлюзу, документация рекомендует начать с AUTH_TOKEN и подтвердить проверочным запросом.

Должен ли ANTHROPIC_BASE_URL включать /v1?

Нет. Не добавляйте /v1 в конец адреса; /v1/messages дописывает сам Claude Code, и официальный проверочный запрос записан как $ANTHROPIC_BASE_URL/v1/messages, из чего видно, что /v1 не входит в значение. Лишний сегмент в конце даёт /v1/v1/messages, шлюз не может маршрутизировать этот путь, и ответ часто выглядит как проблема с учётными данными. На QCode значение — https://api.qcode.cc/api, где /api — часть самого адреса, а не дублированный /v1. Это же правило действует не для всех клиентов: OpenAI-совместимые SDK и Codex используют адреса с /openai или /openai/v1.

В чём разница между 401 и 403?

401 — про сами учётные данные: справочник API определяет его как authentication_error, то есть ключ некорректного формата, отозван или просрочен. 403 — permission_error: ключ действителен, но не имеет прав на запрошенный ресурс, поэтому проверьте настройки доступа организации и рабочего пространства в Console. Одно исключение стоит запомнить: если текст 401 начинается с CORS requests are not allowed for this Organization, проблема не в ключе, потому что запрос нёс заголовок Origin из браузера, и отправлять его нужно со своего бэкенда; смена ключа ничего не даст.

429 и 529 — это проблемы с ключом?

Нет. Ни одно из этих чисел не связано с учётными данными, и новый ключ их не исправит. 429 — rate_limit_error: организация достигла лимита скорости, месячного лимита расходов своего уровня использования или лимита расходов рабочего пространства Claude Code; такой 429 может повторяться до восстановления доступа и приходить без заголовка retry-after. 529 — overloaded_error: API временно перегружен, что, по документации, может происходить при высоком трафике у всех пользователей. Официальный SDK автоматически повторяет такие временные сбои, по умолчанию дважды, соблюдая retry-after.

Что делать, если apiKeyHelper падает или запросы продолжают возвращать 401?

Сначала запустите скрипт отдельно и убедитесь, что он печатает валидный ключ в stdout — это первый официальный шаг диагностики. Когда скрипт не возвращает ключ, запрос уходит в API с заполнителем вместо учётных данных и отклоняется с 401: до v2.1.208 Claude Code тратил весь бюджет повторов на переотправку этого запроса с заполнителем и затем сообщал общий 401 authentication error вместо сбоя скрипта, а начиная с v2.1.208 скрипт, который завершается ошибкой, превышает таймаут или ничего не печатает, проявляется как Your apiKeyHelper script is failing в пределах трёх попыток. Если ключ возвращается дольше 10 секунд, в строке подсказки появляется предупреждение с затраченным временем. Если скрипт исправен, а 401 всё равно есть, проверьте в /status, являются ли его выводом действующие учётные данные, поскольку AUTH_TOKEN и API_KEY стоят выше apiKeyHelper, и оставшаяся переменная означает, что ключ скрипта не используется вовсе. Учтите, что Claude Desktop и облачные сессии не вызывают apiKeyHelper и не читают эти переменные окружения.

Источники

Справочник ошибок Claude Code code.claude.com/docs/en/errors (проверено 2026-11-20); аутентификация и приоритет code.claude.com/docs/en/authentication (проверено 2026-11-20); переменные окружения code.claude.com/docs/en/env-vars (проверено 2026-11-20); подключение через LLM-шлюз code.claude.com/docs/en/llm-gateway-connect (проверено 2026-11-20); файлы настроек code.claude.com/docs/en/settings (проверено 2026-11-20); ошибки Anthropic API platform.claude.com/docs/en/api/errors (проверено 2026-11-20); утверждения сообщества взяты из публичных обсуждений и отмечены как таковые в тексте. Всё проверено 2026-11-20.

Согласуйте адрес и учётные данные, затем проверьте через /status и один запрос

Создайте аккаунт для ключа cr_, задайте ANTHROPIC_BASE_URL=https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN в Claude Code и вызывайте модели с оплатой по токенам, тарифы — на /models.

Связанные материалы

Оплата криптовалютой

Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.

Документация Anthropic по Claude Code и справочник ошибок API проверены 2026-11-20 и являются авторитетными на code.claude.com и platform.claude.com. QCode.cc — независимый сервис доступа к API, не связанный с Anthropic или OpenAI и не одобренный ими, и он не может изменить то, как вендор оценивает ваш аккаунт или ключ. Доступность моделей и актуальные тарифы QCode — на qcode.cc/models.

Не знаете, с чего начать?

Попробовать неделю

Пакет «Малый» — $4: квота $30 на 7 дней

Работаете каждый день

«Стартовый» — $9.00 в месяц и $5 квоты каждый день: всего $0.060 за $1 квоты, у пакета «Средний» — около $0.113