Диагностика

Ошибки 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 вашего инструмента на него, и конфигурация с этой страницы заработает как написано.