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

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 запроса, если он доступен. Коды ошибок