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-ключом. Цены и правила ниже приведены по состоянию на 26 сентября 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: что это такое, когда использовать и когда не стоит.

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

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

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

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

Цены указаны без налогов. Лимиты общие для Claude Code и чата: сессионное окно в 5 часов плюс недельные ограничения, и работа в терминале расходует тот же запас, что и переписка в веб-версии. Когда лимит исчерпан, можно подождать сброса, перейти на тариф выше или включить usage credits — оплату сверх лимита по стандартным ценам API.

Тут легко спутать два вида «кредитов». Usage credits — надстройка над подпиской: они включаются в настройках claude.ai, а команда /usage-credits работает только при входе по подписке. Баланс API — отдельный предоплаченный счёт в Claude Console, с которого списываются вызовы по API-ключу, в том числе из Claude Code.

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

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

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

• Sonnet 5: 2 × $2 + 0,15 × $10 = $5,50 за сессию;
• Opus 5.5: 2 × $4 + 0,15 × $20 = $11,00 за сессию.

Двадцать таких сессий в месяц — $110 на Sonnet 5 или $220 на Opus 5.5 против фиксированных $20 за Pro или $100–200 за Max. Сравнение не прямое: подписка ограничена лимитами и не превращается в «безлимит за $20», а кэширование заметно режет стоимость повторяющегося контекста на API. Для ориентира у самой 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 за то, что покрывает подписка. Если вы в основном программируете сами в Claude Code, а счёт приходит из Console, проверьте, нужен ли вам вообще API-маршрут для этой работы. Pro за $20 включает Claude Code; оплата по токенам оправдана для продукта, для CI с --bare или когда подписки систематически не хватает.

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

Строить свой продукт на входе по подписке. Подписка 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.

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

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

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

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