Claude Code: API-ключ или подписка, кто оплачивает работу?

Платит подписка Pro или Max, пока в окружении нет API-ключа. Если задана переменная ANTHROPIC_API_KEY, интерактивный Claude Code один раз спрашивает, использовать ли её, и запоминает ответ. Одобрили ключ хотя бы однажды — дальше запросы идут в API-биллинг Claude Console по ценам за токены. В неинтерактивном режиме (claude -p) ключ используется всегда, без вопроса. Так это описано в документации Claude Code об аутентификации по состоянию на 10 октября 2026 года.

Отсюда простое правило. Обычная работа в терминале или в расширении VS Code — через вход по подписке. Продукт, сервис или Agent SDK для других людей — через API-ключ. Работа сверх лимита плана — через кредиты использования (usage credits) по ставкам API. Какой вариант активен прямо сейчас, показывает /status.

Сначала найдите активный маршрут

Когда на машине есть несколько учётных данных, Claude Code берёт их в строгом порядке, сверху вниз. Документация приводит семь ступеней; в таблице они же, с ответом на главный вопрос: кто получит счёт.

Главное в таблице: подписка стоит последней. Любая строка выше неё, если она задана, перехватывает оплату. Чаще всего это строка 3, потому что ключ Anthropic когда-то положили в профиль оболочки для другого проекта.

Проверка одна для всех случаев: запустите claude и выполните /status. По документации, когда настроены и вход по подписке, и API-ключ, /status помечает те учётные данные, которые сейчас не используются. Если помечена подписка, платит ключ.

Есть два исключения, о которых стоит помнить. Облачные сессии Claude Code всегда работают на учётных данных подписки: ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN, заданные в облачном окружении, подписку не перекрывают. А Claude Desktop не читает эти переменные и не вызывает apiKeyHelper.

Почему API-биллинг появляется при активной подписке

Почти всегда причина в одном из трёх сценариев.

Ключ был одобрен раньше. Интерактивный Claude Code спрашивает про ANTHROPIC_API_KEY только один раз. Если тогда вы ответили «да», выбор сохранён, и каждый следующий запуск молча идёт в API. Подписка при этом остаётся активной, но не используется. Если ключ относится к отключённой или просроченной организации Console, вместо счёта будут ошибки аутентификации — документация упоминает и такой исход.

Запуск без интерактива. Скрипт, cron, хук или CI вызывает claude -p. В этом режиме вопроса нет: если ключ присутствует в окружении, он используется. Поэтому один и тот же ноутбук может работать по подписке в терминале и по API в ночном скрипте.

Переменную видит обёртка вокруг CLI. ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN и apiKeyHelper действуют для самого CLI и для всего, что его оборачивает: расширения VS Code, Agent SDK и GitHub Actions. Ключ из .zshrc, .bashrc, .env, devcontainer, скрипта запуска IDE или секрета CI попадает в эти инструменты незаметно.

Чтобы понять, задан ли ключ в текущей оболочке, не выводя его значение, хватит стандартной конструкции shell:

echo ${ANTHROPIC_API_KEY:+задан}

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

Ещё один источник путаницы — кредиты использования. Их включают в Settings > Usage на claude.ai, и после исчерпания лимита плана работа продолжается по ставкам API. Это не API-ключ и не Console, но строки «по API-ставкам» в счёте выглядят похоже.

Как читать /status, /usage, /cost и Console

У каждого экрана свой вопрос, и путать их дорого.

Порядок такой: сначала /status, потом остальное. Пока неизвестно, кто платит, любая цифра на других экранах читается неверно. Подробно о полосках лимитов и о том, куда уходят токены, — в статье «Лимиты Claude Code: как проверить в /usage и где теряются токены».

Когда API-ключ действительно нужен

API-ключ нужен, когда работа идёт не от вашего имени в терминале, а от имени программы или продукта. Правовые условия Claude Code формулируют это прямо: вход по подписке (OAuth) предназначен для покупателей планов Free, Pro, Max, Team и Enterprise и для обычной работы в Claude Code и других приложениях Anthropic. Разработчики продуктов и сервисов, в том числе на Agent SDK, должны использовать API-ключ из Claude Console или облачного провайдера (раздел о правовых условиях и учётных данных в документации Claude Code).

claude setup-token, по документации, выпускает OAuth-токен сроком на год и никуда его не сохраняет: его нужно скопировать в переменную CLAUDE_CODE_OAUTH_TOKEN. Токен работает от подписки, требует план Pro, Max, Team или Enterprise и годится только для запросов к модели. Это способ запускать свои скрипты на подписке, не держа в окружении API-ключ. Учтите порядок из первой таблицы: если рядом задан ANTHROPIC_API_KEY, он стоит выше и в -p победит.

Если вы не уверены, нужен ли вам Claude Code или прямой доступ к API, сначала прочитайте «Claude API и Claude Code: в чём разница и что выбрать». Если вопрос только в том, хватает ли лимитов плана для интерактивной работы, сравните тарифы в статье «Claude Pro vs Max в 2026 году: цены, лимиты Claude Code и окупаемость Max» и не переходите на API ради этого.

Ключи создают в Claude Console. Россия не входит в список стран, где Anthropic предоставляет Claude (по состоянию на 23 сентября 2026 года). Сервисы, которые продают «ключи с оплатой в рублях» или доступ к чужим аккаунтам, не являются каналом Anthropic, а передача аккаунтов запрещена правилами использования. Что на деле покупают для Claude API, разобрано в статье «Как купить доступ к Claude API: ключ отдельно не продаётся».

Можно ли подключить подписку Claude к OpenClaw и другим оболочкам

Однозначного ответа нет: первоисточники и сообщения прессы расходятся, поэтому решает документация конкретного инструмента.

• Справка Claude после обновления 7 октября 2026 года говорит, что Agent SDK, claude -p и сторонние приложения по-прежнему можно использовать в пределах лимитов подписки. Объявленные ранее изменения для Agent SDK 15 июня 2026 года поставили на паузу, и, по словам справки, «ничего не изменилось» (статья справки Claude об Agent SDK, claude -p и сторонних приложениях).
• Правовые условия запрещают сторонним разработчикам предлагать вход через аккаунт Claude.ai в своих приложениях и пропускать запросы своих пользователей через учётные данные планов Free, Pro или Max. Заявленные лимиты Pro и Max рассчитаны на обычное индивидуальное использование Claude Code и Agent SDK.
• В апреле 2026 года издания писали, что лимиты подписки перестали покрывать оболочки типа OpenClaw и такие инструменты перевели на оплату по факту, пакеты или API-ключ; позже появились сообщения о частичном откате.

На практике это значит: ваш собственный инструмент на вашем аккаунте — одна ситуация, сервис, который ведёт через ваш план запросы других людей, — другая, и вторая запрещена. Для конкретной оболочки ищите в её документации, каким способом она входит и что сказано про подписку Claude.

Даёт ли подписка API: API-кредиты Max и Team с 7 октября

Подписка Pro API-доступа не даёт: справка Claude говорит, что платная подписка относится к чату, а Claude API оплачивается отдельно, предоплаченными кредитами в Console.

С 7 октября 2026 года у Max и Team появились ежемесячные API-кредиты:

У Team кредиты складываются в общий пул команды с потолком $500 в месяц. Получить их можно через 7 дней на плане, привязав одну организацию Claude Console. Они покрывают Claude API, Managed Agents, Agent SDK и Playground в Console, обновляются каждый расчётный период и не переносятся на следующий.

Две вещи эти кредиты не оплачивают: интерактивный Claude Code и кредиты использования. claude -p и Agent SDK списывают их только тогда, когда запрос идёт с API-ключом из той самой привязанной организации Console. Если ключ из другой организации, платит она.

Сколько стоит подписка Claude Code и API Claude

Отдельной подписки «Claude Code» нет: он входит в планы Claude. Цены со страницы тарифов Claude на 10 октября 2026 года, без налогов:

Max оплачивается только помесячно, а цены указаны для веб-подписки: в мобильных приложениях они могут отличаться. Годовой Pro экономит $40 в год: $240 − $200. Другие способы заплатить меньше собраны в статье «Скидки на Claude Code в 2026 году: годовой Pro и пакеты до 30 %».

API-ключ оплачивается по токенам. Цены за 1 млн токенов, ввод / вывод:

На вопрос, сколько токенов в подписке Claude Pro, точного числа нет: лимиты плана заданы как пятичасовое окно сессии и недельный лимит, а не как баланс токенов. Таблица по планам — в статье «Лимиты Claude Pro и Max в неделю и за 5 часов: сводная таблица».

Usage credits и граница цен

Кредиты использования (usage credits) — это ваша оплата сверх лимита плана. Они доступны на Pro, Max 5x и Max 20x, тарифицируются по стандартным ставкам API, действуют и в чатах Claude, и в Claude Code в терминале. Включаются в Settings > Usage: нужен способ оплаты, можно задать месячный лимит трат, оповещения и автопополнение (справка Claude о кредитах использования). Ежемесячные API-кредиты Max на них не тратятся.

Заранее купить их можно со скидкой — пакетами: $45 за $50 кредитов, $200 за $250, $700 за $1 000. Пакеты есть на Pro, Max и Team, расходуются только после исчерпания лимитов плана и требуют включённых кредитов использования (справка Claude о пакетах).

Оценить расход можно по ценам из таблицы выше. Пусть один ход Claude Code читает 200 000 токенов контекста и пишет 20 000 токенов ответа без кэша. Для Opus 5.5: 200 000 × $4 / 1 000 000 = $0,80 за ввод и 20 000 × $20 / 1 000 000 = $0,40 за вывод, итого $1,20. Для Sonnet 5.5 тот же ход — $0,60, для Fable 5.1 — $3,00. Значит, $20 кредитов хватит примерно на 16 таких ходов Opus 5.5 или на 6 ходов Fable 5.1. Объём токенов здесь условный: реальные ходы бывают в разы меньше или больше. По документации Claude Code на 24 сентября 2026 года, пока работа идёт за счёт кредитов, срок жизни кэша промптов сокращается с часа до 5 минут, так что длинные паузы обходятся дороже.

Отдельная ловушка для Pro: модели Fable не входят в лимиты Pro и стандартных мест Team, и кредиты использования списываются с первого же запроса. На Max на Fable можно потратить до половины недельного лимита, дальше — кредиты или другая модель.

Когда выгоднее перейти на Max, чем докупать кредиты, считается в статье «Стоимость дополнительного использования Claude: кредиты или Max».

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

Документация Claude Code описывает такой порядок:

1. Если ключ нужен вам для других задач, но не здесь, откройте /config и выключите «Use custom API key». Переключатель виден только пока ANTHROPIC_API_KEY задан в окружении.
2. Если ключ здесь не нужен вовсе, выполните unset ANTHROPIC_API_KEY в той оболочке, откуда запускаете Claude Code.
3. Если сохранённый вход тоже под вопросом, выполните /logout, затем /login и войдите аккаунтом с подпиской.
4. Снова запустите /status и убедитесь, что помечен как неиспользуемый именно ключ, а не подписка.

unset и выход не удаляют ключ в Claude Console: меняется только локальная настройка. Если в новом терминале ключ появляется снова, его источник — файлы запуска оболочки, .env, devcontainer, секреты CI, LaunchAgent или скрипт запуска IDE. Удалите его оттуда.

Для claude -p переключателя нет: пока ключ в окружении, он используется. Если скрипт должен работать по подписке, уберите из его окружения ANTHROPIC_API_KEY и задайте CLAUDE_CODE_OAUTH_TOKEN из claude setup-token.

Учётные данные хранятся в связке ключей macOS, а на Linux и Windows — в файле .claude/.credentials.json в домашней папке. Если нужны два аккаунта на одной машине, документация советует отдельный каталог настроек на каждый через CLAUDE_CONFIG_DIR. Остальные переменные и шлюзы описаны в статье «Настройка Claude Code API: ключи, settings.json, модели и шлюзы».

Что нельзя смешивать

Подписку и API. Pro и Max покрывают Claude Code через вход по подписке, но не дают общего доступа к Claude API. Ежемесячные API-кредиты Max и Team — отдельный баланс в Console, и интерактивный Claude Code его не тратит.

Кредиты использования и API-кредиты. Первые вы оплачиваете сами в Settings > Usage для работы сверх лимита плана, в том числе в Claude Code. Вторые входят в Max и Team и работают только с API-ключом привязанной организации.

Оценку и счёт. /cost и сумма сессии в /usage считают работу по прайс-листу API. Для Pro и Max это не дополнительное списание; реальный API-расход виден только в Console.

Облачный кредит и всё остальное. Разовый бонус $100 на Pro или $250 на Max для облачных сессий забрать можно было до 7 октября 2026 года; теперь его не выдают. С API-ключом он не работает. Разница между этим кредитом, кредитами использования и сбросом лимита — в статье «Облачный кредит, кредиты использования и сброс лимита в Claude».

Ключ и переписку. Не вставляйте настоящий API-ключ в тикеты, чаты, скриншоты и запросы к ассистентам. Для разбора хватит того, задана ли переменная, и вывода /status.

Как закрепить правило в команде

Одному разработчику достаточно помнить порядок проверки. В команде разные терминалы, devcontainer, секреты CI и скрипты IDE могут незаметно менять того, кто платит. Запишите правило в README на несколько строк:

• интерактивная работа в терминале и VS Code — вход по подписке;
• собственные скрипты и CI одного человека — CLAUDE_CODE_OAUTH_TOKEN из claude setup-token или проектный API-ключ, выбор записан;
• продукты, бэкенд и агенты для пользователей — только API-ключ Console или облачный провайдер;
• работа сверх лимита плана — кредиты использования, с лимитом трат и ответственным;
• у каждой организации Console есть владелец бюджета, лимит трат и понятная причина автопополнения.

Перед долгим запуском — /status. Перед прогоном CI — проверить, какой ключ или токен лежит в секретах. Перед покупкой кредитов — убедиться, что проблема не в обычном лимите плана, который скоро сбросится. Так спор о счёте начинается с вопроса «кто сейчас платит?», а не с догадки «надо купить Max».

Для разбора инцидента безопасно показывать вывод /status, факт наличия переменной, период и организацию в Console Usage, разделение лимита и кредитов в Settings > Usage. Настоящий ключ, полный .env и экраны биллинга с чужими проектами не нужны.

Проверочный путь

Короткий порядок для своей учётной записи:

1. /status — кто платит прямо сейчас.
2. echo ${ANTHROPIC_API_KEY:+задан} и та же проверка для ANTHROPIC_AUTH_TOKEN — нет ли переменных выше подписки.
3. /config → «Use custom API key», если ключ был одобрен раньше.
4. Settings > Usage на claude.ai — лимиты плана и кредиты использования.
5. Claude Console > Usage — API-расход по ключам и ежемесячные API-кредиты Max или Team.

Только после этих шагов имеет смысл решать, нужен ли другой план, кредиты использования или чистка окружения. Порядок учётных данных и команды приведены по документации Claude Code об аутентификации на 10 октября 2026 года.

Часто задаваемые вопросы

Нужен ли API-ключ для Claude Code?

Для обычной интерактивной работы с Pro, Max, Team или Enterprise не нужен: достаточно /login. API-ключ нужен для продуктов и сервисов, в том числе на Agent SDK, и как один из вариантов для CI. Свои скрипты можно запускать на подписке через claude setup-token.

Почему я вижу API-расход, если у меня есть Pro или Max?

Скорее всего, в окружении задан ANTHROPIC_API_KEY, и вы однажды одобрили его в интерактивном режиме, или запуск идёт через claude -p, где ключ используется всегда. Выполните /status: неиспользуемые учётные данные там помечены.

Сколько стоит подписка Claude Code?

Отдельной подписки нет: Claude Code входит в Pro за $20 в месяц или $200 за год, в Max 5x за $100 и Max 20x за $200 в месяц, а также в планы Team и Enterprise. Цены указаны без налогов, по состоянию на 10 октября 2026 года.

Даёт ли подписка Claude Pro API-ключ?

Нет. Claude API оплачивается отдельно, кредитами в Console. Ежемесячные API-кредиты с 7 октября 2026 года получают только Max ($100 или $200) и Team; Pro их не получает.

Usage credits и подписка — это одно и то же?

Нет. Кредиты использования — ваша доплата сверх лимитов плана по стандартным ставкам API. Подписка Pro или Max даёт свои лимиты со сбросом окна сессии и недели, а сверх них работа продолжается только если вы включили кредиты.

Стоит ли перейти на API вместо Claude Max?

Только если задача действительно программная: продукт, бэкенд, сервис для других людей. Для интерактивной разработки сначала проверьте лимиты плана в /usage; при оплате по токенам один большой ход Opus 5.5 (200 000 токенов на вход и 20 000 на выход) стоит $1,20.

/cost показывает мой счёт по подписке?

Нет. /cost и сумма сессии — оценка по прайс-листу API. На Pro и Max это не дополнительное списание. Реальный API-расход смотрите в Claude Console, кредиты использования — в Settings > Usage.

Как остановить использование API-ключа?

В интерактивном режиме выключите «Use custom API key» в /config или выполните unset ANTHROPIC_API_KEY. При необходимости сделайте /logout и /login, затем снова /status. Если ключ возвращается в новых терминалах, удалите его из файлов запуска оболочки, .env или секретов автоматизации.