Как мы подключали Claude API из России. Новая линейка моделей и счёт за токены

Сразу дисклеймер: мы делаем Polza AI — агрегатор доступа к моделям. Заинтересованность очевидная, поэтому официальный путь через Anthropic описываем так же подробно, как обходной, и честно пишем, где он выгоднее нашего.

Повод для статьи возник, когда мы переносили собственные сервисы на новую линейку. За два месяца Anthropic обновила почти весь модельный ряд: в июне вышли Fable 5 и Sonnet 5, 24 июля 2026 года — Opus 5. Одновременно у Sonnet 5 сменился токенизатор, у Opus 5 появился параметр effort, а старые связки начали возвращать ошибки там, где раньше работали. Русскоязычные гайды при этом в большинстве своём написаны в 2024–2025 годах и рассказывают про Claude 3, которого в актуальной линейке уже нет.

Ниже — то, что мы проверили руками: во что реально обходится запрос, где упирается официальная регистрация, что меняется в коде при работе через посредника и почему Claude Code час возвращал нам 403 на рабочем ключе.

Подписка и API — это два разных продукта

Путаница возникает регулярно, поэтому короткая развилка. Claude Pro и Max — доступ к чату на claude.ai и приложениям за фиксированную сумму в месяц. Claude API — программный доступ к моделям по HTTP: запрос на /v1/messages, ответ в JSON, оплата по токенам. Подписка не выдаёт API-ключ, ключ не открывает чат.

Пограничный случай один — Claude Code: он работает и от подписки Max, и от API-ключа. Что выгоднее, посчитаем ниже.

Что поменялось в линейке за два месяца

Если в гайде фигурируют Claude 3 Opus или Claude 3.5 Sonnet — гайд можно закрывать: первые поколения Anthropic постепенно отключает, и закладывать их в новый проект нельзя.

Предыдущее поколение — Opus 4.8 и Sonnet 4.6 — пока доступно по прежним ценам, 5 $ / 25 $ и 3 $ / 15 $. Это пригодится, если продукт завязан на поведение конкретной версии: смена модели меняет формулировки, длину ответов и иногда формат JSON, который вы парсите.

Три детали, из-за которых мы переписывали код, а не просто меняли строку с названием модели:

У Opus 5 появился параметр effort — низкий, средний, высокий уровень «усилий». Это регулятор баланса между качеством ответа и расходом токенов прямо в запросе. На типовых задачах низкий уровень даёт заметную экономию без видимой просадки, на длинных цепочках рассуждений разница уже чувствуется.

У Sonnet 5 другой токенизатор. Тот же текст режется на большее число токенов — примерно в 1,0–1,35 раза в зависимости от контента. Промо-цена 2 $ / 10 $ до 31 августа как раз компенсирует эту разницу. Практический вывод: если вы считаете бюджет по старым логам, умножайте объём на коэффициент, а не переносите цифры один в один.

Claude Mythos 5 существует, но купить его нельзя. Это версия Fable 5 без части ограничений, доступ Anthropic выдаёт только одобренным организациям. Продавцы «ключей Mythos» — скам, других вариантов там нет.

Во что обходится один запрос

Токен — примерно 3–4 символа, страница A4 — около 500–700 токенов. Платите отдельно за ввод (промпт плюс контекст) и вывод (ответ), вывод дороже в пять раз.

Живой пример. Отправляем Sonnet 5 запрос на 2 000 токенов — промпт с куском кода — и получаем ответ на 1 000 токенов:

• ввод: 2 000 × 2 $ / 1 000 000 = 0,004 $

• вывод: 1 000 × 10 $ / 1 000 000 = 0,01 $

• итого 0,014 $

Тот же запрос к Fable 5 стоит 0,07 $, к Haiku 4.5 — 0,007 $. Между крайними моделями десятикратный разрыв, поэтому первое правило экономии простое: не гонять топ-модель там, где справится Haiku. У нас на разметке входящих сообщений переезд с топовой модели на Haiku срезал счёт почти на порядок и не изменил метрику качества.

Два встроенных механизма, которые складываются друг с другом:

Кэширование промптов. Если в каждом запросе повторяется системный промпт или большой документ, его закэшируйте: чтение из кэша стоит 10% от цены ввода. На сценарии «один длинный контекст, много коротких вопросов» это экономия до 90% на повторяющейся части.

Batch API. Запросы, которым не нужен мгновенный ответ — ночная обработка, массовая генерация — отправляются пачкой со скидкой 50%. Ответ приходит обычно в течение часа, максимум за сутки.

Официальная регистрация упирается в три стены

Ключи выдаются в консоли разработчика на platform.claude.com. Порядок такой: регистрация с подтверждением по номеру телефона, раздел API Keys, кнопка Create Key, понятное имя ключу по названию проекта. Ключ показывается целиком один раз — копируйте сразу. Формат — строка, начинающаяся с sk-ant-. Без положительного баланса в разделе Billing запросы вернут ошибку.

Ключ храните как пароль: переменные окружения или менеджер секретов. Ключ, закоммиченный в публичный репозиторий, боты находят за минуты, и вы оплачиваете чужие запросы, пока Anthropic не заблокирует его.

Теперь то, о чём молчит половина гайдов. Россия не входит в список поддерживаемых регионов: консоль не принимает российские номера при регистрации и российские карты при оплате, а запросы с российских IP возвращают 403. Стены три — номер, карта, регион доступа — и обойти надо все.

Если у вас есть зарубежное юрлицо или карта иностранного банка, официальный путь оптимален: цены без наценки, весь функционал платформы, новые модели в день релиза. Если нет — сбор этого набора занимает больше времени, чем сама интеграция, а аккаунт живёт ровно до того момента, пока Anthropic не заметит несоответствие региона.

Обход через агрегатор: что меняется в коде

Агрегатор — посредник с собственным доступом к моделям. Он выдаёт свой ключ и эндпоинт, совместимый с API Anthropic или OpenAI, и проксирует запросы. По этой схеме работаем мы.

На практике замена выглядит так: SDK остаётся привычным, меняется базовый адрес, а к названию модели добавляется префикс провайдера.

python

from openai import OpenAI

client = OpenAI(
    base_url="https://polza.ai/api/v1",
    api_key="<POLZA_AI_API_KEY>",
)
completion = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[{"role": "user", "content": "Привет"}],
)

Тот же префикс переключает запрос на GPT или Gemini — остальной код не трогается. Ради этого схему обычно и берут даже там, где с картой проблем нет: один ключ и один счёт вместо четырёх кабинетов, когда нужно сравнить модели или настроить фолбэк между провайдерами.

Минусы называем честно. Первый — наценка: посредник зарабатывает на марже к токенам, поэтому сравнивайте тарифы с ценами из каталога Anthropic. Второй — задержка: новые модели появляются от нескольких часов до нескольких дней после релиза. Третий, менее очевидный — часть функционала платформы Anthropic (Files API, Admin API, тонкие настройки батчей) у посредников либо урезана, либо реализована по-своему. Если вы завязаны на них, проверяйте до интеграции, а не после.

Проверить связку за две минуты

Примеры ниже — для официального эндпоинта. У агрегаторов чаще другой стандарт, OpenAI Chat Completions: там меняется и базовый URL, и SDK, как в коде выше.

Python:

bash

pip install anthropic

python

import anthropic

client = anthropic.Anthropic()  # ключ берётся из ANTHROPIC_API_KEY
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="Отвечай кратко, на русском языке.",
    messages=[
        {"role": "user", "content": "Объясни, чем HTTP/2 отличается от HTTP/1.1"}
    ]
)
print(message.content[0].text)
print(f"Токенов: {message.usage.input_tokens} на ввод, {message.usage.output_tokens} на вывод")

Ключ в код не вписывайте:

bash

export ANTHROPIC_API_KEY="sk-ant-..."

JavaScript / TypeScript:

bash

npm install @anthropic-ai/sdk

javascript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // ключ из ANTHROPIC_API_KEY
const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Напиши функцию дебаунса на JavaScript" }],
});
console.log(message.content[0].text);

cURL — когда надо просто убедиться, что ключ живой:

bash

curl https://api.anthropic.com/v1/messages 
  -H "x-api-key: $ANTHROPIC_API_KEY" 
  -H "anthropic-version: 2023-06-01" 
  -H "content-type: application/json" 
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Ответь одним словом: работает?"}]
  }'

Три параметра, которые понадобятся почти сразу. max_tokens — обязательный потолок длины ответа, он же страховка от случайного ответа на 20 000 токенов за ваши деньги. system — роль, тон и формат; именно его выгодно кэшировать. temperature от 0 до 1: ноль для извлечения данных, ближе к единице для творческих задач.

Claude Code: пустая переменная, которая стоила часа

Claude Code — агент для программирования: работает в терминале, VS Code и JetBrains, читает кодовую базу, правит файлы, гоняет тесты. Запитывается от подписки Max или от API-ключа.

С официальным ключом всё скучно:

bash

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_API_KEY="sk-ant-..."
claude

При первом запуске агент спросит способ авторизации, дальше каждая сессия списывает токены с баланса консоли.

А вот с ключом от посредника мы потеряли час. Claude Code шлёт обычные запросы Messages API, поэтому агрегатору достаточно переадресовать их у себя, и настройка выглядит так:

bash

export ANTHROPIC_BASE_URL="https://polza.ai/api"
export ANTHROPIC_AUTH_TOKEN="ключ-от-сервиса"
export ANTHROPIC_API_KEY=""

Вся суть в последней строке. Это две разные переменные с разной семантикой: ANTHROPIC_API_KEY уходит заголовком x-api-key и означает «я иду к Anthropic напрямую», ANTHROPIC_AUTH_TOKEN уходит заголовком Authorization: Bearer и предназначен для шлюзов и корпоративных прокси. Claude Code разрешает маршрут по приоритету, и прямой ключ в этой лестнице стоит выше. Оставите в ANTHROPIC_API_KEY старое значение — агент пойдёт на официальный эндпоинт и вернёт 403, хотя оба ключа рабочие. Логи при этом выглядят так, будто виноват посредник.

Отдельная ловушка — переменная, о которой вы забыли: она может лежать в ~/.zshrc, в .env проекта, в настройках devcontainer или в секретах CI. Проверять маршрут надо не по памяти, а командой /status внутри сессии — она показывает, куда реально ходит агент.

Чтобы не держать всё в терминале, тот же блок кладётся в ~/.claude/settings.json (на Windows — %USERPROFILE%.claudesettings.json) в секцию env:

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://polza.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "ключ-от-сервиса",
    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-5"
  }
}

ANTHROPIC_MODEL здесь полезнее, чем кажется: через посредника название модели идёт с префиксом провайдера, и задавать его переменной надёжнее, чем командой /model в сессии.

Подписка или API для Claude Code

Считается просто. Через API агент списывает токены за каждое действие, и на активной разработке набегает заметно: по данным Anthropic, средний разработчик тратит около 13 $ в активный день — это 150–250 $ в месяц. Подписка Max стоит фиксированных денег и включает большой лимит Claude Code.

Правило, к которому мы пришли: кодите каждый день — подписка почти наверняка дешевле. Запускаете агента пару раз в неделю или встраиваете в CI — платите за API по факту. Если остаётесь на API, держите Sonnet 5 моделью по умолчанию и включайте Opus 5 точечно на сложных задачах: это главный рычаг экономии, всё остальное — доли процента рядом с ним.

Что отвечает API, когда что-то идёт не так

Два правила закрывают почти все проблемы со стабильностью. Первое — оберните вызовы в ретраи с экспоненциальной задержкой; официальные SDK умеют это из коробки через параметр max_retries. Второе — настройте фолбэк: если Opus 5 отвечает 529, запрос уходит в Sonnet 5. С июля 2026 года на платформе Anthropic есть и серверный фолбэк с автоматическим перенаправлением на доступную модель.

И прежде чем дебажить свой код при массовых 500 и 529, откройте статусную страницу Anthropic. Мы однажды потратили вечер на «свой» баг, который чинился на их стороне сам.

Лимиты растут сами

Кроме баланса у аккаунта есть rate limits — потолки по запросам в минуту (RPM) и токенам в минуту (ITPM/OTPM). С апреля 2026 года на платформе три тира: Start, Build и Scale. Тир поднимается автоматически по мере трат и времени жизни аккаунта.

На старте лимиты скромные, и для разработки это нормально. Упираетесь в 429 на проде — сначала посмотрите текущий тир в консоли, потом оптимизируйте расход: кэширование срезает входящие токены, батчи выводят массовые задачи из real-time-квоты. У агрегаторов лимиты свои, их надо смотреть в тарифах сервиса.

Про ключи с форумов

Постоянного бесплатного тарифа у Claude API нет — в отличие от того же Gemini с его free tier. Новым аккаунтам консоль периодически начисляет небольшой пробный баланс, но его хватает на знакомство, а не на продакшен. У агрегаторов порог входа ниже: у нас, например, минимальное пополнение 100 ₽, чего достаточно, чтобы собрать интеграцию и посмотреть реальный расход в поле usage, прежде чем считать бюджет проекта.

Чего делать точно не стоит — покупать «безлимитный Claude API» за 200 рублей на маркетплейсах. Это либо ворованные ключи, которые заблокируют вместе с вашими запросами, либо чистый скам. И отдельный риск, о котором вспоминают в последнюю очередь: через чужой ключ проходят ваши промпты и данные.

А если задача — просто попробовать Claude, не пишите код вообще: чат на claude.ai бесплатен и работает на Sonnet 5.

Что бы мы сделали, начиная сегодня

Взяли бы Sonnet 5 моделью по умолчанию и не трогали Opus 5, пока задача не покажет, что он нужен. Проверили бы связку одним curl, а не полноценной интеграцией. До продакшена включили бы кэширование, ретраи и фолбэк — по нашему опыту, это три вещи, которые дописываются задним числом после первого инцидента.

И решили бы вопрос с доступом честно: есть зарубежная карта и номер — идти напрямую к Anthropic, там дешевле и функциональнее. Нет — брать посредника и заложить наценку в расчёт. Мы делаем Polza AI как раз для второго случая: один ключ на Claude, GPT, Gemini и открытые модели, оплата картой, СБП или счётом для юрлиц. Цены по каждой модели лежат в каталоге до регистрации — сравнить с таблицей выше можно, ничего не создавая.

Если будете подключать и споткнётесь — приходите в наш чат, разбираем упавшие связки, в том числе с n8n. Свои грабли мы описали выше, интересно посмотреть на чужие.