---
title: "Claude Code и формат Anthropic"
description: "Claude Code и SDK Anthropic на открытых моделях за рубли: адрес https://veselo.ai, ключ sk-vsl-… и метод POST /v1/messages в формате Anthropic Messages."
url: https://veselo.ai/docs/anthropic
updated: 2026-11-14T20:55:06.831Z
---

# Claude Code и формат Anthropic

Claude Code и SDK Anthropic на открытых моделях за рубли: адрес https://veselo.ai, ключ sk-vsl-… и метод POST /v1/messages в формате Anthropic Messages.

Обновлено: 14 ноября 2026 г.

Программы, которые говорят с нейросетью в формате Anthropic Messages, — Claude Code, SDK Anthropic для Python и JavaScript и другие — работают с Весело без доработок. Им нужны адрес `https://veselo.ai`, ключ `sk-vsl-…` и id текстовой модели из [списка](https://veselo.ai/docs/models). Метод — `POST https://veselo.ai/v1/messages`.

> Моделей Claude у нас нет: Anthropic не работает с Россией. Формат тот же, а отвечают открытые модели из [каталога](https://veselo.ai/models) — например `deepseek/deepseek-v4.1-flash-ultrafast`. Запрос с моделью `claude-…` вернёт 404 `model_not_found`.

## Claude Code

1. Выпусти в [кабинете](https://veselo.ai/developer) отдельный ключ для Claude Code и поставь ему месячный лимит: каждый шаг Claude Code — платный запрос.
2. Пополни [API-счёт](https://veselo.ai/developer/wallet).
3. Задай переменные окружения, как в примере ниже, и запусти `claude` в том же терминале. Или впиши их в блок `env` файла `~/.claude/settings.json` — тогда они действуют всегда.

**Терминал**

```
export ANTHROPIC_BASE_URL="https://veselo.ai"
export ANTHROPIC_AUTH_TOKEN="$VESELO_API_KEY"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="1048576"
claude
```

**settings.json**

```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://veselo.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-vsl-…",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1048576"
  }
}
```

- `ANTHROPIC_BASE_URL` — без `/v1` на конце: Claude Code сам допишет `/v1/messages`.
- `ANTHROPIC_AUTH_TOKEN` — ключ `sk-vsl-…`, Claude Code передаёт его в заголовке `Authorization: Bearer`. Пустой `ANTHROPIC_API_KEY` нужен, чтобы вместо нашего ключа не ушёл другой — например, ключ Anthropic из твоих переменных окружения.
- Модели — во всех пяти переменных: Claude Code зовёт и «быструю» модель для фоновых задач, и модели помощников. Если какую-то не задать, её запросы уйдут к модели Claude и получат 404 `model_not_found`.
- Модели можно взять разные: посильнее — в `ANTHROPIC_MODEL`, подешевле — в `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Цены — в [каталоге](https://veselo.ai/models).
- `CLAUDE_CODE_MAX_CONTEXT_TOKENS` — сколько токенов модель помнит. Наших моделей Claude Code не знает: он предупредит об этом и будет считать, что их контекст — 200 000 токенов. У DeepSeek V4.1 Flash Ultrafast — 1 048 576. С верным числом Claude Code вовремя сожмёт разговор, а иначе длинная сессия упрётся в ошибку 400. У других моделей число своё.

> Claude Code просит ответ до 32 000 токенов, и на время каждого шага удерживается цена такого ответа. Если модель отвечает 400 из-за длины ответа или хочется удерживать меньше, задай `CLAUDE_CODE_MAX_OUTPUT_TOKENS`, например `8192`. Если потолок ответа модели известен (`max_output_tokens` в `GET https://veselo.ai/v1/models`), сервер сам уменьшает до него слишком большой `max_tokens`.

Цену в `/cost` Claude Code считает сам, по ценам моделей Claude, — с нашей она не совпадает. Сколько стоил запрос на самом деле — `usage.cost_rub` и расход в [кабинете](https://veselo.ai/developer).

**Что не работает.** Поиск в интернете (WebSearch) Claude Code делает инструментом сервера Anthropic — у нас таких инструментов нет, запрос с ним получит 400 `invalid_request`. PDF модели не получают: вместо документа в разговор встаёт пометка, что его нет; текст и картинки проходят. Подсчёта токенов (`/v1/messages/count_tokens`) нет — ответ 404.

MCP-сервер Весело — другое: Claude Code остаётся на своей модели и через MCP сам снимает видео, рисует картинки и спрашивает наши модели. Как подключить — [MCP-сервер](https://veselo.ai/docs/mcp#claude-code).

## Запрос

`POST https://veselo.ai/v1/messages`. Ключ — в `x-api-key: sk-vsl-…`, как у SDK Anthropic, или в `Authorization: Bearer sk-vsl-…`. Заголовок `anthropic-version` принимаем любой, но он не обязателен; `anthropic-beta` не учитываем.

| Поле | Что с ним делаем |
| --- | --- |
| `model` | обязательно: id текстовой модели из `GET /v1/models` |
| `max_tokens` | обязательно: потолок длины ответа, от него зависит удержание; больше `max_output_tokens` модели — уменьшаем до него |
| `messages` | роли `user`, `assistant` и `system`; `content` — строка или блоки `text`, `image` (base64 или url), `document` с текстом, `tool_use`, `tool_result`, `thinking` |
| `system` | строка или блоки `text` |
| `stream` | ответ потоком SSE в формате Anthropic |
| `temperature`, `top_p`, `top_k` | передаём модели |
| `stop_sequences` | на чём остановиться |
| `tools` | свои инструменты с `input_schema`; инструменты сервера Anthropic (`web_search`, `code_execution` и другие) — 400 |
| `tool_choice` | `auto`, `any`, `tool`, `none` и `disable_parallel_tool_use` |
| `thinking` | `enabled` или `adaptive`: рассуждения модели, если она их пишет, приходят блоками `thinking`. Длину рассуждений поле не задаёт — модели думают по-своему |
| `provider` | наше поле — выбор провайдера модели, как в разделе [Провайдеры](https://veselo.ai/docs/providers) |

Прочие поля — `metadata`, `cache_control`, `service_tier` и другие — принимаем, но нейросети не передаём. Блоки `thinking` из прошлых ответов тоже не передаём: нашим моделям их не прочитать. Вместо PDF и других файлов в `document` модель видит пометку. `mcp_servers` — 400: MCP-серверы из запроса мы не подключаем.

Сообщения `system` в середине разговора (так делает Claude Code) многие модели не принимают, поэтому они доходят до модели текстом в сообщении `user`, в тегах `<system-reminder>`. Сообщения одной роли подряд склеиваем в одно — так делает и Anthropic.

## Ответ

Сообщение Anthropic: `id` вида `msg_req_…`, в `content` — блоки `text`, `tool_use` и, если включён `thinking`, `thinking`. `stop_reason` — `end_turn`, `max_tokens`, `tool_use` или `refusal` (отказ фильтра); `stop_sequence` — если модель сообщила, на какой строке из `stop_sequences` остановилась. В `usage` — `input_tokens` (без входа из кэша), `cache_read_input_tokens`, `output_tokens` и цена в рублях `cost_rub`; без потока та же цена — в заголовке `x-veselo-cost-rub`.

**curl**

```
curl https://veselo.ai/v1/messages \
  -H "x-api-key: $VESELO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4.1-flash-ultrafast",
    "max_tokens": 300,
    "messages": [{"role": "user", "content": "Объясни в двух предложениях, что такое API."}]
  }'
```

**Python**

```
import os
import anthropic  # pip install anthropic

client = anthropic.Anthropic(base_url="https://veselo.ai", api_key=os.environ["VESELO_API_KEY"])
msg = client.messages.create(
    model="deepseek/deepseek-v4.1-flash-ultrafast",
    max_tokens=300,
    messages=[{"role": "user", "content": "Объясни в двух предложениях, что такое API."}],
)
print("".join(b.text for b in msg.content if b.type == "text"))
```

**JavaScript**

```
import Anthropic from '@anthropic-ai/sdk'; // npm i @anthropic-ai/sdk

const client = new Anthropic({ baseURL: 'https://veselo.ai', apiKey: process.env.VESELO_API_KEY });
const msg = await client.messages.create({
  model: 'deepseek/deepseek-v4.1-flash-ultrafast',
  max_tokens: 300,
  messages: [{ role: 'user', content: 'Объясни в двух предложениях, что такое API.' }],
});
console.log(msg.content.filter((b) => b.type === 'text').map((b) => b.text).join(''));
```

**Ответ**

```
{
  "id": "msg_req_6f1c…",
  "type": "message",
  "role": "assistant",
  "model": "deepseek/deepseek-v4.1-flash-ultrafast",
  "content": [{ "type": "text", "text": "API — это способ, которым одна программа просит другую что-то сделать…" }],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 18,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 64,
    "cost_rub": 0.01
  }
}
```

SDK Anthropic сами дописывают `/v1/messages` к адресу, поэтому в `base_url` — `https://veselo.ai` без `/v1`.

## Поток

С `stream: true` ответ идёт событиями Anthropic: `message_start`; затем блоки — `content_block_start`, `content_block_delta` (`text_delta`, `thinking_delta`, `input_json_delta`) и `content_block_stop`; потом `message_delta` с `stop_reason` и `usage` и в конце `message_stop`. Цена в рублях — `usage.cost_rub` в `message_delta`. Если долго нет новых событий — например, модель думает молча, — приходят события `ping`.

Аргументы инструмента приходят одним куском `input_json_delta`, когда модель дописала вызов. Ошибка посреди потока — событие `error`, после него событий нет. Оборванный поток стоит столько, сколько модель успела написать, — как у [стриминга](https://veselo.ai/docs/streaming) в формате OpenAI.

**Python**

```
with client.messages.stream(
    model="deepseek/deepseek-v4.1-flash-ultrafast",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Напиши короткое стихотворение о Москве."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
```

**События**

```
event: message_start
data: {"type":"message_start","message":{"id":"msg_req_6f1c…","type":"message","role":"assistant","model":"deepseek/deepseek-v4.1-flash-ultrafast","content":[],"stop_reason":null,"stop_sequence":null,"usage":{"input_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":0}}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Москва"}}

event: content_block_stop
data: {"type":"content_block_stop","index":0}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":21,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":48,"cost_rub":0.01}}

event: message_stop
data: {"type":"message_stop"}
```

В `message_start` токенов ещё нет — настоящие числа приходят в `message_delta`, когда модель закончила.

## Ошибки

Ошибки `/v1/messages` — в формате Anthropic, SDK Anthropic понимают их без доработок. Коды и тексты — те же, что в разделе [Ошибки](https://veselo.ai/docs/errors): постоянный `code` лежит внутри `error`, рядом — `param` и поля вроде `required_rub`. Тип — как у Anthropic: 402 — `billing_error`, 413 — `request_too_large`, 503 `model_unavailable` — `overloaded_error`, 504 — `timeout_error`.

**Ответ 402**

```
{
  "type": "error",
  "error": {
    "type": "billing_error",
    "message": "Не хватает денег на балансе для этого запроса.",
    "code": "insufficient_balance",
    "required_rub": 1.37,
    "available_rub": 0,
    "topup_url": "https://veselo.ai/developer/wallet"
  },
  "request_id": "req_6f1c…"
}
```

Деньги и лимиты — как у `/chat/completions`: удержание по `max_tokens`, списание по факту, ошибка нейросети не стоит денег; 60 запросов в минуту и 10 одновременных на ключ. Подробнее — [Цены и списания](https://veselo.ai/docs/pricing) и [Лимиты](https://veselo.ai/docs/limits).

[← SDK и программы](https://veselo.ai/docs/sdks) · [Ключ для нейросети →](https://veselo.ai/docs/agents)

[Вся документация одним текстом](https://veselo.ai/docs/llms.txt) · [Все модели и цены](https://veselo.ai/models)

## Разделы документации

### Начало

- [Быстрый старт](https://veselo.ai/docs)
- [Ключи](https://veselo.ai/docs/auth)
- [Цены и списания](https://veselo.ai/docs/pricing)
- [Модели](https://veselo.ai/docs/models)

### Как сделать

- [Сообщения и параметры](https://veselo.ai/docs/chat)
- [Стриминг](https://veselo.ai/docs/streaming)
- [Вызов функций](https://veselo.ai/docs/tools)
- [Ответ в JSON](https://veselo.ai/docs/structured-output)
- [Провайдеры](https://veselo.ai/docs/providers)
- [Без цензуры](https://veselo.ai/docs/uncensored)
- [Картинки во входе](https://veselo.ai/docs/vision)
- [Картинки](https://veselo.ai/docs/images)
- [Видео](https://veselo.ai/docs/video)
- [Озвучка](https://veselo.ai/docs/speech)
- [Музыка](https://veselo.ai/docs/music)
- [SDK и программы](https://veselo.ai/docs/sdks)
- **Claude Code**
- [Ключ для нейросети](https://veselo.ai/docs/agents)
- [MCP](https://veselo.ai/docs/mcp)

### Справочник

- [Методы API](https://veselo.ai/docs/reference)
- [Ошибки](https://veselo.ai/docs/errors)
- [Лимиты](https://veselo.ai/docs/limits)
- [Заголовки](https://veselo.ai/docs/headers)

### Ещё

- [Вопросы](https://veselo.ai/docs/faq)
- [Данные и приватность](https://veselo.ai/docs/privacy)
- [Изменения](https://veselo.ai/docs/changelog)
