CoreCodeБлог

Руководство

Claude API из России: как подключиться через прокси

Опубликовано · Проверено

Официальный Claude API из России недоступен: Россия не входит в список поддерживаемых регионов Anthropic. Если вы вызываете API из кода, а не работаете в Claude Code, можно направить SDK или curl на Anthropic-совместимый прокси. В CoreCode для этого нужны базовый адрес https://corecode.live и ключ из группы «Claude 满血(可外接)». Ниже показаны curl, Python и Node, маршрут в формате OpenAI, ссылки на цены и способ оплаты, который нужно знать заранее.

Главное
  • Россия не входит в список поддерживаемых регионов Anthropic, поэтому запросы к официальному API оттуда отклоняются.
  • CoreCode принимает запросы Anthropic Messages по адресу https://corecode.live/v1/messages; в SDK достаточно указать base_url (Python) или baseURL (Node).
  • Для SDK и curl нужен ключ группы «Claude 满血(可外接)»; группа «Claude 满血(仅限CC)» принимает только клиентов Claude Code.
  • Оплата только через Alipay или WeChat Pay в юанях по курсу ¥1 = $1 кредита. Российских карт, СБП и криптовалюты нет.
  • Мы не обещаем доступность или скорость из вашей сети и не даём советов по обходу ограничений.

Почему официальный API отклоняет запросы из России

Anthropic публикует Supported Regions Policy, и Россия в этом списке отсутствует. Запрос к api.anthropic.com из неподдерживаемого региона отклоняется на стороне Anthropic, а использование аккаунта оттуда нарушает условия сервиса. Это касается и Claude Code, и вызовов из собственного кода. Как с этим обстоит дело у пользователей Claude Code, мы разобрали отдельно: Claude Code в России. Эта статья про разработчиков, которые вызывают API из SDK или curl.

Мы не описываем способы обхода региональных ограничений и не рекомендуем VPN. Прокси в этой статье — это другой адрес API, а не способ скрыть своё местоположение: ваши запросы идут на corecode.live, и отвечают на них официальные аккаунты Claude.

Что нужно: адрес, ключ и группа

Пример на curl

Формат запроса тот же, что в справочнике Anthropic по Messages API: заголовки x-api-key, anthropic-version: 2023-06-01 и content-type. Меняется только адрес.

curl https://corecode.live/v1/messages \
  -H "x-api-key: sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "reply ok"}]
  }'

Если в ответе content[0].text равно ok, подключение работает. Запрос появится в журнале использования в консоли.

Anthropic SDK: Python и Node

Оба SDK сами добавляют путь /v1/messages, поэтому в base_url указывается только адрес без /v1. Переменная окружения ANTHROPIC_BASE_URL тоже подходит: SDK читает её, если адрес не задан в коде.

import anthropic

client = anthropic.Anthropic(
    base_url="https://corecode.live",
    api_key="sk-your-key",
)
message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "reply ok"}],
)
print(message.content[0].text)

Установка: pip install anthropic или npm install @anthropic-ai/sdk. Метки cache_control и заголовки anthropic-beta передаются в Anthropic без изменений, подробнее — в разделе Кэширование и оплата.

Маршрут, совместимый с OpenAI

Кроме Messages, CoreCode принимает POST /v1/chat/completions. В /api/pricing для claude-sonnet-5-5 указаны два типа эндпоинтов: anthropic и openai. Значит, если ваш код уже написан под OpenAI SDK, можно указать base_url="https://corecode.live/v1" и имя модели Claude; ключ по-прежнему должен быть из группы 可外接. Пример для OpenAI SDK и модели других вендоров описаны в разделе OpenAI SDK и совместимые клиенты. Для Claude родной формат Messages предпочтительнее, потому что он передаёт все параметры Anthropic без преобразования.

Сколько это стоит

Официальные цены Anthropic за миллион токенов приведены в статье Цены Claude API: например, Sonnet 5.5 — $2 за вход и $10 за выход. Цены CoreCode по группам и моделям публикуются на странице /docs/ru/pricing/; группа 可外接 стоит немного дороже группы 仅限CC. Прикинуть расходы на свою нагрузку можно в статье Калькулятор стоимости Claude API.

Оплата: честно о главном ограничении

CoreCode принимает оплату только через Alipay или WeChat Pay в китайских юанях; ¥1 даёт $1 кредита. Оплаты российскими банковскими картами, через СБП или криптовалютой нет. Если у вас нет доступа к Alipay или WeChat Pay, этот вариант вам не подойдёт, и лучше узнать об этом до регистрации. Как пополнить баланс и создать ключ, описано в руководстве для новых пользователей.

Что мы не обещаем

FAQ

Можно ли использовать Claude API из России?

Официальный API Anthropic из России недоступен, потому что Россия не входит в список поддерживаемых регионов. Прокси CoreCode принимает запросы в формате Anthropic Messages на https://corecode.live/v1/messages, но доступность из вашей сети мы не гарантируем, а оплата возможна только через Alipay или WeChat Pay.

Какой ключ нужен для SDK и curl?

Ключ из группы «Claude 满血(可外接)». Ключ группы «Claude 满血(仅限CC)» работает только с Claude Code и отклонит запросы SDK и curl.

Какой base URL указать в Anthropic SDK?

https://corecode.live, без /v1: SDK добавляет /v1/messages сам. Можно задать его и через переменную ANTHROPIC_BASE_URL.

Работает ли OpenAI SDK с моделями Claude?

Да: /v1/chat/completions поддерживается, а для claude-sonnet-5-5 в списке цен указаны типы эндпоинтов anthropic и openai. См. страницу про OpenAI SDK.

Сколько стоит Claude API через CoreCode?

Цены по группам приведены на странице цен; официальные цены Anthropic — в статье Цены Claude API. Группа 可外接 немного дороже группы 仅限CC.

Чем это отличается от Claude Code через прокси?

Claude Code настраивается переменными ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN и может использовать более дешёвую группу 仅限CC; настройка описана в Claude Code в России. Для кода с SDK или curl нужна группа 可外接.

Можно ли оплатить российской картой или через СБП?

Нет. Принимаются только Alipay и WeChat Pay в юанях.

Источники