Claude API и Claude Code: в чём разница и что выбрать

Claude API и Claude Code работают на одних и тех же моделях Claude, но находятся на разных уровнях. Claude API — программный доступ к моделям: ваш код отправляет запрос на https://api.anthropic.com/v1/messages с ключом из Claude Console и платит за каждый входной и выходной токен. Claude Code — готовый агент Anthropic для программирования: он сам читает репозиторий, правит файлы и запускает команды в терминале, IDE, десктопном приложении или браузере. Платить за него можно подпиской Pro или Max либо тем же API по токенам.

Отсюда простое правило. Вы сами пишете код в своём репозитории — берите Claude Code со входом по подписке. Claude должен работать внутри вашего продукта, которым пользуются другие люди, — нужен API-ключ: Messages API или Agent SDK. Скрипты и CI над собственным кодом — claude -p, обычно тоже с API-ключом.

Что изменилось к 8 октября 2026 года: с 7 октября в тарифы Max и Team входят ежемесячные кредиты на Claude API. Они оплачивают API, Agent SDK и claude -p с ключом связанной организации Console, но не интерактивный Claude Code. В прайсе API появились Sonnet 5.5 и Haiku 5.5. Цены и правила ниже приведены по состоянию на 8 октября 2026 года.

Одни модели, два разных уровня

Claude Code — не отдельная модель, а программа, которая обращается к тем же моделям, что доступны через API. Поэтому в документации Anthropic его расход описан в токенах, а работа сверх лимита подписки оплачивается по стандартным ценам API.

Путаницу добавляет выражение «Claude Code API». Под ним обычно понимают одно из двух:

• Claude Code, оплаченный API-ключом вместо подписки. Это тот же инструмент, просто счёт приходит из Console.
• Запуск Claude Code из своего кода: команда claude -p в скрипте или Agent SDK для Python и TypeScript. Отдельного HTTP-эндпоинта «Claude Code» нет: Agent SDK — библиотека, которая запускает тот же бинарник Claude Code с его инструментами.

Какой слой выбрать под задачу

Anthropic сама разводит четыре способа работы с Claude: Claude Code CLI, Agent SDK, Client SDK (прямые вызовы API) и Managed Agents. Но для выбора важно ещё, какими учётными данными вы авторизуетесь и кому приходит счёт: именно на этом чаще всего и ошибаются. Сводная таблица:

Пара пояснений к строкам. Токен CLAUDE_CODE_OAUTH_TOKEN выдаёт команда claude setup-token; он действует год, работает только на тарифах Pro, Max, Team и Enterprise и нужен там, где входа через браузер нет. Для Managed Agents на сайте есть отдельный разбор: Claude Managed Agents в 2026 году: что это такое, когда использовать и когда не стоит.

Claude Code умеет работать не только напрямую с Anthropic. Через переменные окружения его можно направить в Amazon Bedrock, Google Cloud's Agent Platform (переменная по-прежнему называется CLAUDE_CODE_USE_VERTEX) или Microsoft Foundry, а через ANTHROPIC_AUTH_TOKEN и ANTHROPIC_BASE_URL — в корпоративный или сторонний LLM-шлюз. Тогда счёт выставляет облако или владелец шлюза, а не Console. Сторонний шлюз — не Anthropic: список моделей, цены и условия задаёт он сам. Как прописать такие настройки, описано в статье Настройка Claude Code API: ключи, settings.json, модели и шлюзы, а чем прямой Anthropic отличается от облака и шлюза — в материале Как выбрать стабильный доступ к Claude: прямой Anthropic, поддерживаемое облако или шлюз laozhang.ai?

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Граница между личной подпиской и своим продуктом

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

Что запрещено без отдельного согласования с Anthropic:

• предлагать в своём приложении вход через claude.ai;
• пропускать запросы своих пользователей через учётную запись Free, Pro или Max;
• собирать, хранить или передавать через себя учётные данные и сессионные токены claude.ai;
• модифицировать бинарник Claude Code, если вы предустанавливаете его для клиентов, и платить за их использование или перепродавать его.

Что разрешено: раздать собственные API-ключи своим сотрудникам, если расход записывается на владельца ключа и не перепродаётся; дать пользователю войти в неизменённый Claude Code на вашей платформе с его собственной подпиской. Anthropic оставляет за собой право применять меры без предварительного уведомления.

Паниковать из-за личных скриптов при этом не нужно. Заявленные лимиты Pro и Max рассчитаны на «обычное индивидуальное использование Claude Code и Agent SDK», то есть ваш собственный claude -p над вашим репозиторием в эти рамки укладывается. Граница проходит там, где подписку начинают использовать другие люди или где она подменяет API в продукте. Ежемесячные кредиты Max и Team эту границу не размывают: они начисляются на организацию Console и тратятся через API-ключ, а не через вход по подписке.

Сколько это стоит

Подписки Anthropic, в которые входит Claude Code:

• Free — $0, Claude Code не включён;
• Pro — $20 в месяц при помесячной оплате или $17 в месяц при годовой ($200 сразу);
• Max (бывший Max 5x) — $100 в месяц, Ultra (бывший Max 20x) — $200 в месяц (только помесячно; цены для веб-подписки, в мобильных приложениях могут отличаться).

Цены указаны в долларах США без налогов. Лимиты общие для Claude Code и чата: сессионное окно в 5 часов плюс недельный лимит, который сбрасывается в закреплённое за аккаунтом время, и работа в терминале расходует тот же запас, что и переписка в веб-версии. Max даёт в пять раз больше Pro и за пять часов, и за неделю, а Ultra — в десять раз больше Pro за неделю, и у подтверждённых аккаунтов пятичасового лимита у него нет; числа сообщений или токенов Anthropic не публикует. Подробная таблица лимитов по тарифам — в статье Лимиты Claude Pro и Max в неделю и за 5 часов: сводная таблица, а сравнение Free и Pro — в материале Claude Free или Pro: как сравнить лимиты без подсчёта сообщений.

Модели Fable расходуют подписку по-разному. На Pro модели Fable 5, Fable 5.1 и Fable 5.2 не входят в лимиты тарифа и с первого запроса оплачиваются из usage credits. Исключение — стартовая акция: с 9 по 16 ноября 2026 года (до 23:59 по тихоокеанскому времени) на Pro и стандартных местах Team модели Fable входят в тариф, до 50 % недельного лимита, а после этой даты снова оплачиваются из usage credits. На Max на них можно потратить до 50 % недельного лимита без доплаты; это не прибавка к лимиту, а его доля, и Fable расходует её быстрее других моделей.

Когда лимит исчерпан, можно подождать сброса, перейти на тариф выше или включить usage credits — оплату сверх лимита по стандартным ценам API. Они включаются в Settings > Usage на claude.ai, пополняются заранее (можно настроить автопополнение и месячный потолок) и работают в чате и в Claude Code в терминале; пятичасовые лимиты при этом по-прежнему сбрасываются как обычно. У части подписчиков есть ещё сброс лимита: он разово возвращает к полному пятичасовой или недельный лимит и включается в Settings > Usage в веб-версии или Claude Desktop, но не в Claude Code в терминале или IDE.

Тут легко спутать три вида денег на Claude:

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

Разница между разовым облачным кредитом, usage credits и сбросом лимита разобрана в статье Облачный кредит, кредиты использования и сброс лимита в Claude.

Цены API за 1 млн токенов:

С 9 ноября 2026 года текущая модель Fable — Claude Fable 5.2 по $8 / $40 за 1 млн токенов, а Fable 5.1 остаётся доступной как legacy-модель по $10 / $50.

Sonnet 5.5 (вышла 28 сентября) и Haiku 5.5 (7 октября) — новые строки прайса; Sonnet 5 и Haiku 4.5 Anthropic теперь относит к предыдущим моделям, но они по-прежнему доступны. У Haiku 5.5 цена зависит от длины промпта: свыше 100 тыс. токенов — $0,50 за вход, $0,05 за чтение из кэша и $2,50 за выход. Для Sonnet 5 цена $2 / $10 стала постоянной: запланированное на 1 сентября 2026 года повышение до $3 / $15 отменено. Чтение из кэша промптов стоит 0,05 от цены входа у Opus 5.5 и Sonnet 5.5, 0,025 у Fable 5.1 и 0,1 у остальных моделей; пакетная обработка (Batch) даёт скидку 50 %.

Условный пример, чтобы почувствовать порядок сумм. Допустим, одна агентная сессия в Claude Code съедает 2 млн входных и 150 тыс. выходных токенов — это допущение, а не замер. Без кэша по прайсу получается:

• Sonnet 5.5 (и Sonnet 5 — без кэша цена та же): 2 × $2 + 0,15 × $10 = $5,50 за сессию;
• Opus 5.5: 2 × $4 + 0,15 × $20 = $11,00 за сессию.

Двадцать таких сессий в месяц — $110 на Sonnet 5.5 или $220 на Opus 5.5 против фиксированных $20 за Pro, $100 за Max или $200 за Ultra. Сравнение не прямое: подписка ограничена лимитами и не превращается в «безлимит за $20», а кэширование заметно режет стоимость повторяющегося контекста на API. Ежемесячные $100 кредитов Max покрыли бы около 18 таких сессий на Sonnet 5.5 ($100 / $5,50), но только если запускать их через claude -p или Agent SDK с ключом связанной организации, а не в интерактивном Claude Code. Для ориентира у самой Anthropic есть цифра по корпоративным внедрениям: в среднем около $13 на разработчика в активный день и $150–250 в месяц, у 90 % пользователей — меньше $30 в активный день. Это средние по компаниям, а не прогноз для одного человека.

Подробные расчёты вынесены в отдельные материалы: Цена Claude Code 2026: Pro, Max, Team, API и extra usage, Claude Pro vs Max в 2026 году: цены, лимиты Claude Code и окупаемость Max и для тех, кто упирается в лимиты каждый день, — Claude Code: оставить подписку, понизить план или перейти на API

Кредиты на API в Max и Team: что они покрывают, а что нет

С 7 октября 2026 года тарифы Max и Team включают ежемесячные кредиты на Claude API. API-ключ по-прежнему выдаёт Claude Console, но платить за первые запросы с него владельцу Max или Team больше не обязательно. Размер кредитов за расчётный период:

• Max — $100, Ultra — $200;
• Team — $20 за место Standard и $100 за место Premium; кредиты всех мест собираются в общий баланс с потолком $500 в месяц (команда из трёх мест Standard и двух Premium получает $260);
• Free, Pro и Enterprise — кредитов нет.

Получить их можно после семи дней на тарифе: на claude.ai в веб-браузере откройте Settings > Billing (для Max) или Organization settings > Billing (владелец Team), в разделе API credits выберите «Link organization» и свяжите одну организацию Claude Console. Способ оплаты для этого не нужен. Связать можно только одну организацию, и сменить её самостоятельно нельзя. Anthropic включает кредиты постепенно, в течение нескольких дней, поэтому предложение может появиться не сразу.

Остальные правила:

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

Для выбора между API и Claude Code это значит следующее. Интерактивная работа в репозитории на Max по-прежнему идёт в лимиты подписки. Скрипты и CI с claude --bare -p и так требуют API-ключ, поэтому с ключом связанной организации они теперь сначала тратят ежемесячные кредиты, а не лимиты тарифа. Подписчикам Pro, которым нужен API, по-прежнему придётся пополнять баланс Console отдельно. Ещё одна оговорка: это не «кредиты для Agent SDK», которые Anthropic анонсировала в июне, — по словам компании, та программа недоступна.

Три дорогие ошибки и как их поймать

Платить за API за то, что покрывает подписка. Если вы в основном программируете сами в Claude Code, а счёт приходит из Console, проверьте, нужен ли вам вообще API-маршрут для этой работы. Pro за $20 включает Claude Code; оплата по токенам оправдана для продукта, для CI с --bare или когда подписки систематически не хватает. На Max и Team начните с ежемесячных кредитов: для скриптов и API их может хватить без пополнения.

Забытый ANTHROPIC_API_KEY. Claude Code выбирает учётные данные по приоритету, и API-ключ стоит выше входа по подписке. В интерактивном режиме Claude Code один раз спрашивает, использовать ли найденный ключ, и запоминает ответ; в режиме -p ключ используется всегда, если он задан. Итог: подписка оплачена, а расход идёт с баланса Console. Ключ связанной организации Max не спасает: интерактивные сессии Claude Code из ежемесячных кредитов не оплачиваются. Если ключ принадлежит отключённой организации, запросы вообще начинают падать с ошибкой авторизации.

Строить свой продукт на входе по подписке. Подписка Pro или Max не заменяет API для сервиса, которым пользуются другие люди, — об этом раздел выше. Для продукта нужен API-ключ или облачный провайдер с самого начала, иначе переделывать авторизацию придётся после запуска.

Быстрая проверка. В терминале выведите имена переменных, которые влияют на маршрут (значения ключей на экран не попадут):

env | grep -E '^(ANTHROPIC_|CLAUDE_CODE_)' | cut -d= -f1

Затем внутри Claude Code выполните /status: команда показывает активный способ входа, а если настроены и подписка, и ключ, помечает неиспользуемый. Вернуться на подписку можно так:

unset ANTHROPIC_API_KEY

Уже одобренный ключ в интерактивном режиме отключается переключателем «Use custom API key» в /config. И помните, что сумма в блоке Session команды /usage — оценка по прайсовым ценам: для подписчиков Pro и Max она к счёту отношения не имеет, а настоящий расход по API показывает страница Usage в Claude Console. Пошаговая диагностика — в статье Claude Code: API-ключ или подписка, кто оплачивает работу?

Как выглядит вызов API и вызов Claude Code из скрипта

Прямой вызов Messages API — это HTTP-запрос с ключом и версией API в заголовках:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "Объясни, что делает этот SQL-запрос: SELECT count(*) FROM orders;"}
    ]
  }'

В ответ приходит JSON с текстом модели. Прочитать файл, запустить тесты или внести правку модель сама не может: инструменты описываете и исполняете вы, в своём коде. Ключ создаётся в Claude Console, про получение ключа и пополнение баланса — в статье Как купить доступ к Claude API: ключ отдельно не продаётся.

Claude Code из скрипта запускается одной командой, и работу с файлами он берёт на себя:

claude --bare -p "Найди и исправь ошибку в auth.py" --allowedTools "Read,Edit,Bash"

Флаг -p включает неинтерактивный режим, --allowedTools заранее разрешает перечисленные инструменты. Из языков, для которых нет Agent SDK, Claude Code вызывают как подпроцесс с -p и --output-format json.

Про --bare стоит знать две вещи. Во-первых, в этом режиме Claude Code не читает вход по подписке и системную связку ключей, поэтому нужен ANTHROPIC_API_KEY или apiKeyHelper (облачные провайдеры читают свои учётные данные как обычно). Во-вторых, без --bare сессия -p подхватывает hooks из .claude/settings.json и MCP-серверы из .mcp.json проекта даже в папке, которой вы не доверяли, причём без диалога подтверждения. Для CI, где код приходит из чужих веток, это важная граница. Anthropic рекомендует --bare для скриптов и SDK-вызовов и планирует сделать его режимом -p по умолчанию.

Если Claude Code ещё не установлен, начните со статьи Как установить Claude Code в 2026: полное руководство для Mac, Windows и Linux.

Можно ли пользоваться Claude API и Claude Code в России

По состоянию на 26 сентября 2026 года России нет в списке поддерживаемых стран и регионов Anthropic. Официально сервис для России не предоставляется — ни API, ни подписки, через которые работает Claude Code. Где сервисом можно пользоваться, определяют условия Anthropic и выбранного провайдера, а не язык: то, что Claude отвечает по-русски, ещё не значит, что он доступен в России.

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

Нужен ли API-ключ, чтобы пользоваться Claude Code?

Нет. Claude Code входит во все платные подписки — Pro, Max, Team и Enterprise; достаточно войти через /login. На бесплатном тарифе Free Claude Code недоступен. API-ключ нужен, если вы хотите платить за токены вместо подписки, запускать claude --bare -p или работаете через аккаунт Console организации.

Можно ли использовать в Claude Code свой API-ключ?

Да, и при наличии подписки ключ окажется главнее: одобренный ANTHROPIC_API_KEY Claude Code использует вместо входа по подписке, а в режиме -p — всегда. Проверить активный вариант можно командой /status. На Max и Team ключ связанной организации оплачивает из ежемесячных кредитов только claude -p и Agent SDK, запущенные вами; интерактивные сессии в терминале, IDE, десктопе и вебе кредиты не покрывают.

Входят ли кредиты на Claude API в подписку Pro или Max?

В Pro — нет: API оплачивается отдельно через баланс Console. С 7 октября 2026 года Max получает $100, а Ultra — $200 кредитов на API за расчётный период; Team — $20 или $100 за место, но не больше $500 в месяц на команду. Кредиты начисляются на одну связанную организацию Console и не увеличивают лимиты подписки.

Можно ли вызывать Claude Code как API?

Не как HTTP-сервис, а как программу: claude -p в скриптах и CI или Agent SDK в приложениях на Python и TypeScript. Для своего кода подойдёт и подписка, но если агентом будут пользоваться другие люди, авторизация должна идти через API-ключ или облачного провайдера.

Что дешевле: Claude API или Claude Code по подписке?

При регулярной личной работе с кодом подписка обычно выгоднее: $20 за Pro против $5–11 за одну тяжёлую агентную сессию на API в примере выше. API выигрывает, когда нагрузка редкая, когда нужна интеграция в продукт или когда лимиты подписки систематически мешают, а доплата за Max выходит дороже фактического расхода по токенам. На Max и Team небольшой расход на API и скрипты с ключом могут закрыть ежемесячные кредиты.