Как устроен API Claude Code

Claude Code — это агент для терминала, но внутри каждое действие представляет собой вызов того же Anthropic Messages API, который можно использовать напрямую. Из этого следует полезная возможность: вы управляете конечной точкой, к которой он обращается, ключом, по которому начисляется оплата, и, соответственно, стоимостью сессии. На этой странице объясняются основные компоненты и приводятся ссылки на подробные руководства по настройке.

Что на самом деле означает «API Claude Code»

Отдельного продукта под названием API Claude Code не существует. Claude Code проходит аутентификацию либо через подписку Claude (Pro/Max), либо с помощью ключа API, а в режиме API отправляет стандартные запросы Messages API — системный промпт, диалог, определения инструментов и результаты их работы — на конечную точку, указанную в его окружении.

Эту конечную точку можно настроить. Всем управляют две переменные окружения: ANTHROPIC_BASE_URL (куда отправляются запросы) и ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY (с чьего аккаунта списывается оплата). Настройте их для прямого обращения к Anthropic или к совместимому с Anthropic шлюзу — Claude Code будет работать одинаково.

Использование собственного ключа API с Claude Code

Задайте две переменные в профиле командной оболочки или в ~/.claude/settings.json и запустите claude как обычно. Полная пошаговая инструкция с примерами settings.json приведена в нашем <a href="/ru/learn/claude-code-api-key-setup/">руководстве по настройке ключа API для Claude Code</a>.

Есть один нюанс: если в командной оболочке задана ANTHROPIC_API_KEY, Claude Code использует тарифы API, даже если у вас также есть подписка — переменная окружения имеет приоритет. Удалите её из окружения, если хотите использовать тариф Pro/Max.

Сколько стоит сессия Claude Code

Агентные сессии расходуют много токенов: каждый прочитанный файл, результат работы инструмента и diff попадают в контекст. За час сосредоточенной работы можно израсходовать миллионы входных токенов, поэтому кеширование промптов так важно — на поддерживаемых конечных точках повторяющийся контекст считывается из кеша за малую долю обычной цены.

В <a href="/ru/learn/claude-code-api-costs/">руководстве по стоимости API Claude Code</a> мы разбираем реальные расходы на сессию, работу кеша и способы сохранять доступную стоимость длительных сессий.

Прямой доступ к Anthropic или шлюз

Прямой доступ к API Anthropic предоставляет оплату по объёму использования и поддержку от самого поставщика — это подходящий вариант по умолчанию для команд со стабильным бюджетом. Независимые шлюзы, такие как AI Prime Tech (не связан с Anthropic и не одобрен ею), перепродают доступ по фиксированным или сниженным тарифам и используют тот же формат обмена данными, поэтому для работы Claude Code достаточно изменить базовый URL и ключ.

Какой бы вариант вы ни выбрали, проверьте, что потоковая передача работает на всём пути и что нужные модели доступны под теми же идентификаторами, которые запрашивает Claude Code. Полный список проверок приведён в руководстве <a href="/ru/learn/use-claude-api-with-claude-code/">по использованию API Claude с Claude Code</a>.

# Claude Code with your own key + custom endpoint
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

# or persist in ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.