Claude Code нельзя запустить просто так — нужна платная подписка (Pro от $20/мес, Max от $100/мес) или аккаунт Claude Console с API-ключом и оплатой за токены. Бесплатный тариф Claude.ai в Claude Code не входит (документация).
Второй путь — API — интересен тем, кто не хочет платить фиксированную сумму каждый месяц. Вы платите за фактическое использование: потратили на Claude Code $3 в месяц — заплатили $3. Это легальный способ «работать без подписки», и именно под него заточены запросы «claude code api key» и «claude code без подписки».
Дальше — как получить API-ключ Anthropic, как подключить к нему Claude Code, чем API-режим отличается от подписки, как считаются деньги и лимиты, и как сэкономить на промпт-кешировании. Установка самого Claude Code здесь не разбирается — для этого есть отдельный гайд по установке.
Зачем API вместо подписки
Подписка и API дают один и тот же Claude Code: те же модели, режимы, MCP-серверы и сабэдженты. Разница только в том, как вы платите и на что натыкаетесь по лимитам.
| Критерий | Подписка Pro / Max | API (Console) |
|---|---|---|
| Оплата | Фиксированная: Pro $20/мес ($17 при годовой), Max 5x $100, Max 20x $200 (claude.com/pricing) | Pay-as-you-go: только за токены |
| Лимиты | Скользящие окна 5 часов и 7 дней | Только деньги + rate limits (запросов/токенов в минуту) |
| Вход | Браузер, аккаунт claude.ai | ANTHROPIC_API_KEY или claude auth login --console |
| Бюджет | Нельзя ограничить траты сверх окна | Лимит бюджета workspace, пополнения вручную |
| Для кого | Индивидуальная работа 2–3 ч/день | Скрипты, CI, команды, редкое использование, контроль счёта |
Когда API объективно выгоднее подписки:
- Редкое использование. Пять сессий в месяц на Sonnet — это примерно $1–3. Pro за $20 окупится только при регулярной работе.
- Автоматизация и CI. В headless-режиме (
claude -p "...") API-ключ не требует браузерного входа и работает в скриптах. Подписка тоже поддерживает headless черезclaude setup-token, но токен привязан к аккаунту и его сложнее делить между машинами. - Точный контроль расходов. В Console видно стоимость каждой сессии по токенам; можно выставить жёсткий бюджет workspace и не бояться «лимита на 5 часов» в середине задачи.
- Командам. Console позволяет добавить пользователей с ролью Claude Code (создают только ключи для Claude Code) или Developer (любые ключи) и разносить расходы по организации (документация по аутентификации).
Обратная сторона — API безлимитен только в денежном смысле: при интенсивной работе счёт растёт, а у подписки траты фиксированы. Enterprise-статистика Anthropic: в среднем $13 на разработчика за активный день и $150–250 в месяц, у 90% пользователей меньше $30 в день (стоимость Claude Code).
Как получить API-ключ: пошагово
API-ключи создаются в Claude Console — это отдельная от claude.ai платформа для разработчиков.
- Зарегистрируйте аккаунт на platform.claude.com. Понадобится email и верификация — Anthropic работает только в списке поддерживаемых стран, про ограничения для России — ниже.
- Создайте организацию (workspace) — через Console или вместе с регистрацией. Ключи привязаны к организации, а не к личному аккаунту.
- Пополните баланс. API оплачивается предоплаченными usage credits. На странице Billing (
platform.claude.com/settings/billing) нажмите «Buy credits» и введите сумму. Кредиты не возвращаются и сгорают через год после покупки; можно включить авто-пополнение при падении баланса ниже порога (как оплачивать API). - Создайте ключ. Путь: Settings → API keys → Create key. Роль должна позволять создавать ключи: Claude Code role — только ключи для Claude Code, Developer — любые (аутентификация в Console).
- Скопируйте ключ (формат
sk-ant-...). Он показывается один раз — если потеряли, создайте новый.
Как настроить Claude Code на API
После установки Claude Code (гайд) подключение к API сводится к одной переменной окружения.
export ANTHROPIC_API_KEY="sk-ant-..."
claude
При запуске Claude Code увидит переменную, пропустит браузерный вход и один раз спросит подтверждение на использование ключа. Заголовок X-Api-Key уходит в api.anthropic.com, и все запросы биллятся на ваш workspace (аутентификация).
Два нюанса:
- Ключ перекрывает подписку. Если у вас есть Pro/Max и одновременно задан
ANTHROPIC_API_KEY, Claude Code использует ключ, а не подписку. Это «intentional functionality» — официально заявленное поведение, из-за которого люди теряли деньги: в треде r/ClaudeAI с 484 апвоутами пользователь потерял $187, потому что ключ остался в.envпроекта, и Claude Code незаметно переключился с Max-плана на оплату по токенам:
«Claude Code is designed to prioritize API keys set as environment variables over subscription credentials — this is intentional functionality that gives users flexibility in authentication methods.»
«Claude Code спроектирован так, что API-ключи в переменных окружения имеют приоритет над учётными данными подписки — это intentional functionality, дающая гибкость в способах аутентификации».
— ответ поддержки Anthropic из обсуждения
Если подписка нужна, а ключ в окружении нет — выполните unset ANTHROPIC_API_KEY перед запуском, либо не держите ключ в .env проекта под этим именем (переименуйте, например, в MY_PROJECT_API_KEY).
- Либо вход через Console без переменной. Альтернатива экспорту ключа — штатная команда:
claude auth login --console
Это браузерный вход в Console-аккаунт, после которого Claude Code биллит использование на API-организацию, а не на подписку (CLI reference).
Модель по умолчанию в API-режиме — Sonnet (на момент публикации Sonnet 5 с нативным окном 1 млн токенов). Переключение — команда /model внутри сессии или флаг --model:
claude --model claude-opus-5
claude --model claude-fable-5
Алиасы sonnet, opus, fable, haiku резолвятся в актуальные версии для вашего провайдера (конфигурация модели).
Ещё одна деталь режимов «на момент публикации»: с 14 августа 2026 года auto mode стал режимом по умолчанию для новых сессий на планах Pro, Max и Team — агент выполняет безопасные действия (правки файлов, запуск команд) без запроса подтверждения, а рискованные блокирует классификатором. В API-режиме auto mode тоже доступен: он работает на любом провайдере, включая Anthropic API (конфигурация auto mode).
Лимиты и стоимость: на чём считаются деньги
Цены моделей на момент публикации (август 2026)
Claude Code биллит по тарифам моделей Anthropic — входные и выходные токены, за миллион:
| Модель | Вход | Выход | Промпт-кеширование |
|---|---|---|---|
| Haiku 4.5 | $1 | $5 | до 90% скидки на входные |
| Sonnet 5 | $2 | $10 | до 90% скидки на входные |
| Opus 5 | $5 | $25 | до 90% скидки на входные |
| Fable 5 | $10 | $50 | 90% скидки на входные |
Источники: страница Sonnet, Opus, Fable, Haiku. Батч-обработка даёт ещё 50% на обе стороны, но в интерактивном Claude Code она не применяется.
Как выглядит расход на практике: сессия из нескольких правок файлов на Sonnet 5 — обычно $0.05–0.30. Крупный рефакторинг с чтением десятка файлов — $1–3. Долгая автономная сессия на Fable 5 может выйти в $10–30. Команда /usage внутри сессии показывает стоимость по токенам в реальном времени.
Промпт-кеширование — главный способ экономии
Claude Code включает промпт-кеширование автоматически: каждый запрос пересылает весь контекст (системный промпт, историю, результаты инструментов), и повторно обработанные префиксы биллятся по ставке кешированного входа — примерно 10% от обычной цены входных токенов (как Claude Code использует кеширование).
Это значит: при длинной сессии каждый новый ход «перечитывает» весь контекст за копейки, а не за полную цену. Кеш живёт 5 минут в API-режиме по умолчанию (на подписке — час). Перерыв больше 5 минут — следующий запрос пересчитывает контекст заново. Если вы часто возвращаетесь в сессию после перерыва, можно включить часовой кеш:
export ENABLE_PROMPT_CACHING_1H=1
Что сбрасывает кеш (и делает следующий ход дороже): смена модели, смена effort level, /compact, подключение/отключение MCP-сервера с загрузкой тулзов в префикс, обновление Claude Code (полный список). Практические выводы: выбирайте модель в начале сессии и не дёргайте /model в середине задачи.
Rate limits и бюджет
У API-режима нет «5-часовых окон», но есть rate limits: лимиты запросов в минуту, токенов в минуту и запросов в день. Уровень (usage tier) присваивается аккаунту автоматически; посмотреть текущий тир и лимиты можно в Console на странице platform.claude.com/settings/limits. Если упираетесь в лимит и используете ≥50% текущего — можно запросить повышение прямо в Console (как повысить rate limits).
При превышении API отвечает кодом 429. Для Claude Code это не фатально: у агента есть авто-ретраи, но темп работы падает.
Второй лимит — денежный. В Console выставляется лимит бюджета workspace, и когда он исчерпан, запросы прекращаются. Для headless-запусков есть локальная защита — флаг --max-budget-usd:
claude -p "выполни рефакторинг auth-модуля" --max-budget-usd 5.00 --max-turns 3
--max-budget-usd останавливает сессию, когда потрачено $5 (считается по локальной оценке токенов), --max-turns ограничивает число агентных ходов. Оба флага работают в print-режиме (-p) — для CI и разовых задач это обязательная гигиена (CLI reference).
Практика: типовые команды и промпты
Проверить, что ключ работает и куда уходят запросы:
claude doctor # диагностика установки и аутентификации
/status # версия, модель, аккаунт и статус подключения
/usage # стоимость сессии, лимиты плана, статистика по токенам
Разовая задача в CI/скрипте (headless, с защитой бюджета):
export ANTHROPIC_API_KEY="sk-ant-..."
claude -p "Найди баг: после входа на /login пустой экран. Запусти тесты и исправь." \
--permission-mode plan \
--max-budget-usd 2.00 \
--output-format json
Совмещение подписки и API в одном проекте. Распространённый сценарий — «в интерактиве работаю по Pro, в скриптах — по API». Для этого держите ключ только в окружении скрипта и снимайте его перед интерактивным запуском:
# скрипт/CI
export ANTHROPIC_API_KEY="sk-ant-..."
claude -p "..." --max-budget-usd 1.00
# интерактив — сбросить ключ, вернуться на подписку
unset ANTHROPIC_API_KEY
claude
Экономия на токенах (актуально и для API, и для подписки):
- Одна сессия — одна задача, между задачами
/clear: старый контекст перечитывается при каждом запросе (стоимость). - Для простых подзадач (commit-месседжи, форматирование) выберите Haiku через
/model haiku— $1/$5 против $2/$10 у Sonnet. - Формулируйте конкретные промпты: «добавь валидацию email в auth.ts» вместо «улучши код» — меньше чтения лишних файлов.
- Держите
CLAUDE.mdкомпактным и выносите детальные инструкции в навыки — они грузятся по требованию, а не в каждом запросе (memory). Про формат файлов-конвенций — отдельная статья.
Российские реалии: как это работает из РФ
Тут всё как с остальными сервисами Anthropic — и честно, ничего хорошего:
- Россия не входит в список поддерживаемых стран ни для API, ни для Claude.ai (список).
api.anthropic.comиplatform.claude.comблокируются с российских IP на уровне geo-block. Без VPN вы даже не откроете Console, чтобы получить ключ. - Оплата российскими картами не проходит. Visa и Mastercard российских банков не принимаются. Реальные способы пополнить usage credits на момент публикации: карта зарубежного банка, UnionPay (проходит не у всех эмитентов), криптовалюта через посредников, пополнение через сервисы, продающие кредиты, либо юрлицо в поддерживаемой стране (Казахстан, Турция, Армения, Грузия).
- Регистрация требует телефон для верификации; российские номера не принимаются. Нужен номер из поддерживаемой страны — часто виртуальные номера уже сожжены.
- Баны. Аккаунты, зарегистрированные с российских IP или с карт «не тех» стран, Anthropic может банить. Обходные схемы работают на свой страх и риск.
Русскоязычный опыт по теме есть, но он точечный:
- «Как использовать Claude в России в 2026» (Habr, ЦНИС, июнь 2026) — обзорный материал про geo-block на уровне API и веб-интерфейса, оплату и обходные пути.
- «Как стать вайбкодером» (spryt.ru, июль 2026) — практический опыт из РФ: автор честно пишет, что «выложить $20–200 через мутных посредников, сидеть по VPN и ждать бана своего акка» — самый некомфортный путь, и рекомендует начинать с бесплатных агентов вроде OpenCode.
- Тред про API-ключ в .env (r/ClaudeAI, 484↑) — свежий кейс о том, как ключ незаметно переключает биллинг с подписки на API; актуален для всех, кто совмещает оба способа.
Про альтернативы без VPN и зарубежных карт: бесплатный open-source агент OpenCode работает из РФ без ограничений и подключается к разным моделям; полностью локальный вариант — Qwen3-Coder через Ollama. Качество на сложных задачах у флагманских моделей выше, но для старта и простых задач этого достаточно — обзор сценариев в статье «Лучший ИИ-агент для кодинга».
Честные ограничения API-режима
- Нет «просто попробовать». В отличие от подписки, где за $20 вы работаете до лимита, в API каждый токен стоит денег. Тестовая сессия «посмотреть, как агент делает рефакторинг» обойдётся в $1–3, а не в «бесплатно в рамках подписки».
- Счёт уходит быстро при плохих промптах. Расплывчатые задачи («улучши код») заставляют агента читать половину репозитория. Стоимость — следствие контекста, а не скорости модели.
- Нельзя ограничить одну сессию извне.
--max-budget-usdработает только в print-режиме; в интерактивной сессии защита — только лимит workspace в Console. - Fable 5 дорогая. $10/$50 за миллион — это в 5 раз дороже Sonnet по входу. Для ежедневных задач Fable 5 нецелесообразна; её берут под долгие автономные задачи (про Fable 5).
- Rate limits ниже у нового аккаунта. Сразу после регистрации тир низкий; параллельные агенты и CI-пайплайны могут упираться в 429, пока аккаунт не «прогреется».
- Из РФ всё это ещё и через VPN. Даже если технически вы готовы платить по факту, доступ к Console, оплата и верификация требуют обходных схем.
Что в итоге
API-режим Claude Code — это тот же агент, но с биллингом по факту вместо фиксированной подписки. Он выгоден при редком использовании (несколько долларов в месяц против $20 за Pro), в автоматизации и CI, и там, где нужен точный контроль расходов. Подписка остаётся разумным выбором для ежедневной работы по 2–3 часа: за $20 вы получаете предсказуемый лимит без сюрпризов на счету.
Технически подключение тривиальное: ключ в Console, одна переменная ANTHROPIC_API_KEY, и Claude Code работает по API. Главные грабли — не оставлять ключ в .env (переключит биллинг с подписки на API), выбирать модель под задачу и помнить, что промпт-кеширование экономит до 90% на входных токенах в длинных сессиях.
Дальше по теме: как установить и настроить Claude Code, что такое агентный кодинг, AGENTS.md — файл конвенций, что такое MCP, бесплатные инструменты агентского кодинга.
