Диагностика · Claude Code

Claude Code API Error 402 billing_error — недостаточно баланса

Claude Code печатает API Error: 402 billing_error, когда предоплаченного баланса не хватает на запрос. Пополните баланс; не ретрайте 402 как лимит частоты.

Что вы видите

API Error: 402 {"type":"error","error":{"type":"billing_error","message":"insufficient balance or key spending limit reached for this request"}}

Почему возникает

  • Предоплаченного баланса на ключе не хватает на только что отправленный запрос.
  • У ключа задан лимит трат, и он достигнут, хотя на аккаунте баланс ещё есть.
  • Незавершённое пополнение ещё нельзя тратить.

Что делать

  • Пополните баланс на любую целую сумму в долларах и повторите после зачисления. Ожидание само по себе 402 не устраняет.
  • Если у этого ключа задан лимит трат, поднимите или снимите его.
  • Смотрите живой баланс тем же ключом. Ветвитесь по HTTP 402 и error.type billing_error.

Проверить баланс по ключу

curl https://router.apitoken.sale/balance \
  -H "x-api-key: $ANTHROPIC_API_KEY"

Похожие запросы

  • claude code 402
  • claude code insufficient balance

Вопросы и ответы

402 — это то же самое, что 429?+
Нет. 429 — поминутная пропускная способность, его можно ретраить. 402 — пустой предоплаченный баланс. На 429 читайте Retry-After. На 402 пополните баланс.
Claude Code сам выйдет из 402?+
Нет. Повторы баланс не зачислят. Пополните и отправьте запрос снова.
Почему запрос упал, хотя в панели ещё виден остаток?+
Остаток на аккаунте может быть, пока этот ключ уже упёрся в свой лимит трат. Поднимите лимит ключа или пополните баланс.

Все ошибки Claude Code · Коды ошибок Claude API · Гайд по настройке

Пропустите сломанную настройку

apiToken.sale отдаёт стандартный Anthropic API — те же модели, те же SDK, один предоплаченный баланс. Направьте base URL вашего инструмента на него, и конфигурация с этой страницы заработает как написано.

Получить ключДокументация API