Claude API в России — ключ и оплата в рублях

Что такое Claude API

Anthropic — компания-разработчик моделей Claude. Claude API — программный доступ к этим моделям: приложение отправляет запрос в формате Anthropic Messages и получает ответ модели. Через ProxyAPI формат запросов и ответов остаётся тем же, меняются только адрес и ключ, поэтому код под API Anthropic переносится без переписывания.

Модели называются в форме vendor/name, например anthropic/claude-sonnet-5-5. Доступные модели Claude с ценами показаны выше, полный каталог всех вендоров — на странице моделей.

Как получить API-ключ Claude

1. Зарегистрируйтесь в личном кабинете и подтвердите почту по ссылке из письма.
2. В разделе «Ключи API» создайте ключ. Он начинается с sk- и показывается целиком только один раз, поэтому сохраните его сразу.
3. Пополните баланс: пока он пуст, запросы возвращают ошибку 402.

Аккаунт у Anthropic и ключ Anthropic не нужны. Ключ ProxyAPI работает только с адресом ProxyAPI: с api.anthropic.com он вернёт 401. Для ключа можно ограничить список моделей, задать бюджет и белый список IP-адресов — подробнее в статье API-ключи.

Как оплатить Claude API из России

Баланс пополняется в рублях банковской картой или через СБП в разделе «Баланс» личного кабинета, зачисление происходит сразу после оплаты. Зарубежная карта и VPN не нужны.

Цены в каталоге указаны за миллион токенов с НДС. Это единица измерения, а не пакет: с баланса списывается стоимость фактически израсходованных токенов, без округления до рубля. Подписок, предоплаченных пакетов и обязательного ежемесячного платежа нет.

Юридические лица оплачивают по счёту: после регистрации договора счёт формируется в кабинете, баланс пополняется после поступления оплаты, как правило в тот же день. Для компаний предоставляются закрывающие документы и доступен электронный документооборот. Автопополнение, уведомления о низком балансе и месячный бюджет описаны в статье Баланс и пополнение.

Пример запроса к Claude API

Официальный SDK ставится обычным способом: pip install anthropic. В base_url указывается хост https://api.proxyapi.ru без сегмента /v1 — SDK сам дописывает /v1/messages. Ключ берётся из переменной окружения PROXY_API_KEY.

pythoncurlnode.js
import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["PROXY_API_KEY"],
    base_url="https://api.proxyapi.ru",
)

message = client.messages.create(
    model="anthropic/claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Объясни в двух предложениях, что такое API."}],
)

print(message.content[0].text)

В формате Anthropic поле max_tokens обязательное. Текст ответа лежит в массиве content, в блоке с типом text. Стриминг, подсчёт токенов и батчи разобраны в статье Формат Anthropic Messages.

Claude через OpenAI-совместимый API

Модели Claude доступны и на эндпоинте /v1/chat/completions, поэтому код на SDK openai менять на SDK Anthropic не обязательно. В этом случае base_url — https://api.proxyapi.ru/v1, а модель указывается целиком, с вендором: anthropic/claude-sonnet-5-5. Короткое имя без anthropic/ на этом эндпоинте вернёт ошибку Model not supported. Как устроены идентификаторы — в статье Модели.

Claude Code через ProxyAPI

Claude Code подключается тем же ключом: в ~/.claude/settings.json задаются ANTHROPIC_BASE_URL со значением https://api.proxyapi.ru и ANTHROPIC_AUTH_TOKEN с ключом ProxyAPI. Пошаговая настройка — в статье Claude Code с ProxyAPI.