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

> Модели общие: Claude API — оплата за токены для вашего кода и продукта, Claude Code — агент для работы в репозитории по подписке Pro/Max или по API-ключу.

- URL: https://blog.laozhang.ai/ru/posts/claude-api-vs-claude-code
- Published: 2026-09-26
- Updated: 2026-09-26
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ru/about)
- Category: Claude Code
- Tags: Claude Code, Claude API, Anthropic, Agent SDK, подписка Claude

---
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 API | Claude Code |
| --- | --- | --- |
| Что это | Интерфейс к моделям (Messages API) и клиентские SDK для разных языков | Приложение-агент: CLI, расширения VS Code и JetBrains, десктоп, веб |
| Кто работает с файлами и командами | Вы: цикл вызова инструментов пишете сами или отдаёте beta tool runner из Client SDK | Сам Claude Code: встроенные инструменты, разрешения, сессии, hooks |
| Как платить | Только за токены: баланс в Claude Console или счёт облачного провайдера | Подписка Pro, Max, Team, Enterprise либо API-ключ или облако с оплатой за токены |
| С чего начать | Аккаунт в Console и API-ключ | Установить Claude Code и войти через `/login` (тариф Free не подходит) |
| Условия использования | Commercial Terms | Free, Pro, Max — Consumer Terms; Team, Enterprise и API — Commercial Terms |

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: CLI, VS Code, JetBrains, десктоп | `/login` с Pro, Max, Team или Enterprise либо аккаунт Console | Подписка — в лимиты плана, общие с чатом; Console — баланс API | Лимиты 5-часового окна и недельные; заданный `ANTHROPIC_API_KEY` перехватывает оплату |
| Скрипт или CI над своим кодом | `claude -p`, желательно с `--bare` | `ANTHROPIC_API_KEY` или `apiKeyHelper`; без `--bare` можно `CLAUDE_CODE_OAUTH_TOKEN` | Ключ — Console; токен — лимиты вашей подписки | `--bare` не читает вход по подписке; без него запускаются hooks и MCP-серверы из репозитория |
| Функция с Claude в вашем приложении: чат, суммаризация, разбор документов | Messages API через Client SDK | API-ключ Console или облачный провайдер | Баланс Console или счёт облака | Работу с инструментами пишете сами; вход claude.ai в продукт встраивать нельзя |
| Агент с инструментами Claude Code в процессе, которым управляете вы | Agent SDK (Python, TypeScript) | API-ключ или облачный провайдер | Console или облако | Вход по подписке для чужих пользователей запрещён без согласования с Anthropic |
| Агент, которого хостит Anthropic | Managed Agents | Claude API | Console | Отдельный продукт со своей песочницей |
| Дать Claude Code пользователям своей платформы | Неизменённый Claude Code, предустановленный в песочнице | Каждый входит сам: свой ключ, своя подписка или облачные учётные данные | Сам пользователь | Нельзя платить за пользователей, перепродавать доступ или отключать способы входа |

![Схема выбора: задача, инструмент, учётные данные и кому приходит счёт, плюс две границы — вход claude.ai только для себя и --bare без подписки](https://blog.laozhang.ai/posts/ru/claude-api-vs-claude-code/img/layer-picker.webp)

Пара пояснений к строкам. Токен `CLAUDE_CODE_OAUTH_TOKEN` выдаёт команда `claude setup-token`; он действует год, работает только на тарифах Pro, Max, Team и Enterprise и нужен там, где входа через браузер нет. Для Managed Agents на сайте есть отдельный разбор: [Claude Managed Agents: что это такое, когда использовать и когда не стоит](https://blog.laozhang.ai/ru/posts/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, модели и шлюзы](https://blog.laozhang.ai/ru/posts/claude-code-api-configuration), а чем прямой Anthropic отличается от облака и шлюза — в материале [Как выбрать стабильный доступ к Claude: прямой Anthropic, поддерживаемое облако или шлюз laozhang.ai?](https://blog.laozhang.ai/ru/posts/claude-gateway-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 млн токенов:

| Модель | ID | Вход | Выход |
| --- | --- | --- | --- |
| Claude Fable 5.1 | `claude-fable-5-1` | $10 | $50 |
| Claude Opus 5.5 | `claude-opus-5-5` | $4 | $20 |
| Claude Sonnet 5 | `claude-sonnet-5` | $2 | $10 |
| Claude Haiku 4.5 | `claude-haiku-4-5-20251001` | $1 | $5 |

Для 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](https://blog.laozhang.ai/ru/posts/claude-code-pricing-guide), [Claude Pro vs Max в 2026 году: цены, лимиты Claude Code и окупаемость Max](https://blog.laozhang.ai/ru/posts/claude-code-pro-vs-max) и для тех, кто упирается в лимиты каждый день, — [Claude Code для интенсивных пользователей: оставить подписку, понизить план или перейти на API?](https://blog.laozhang.ai/ru/posts/claude-api-vs-subscription-cost)

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

**Платить за 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-ключ или облачный провайдер с самого начала, иначе переделывать авторизацию придётся после запуска.

![Забытый ANTHROPIC_API_KEY перехватывает оплату у подписки: как проверить через env и /status и вернуться на подписку командой unset](https://blog.laozhang.ai/posts/ru/claude-api-vs-claude-code/img/api-key-check.webp)

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

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

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

```bash
unset ANTHROPIC_API_KEY
```

Уже одобренный ключ в интерактивном режиме отключается переключателем «Use custom API key» в `/config`. И помните, что сумма в блоке Session команды `/usage` — оценка по прайсовым ценам: для подписчиков Pro и Max она к счёту отношения не имеет, а настоящий расход по API показывает страница Usage в Claude Console. Пошаговая диагностика — в статье [Claude Code: API-ключ или подписка, кто оплачивает работу?](https://blog.laozhang.ai/ru/posts/claude-code-api-key-vs-subscription-billing)

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

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

```bash
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: ключ отдельно не продаётся](https://blog.laozhang.ai/ru/posts/claude-api-key-free-tier).

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

```bash
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](https://blog.laozhang.ai/ru/posts/how-to-install-claude-code).

## Можно ли пользоваться 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 выходит дороже фактического расхода по токенам.