Anthropic SDK и Claude Code
POST /v1/messages принимает запрос в форме Anthropic Messages и отвечает в ней же, целиком или потоком. Поэтому Anthropic SDK и Claude Code работают со сменой адреса и ключа. Модель берётся из того же каталога, что на проводе OpenAI, и выбирается теми же provider и models (см. «Маршрутизация и кэш»).
Адрес и ключ
Anthropic SDK и Claude Code сами дописывают /v1/messages, поэтому им нужен адрес без пути: https://api.samreshuuu.ru. Ключ API моделей Anthropic SDK шлёт в x-api-key, Claude Code в Authorization: Bearer; принимаются оба. Ключ выпускается в консоли разработчика.
Claude Code
Кроме ANTHROPIC_MODEL Claude Code сам зовёт модели уровней Opus, Sonnet и Haiku (Haiku для фоновых задач) по их именам у Anthropic. Таких id в нашем каталоге нет, поэтому сниппет ставит в ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL id модели каталога; без них фоновые вызовы получают model_not_found. Любую модель можно заменить другой со страницы «Модели», например дешёвой для уровня Haiku.
Claude Code шлёт заголовок x-claude-code-session-id: по нему вызовы одного сеанса попадают в один кэш.
Поля Messages
| Поле | Что с ним происходит | Примечание |
|---|---|---|
messages | проходит к хосту как прислано | |
system | проходит к хосту как прислано | |
tools | проходит к хосту как прислано | |
tool_choice | проходит к хосту как прислано | |
temperature | проходит к хосту как прислано | |
top_p | проходит к хосту как прислано | |
top_k | проходит к хосту как прислано | |
stop_sequences | проходит к хосту как прислано | |
thinking | проходит к хосту как прислано | |
output_config | проходит к хосту как прислано | |
output_format | проходит к хосту как прислано | |
cache_control | проходит к хосту как прислано | |
context_management | проходит к хосту как прислано | |
model | заменяется: его читает API, хост получает значение API | |
max_tokens | заменяется: его читает API, хост получает значение API | |
stream | заменяется: его читает API, хост получает значение API | |
metadata | заменяется: его читает API, хост получает значение API | |
models | заменяется: его читает API, хост получает значение API | |
provider | заменяется: его читает API, хост получает значение API | |
plugins | заменяется: его читает API, хост получает значение API | |
service_tier | принимается и отбрасывается | |
mcp_servers | отклоняется с 400 | mcp_servers and container run on Anthropic's own servers, which this API does not reach. |
container | отклоняется с 400 | mcp_servers and container run on Anthropic's own servers, which this API does not reach. |
extra_body | отклоняется с 400 | extra_body, extra_headers, extra_query and timeout are SDK request options, merged by the SDK before the request is sent; send their fields at the top level of the body. |
extra_headers | отклоняется с 400 | extra_body, extra_headers, extra_query and timeout are SDK request options, merged by the SDK before the request is sent; send their fields at the top level of the body. |
extra_query | отклоняется с 400 | extra_body, extra_headers, extra_query and timeout are SDK request options, merged by the SDK before the request is sent; send their fields at the top level of the body. |
timeout | отклоняется с 400 | extra_body, extra_headers, extra_query and timeout are SDK request options, merged by the SDK before the request is sent; send their fields at the top level of the body. |
Как дойдёт тело, зависит от хоста, который ответит (wires у хоста в GET /v1/models):
- Хост сам говорит на Messages (
messagesвwires). Он получает поля тела, которые знает API, с нашимиmodel,max_tokensи ключом разговора вmetadata.user_id. Меткиcache_controlдоходят как есть, кроме ключейttlиscope. - Хост говорит только на Chat Completions. Тело переводится. Дополнительно не применяются
top_k,cache_controlверхнего уровня,context_management,citationsу текстовых блоков,signatureу блоков рассуждений и блокиredacted_thinking. Отклоняются с400блокиdocument,search_result,container_uploadи картинка с источникомfile. Текстовые блоки одного сообщения соединяются пустой строкой, а рассуждение хода ассистента идёт перед его текстом и вызовами инструментов: другого порядка в сообщении Chat Completions нет.
tools и tool_choice передаются в форме инструментов Anthropic (tool_use, tool_result). Инструменты исполняете вы. Серверные инструменты Anthropic (web_search, bash, text_editor, computer и другие), mcp_servers и container выполняются на серверах Anthropic, куда этот API не ходит, и отклоняются с 400.
Заголовок anthropic-beta
Значение anthropic-beta либо передаётся хосту, который говорит на Messages, либо отбрасывается. Неизвестное значение отбрасывается, а не отклоняется: Claude Code добавляет новые беты с каждым выпуском, и вызов не должен на них ломаться.
| Значение anthropic-beta | Что с ним происходит |
|---|---|
claude-code-20250219 | проходит к хосту как прислано |
interleaved-thinking-2025-05-14 | проходит к хосту как прислано |
fine-grained-tool-streaming-2025-05-14 | проходит к хосту как прислано |
token-efficient-tools-2025-02-19 | проходит к хосту как прислано |
prompt-caching-2024-07-31 | проходит к хосту как прислано |
context-management-2025-06-27 | проходит к хосту как прислано |
effort-2025-11-24 | проходит к хосту как прислано |
structured-outputs-2025-11-13 | проходит к хосту как прислано |
context-1m-2025-08-07 | принимается и отбрасывается |
extended-cache-ttl-2025-04-11 | принимается и отбрасывается |
fast-mode-2026-02-01 | принимается и отбрасывается |
output-128k-2025-02-19 | принимается и отбрасывается |
output-300k-2026-03-24 | принимается и отбрасывается |
oauth-2025-04-20 | принимается и отбрасывается |
prompt-caching-scope-2026-01-05 | принимается и отбрасывается |
advanced-tool-use-2025-11-20 | принимается и отбрасывается |
files-api-2025-04-14 | принимается и отбрасывается |
mcp-client-2025-11-20 | принимается и отбрасывается |
code-execution-2025-08-25 | принимается и отбрасывается |
web-search-2025-03-05 | принимается и отбрасывается |
web-fetch-2025-09-10 | принимается и отбрасывается |
computer-use-2025-11-24 | принимается и отбрасывается |
skills-2025-10-02 | принимается и отбрасывается |
advisor-tool-2026-03-01 | принимается и отбрасывается |
Отбрасываются беты, которые меняют цену (длинное окно, часовой кэш, быстрый режим, увеличенный ответ), и возможности серверов Anthropic (файлы, MCP, исполнение кода, веб-поиск, компьютер, навыки).
Ответ и стоимость
id ответа имеет вид msg_…, как у Anthropic. usage той же формы, что у Anthropic: input_tokens (только не прочитанное из кэша), output_tokens, cache_read_input_tokens, cache_creation_input_tokens и разбивка записи по уровням в cache_creation, без cost. Идентификатор вызова gen-… приходит в заголовке x-request-id, по нему GET /v1/generation отдаёт стоимость (см. «Учёт и стоимость»).
Кроме заголовков минуты x-ratelimit-* ответ несёт заголовки Anthropic anthropic-ratelimit-requests-* и anthropic-ratelimit-tokens-* со сбросом в RFC 3339 (см. «Лимиты частоты»). Ошибка приходит в форме Anthropic: {"type": "error", "error": {"type", "message"}, "request_id"}.
Подсчёт токенов
POST /v1/messages/count_tokens принимает тело Messages (model, messages, system, tools) и отвечает {"input_tokens": n}, посчитанным так же, как считается резерв вызова. Ничего не списывается, scope models:read. В Anthropic SDK это client.messages.count_tokens(...).
Частые вопросы
Зачем Claude Code переменные ANTHROPIC_DEFAULT_*_MODEL?
Кроме ANTHROPIC_MODEL Claude Code сам зовёт модели уровней Opus, Sonnet и Haiku (Haiku для фоновых задач) по их именам у Anthropic. Таких id в нашем каталоге нет, и без этих переменных фоновые вызовы получают model_not_found. Сниппет ставит во все три id модели каталога.
Почему в ответе Messages нет usage.cost?
usage на проводе Messages той же формы, что у Anthropic. Цену вызова отдаёт GET /v1/generation?id=gen-…, где gen-… берётся из заголовка x-request-id ответа.