Claude Code 529 Overloaded: причины, настройки повторов и решения

Wokey Team · 2026-09-24

Коротко: ошибка 529 означает, что у апстрим-модели прямо сейчас не хватает мощностей («overloaded»). К вашему балансу, квоте или API-ключу она отношения не имеет. Прежде чем показать ошибку, Claude Code уже несколько раз повторил запрос. Быстрее всего помогает переключение модели через /model, потому что мощности учитываются для каждой модели отдельно. Если вы не спешите, подождите несколько минут и отправьте запрос снова.

Точный текст ошибки

В Claude Code вы видите:

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

Документация Claude Code говорит о ней три вещи:

• Это временная нехватка мощностей, общая для всех пользователей.
• Прежде чем её показать, Claude Code несколько раз повторил запрос.
• 529 — это не ваш лимит использования, и она не расходует вашу квоту.

Если вы подключаетесь через шлюз с помощью ANTHROPIC_BASE_URL, в последнем предложении вместо status.claude.com будет указан хост шлюза.

Откуда берётся 529 в Wokey

Wokey никогда не генерирует 529 сам: этот статус всегда приходит от апстрим-модели. Wokey обрабатывает его в три шага:

1. Когда апстрим сообщает о перегрузке (например, overloaded_error от Anthropic), Wokey сначала повторяет ваш запрос по другому апстрим-маршруту для той же модели. Вы этого не видите.

2. Только если повторный запрос тоже упирается в перегрузку, Wokey передаёт статус апстрима дальше. HTTP-статус остаётся 529. Тело ответа использует стандартный формат ошибок Wokey, а в message стоит собственная формулировка апстрима:

   {"error":{"code":"upstream_unavailable","message":"Overloaded","type":"invalid_request_error"}}
   

3. Если перегрузка случается после того, как ответ уже начал передаваться потоком, она приходит как событие error внутри потока, а не как HTTP 529.

Итак, 529 через Wokey означает, что несколько апстрим-маршрутов для одной и той же модели были перегружены одновременно — обычно это пик нагрузки на стороне поставщика. Заголовка Retry-After в таких ответах нет; ваш клиент повторяет запросы по собственному графику отсрочки (backoff).

Как отличить её от других ошибок

Только 529 и 503 означают «апстрим занят». Остальные требуют действий с вашей стороны.

Что делать

1. Подождать и отправить снова. Перегрузка обычно проходит за несколько минут, а короткие всплески и так покрываются автоматическими повторами Claude Code.

2. Сменить модель через /model. Мощности учитываются для каждой модели отдельно, поэтому, когда Opus перегружена, Sonnet часто продолжает работать. Выполните /model в сессии и выберите другую модель; перезапускать ничего не нужно.

3. Для длинных задач без присмотра — повторять настойчивее. Добавьте это в блок env файла ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_RETRY_WATCHDOG": "1"
  }
}

• CLAUDE_CODE_RETRY_WATCHDOG=1 заставляет Claude Code бесконечно повторять запросы при ошибках 429 и 529, увеличивая паузу между попытками до 5 минут. Подходит для задач, оставленных на ночь.
• Если нужно лишь несколько дополнительных попыток, задайте вместо этого CLAUDE_CODE_MAX_RETRIES. По умолчанию это 10, максимум — 15.

4. В собственном коде оставьте запас на повторы при 529. Официальные SDK Anthropic по умолчанию дважды повторяют запросы при ошибках 5xx, включая 529. Для пакетных задач увеличьте max_retries и оберните вызов экспоненциальной отсрочкой.

Ошибка 529 в Codex

Codex считает ошибки 5xx, включая 529, допускающими повтор:

• HTTP-уровень по умолчанию повторяет запрос 4 раза (request_max_retries провайдера).
• Затем уровень потока делает ещё до 5 повторов (stream_max_retries).
• Если все они неудачны, ошибка начинается с unexpected status 529, за которым следует тело ответа.

Если в этом теле code равен upstream_unavailable, речь идёт о перегрузке апстрима, описанной выше. Решение то же: подождать или сменить модель в config.toml. Полную настройку Codex смотрите в руководстве по config.toml для Codex.