Ошибки API в Claude Code — 429, 401, 402, 529
Сбои API Claude Code показывает одной строкой, начинающейся с "API Error:" и сырым телом ответа следом. Страницы ниже разбирают каждую форму: точный текст, почему это происходит и что помогает.
| Ошибка | Что означает |
|---|---|
API Error: 429 {"type":"error","error":{"type":"rate_limit_error… | Claude Code печатает API Error: 429 rate_limit_error, когда исчерпан поминутный лимит. Что это за лимит, почему его выбивают параллельные агенты и как это чинится. |
API Error: 401 {"type":"error","error":{"type":"authentication_e… | Claude Code печатает API Error: 401 invalid x-api-key, когда ключ не доходит до нужного эндпоинта. Правила переменных окружения, которые к этому приводят, и решение. |
API Error: 529 {"type":"error","error":{"type":"overloaded_error… | Claude Code печатает API Error: 529 Overloaded, когда мощности апстрима перегружены. Почему ваш запрос ни при чём, почему ошибка кучкуется и что реально помогает. |
API Error: 402 {"type":"error","error":{"type":"billing_error","… | Claude Code печатает API Error: 402 billing_error, когда предоплаченного баланса не хватает на запрос. Пополните баланс; не ретрайте 402 как лимит частоты. |
Claude Code API Error 429 (rate_limit_error) — причина и решение
Claude Code печатает API Error: 429 rate_limit_error, когда исчерпан поминутный лимит. Что это за лимит, почему его выбивают параллельные агенты и как это чинится.
Claude Code API Error 401 invalid x-api-key — решение
Claude Code печатает API Error: 401 invalid x-api-key, когда ключ не доходит до нужного эндпоинта. Правила переменных окружения, которые к этому приводят, и решение.
Claude Code API Error 529 Overloaded — что это значит
Claude Code печатает API Error: 529 Overloaded, когда мощности апстрима перегружены. Почему ваш запрос ни при чём, почему ошибка кучкуется и что реально помогает.
Claude Code API Error 402 billing_error — недостаточно баланса
Claude Code печатает API Error: 402 billing_error, когда предоплаченного баланса не хватает на запрос. Пополните баланс; не ретрайте 402 как лимит частоты.
Пропустите сломанную настройку
apiToken.sale отдаёт стандартный Anthropic API — те же модели, те же SDK, один предоплаченный баланс. Направьте base URL вашего инструмента на него, и конфигурация с этой страницы заработает как написано.