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

bash
export ANTHROPIC_BASE_URL="https://api.samreshuuu.ru" export ANTHROPIC_AUTH_TOKEN="$SAMRESHUUU_API_KEY" export ANTHROPIC_MODEL="deepseek/deepseek-v4.1-flash" export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek/deepseek-v4.1-flash" export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek/deepseek-v4.1-flash" export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek/deepseek-v4.1-flash" claude

Кроме 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отклоняется с 400mcp_servers and container run on Anthropic's own servers, which this API does not reach.
containerотклоняется с 400mcp_servers and container run on Anthropic's own servers, which this API does not reach.
extra_bodyотклоняется с 400extra_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отклоняется с 400extra_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отклоняется с 400extra_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отклоняется с 400extra_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 ответа.

Была ли страница полезна?