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