Claude Code и формат Anthropic
Claude Code и SDK Anthropic на открытых моделях за рубли: адрес https://veselo.ai, ключ sk-vsl-… и метод POST /v1/messages в формате Anthropic Messages.
Обновлено:
Программы, которые говорят с нейросетью в формате Anthropic Messages, — Claude Code, SDK Anthropic для Python и JavaScript и другие — работают с Весело без доработок. Им нужны адрес https://veselo.ai, ключ sk-vsl-… и id текстовой модели из списка. Метод — POST https://veselo.ai/v1/messages.
Моделей Claude у нас нет: Anthropic не работает с Россией. Формат тот же, а отвечают открытые модели из каталога — например
deepseek/deepseek-v4.1-flash-ultrafast. Запрос с модельюclaude-…вернёт 404model_not_found.
Claude Code
- Выпусти в кабинете отдельный ключ для Claude Code и поставь ему месячный лимит: каждый шаг Claude Code — платный запрос.
- Пополни API-счёт.
- Задай переменные окружения, как в примере ниже, и запусти
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"
claudesettings.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. Цены — в каталоге. 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 и расход в кабинете.
Что не работает. Поиск в интернете (WebSearch) Claude Code делает инструментом сервера Anthropic — у нас таких инструментов нет, запрос с ним получит 400 invalid_request. PDF модели не получают: вместо документа в разговор встаёт пометка, что его нет; текст и картинки проходят. Подсчёта токенов (/v1/messages/count_tokens) нет — ответ 404.
MCP-сервер Весело — другое: Claude Code остаётся на своей модели и через MCP сам снимает видео, рисует картинки и спрашивает наши модели. Как подключить — MCP-сервер.
Запрос
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 | наше поле — выбор провайдера модели, как в разделе Провайдеры |
Прочие поля — 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, после него событий нет. Оборванный поток стоит столько, сколько модель успела написать, — как у стриминга в формате 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 понимают их без доработок. Коды и тексты — те же, что в разделе Ошибки: постоянный 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 одновременных на ключ. Подробнее — Цены и списания и Лимиты.