Your credit balance is too low to access the Anthropic API: что делать

«Your credit balance is too low to access the Anthropic API» означает, что у вас не хватает предоплаченных кредитов, чтобы оплатить использование Claude API. В Claude Code эта ошибка выглядит как «Credit balance is too low». Если вы были уверены, что работаете по тарифу Pro или Max, а сообщение всё равно появляется, обычно причина в том, что API-ключ из переменной окружения ANTHROPIC_API_KEY имеет приоритет над входом по подписке, и вас переключило на оплату через API.

400 invalid_request_error
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.

Пример ответа API. В таком виде он встречается в логах, которые пользователи публикуют на GitHub Claude Code (отчёт от апреля 2025 года, отчёт от августа 2026 года). В официальном списке ошибок API от Anthropic этой фразы дословно нет.

На основе официальной документации Claude Code и справочного центра Anthropic (проверено 26 октября 2026 года) в статье разбирается, что означает ошибка, как отличить причины друг от друга, два способа исправления и чем эта ситуация отличается от ежемесячных API-кредитов, входящих в Max и Team, и от «кредитов на использование» (usage credits) вашего тарифа. Причины обозначены цветом: A Баланс и B API-ключ.

1. Что означает ошибка и как она выглядит

Claude API работает по предоплате — исключение составляют организации с договором через отдел продаж, которым выставляют счёт в конце месяца. Согласно справочной статье Anthropic, использование API, Playground и Claude Code через организацию Claude Console списывается с заранее купленных кредитов, и когда кредиты заканчиваются, вызывать API нельзя, пока вы их не пополните. Эта ошибка сообщает, что вы попали именно в такое состояние «не хватает».

«Plans & Billing» в конце сообщения — это экран оплаты в Console. В нынешней Console баланс можно посмотреть и кредиты купить на странице Billing (platform.claude.com/settings/billing).

Источники: Anthropic, «How do I pay for my Claude API usage?»; Claude Code, «Error reference: Credit balance is too low». Старое сообщение взято из отчёта на GitHub. Проверено 26 октября 2026 года.

Официальный справочник ошибок Claude Code называет две причины: в вашей организации Console закончились предоплаченные кредиты или вы собирались пользоваться подпиской, но запросы уходят с API-ключом Console. Это и есть причины A и B выше.

2. Три вопроса, чтобы найти причину

Ответьте на них по порядку — и станет ясно, какой способ исправления вам нужен.

1. Q1 Вы собираетесь пользоваться Claude Code по тарифу Pro, Max, Team или Enterprise?

   Да Переходите к Q2. Если вы работаете по подписке, эта ошибка появляться не должна

   Нет (работаю с API-ключом или в своём приложении) Переходите к Q3

2. Q2 Показывает ли /status API-ключ?

   ДаПричина B Одобренный вами ANTHROPIC_API_KEY перекрывает подписку → раздел 4

   Нет Посмотрите строку со способом входа. Если вы вошли через аккаунт Console, оплата идёт с баланса Console → выполните /login и войдите заново через аккаунт с подпиской (шаг 5 в разделе 4)

3. Q3 Есть ли баланс у организации этого ключа в разделе Billing в Console?

   Нет или малоПричина A Купите кредиты → раздел 3

   Есть Проверьте, не принадлежит ли ключ другой организации, не купили ли вы кредиты только что и не тратите ли вы одни лишь ежемесячные кредиты Max или Team на то, что они не покрывают → частые вопросы

Основание для Q2: справочник ошибок Claude Code советует пользователям подписки, которые видят эту ошибку, проверить строку API key в /status. О переключении, когда способ входа — Console, см. Anthropic, «Use Claude Code with your Pro or Max plan» (если вы вошли через аккаунт Console с оплатой по факту, переключитесь на подписку с помощью /login).

Деньги, которые вы платите за подписку вроде Claude Pro, нельзя пустить на оплату API. В справке Anthropic сказано, что подписки и Console — отдельные продукты, и API оплачивается отдельно (Why is Claude API usage billed separately from my paid Claude plan?). Даже при наличии подписки, пока вы работаете с API-ключом, нужен баланс в Console.

3. Причина A Пополните кредиты

Это решение для тех, кто работает с API-ключом. Покупать кредиты могут только участники организации Console с ролью Admin или Billing. Если это организация вашей компании, обратитесь к администратору.

1. Откройте страницу Billing Войдите в Console и откройте Billing. Баланс кредитов организации и израсходованная сумма показаны на одной странице. Если вы состоите в нескольких организациях, убедитесь, что выбрана организация, в которой создан проблемный ключ. Баланс ведётся по организациям, и все API-ключи одной организации расходуют общий баланс.
2. Купите кредиты Нажмите «Buy credits», введите сумму и подтвердите. Согласно справочной статье, купленные кредиты доступны сразу.
3. Включите автопополнение (по желанию) В разделе Credit balance через «Set up auto-reload» укажите баланс, при котором срабатывает пополнение (When credit balance reaches), и баланс, до которого его пополнить (Bring credit balance back up to), затем нажмите «Turn on». Если баланс уже на этом уровне или ниже, кнопка превращается в «Turn on and purchase», и покупка происходит сразу.
4. Повторите то, что не прошло В Claude Code отправьте ту же инструкцию ещё раз.

Источник: Anthropic, «How do I pay for my Claude API usage?» (порядок покупки, мгновенная доступность, настройка автопополнения, срок действия — один год с даты покупки, без возврата). Проверено 26 октября 2026 года.

Купленные кредиты сгорают через год после даты покупки и не возвращаются. Скорее всего, меньше пропадёт впустую, если покупать только то, что вы потратите, а при нехватке полагаться на автопополнение. Справочник ошибок Claude Code также рекомендует задать в Console лимиты расходов для каждого рабочего пространства (workspace), чтобы один проект не исчерпал баланс всей организации.

4. Причина B Удалите API-ключ и пользуйтесь подпиской

Это решение для тех, кто собирается пользоваться тарифом Pro, Max, Team или Enterprise. Когда учётных данных несколько, Claude Code выбирает одни из них в фиксированном порядке, и переменная окружения ANTHROPIC_API_KEY и apiKeyHelper в файле настроек стоят выше входа по подписке, выполненного через /login. Когда используется ключ, как поясняет справка Anthropic, оплата по факту списывается с организации этого ключа, и если у этой организации нет баланса, вас останавливает эта ошибка.

1. Проверьте через /status Выполните /status в Claude Code и посмотрите строку API key. Когда есть и вход, и API-ключ, тот, что не используется, помечается.
2. Удалите ключ из текущей оболочки Удалите переменную в открытом терминале (команды ниже).
3. Удалите источник ключа Найдите и удалите строку export ANTHROPIC_API_KEY=... в файле настроек оболочки, пользовательскую переменную окружения Windows и запись в профиле PowerShell ($PROFILE). Иначе следующий открытый терминал снова её загрузит. Согласно официальному справочнику ошибок, инструменты вроде direnv или терминал IDE могут подгружать ключ из файла .env проекта, так что проверьте и .env в папке проекта. Как найти ключ в env или apiKeyHelper в файлах настроек Claude Code, рассказано в нашей статье об ошибке «claude.ai connectors are disabled».
4. Переоткройте терминал и запустите claude Официальная справка называет частой ошибкой изменение переменных окружения без перезапуска терминала.
5. При необходимости выполните /login, затем снова /status Если вы ещё не вошли через аккаунт с подпиской, выполните /login. Как только /status подтвердит, что API-ключ не используется, всё готово.

# macOS / Linux: проверить, задана ли переменная
env | grep ANTHROPIC
# Удалить её из текущей оболочки
unset ANTHROPIC_API_KEY
# Найти файл настроек, в котором она задаётся
grep -n ANTHROPIC_API_KEY ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null

# Windows (PowerShell): проверить, задана ли переменная
Get-ChildItem Env:ANTHROPIC*
# Удалить её из текущей оболочки
Remove-Item Env:ANTHROPIC_API_KEY

# Windows (командная строка): проверить, задана ли переменная
echo %ANTHROPIC_API_KEY%
# Удалить её из текущей оболочки
set ANTHROPIC_API_KEY=

В Windows постоянные настройки удаляйте из пользовательских переменных в разделе «Свойства системы» → «Дополнительно» → «Переменные среды». Источники: Anthropic, «Manage API key environment variables in Claude Code»; Claude Code, «Authentication precedence» и «Error reference» (команды проверки и .env — в пункте «Invalid API key»). Проверено 26 октября 2026 года.

Если удалять ключ не хочется, можно вместо этого отозвать согласие. При интерактивном запуске Claude Code, впервые обнаружив ANTHROPIC_API_KEY, один раз спрашивает, использовать ли его, и запоминает ответ. Чтобы изменить решение позже, переключите «Use custom API key» в /config (этот пункт появляется, только пока переменная задана). Однако в claude -p (неинтерактивный режим) ключ используется всегда, если он есть. Если ключ нужен другим скриптам, передавайте его только при запуске этих команд.

Если ошибка появляется в расширении для VS Code

В расширении Claude Code для VS Code проверяется то же самое. Введите /status в панели, чтобы увидеть аккаунт и другие сведения (Claude Code v2.1.280 или новее). Согласно официальной документации, VS Code, запущенный из терминала командой code ., наследует переменные окружения этой оболочки. Если ключ прописан в файле настроек терминала, он может попасть и в расширение. Удалив ключ, закройте и снова откройте VS Code, прежде чем проверять.

Переменные окружения можно задать и в настройке расширения claudeCode.environmentVariables. В Settings в разделе Extensions → Claude Code убедитесь, что там не задан ANTHROPIC_API_KEY.

Источник: Claude Code, «Use Claude Code in VS Code» (наследование переменных окружения, настройка environmentVariables, /status). Проверено 26 октября 2026 года.

5. Из чего оплачивается ваше использование

«Кредитами» называют три разные вещи, и если их путать, эту ошибку легко понять неправильно: API-кредиты, купленные в Console, ежемесячные API-кредиты, входящие в Max и Team, и кредиты на использование (usage credits), которыми оплачивается использование сверх лимитов тарифа Pro или Max. Вот чем можно оплатить каждый вид использования.

Источники: Anthropic, «Monthly API credits for Max and Team plans» (интерактивный Claude Code и кредиты на использование не покрываются; claude -p и Agent SDK, запускаемые вами с API-ключом, покрываются); «Manage usage credits for paid Claude plans» (кредиты на использование применяются и к Claude, и к Claude Code после лимитов тарифа и не связаны с ежемесячными API-кредитами); «Manage API key environment variables in Claude Code» (если API-ключ задан, оплата по факту списывается с организации этого ключа); «How do I pay for my Claude API usage?». Проверено 26 октября 2026 года.

Для этой ошибки важны два правых столбца (баланс вашей организации Console). Из таблицы следуют три вывода.

• Если ошибка появляется, когда вы думаете, что работаете по подписке, вы находитесь в одной из строк с API-ключом. Пополнение тарифа или кредитов на использование (два левых столбца) не поможет, сколько ни пополняйте (причина B).
• Ежемесячные API-кредиты Max и Team нельзя тратить на интерактивный Claude Code. Даже если кредиты вашего тарифа всё ещё видны на экране баланса в Console, ими нельзя оплатить работу интерактивного Claude Code с API-ключом. Как их получить и в каком порядке они расходуются, рассказано в нашей статье об API-кредитах Max и Team.
• Кредиты на использование — это отдельный баланс в настройках claude.ai (Settings → Usage). Поскольку он не связан с балансом Console, его пополнение не помогает при работе с API-ключом.

6. Похожие, но другие ошибки

С балансом или лимитами связаны и другие ошибки. Различайте их по тому, с чего начинается сообщение.

Источники: Claude API, «Rate limits» (две ошибки лимита расходов); Claude Code, «Error reference». Проверено 26 октября 2026 года.

Список других ошибок Claude Code — в статье Частые ошибки Claude Code и как их исправить.

Итоги

Частые вопросы

Q. Есть ли у Claude API бесплатный уровень?

A. В официальной справке бесплатный уровень не упоминается. После создания организации Console рекомендуется «пополнить баланс организации кредитами, чтобы пользоваться API и Playground» (I created a Claude Console organization - how do I start using the Claude API?). Исключение — ежемесячные API-кредиты, входящие в тарифы Max и Team; тарифы Free, Pro и Enterprise на них не распространяются.

Q. У меня Claude Pro. Почему я вижу эту ошибку?

A. Потому что Claude Code работает с API-ключом. Плата за подписку не покрывает API, поэтому, если у организации API-ключа нет баланса, появляется эта ошибка. Проверьте через /status, используется ли API-ключ, и удалите его по шагам из раздела 4.

Q. Я купил кредиты, но ошибка не исчезает.

A. Согласно справочной статье, купленные кредиты доступны сразу. Сначала проверьте, что организация, в которой создан ключ, — та же, для которой вы покупали кредиты. На странице статуса Anthropic зафиксирован инцидент 1 сентября 2026 года (UTC): у пользователей с нулевым балансом купленные кредиты зачислялись с задержкой, а часть запросов к API ошибочно возвращала «credit balance is too low» (Delays in credit purchases). 1 октября того же года был ещё один инцидент, когда покупки зачислялись с задержкой (Delayed credits on the Claude Platform). Если организация совпадает и баланс отображается, проверьте на status.claude.com, нет ли текущего инцидента.

Q. Ежемесячные API-кредиты Max у меня ещё остались, но в Claude Code появляется эта ошибка.

A. Ежемесячные API-кредиты нельзя тратить на интерактивный Claude Code — в терминале, IDE, десктопном приложении или в вебе (таблица в разделе 5). Чтобы пользоваться подпиской, удалите API-ключ и работайте через вход по аккаунту; чтобы пользоваться API-ключом, купите кредиты в Console.