Claude Code API: ключ, подключение, цены и лимиты

Материал редакции Зерокодера. Команда ведёт рабочие проекты на Claude Code в продакшене с весны 2026. Обновлено: июль 2026.

«Claude Code API» — это работа Claude Code не по подписке Pro/Max, а по вашему API-ключу Anthropic с поштучной оплатой за токены. Ключ создаётся в консоли console.anthropic.com, кладётся в переменную окружения ANTHROPIC_API_KEY, и Claude Code сразу считает деньги с API-баланса. Цена зависит от модели: Opus 4.8 — $5 за миллион входных токенов и $25 за миллион выходных.

Коротко, до деталей:

• Подписка и API — два раздельных биллинга. Подписка = фикс в месяц, API = плата за каждый токен.
• Ключ в ANTHROPIC_API_KEY имеет приоритет над подпиской: если переменная задана, Claude Code спишет деньги по API, а не с лимита Pro/Max.
• Актуальные рабочие модели: Opus 4.8 (claude-opus-4-8), Sonnet 5 (claude-sonnet-5), Haiku 4.5 (claude-haiku-4-5).
• Счёт по API сбивают два рычага: prompt caching (чтение из кэша — 10% цены) и Batch API (−50%).
• Российской картой оплатить API напрямую нельзя — способы разбираем в отдельной статье про Claude Code в России.

Чем API-доступ отличается от подписки Pro/Max

Это два разных продукта, которые легко перепутать. Подписка Claude (Pro, Max) даёт доступ к веб-приложению claude.ai и к Claude Code по фиксированной цене — Pro $20, Max 5x $100, Max 20x $200 в месяц (данные с страницы тарифов Claude). API — это отдельный вход: вы платите за фактически потраченные токены, без месячной абонплаты.

Ключевой факт, о котором молчат гайды: по официальной справке Anthropic, если в системе установлена переменная ANTHROPIC_API_KEY, Claude Code берёт для авторизации именно её — и списывает деньги по API, игнорируя подписку. То есть можно платить за Max $200 и одновременно жечь API-баланс, не замечая этого. Проверка: команда /status внутри Claude Code показывает активный способ авторизации.

Подписка и API — не «дороже/дешевле», а разные модели оплаты под разные сценарии. Ниже — когда какая выгоднее.

Как получить API-ключ Anthropic

Ключ выпускается в консоли разработчика:

1. Зайдите на console.anthropic.com под своим аккаунтом Anthropic.
2. Откройте раздел Settings → API Keys и нажмите Create Key.
3. Скопируйте ключ. Он имеет формат sk-ant-api03-… и по документации Anthropic показывается только один раз — уйдёте со страницы, второй раз его не увидите.

Ключ — это доступ к деньгам на вашем балансе. Не коммитьте его в репозиторий и не кладите в общий settings.json: утёкший ключ = чужие списания. Храните в переменной окружения, менеджере секретов ОС или в CI-хранилище.

Новый аккаунт Console получает небольшой стартовый кредит на тест API — официальная страница цен называет его «небольшим количеством бесплатных кредитов», не фиксируя сумму; точный остаток виден в самой Console.

Как подключить ключ к Claude Code

Сам Claude Code ставится глобально через npm (пакет @anthropic-ai/claude-code):

Дальше ключ отдаётся Claude Code через переменную окружения. На macOS/Linux:

Чтобы не вводить каждый раз, строку добавляют в профиль оболочки (~/.bashrc или ~/.zshrc) и перечитывают его: source ~/.bashrc. На Windows переменная задаётся в параметрах системы или командой setx ANTHROPIC_API_KEY "...".

После этого запустите claude в папке проекта — команда /status подтвердит, что активен API-ключ, а не подписка. Если вы, наоборот, хотите вернуться с API на план Pro/Max, выполните /login внутри Claude Code: по справке Anthropic это переключает авторизацию с ключа обратно на подписку.

Практика нашей команды: держать проекты на подписке, а ANTHROPIC_API_KEY в общем профиле оболочки не выставлять — иначе она незаметно перетянет на себя оплату во всех сессиях. Ключ подставляем точечно, когда нужна именно API-оплата (автоматизация, CI, скрипты).

Модели и цены API за 1 млн токенов

Цены ниже — с официальной страницы цен Anthropic на июль 2026. Указывайте модель по её ID.

* У Sonnet 5 действует вводная цена $2/$10 за 1М до 31 августа 2026, затем стандартная $3/$15 (та же страница цен).

Одна оговорка, которая ломает расчёты «на глаз»: Opus 4.7 и новее, а также Sonnet 5 перешли на новый токенайзер, который даёт примерно на 30% больше токенов на том же тексте (примечание на странице цен). Тот же промпт на Opus 4.8 стоит дороже, чем считался бы по старому токенайзеру, — закладывайте эту поправку в смету.

Подписка Pro/Max или API: что выгоднее

Прямого «дешевле» нет — считать надо под сценарий.

Ориентир из практики: пока вы работаете в Claude Code руками и укладываетесь в лимиты плана, подписка почти всегда дешевле — интерактивная сессия на Opus по API легко набирает десятки центов за задачу. API включается там, где подписка структурно не работает: автоматизация и поштучный контроль расхода. Модель в Claude Code переключается командой /model.

Лимиты и rate-limits API

У API два вида ограничений (по документации о лимитах): месячный спенд-кэп и посекундные rate-лимиты.

Rate-лимиты меряются в трёх величинах: RPM (запросы в минуту), ITPM (входные токены в минуту), OTPM (выходные токены в минуту). На стартовом тире для Opus 4.x это 1000 RPM, 2 000 000 ITPM и 400 000 OTPM. Важная деталь: токены, прочитанные из кэша, не считаются в ITPM (кроме устаревшей Haiku 3.5) — то есть prompt caching поднимает и реальную пропускную способность.

Организация автоматически стоит на тире и растёт по мере использования. Месячные потолки трат: Start — $500, Build — $1000, Scale — $200 000 (та же документация). Свой лимит можно опустить ниже потолка тира в разделе Limits в Console, чтобы застраховаться от перерасхода.

Вывод: rate-лимиты на старте щедрые, реально упираются в них лишь тяжёлые агентные нагрузки; главный предохранитель для новичка — не rate-лимит, а спенд-кэп.

Как снизить счёт по API

Два штатных рычага, которые почти вдвое-втрое режут стоимость повторяющегося контекста:

• Prompt caching. Чтение из кэша стоит 10% базовой цены ввода, запись — 1.25x (5-мин кэш) или 2x (1-час). По расчёту страницы цен 5-минутный кэш окупается уже после одного повторного чтения. Кэшируйте системный промпт, крупный контекст и историю.
• Batch API. Для асинхронных, не срочных задач — скидка 50% и на ввод, и на вывод. Не для интерактивной работы, но идеально для пакетной обработки.

Мини-вывод: связка «кэш + правильная модель» экономит больше, чем перебор моделей. Haiku 4.5 на простых задачах ($1/$5) вместо Opus дешевле в пять раз по вводу и в пять по выводу.

Оплата API из России

Списание с российской карты Anthropic не принимает, и РФ нет в списке поддерживаемых стран — это касается и подписки, и пополнения API-баланса. Механика доступа, классы способов оплаты и их риски разобраны в отдельном материале про Claude Code в России — тут мы намеренно не рекламируем конкретных посредников. Технически после пополнения баланса API работает без гео-ограничений на сам вызов.

Чек-лист: подключить Claude Code по API

1. Создать ключ на console.anthropic.com (формат sk-ant-api03-…, сохранить сразу — покажут один раз).
2. Поставить Claude Code: npm install -g @anthropic-ai/claude-code.
3. Прописать ANTHROPIC_API_KEY в профиль оболочки (или задать точечно под задачу).
4. Запустить claude, проверить /status — активен ключ, а не подписка.
5. Выбрать модель под задачу через /model, включить prompt caching для повторяющегося контекста.
6. Поставить спенд-лимит в Console ниже потолка тира — страховка от перерасхода.

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

Нужна ли подписка Claude Pro, чтобы пользоваться Claude Code?
Нет. Есть два раздельных способа: подписка Pro/Max по фиксированной цене или API-ключ с поштучной оплатой за токены. Достаточно любого одного.

Что будет, если у меня есть и подписка, и переменная ANTHROPIC_API_KEY?
Победит ключ. По справке Anthropic Claude Code при заданной ANTHROPIC_API_KEY авторизуется по API и списывает деньги с API-баланса, а не с лимита подписки. Чтобы вернуться на план, выполните /login внутри Claude Code.

Сколько стоит Claude Code на API?
Зависит от модели: Opus 4.8 — $5 за 1М входных и $25 за 1М выходных токенов, Haiku 4.5 — $1/$5. Учтите новый токенайзер: на Opus 4.7+ и Sonnet 5 тот же текст даёт примерно на 30% больше токенов.

Какие модели доступны в Claude Code по API?
Актуальные рабочие — Opus 4.8 (claude-opus-4-8), Sonnet 5 (claude-sonnet-5) и Haiku 4.5 (claude-haiku-4-5). Переключение — командой /model.

Можно ли оплатить API Anthropic из России?
Российской картой напрямую — нет, РФ нет в поддерживаемых странах. Рабочие способы пополнения разобраны в отдельной статье про Claude Code в России.

Есть ли бесплатный способ попробовать?
Да — новый аккаунт Console получает небольшой стартовый кредит на тест API. Точную сумму видно в самой консоли.