# Anthropic SDK и Claude Code

`POST /v1/messages` принимает запрос в форме Anthropic Messages и отвечает в ней же, целиком или потоком. Поэтому Anthropic SDK и Claude Code работают со сменой адреса и ключа. Модель берётся из того же каталога, что на [проводе OpenAI](/docs/model-api-requests), и выбирается теми же `provider` и `models` (см. [«Маршрутизация и кэш»](/docs/model-api-routing)).

## Адрес и ключ

Anthropic SDK и Claude Code сами дописывают `/v1/messages`, поэтому им нужен адрес без пути: `https://api.samreshuuu.ru`. Ключ API моделей Anthropic SDK шлёт в `x-api-key`, Claude Code в `Authorization: Bearer`; принимаются оба. Ключ выпускается в [консоли разработчика](https://platform.samreshuuu.ru).

## 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`. Любую модель можно заменить другой со страницы [«Модели»](/models), например дешёвой для уровня Haiku.

Claude Code шлёт заголовок `x-claude-code-session-id`: по нему вызовы одного сеанса попадают в один [кэш](/docs/model-api-routing#кэш-промпта).

## Поля 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` отдаёт стоимость (см. [«Учёт и стоимость»](/docs/model-api-requests#учёт-и-стоимость)).

Кроме заголовков минуты `x-ratelimit-*` ответ несёт заголовки Anthropic `anthropic-ratelimit-requests-*` и `anthropic-ratelimit-tokens-*` со сбросом в RFC 3339 (см. [«Лимиты частоты»](/docs/model-api#лимиты-частоты)). Ошибка приходит в форме 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(...)`.
