Claude Code и Claude API через Modelflare — от ключа до первого запроса

Подключите Claude Code, Python, Node.js или curl через Messages. Проверьте адрес, ключ, доступ к модели и стоимость вызовов.

Claude Code и Claude API через Modelflare — от ключа до первого запроса

Claude Code и SDK Anthropic подключаются к интерфейсу Messages Modelflare. В настройках клиента укажите https://modelflare.dev. При прямом вызове по HTTP используйте https://modelflare.dev/v1/messages. Ключ создаётся в Modelflare, там же учитывается расход.

Клиент Куда указать адрес Как передать ключ
Claude Code ANTHROPIC_BASE_URL=https://modelflare.dev ANTHROPIC_AUTH_TOKEN
Python SDK base_url="https://modelflare.dev" api_key в конструкторе
TypeScript SDK baseURL: "https://modelflare.dev" apiKey в конструкторе
curl https://modelflare.dev/v1/messages Authorization: Bearer … или x-api-key

SDK и CLI сами добавляют путь /v1/messages. Суффикс /v1 в базовом адресе может привести к запросу на /v1/v1/messages. Интерфейсы Modelflare · Подключение Claude Code к шлюзу

1. Проверьте баланс и доступ к моделям

Войдите в Modelflare и при необходимости пополните кошелёк. Создайте обычный ключ, выбрав основную группу с доступом к моделям из вашего сценария. Для примеров с SDK достаточно claude-sonnet-5. Для стандартной конфигурации Claude Code нужны claude-opus-4-8 и claude-sonnet-5. При выборе группы сверьте обе строки в каталоге. Вход · Кошелёк · Ключи API · Модели и цены

Для разового подключения и для приложения удобно использовать отдельные ключи с лимитами расхода. Идентификаторы указывайте как в каталоге, включая дефисы и номера версий. Полный ключ вносите только в локальную настройку или в хранилище секретов приложения. Модели и группы · Пополнение криптовалютой

2. Установите и настройте Claude Code

Установщик Modelflare при необходимости устанавливает официальный CLI, сохраняет копию существующего файла и обновляет параметры в env. Он ищет Opus и Sonnet в общем каталоге GET /v1/models. Доступ по ключу проверяется отдельно. Интерфейс установщика доступен на английском, китайском и японском.

macOS или Linux, от имени обычного пользователя:

curl -fsSL https://modelflare.dev/install/claude.sh | sh

Windows PowerShell:

irm https://modelflare.dev/install/claude.ps1 | iex

При ручной настройке установленного CLI сначала выполните claude --version. Затем откройте пользовательский ~/.claude/settings.json. В Windows стандартный путь — %USERPROFILE%\.claude\settings.json. Если задан CLAUDE_CONFIG_DIR, используйте settings.json в этом каталоге. Сохраните копию существующего файла. Впишите следующие поля внутрь уже существующего объекта env или создайте этот объект. Остальные настройки можно сохранить.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelflare.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELFLARE_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

ANTHROPIC_MODEL задаёт модель для нового сеанса, если её не переопределила настройка с более высоким приоритетом. Переменные ANTHROPIC_DEFAULT_*_MODEL сопоставляют варианты Opus, Sonnet и Haiku с конкретными ID при выборе через /model. В примере вариант Haiku вызывает claude-sonnet-5 и оплачивается по цене Sonnet. Чтобы использовать claude-haiku-5-5, укажите этот ID и проверьте, что он есть в группе ключа. По каталогу от 22 ноября 2026 года у Haiku 5.5 и Fable 5.2 не было доступа через claude-first-topup. Параметры моделей Claude Code · Текущий каталог

Файл содержит ключ. На macOS и Linux доступны права 600, а в Windows файл следует хранить в личном профиле с доступом только для доверенных пользователей. Защитите и резервную копию. Настройка Claude Code по платформам

3. Проверьте доступ и запустите первый сеанс

В Bash выполните запрос каталога с параметром scope=authorized и фильтром endpoint=anthropic. Он проверяет ключ и ищет модели для Messages без генерации текста.

(
  read -rsp "Modelflare API key: " api_key
  printf '\n' >&2
  printf 'Authorization: Bearer %s\n' "$api_key" |
    curl --silent --show-error --fail-with-body --max-time 30 \
      --header @- \
      'https://modelflare.dev/v1/models?scope=authorized&kind=text&endpoint=anthropic'
)

В ответе ищите claude-sonnet-5. Для стандартных псевдонимов проверьте также claude-opus-4-8. Если нужного ID нет, сверьте группу ключа, ограничения по моделям и отметку Messages в карточке. Доступность маршрута и баланс проверяются при вызове. Модели и цены

Для пробного сеанса в небольшом проекте укажите ID Sonnet и режим плана.

claude --model claude-sonnet-5 --permission-mode plan

Задайте короткий вопрос о README, содержимое которого можно отправить сервису. После ответа сверьте модель, фактическую группу и списание. Этот запрос расходует баланс. Для диагностики настроек откройте /status. Строка Setting sources показывает, какие файлы были загружены. При предупреждении о настройках выполните claude doctor, чтобы увидеть отклонённые параметры. Команды Claude Code · Приоритет настроек · Журнал использования

4. Отправьте тот же запрос через Python, Node.js или curl

Ниже три способа отправить один и тот же короткий запрос. Достаточно выбрать один. Сохраните ключ в переменной окружения MODELFLARE_API_KEY средствами своей среды или хранилища секретов. В интерактивном Bash её можно заполнить без вывода ключа и без записи значения в историю команд.

read -rsp "Modelflare API key: " MODELFLARE_API_KEY
printf '\n'
export MODELFLARE_API_KEY

Python. В окружении проекта выполните python -m pip install anthropic, сохраните пример как messages_demo.py и запустите python messages_demo.py. Пример печатает только текстовые блоки ответа.

import os
from anthropic import Anthropic

client = Anthropic(
    base_url="https://modelflare.dev",
    api_key=os.environ["MODELFLARE_API_KEY"],
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=64,
    messages=[{"role": "user", "content": "Ответь одним словом: pong"}],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

Node.js. В проекте выполните npm install @anthropic-ai/sdk. Сохраните пример как messages_demo.mjs и запустите node messages_demo.mjs.

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

const apiKey = process.env.MODELFLARE_API_KEY;
if (!apiKey) throw new Error("Set MODELFLARE_API_KEY");

const client = new Anthropic({
  baseURL: "https://modelflare.dev",
  apiKey,
});

const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 64,
  messages: [{ role: "user", content: "Ответь одним словом: pong" }],
});

for (const block of message.content) {
  if (block.type === "text") console.log(block.text);
}

curl. Полный URL включает /v1/messages. Modelflare принимает Authorization: Bearer, а также x-api-key при отсутствии Authorization. Версии SDK могут использовать разные заголовки авторизации. Изменения заголовков в SDK Anthropic

printf 'Authorization: Bearer %s\n' "$MODELFLARE_API_KEY" |
  curl --silent --show-error --fail-with-body --max-time 60 \
  'https://modelflare.dev/v1/messages' \
  --header @- \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  --data '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"Ответь одним словом: pong"}]}'

max_tokens задаёт верхнюю границу размера ответа. Для оценки стоимости учитывайте также вход и параметры кеша. Если короткий текстовый запрос работает, а потоковый вызов или вызов с инструментами завершается ошибкой, проверяйте проблемный параметр на том же ID и в той же группе. Совместимость с OpenAI Chat Completions отмечается в каталоге отдельно. Справочник Messages · Интерфейсы Modelflare

Цена и разбор ошибок

22 ноября 2026 года для claude-sonnet-5 базовая цена составляла 2 USD за миллион входных и 10 USD за миллион выходных токенов. В claude-award с коэффициентом 0,25 это 0,50 и 2,50 USD соответственно. В claude-stable с коэффициентом 0,315 — 0,63 и 3,15 USD. Параметры кеша и фактическую группу учитывайте отдельно. Как считать стоимость · Текущие цены

Признак Что проверить
401 В Claude Code проверьте ANTHROPIC_AUTH_TOKEN, в примерах SDK — MODELFLARE_API_KEY. Ключ должен быть выпущен в Modelflare и оставаться активным.
403 или модель недоступна Сопоставьте модель, группу и ограничения ключа. При insufficient_user_quota проверьте доступный баланс.
404, в пути два /v1 В базовом адресе CLI или SDK оставьте только https://modelflare.dev. В curl используется полный путь.
curl работает, а Claude Code просит войти В /status проверьте, что CLI прочитал пользовательский файл. Сверьте CLAUDE_CONFIG_DIR, базовый адрес и ключ в env.
Тайм-аут после отправки Перед повтором проверьте журнал по времени и модели. Для обращения в поддержку укажите X-ModelFlare-Request-Id, если он доступен.
429 Уменьшите параллелизм и проверьте лимит группы. В каталоге от 22 ноября 2026 года у claude-first-topup было 3 запроса в минуту.
Выбран Haiku, а в журнале Sonnet Проверьте ANTHROPIC_DEFAULT_HAIKU_MODEL. В примере это явное сопоставление с Sonnet.

Если нужен только Sonnet, при ручной настройке можно сопоставить все четыре переменные модели с claude-sonnet-5. Установщик при этом по-прежнему проверяет два стандартных ID. При обращении за помощью укажите модель, HTTP-статус и ID запроса, если он доступен. Коды ошибок