Ошибки 403, 503 и 529 в Claude Code: кто ответил и что чинить

Код ошибки в Claude Code сам по себе не говорит, кто отказал. Один и тот же 403 возвращают ваш прокси, Anthropic из-за подписки или региона, корпоративный шлюз и сайт, который Claude пытался открыть. 503 с текстом вроде No available accounts или No available channel почти всегда приходит от сервиса-посредника, через который идут ваши запросы, а не от Anthropic. 529 означает нехватку мощностей у Anthropic (или у облачного провайдера), и ваш лимит он не расходует.

Чтобы понять, какой случай у вас, достаточно двух вещей: точного текста после кода и строки Anthropic base URL в /status. Если такой строки нет, запросы идут напрямую в Anthropic (или к облачному провайдеру). Если есть, каждый ответ сначала проходит через указанный там адрес, и чинить надо начинать с него.

Кто на самом деле ответил: /status и хвост сообщения

Запустите Claude Code там, где видите ошибку (в том же терминале или в той же IDE), и наберите /status. На вкладке Status важны две строки:

• Anthropic base URL появляется только тогда, когда задан адрес шлюза или посредника. Нет строки — переменная ANTHROPIC_BASE_URL до этой сессии не дошла, и Claude Code ходит в api.anthropic.com.
• Auth token или API key называет переменную с ключом, которую сессия реально использует. Строка Login method с аккаунтом claude.ai означает вход по подписке.

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

Второй сигнал — последняя фраза сообщения об ошибке. В актуальных версиях для любой 5xx она называет, где смотреть состояние сервиса: status.claude.com на прямом пути, страницу статуса провайдера для Bedrock, Google Cloud и Microsoft Foundry и хост шлюза, если задан свой ANTHROPIC_BASE_URL (справочник ошибок Claude Code). Если ответил прокси или балансировщик HTML-страницей, начиная с версии 2.1.281 вы увидите код и заголовок страницы, например API Error: 502 Bad Gateway. На старых сборках хвосту верить нельзя: в отчётах пользователей версии 2.1.137 ответ посредника 503 No available accounts всё равно заканчивался советом проверить status.claude.com. Поэтому сначала /status, потом хвост.

Три проверочные команды

Прямой путь. Из того же shell, где запускаете Claude Code:

curl -I https://api.anthropic.com
echo $ANTHROPIC_BASE_URL

В PowerShell вместо них — curl.exe -I https://api.anthropic.com (именно curl.exe, иначе сработает встроенный Invoke-WebRequest) и echo $env:ANTHROPIC_BASE_URL. Если curl проходит, а Claude Code падает, ищите ANTHROPIC_BASE_URL ещё и в блоке env файлов настроек: при заданном адресе модельные запросы уходят туда, а не в api.anthropic.com.

Путь через шлюз или посредника. Официальная документация предлагает отправить запрос на один токен прямо к шлюзу, минуя Claude Code:

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Ответ, начинающийся с {"id":"msg_, значит, что адрес и ключ рабочие. Ошибка про неизвестную модель тоже подтверждает адрес и ключ: шлюз сначала проверил ключ и только потом отверг имя модели. 401 — ключ отклонён. Если шлюз ждёт ключ в заголовке x-api-key, замените строку Authorization на -H "x-api-key: $ANTHROPIC_API_KEY". Если этот запрос возвращает ту же ошибку, что и Claude Code, его вывод — лучшее, что можно отправить владельцу шлюза.

403: пять разных отказов под одним кодом

403 в Claude Code — не приговор аккаунту. Тот же код приходит, когда клиент просто не подхватил прокси. Разберите случаи по порядку: от самого частого и дешёвого в проверке к тем, где от вас ничего не зависит.

VPN включён, а 403: прокси не дошёл до Claude Code

Типичная картина: в терминале, где экспортирован HTTPS_PROXY, Claude Code работает, а из VS Code, JetBrains или после запуска IDE из Dock — 403 или ошибка соединения. Причина в том, что IDE, открытая не из терминала, не видела переменных вашего shell. Официальная документация расширения прямо советует запускать VS Code командой code . из терминала, чтобы окружение унаследовалось (Claude Code в VS Code).

Что учитывать:

• Claude Code читает переменные https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY (берёт первую заданную в этом порядке) и NO_PROXY (сетевые настройки). На настройку «системный прокси» в macOS или Windows не рассчитывайте: Claude Code ориентируется на переменные окружения.
• SOCKS-прокси Claude Code не поддерживает. Если ваш клиент (например, для VLESS) открывает локально и HTTP-, и SOCKS-порт, в HTTPS_PROXY указывайте HTTP-порт.
• Если сам шлюз локальный или внутренний, внесите его в NO_PROXY, иначе запрос к нему уйдёт в прокси и не вернётся.

Самый надёжный способ, который не зависит от того, откуда запущен Claude Code, — блок env в ~/.claude/settings.json. Этот файл общий для CLI и расширения:

{
  "env": {
    "HTTPS_PROXY": "http://proxy.example.com:8080"
  }
}

Вместо proxy.example.com:8080 подставьте адрес и HTTP-порт своего прокси. Для одного только расширения VS Code есть параметр environmentVariables, но документация советует хранить общую конфигурацию в settings.json. После правки перезапустите Claude Code и сравните /status в IDE и в терминале. Подробнее про ошибки соединения, ECONNREFUSED и прокси — в разборе Claude Code: Unable to connect to API — как исправить ECONNREFUSED, ECONNRESET и proxy, а если проблема только в редакторе — в статье Claude Code не работает в VS Code? Сначала найдите поверхность сбоя.

403 после входа: подписка, роль, рабочее пространство

Сообщение API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} сразу после входа, при отсутствии base URL в /status, приходит от Anthropic. Официальная инструкция (устранение неполадок при установке и входе) называет три проверки:

• Pro или Max: убедитесь, что подписка активна, на claude.ai/settings.
• Вход через Anthropic Console: у аккаунта должна быть роль «Claude Code» или «Developer». Её назначает администратор в Console, раздел Settings → Members.
• Корпоративный прокси: он может вмешиваться в запросы к API — см. раздел выше.

В командных и корпоративных планах 403 после входа часто значит, что администратор ещё не включил Claude Code для рабочего пространства (так это объясняет русскоязычный FAQ Help Center). Если страница входа пишет Claude Code access has not been granted for this account. Contact your administrator., организация на Claude Enterprise назначила вам роль Custom, и ни одна из ваших custom-ролей не даёт доступа к Claude Code. Здесь помогает только владелец организации: он добавляет нужную роль вашей группе или меняет вашу роль на стандартную, после чего вы входите заново.

Ещё одна ловушка — ANTHROPIC_API_KEY от старого проекта в профиле shell. Когда ключ задан и вы его одобрили, Claude Code использует его вместо подписки. Строка API key в /status это покажет.

Чтобы перелогиниться, достаточно /logout, затем /login. Советы удалить ~/.claude целиком лучше не выполнять: там лежат настройки, история и учётные данные, а регион, роль и прокси от этого не изменятся.

403 из-за региона: настройками не исправить

По состоянию на 29 сентября 2026 года России нет в списке поддерживаемых стран Anthropic (как и Китая, Гонконга и Макао). Официальная документация связывает 403 на проверке соединения либо с прокси или сетевым фильтром, либо с тем, что Claude Code недоступен в вашем регионе. Если страница установки отвечает App unavailable in region, это как раз региональное ограничение.

На официальном прямом пути такой отказ не лечится ни переустановкой, ни сменой ключа, ни правкой settings.json: это вопрос допуска, а не настройки. Попытки обойти ограничение ставят под удар аккаунт, в том числе оплаченный (о последствиях блокировки — в статье Claude Code Max: аккаунт заблокирован после оплаты?).

Что реально меняет ситуацию — это другой договор, а не другие настройки: доступ через организацию или облачного провайдера в поддерживаемой стране либо API-сервис, совместимый с Anthropic Messages, у которого свои условия. Например, laozhang.ai подключается к Claude Code через ANTHROPIC_BASE_URL=https://api.laozhang.ai и ANTHROPIC_AUTH_TOKEN в блоке env (документация). Помните, что это тоже посредник: в /status появится его base URL, его ошибки разбираются по той же схеме, что и в разделе про 503, а перегрузку 529 у Anthropic он не устраняет. До оплаты проверьте условия, список моделей и то, есть ли у сервиса страница статуса. Как прописать ключи, модели и адрес шлюза, подробно описано в статье Настройка Claude Code API: ключи, settings.json, модели и шлюзы.

403 от шлюза или WAF перед ним

Если в /status есть base URL, 403 может выдать сам шлюз. В корпоративном шлюзе Claude начиная с версии 2.1.273 это выглядит так:

Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

Повторный вход здесь не поможет: отказ дал шлюз или сервис за ним, и причину видно в его журнале аудита. На более ранних версиях тот же отказ маскировался под Please run /login или Failed to authenticate.

Отдельный случай для тех, кто держит свой шлюз: 403 с HTML-страницей 403 Forbidden, а в логах шлюза запрос вообще не появился. Значит, запрос остановил WAF или обратный прокси перед шлюзом. В промптах Claude Code есть XML-подобные теги и исходный код, и правила против межсайтового скриптинга (XSS) в теле запроса на них срабатывают. Короткий curl на 1 токен при этом проходит, а настоящая сессия — нет. Решение из документации: исключить путь /v1/messages из проверки тела запроса (в AWS WAF это управляемое правило CrossSiteScripting_Body, в nginx с ModSecurity — соответствующие правила OWASP CRS).

Встречаются и посредники, которые отвечают 403 ... "This service is restricted to the official Claude Code client.". Это проверка клиента на стороне самого посредника, у Anthropic такой ошибки в документации нет; разбираться нужно с его владельцем.

403, который вообще не про доступ к API

Если 403 возникает, когда Claude открывает ссылку (инструмент WebFetch сообщает, что не может получить URL), отказал сайт или его CDN: защита от ботов, WAF, Cloudflare. К вашему аккаунту и доступу к модели это отношения не имеет. Откройте страницу в браузере, скопируйте нужный фрагмент в чат или дайте другую ссылку.

Похоже выглядит и 403 при установке: curl: (22) The requested URL returned error: 403 от скрипта установки означает, что адрес загрузки вернул ошибку вместо скрипта. Причина — либо регион, либо прокси или фильтр, блокирующий хост загрузки.

503: почти всегда посредник, а не Anthropic

В документированном списке ошибок Claude API (Messages) кода 503 нет: перегрузка там возвращается как 529 overloaded_error, внутренний сбой как 500 api_error, таймаут как 504 (список ошибок API). Это не доказывает, что 503 от инфраструктуры Anthropic невозможен в принципе. Но если текст после 503 похож на один из вариантов ниже, ответил не Anthropic, а программа посередине.

Значения первых трёх строк описаны в исходном коде и документации самих программ, а первые две встречаются и в отчётах пользователей Claude Code. Например, в августе 2026 года пользователь посредника на new-api получил 503 No available channel for model claude-opus-5 under group default, и хвост сообщения указывал на хост посредника, а не на status.claude.com. Про no available server точно известно одно: так отвечает Traefik, когда у него нет живых бэкендов. Публичных сведений о том, что Traefik стоит перед API Anthropic, нет, поэтому при заданном base URL это почти наверняка инфраструктура вашего шлюза: сервис упал или перезапускается.

no healthy upstream — единственный вариант, который стоит связывать с Anthropic, и то только при двух условиях: в /status нет base URL и на status.claude.com объявлен инцидент.

Что делать с 503 от посредника:

1. Проверьте /status: чей адрес в Anthropic base URL.
2. Прогоните тест шлюза на 1 токен из раздела выше. Если он тоже возвращает 503 с тем же текстом, проблема не в Claude Code и не в вашем компьютере.
3. Если ошибка про модель или группу, попробуйте через /model модель, которая точно есть у посредника, или смените группу в его панели.
4. Напишите владельцу сервиса. Разработчики new-api, например, прямо просят с проблемами сторонних инстансов обращаться к их операторам, а не в репозиторий.

Переустанавливать Claude Code, удалять ~/.claude и ждать исправления на status.claude.com в этом случае бессмысленно.

529: мощности Anthropic, а не ваш лимит

API Error: Repeated 529 Overloaded errors. The API is at capacity… означает, что у Anthropic (или у облачного провайдера, если хвост называет его) закончились свободные мощности для выбранной модели сразу у всех пользователей. К моменту, когда вы видите это сообщение, Claude Code уже сделал до 10 повторов с нарастающей паузой. 529 не входит в ваш лимит использования и квоту не расходует.

Мощности считаются отдельно для каждой модели, поэтому быстрее всего продолжить работу через /model, переключившись на другую модель, либо подождать несколько минут. Смена посредника перегрузку не лечит: мощностей Anthropic он не добавляет. Подробнее — в статье Ошибка 529 в Claude Code: что делать, когда API перегружен, а как продолжить прерванную задачу без дублирования действий — в материале Claude Code 500 и 529: как безопасно продолжить после сбоя без дублей.

Когда обращаться и что приложить

Кому писать, зависит от слоя, который вы определили выше:

• Администратор организации — 403 после входа при активной подписке, Claude Code access has not been granted, роль в Console. Приложите email аккаунта, название рабочего пространства и точный текст ошибки.
• Владелец шлюза или посредника — любая ошибка при заданном base URL, которую воспроизводит тест на 1 токен, а также Gateway refused the request. Приложите полный текст ошибки вместе с request id, если он есть, время, модель и вывод curl с HTTP-кодом. Ключ не пересылайте.
• Anthropic — 5xx на прямом пути (без base URL в /status), который повторяется, хотя на status.claude.com инцидентов нет. Выполните /feedback, чтобы отправить данные запроса. Для устойчивых 500 есть отдельный разбор: Claude Code API Error 500: как исправить Internal Server Error без слепых повторов.
• Никто — 403 по региону на официальном пути и 403 от сайта при WebFetch: первое не меняется настройками, второе — ограничение чужого сайта.

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

Ошибка 403 означает, что мой аккаунт заблокирован?

Нет. Блокировка — лишь один из вариантов, и не самый частый. Тот же 403 возвращается, когда Claude Code не подхватил прокси, когда у аккаунта нет нужной роли или Claude Code не включён для рабочего пространства, когда отказал шлюз или когда сайт не пустил WebFetch. Сверьте точный текст ошибки и /status с таблицей в начале.

Поможет ли удалить ~/.claude и войти заново?

Для 403 почти никогда. В этой папке хранятся настройки, история и учётные данные; удаление сотрёт их, но не изменит ни регион, ни роль, ни прокси. Если нужно перелогиниться, используйте /logout и /login.

Как понять, что Claude Code не работает у всех, а не только у меня?

Посмотрите status.claude.com или страницу статуса, которую называет хвост ошибки. Если в /status есть base URL, статус Anthropic вам мало что скажет: сначала проверьте шлюз тестом на 1 токен. Если на прямом пути вы видите 5xx или 529, а на странице статуса объявлен инцидент, проблема общая и остаётся ждать или сменить модель.