ВойтиПолучить доступ

Инструменты12 минобновлено

Claude Code: «Credit balance is too low» - что делать

Коротко: «Credit balance is too low» - это не про твою подписку. Claude Code платит из предоплаченного счёта Claude Console, а на нём нет кредитов, которыми можно оплатить этот запуск. Одна из двух главных причин - в окружении остался ключ ANTHROPIC_API_KEY, и он перекрыл вход по подписке. Открой /status: строка API key покажет, чем агент платит сейчас. Данные по «Credit balance is too low» сверены с документацией Anthropic 19 ноября 2026 года.

Что значит «Credit balance is too low» в Claude Code

В терминале ошибка выглядит так:

Credit balance too low · Add funds: https://platform.claude.com/settings/billing

Иногда приходит длинная форма: Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits. Смысл тот же. В справочнике ошибок Claude Code Anthropic относит строку к разделу про лимиты и объясняет её двумя причинами: у организации в Console кончились предоплаченные кредиты, либо Claude Code отправляет запросы с ключом Console, хотя ты хотел работать по подписке.

Главное, что нужно понять сразу. Подписка Pro, Max или Ultra и счёт Console - два разных кошелька. Подписка даёт лимиты по окнам и неделям, счёт Console оплачивается за токены. Эта ошибка приходит от второго. Сколько осталось по подписке, она не показывает, и ждать сброса лимита не нужно: сначала выясни, откуда Claude Code берёт деньги.

Сначала открой /status: чем платит Claude Code

Запусти claude и введи:

/status

Команда показывает активный источник входа. Что искать и что это значит:

Что видишь в /status Что это значит Куда дальше
Строка API key, не помеченная как не используемая Агент платит ключом Console Причина 1 или 4
Строка Profile Вход идёт через профиль Anthropic Причина 3
Только вход по подписке, ключа и профиля нет, а ошибка есть Документация такой случай не описывает Проверь, не идёт ли запуск из другой программы, и раздел про шлюзы

Документация Anthropic описывает порядок выбора источника так: облачные провайдеры (Bedrock, Vertex, Foundry), затем ANTHROPIC_AUTH_TOKEN, затем ANTHROPIC_API_KEY, потом помощник ключей apiKeyHelper, токен CLAUDE_CODE_OAUTH_TOKEN, профили Anthropic и федерация и на последнем месте вход по подписке из /login. Профили тут особый случай. Именованный профиль (ANTHROPIC_PROFILE) и переменные федерации стоят выше подписки. Активный профиль стоит выше подписки, если он создан для федерации (oidc_federation), и ниже рабочего /login, если он создан входом в Console (user_oauth). Остальные источники из списка стоят выше подписки: ключ, токен и помощник ключей сработают первыми. Одна оговорка из документации: если задан CLAUDE_CODE_OAUTH_TOKEN, а ты выполнил /login, текущая сессия переключится на новый вход; чтобы он держался и в новых сессиях, переменную убирают из профиля оболочки и файлов настроек.

Причина 1. Подписка есть, но платит ключ ANTHROPIC_API_KEY

Типичная история у подписчиков, которые видят «Credit balance is too low». В окружении лежит ANTHROPIC_API_KEY: ты когда-то получал ключ для скрипта, оставил его в .zshrc, в переменных Windows или в .env. При первом запуске Claude Code спросил, использовать ли этот ключ. Ты ответил «да», и выбор запомнился. Теперь агент идёт через ключ, а подписка в стороне. Так записано в документации: одобренный ключ перекрывает вход по подписке, и это может привести к ошибкам, если ключ принадлежит отключённой организации или организации с истёкшим сроком.

Как вернуться на подписку:

  1. В текущем терминале убери переменную. На macOS и Linux: unset ANTHROPIC_API_KEY. В PowerShell: Remove-Item Env:ANTHROPIC_API_KEY.
  2. Найди, откуда переменная берётся, и удали её там: профиль оболочки (.zshrc, .bashrc, .profile), переменные среды Windows, файл .env, который подхватывает терминал, и блок env в файлах настроек Claude Code (~/.claude/settings.json и .claude/settings.json проекта). Без этого ключ вернётся в новом окне терминала.
  3. Закрой терминал, запусти claude заново, при необходимости выполни /login и выбери вход по подписке.
  4. Снова открой /status. Если ключ и вход по подписке настроены одновременно, /status помечает тот источник, который не используется.

Одна оговорка из документации. В неинтерактивном режиме (claude -p) ключ используется всегда, когда он есть. Если ошибка появляется только в скриптах и автозапусках, а в обычном окне всё хорошо, проверь этот вариант: скрипт мог получить ключ из окружения и не спрашивал разрешения. Чей это счёт и покрывают ли его кредиты плана, смотри в причине 5. Переменные окружения и помощник ключей действуют не только в терминале, но и в расширении VS Code, Agent SDK и GitHub Actions, поэтому ошибку может давать любая из этих программ. Подробнее про то, как ключ и подписка делят агента, есть в статье Claude Code API: когда нужен ключ.

Причина 2. Ключ остался после входа через Console

Вход в Claude Code бывает двух видов: подписка claude.ai и аккаунт Console. Второй может создать ключ и сохранить его у тебя на компьютере. В документации сказано: если /login сохранил ключ и переменная CI не задана, Claude Code использует этот ключ вместо других источников. Убрать его можно командой /logout: она выходит из аккаунта и при следующем запуске агент проведёт вход заново.

В актуальной версии при входе через Console есть два пути: «Sign in with your Console account» (помечен как рекомендуемый, ключ не создаётся) и «Create an API key» (помечен как legacy). Если ты выбрал второй, ключ сохранён, и именно он тратит баланс. Перезайди через /login и выбери подписку claude.ai, если нужна она.

Причина 3. Платит профиль Anthropic

Профиль - файл с данными входа в папке ~/.config/anthropic (на Windows %APPDATA%\Anthropic). Его создают утилита ant (ant auth login), настройка федерации и вход в Console без ключа: на экране /login пункт «Sign in with your Console account» с пометкой рекомендуемого. Claude Code эти профили читает. Что говорит документация о приоритете:

Какой профиль Где стоит относительно /login по подписке
Именованный, задан в ANTHROPIC_PROFILE Выше, любого типа
Переменные федерации ANTHROPIC_FEDERATION_RULE_ID и ANTHROPIC_ORGANIZATION_ID, обе заданы Выше
Активный профиль типа oidc_federation Выше
Активный профиль типа user_oauth (ваш вход в Console или ant auth login) Ниже рабочего /login

Есть и второй момент. При входе в Console без ключа Claude Code, по документации, выходит из любого входа claude.ai, сохранённого на этом компьютере. Подписки после этого на машине нет, остаётся профиль, и счёт - это счёт Console. Если в /status есть строка Profile, источник входа - профиль, а не подписка.

Как отключить профиль, по документации:

  • /logout для профиля, созданного входом в Console без ключа;
  • ant auth logout для профиля, созданного ant auth login;
  • unset ANTHROPIC_PROFILE (в PowerShell Remove-Item Env:ANTHROPIC_PROFILE) для именованного профиля, и снять обе переменные федерации, если они заданы;
  • либо удалить файл профиля в папке configs внутри каталога настроек.

После этого снова войди через /login и выбери подписку.

Причина 4. Деньги на счёте Console действительно кончились

Если ты сознательно работаешь по ключу, «Credit balance is too low» значит ровно то, что написано: предоплаченный баланс организации Console исчерпан. Что делать, по документации Anthropic:

  • открыть страницу Billing в Console и пополнить баланс;
  • включить там же автопополнение, чтобы баланс пополнялся до того, как упадёт в ноль;
  • задать лимиты расходов по рабочим пространствам: проект с собственным лимитом не опустошит общий счёт.

Баланс принадлежит организации, а не ключу и не тебе лично: все ключи организации списывают деньги из одного места. Пополнил не ту организацию, и ошибка останется. Проверь, что ключ в Claude Code создан именно в ней.

Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF

Причина 5. Кредиты плана Max или Team покрывают не каждый запуск

Планы Max, Ultra и Team включают ежемесячные API-кредиты: по справке Anthropic от 19 ноября 2026 это $100 для Max, $200 для Ultra, для Team $20 на стандартное место и $100 на премиальное, общая сумма до $500. Free, Pro и Enterprise такой бонус не получают. Кредиты зачисляются на связанную организацию Console, не переносятся на следующий период и тратятся раньше купленных.

Что они покрывают, зависит от того, как запущен Claude Code:

Как запущено Покрывают ли кредиты плана
Интерактивный Claude Code в терминале, IDE, приложении и вебе Нет
Дополнительное использование (extra usage) после лимитов плана Нет
Свой claude -p или Agent SDK с ключом связанной организации Console Да: это учитывается как использование Agent SDK
claude -p или Agent SDK при входе по подписке Нет, тратятся лимиты подписки
GitHub Action, расширение IDE, приложение Claude, даже с -p Нет

Отсюда два вывода. Первый: если ключ принадлежит организации, которая получила кредиты плана, твой собственный скрипт с claude -p может работать на них, пополнять баланс заранее не нужно. Второй: когда эти кредиты кончились, а купленного баланса и автопополнения нет, запросы к API останавливаются до следующего начисления, и Claude Code показывает ту же строку «Credit balance too low · Add funds». Использование при этом не списывается с подписки.

Что делать: хочешь работать по подписке - /login. Нужны скрипты по ключу сверх кредитов плана - купи баланс Console или включи автопополнение. Суммы меняются, актуальное смотри в справке Anthropic.

Я пополнил баланс, а «Credit balance is too low» осталась

В документации Anthropic срока обновления баланса нет и такой ситуации она не описывает. В обращениях на GitHub пользователи сообщали, что Claude Code продолжал показывать ошибку после пополнения: например, обращение 34914 закрыли как дубликат, а обращение 31537 на день проверки оставалось открытым с меткой invalid. Подтверждения от Anthropic я там не нашёл.

Что можно проверить без догадок:

  1. Организация в Console - та же, к которой привязан ключ Claude Code.
  2. /status показывает именно тот ключ, который ты пополнял, а не другой из окружения.
  3. Claude Code закрыт и запущен заново, а не продолжен в старой сессии.
  4. На странице Billing есть купленный баланс, а не только кредиты плана: они покрывают не все запуски (см. причину 5).

Если после этого строка остаётся, а баланс на Billing положительный, это случай для обращения в поддержку Anthropic с текстом ошибки и скриншотом /status.

Чем эта ошибка отличается от соседних

Что видишь Что это Где разобрано
«You’ve hit your session limit», «spend limit» и время сброса Лимит подписки или лимит расходов Лимиты Claude Code
«Invalid API key» Ключ не принят: опечатка, отозван, лишний перенос строки справочник ошибок Anthropic
«Your ANTHROPIC_API_KEY belongs to a disabled organization» Ключ принадлежит отключённой организации убрать ключ, как в причине 1
«Request failed with status code 403» Доступ или регион, а не деньги Request failed 403
«Your account is on hold» Аккаунт заморожен Account on hold
«Credit balance is too low» Пуст счёт Console или платит ключ эта статья

Общую диагностику «Claude Code не запускается» собирает статья Claude Code не работает. А если нужно понять, какой тариф и сколько даёт Max, смотри разбор Claude Max под Claude Code.

Доступ и оплата из России

Здесь только официальные условия, без советов их обходить. Пополнить Console можно теми способами, которые страница Billing показывает твоей организации. Состав способов зависит от страны и организации и меняется, поэтому цифр и обещаний здесь нет. Что и как оплачивается и чем отличается подписка от баланса API, разобрано в статье как оплатить OpenAI API и Claude API из России, а про установку и доступ к Claude Code из России - в статье Claude Code в России.

Если ты подключаешь Claude Code не к Anthropic напрямую, а через чужой сервис (его адрес задаёт ANTHROPIC_BASE_URL), та же строка может прийти от него, и тогда пополнять нужно его кабинет. Это логика, а не пункт документации Claude Code; для конкретного сервиса смотри его условия.

Чек-лист

Если Claude Code пишет «Credit balance is too low», пройди по порядку:

  1. /status: видна ли строка API key или Profile.
  2. Хочешь подписку: убери ANTHROPIC_API_KEY из терминала и из профиля оболочки, сделай /logout и /login.
  3. Хочешь ключ: пополни баланс на Billing в нужной организации и включи автопополнение.
  4. Для скриптов и claude -p проверь, не подтягивается ли ключ из окружения сам и чья это организация.
  5. Помни: кредиты Max и Team покрывают свои claude -p и Agent SDK с ключом связанной организации, но не интерактивный Claude Code и не запуски из GitHub Action, IDE и приложения.
  6. Перезапусти Claude Code и снова открой /status.

Как собрана эта статья

Тексты ошибок, команды, порядок выбора источника входа и правила кредитов сверены 19 ноября 2026 года со справочником ошибок Claude Code, страницами про вход и расходы, документацией API-кредитов и справкой Anthropic. Пересказы блогов за источник не брались; на обращения GitHub ссылка дана как на сообщения пользователей, а не как на подтверждённый факт. Как часто встречается каждая причина, документация не измеряет, поэтому порядок причин ничего не говорит о частоте. Команды на собственном компьютере в этой статье не запускались. Суммы и условия кредитов меняются, сверяй с актуальной справкой.

Хочешь меньше тратить токены и не упираться в лимиты? В ClaudeBase есть урок «Какую модель выбрать: Claude, GPT, китайские» и урок «Контекст и лимиты: почему длинный диалог врёт». Открой страницу доступа ClaudeBase, чтобы сверить уроки со своими задачами. Статья открыта без оплаты, уроки и материалы доступны после оплаты.

Спрашивают

Пять вопросов по теме

У меня подписка Pro или Max. Почему Claude Code пишет про баланс?

Одна из двух главных причин: Claude Code платит не подпиской, а ключом Console. По документации Anthropic, одобренный ключ ANTHROPIC_API_KEY в окружении перекрывает вход по подписке. Открой /status, найди строку API key, убери переменную из терминала и из профиля оболочки, перезапусти claude и войди через /login.

Чем эта ошибка отличается от лимита подписки?

Лимит подписки приходит с текстом про session limit или spend limit и временем сброса окна. «Credit balance is too low» говорит о счёте Console, пополнить который можно только на странице Billing. Лимиты подписки и баланс Console учитываются отдельно, поэтому ждать сброса лимита здесь бесполезно.

Кредиты из плана Max или Team можно потратить в Claude Code?

Зависит от запуска. По справке Anthropic от 19 ноября 2026 кредиты не покрывают интерактивный Claude Code в терминале, IDE, приложении и вебе, а также запуски через GitHub Action, расширение IDE и приложение Claude, даже с -p. Кредиты покрывают claude -p и Agent SDK, которые вы запускаете сами с ключом связанной организации Console. Если кредиты кончились, а купленного баланса и автопополнения нет, запросы к API останавливаются до следующего начисления.

Я пополнил баланс, а ошибка осталась. Что проверить?

Сначала сверь организацию: баланс считается у организации Console, к которой привязан ключ. Затем закрой Claude Code, запусти заново и проверь /status. В документации срока обновления баланса нет; в обращениях на GitHub пользователи писали, что ошибка держалась и после пополнения (в одном случае больше часа), но подтверждения от Anthropic я не нашёл.

Как оплатить Console из России?

Баланс пополняют на странице Billing в Claude Console теми способами, которые она показывает для вашей страны и организации. Мы не обещаем, что любой способ сработает: условия меняются. Разбор оплаты с датой проверки есть в статье об оплате OpenAI API и Claude API из России.

Источники