Claude Code · native /v1/messages

Claude Code и AIRouter: native /v1/messages

AIRouter поддерживает Anthropic-native Messages API на /v1/messages для Claude Code-style клиентов. Укажите корневой ANTHROPIC_BASE_URL, AIRouter API key и model id из каталога; AIRouter применяет auth, model allowlist, billing preflight, streaming accounting и usage logging. Native поля вроде tools/tool_choice, thinking, cache_control, images/PDF blocks и context_management доступны, когда их поддерживает выбранная модель.

Native /v1/messages Документация Claude Code: env vars

Нужен спокойный старт?

Если вы только устанавливаете Claude Code и хотите пройти без лишней терминологии, откройте отдельный quickstart с Windows, macOS, Linux/WSL и безопасным первым заданием.

Открыть Claude Code quickstart

Короткий ответ

AIRouter поддерживает Anthropic Messages API на /v1/messages для Claude Code-style клиентов.

ANTHROPIC_BASE_URL указывает на корень API‑сервиса https://api.ai-router.app, ANTHROPIC_API_KEY — на AIRouter API key.

Используйте ANTHROPIC_MODEL=sonnet и задайте ANTHROPIC_DEFAULT_SONNET_MODEL/ANTHROPIC_DEFAULT_HAIKU_MODEL AIRouter catalog ids, например anthropic/claude-sonnet-4.5 и anthropic/claude-haiku-4.5, если они активны в каталоге.

Для безопасной проверки начинайте с короткого запроса и ограниченного AIRouter API key.

Что понадобится

Начните с регистрации AIRouter, проверьте модели и цены, пополните баланс от 100 ₽, а базовый OpenAI‑compatible quickstart держите под рукой в документации.

AIRouter аккаунт, подтверждённый email, API‑ключ и положительный баланс.
Модели из каталога AIRouter для Sonnet и Haiku slots Claude Code; рекомендуемый golden path: anthropic/claude-sonnet-4.5 и anthropic/claude-haiku-4.5, если они активны.
Короткая текстовая, tool-use или multimodal проверка перед рабочим workflow.
Понимание, что это отдельный endpoint Anthropic Messages API, а не OpenAI-compatible https://api.ai-router.app/v1/chat/completions.

Пошаговая настройка

Укажите корень AIRouterANTHROPIC_BASE_URL должен указывать на корень сервиса, потому что endpoint находится на /v1/messages, а не под /api/v1.
Начните с короткого запросаСначала проверьте короткий текстовый запрос, затем маленький tool-use или multimodal сценарий, если он нужен. Так можно проверить ключ, модель, баланс и streaming.
Проверяйте capabilities моделиAIRouter принимает native поля и применяет billing/auth safety, но конкретные tools, thinking, images/PDF и cache_control должны поддерживаться выбранной моделью.

Пример конфига

В публичных примерах используйте <AIROUTER_API_KEY>, <AIROUTER_MODEL> или переменную AIROUTER_API_KEY.

Claude Code env

ANTHROPIC_BASE_URL=https://api.ai-router.app
ANTHROPIC_API_KEY=<AIROUTER_API_KEY>
ANTHROPIC_MODEL=sonnet
ANTHROPIC_DEFAULT_SONNET_MODEL=anthropic/claude-sonnet-4.5
ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-4.5

Model selection

# ANTHROPIC_MODEL=sonnet makes Claude Code use the Sonnet slot.
# ANTHROPIC_DEFAULT_SONNET_MODEL and ANTHROPIC_DEFAULT_HAIKU_MODEL
# must be AIRouter catalog ids that are active for your account.
# Haiku is used by Claude Code for lightweight/background tasks.

Проверка

Проверьте POST /v1/messages или Claude Code с ANTHROPIC_MODEL=sonnet простым prompt.
Проверьте stream:true, если клиент стримит ответы.
Для tools/thinking/images/PDF проверьте маленькую задачу с низким max_tokens на выбранной модели.

Частые ошибки

Поставить https://api.ai-router.app/v1 в ANTHROPIC_BASE_URL вместо корня сервиса.
Считать, что любая модель поддержит все Anthropic-native fields.
Смешивать настройки Anthropic Messages API с OpenAI-compatible Chat Completions endpoint.
Выбрать модель, которой нет в каталоге AIRouter, или не задать ANTHROPIC_DEFAULT_HAIKU_MODEL для фоновых Haiku-задач Claude Code.

FAQ

Можно ли подключить Claude Code к AIRouter напрямую?

Да, через корневой ANTHROPIC_BASE_URL=https://api.ai-router.app и /v1/messages. Используйте AIRouter API key, ANTHROPIC_MODEL=sonnet, ANTHROPIC_DEFAULT_SONNET_MODEL=anthropic/claude-sonnet-4.5 и ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-4.5, если эти модели активны в каталоге.

Поддержаны ли tools и multimodal blocks?

AIRouter принимает tools/tool_choice, thinking, cache_control, images/PDF blocks и другие native поля; фактический результат зависит от поддержки выбранной модели.

Что использовать для OpenAI-compatible base URL?

Cline, Continue.dev, OpenCode, Hermes Agent или OpenClaw подходят для https://api.ai-router.app/v1/chat/completions.

Ограничения

Поддержан Anthropic-native /v1/messages: JSON и stream:true доступны в AIRouter без настройки Chat Completions endpoint.

AIRouter принимает tools/tool_choice, thinking, cache_control, images/PDF blocks, context_management и extension fields; фактическая поддержка зависит от выбранной модели.

Перед рабочим coding workflow проверьте короткий сценарий на выбранной модели и держите лимиты ключа/баланса под контролем.

Официальные источники

Документация Claude Code: env vars

Официальная документация Claude Code env vars подтверждает Anthropic-oriented переменные вроде ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY; Messages API docs описывают tools и streaming events.

← Все инструкции · Модели и цены · Начать