Подключение API за 5 минут
Claude API — единый API к моделям Claude, GPT, Gemini и open-source (DeepSeek, Qwen, GLM, MiniMax). Совместим с OpenAI- и Anthropic-SDK и подключается к популярным AI-инструментам для кодинга: Claude Code, Codex, Cline, Kilo Code, OpenCode и Roo Code. Достаточно сменить base_url и подставить ключ sk-….
https://claude-api.io/v1Кэш контекста: для агентов и длинных диалогов выбирайте Anthropic-формат
На OpenAI-совместимых эндпоинтах (/chat/completions, /responses) промпт-кэш не действует — каждый запрос оплачивается по полному объёму входных токенов. В агентах (Cursor, Cline, Roo, Kilo) и длинных чатах весь контекст пересылается на каждом шаге, поэтому расход растёт очень быстро. Используйте Anthropic-формат (/v1/messages, Claude Code или Anthropic SDK): повторяемый контекст кэшируется и тарифицируется со скидкой до ~10×.
Быстрый старт
Подставьте ваш ключ sk-… в заголовок Authorization. Базовый адрес:
https://claude-api.io/v1curl https://claude-api.io/v1/chat/completions \
-H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-8",
"messages": [
{"role": "user", "content": "Привет!"}
]
}'Аутентификация
Все запросы авторизуются ключом в формате sk-…. Передавайте его как Authorization: Bearer sk-… (диалект OpenAI) или как заголовок x-api-key (диалект Anthropic). Не публикуйте ключ в клиентском коде — баланс списывается с него напрямую.
Список моделей
Используйте точное имя модели при настройке клиента — укажите нужный ID в поле model запроса, и мы направим его соответствующему провайдеру. Кликните по любой строке, чтобы скопировать. Полный список также доступен по GET https://claude-api.io/v1/models.
Fable
Opus
Sonnet
Haiku
GPT-5.5
GPT-5.4
GPT-5.2
GPT-5.1
GPT-5
GPT-4.1
GPT-4o
GPT-4
GPT-3.5
o4-mini
o3
o3-mini
o1
Gemini 3
Gemini 2
Токены списываются как сумма входных и выходных токенов запроса (Вход + Выход = Списано) по единому тарифу, независимо от модели.
Поддерживаемые эндпоинты
API предоставляет несколько совместимых по протоколу эндпоинтов — выберите тот, который понимает ваш клиент.
https://claude-api.io/v1/chat/completionsOpenAI Chat Completionshttps://claude-api.io/v1/responsesOpenAI Responseshttps://claude-api.io/v1/messagesAnthropic Messageshttps://claude-api.io/v1/modelsСписок моделейhttps://claude-api.io/v1/balanceБаланс токеновOpenAI SDK
Эндпоинт: POST https://claude-api.io/v1/chat/completions
from openai import OpenAI
client = OpenAI(
api_key="sk-ВАШ_КЛЮЧ",
base_url="https://claude-api.io/v1",
)
resp = client.chat.completions.create(
model="claude-opus-4-8", # любой ID из списка моделей
messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-ВАШ_КЛЮЧ",
baseURL: "https://claude-api.io/v1",
});
const resp = await client.chat.completions.create({
model: "claude-opus-4-8",
messages: [{ role: "user", content: "Привет!" }],
});
console.log(resp.choices[0].message.content);Python (requests)
Без SDK — обычный HTTP-запрос через requests. Заголовок Content-Type: application/json ставится автоматически при использовании json=.
import requests
resp = requests.post(
"https://claude-api.io/v1/chat/completions",
headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
json={
"model": "claude-opus-4-8", # любой ID из списка моделей
"messages": [{"role": "user", "content": "Привет!"}],
},
timeout=120,
)
print(resp.json()["choices"][0]["message"]["content"])Anthropic SDK
Эндпоинт: POST https://claude-api.io/v1/messages. Тем же ключом, формат сообщений — как в Anthropic API.
import anthropic
client = anthropic.Anthropic(
api_key="sk-ВАШ_КЛЮЧ",
base_url="https://claude-api.io",
)
msg = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
messages=[{"role": "user", "content": "Привет!"}],
)
print(msg.content[0].text)Стриминг
Добавьте "stream": true — ответ придёт потоком Server-Sent Events с чанками data: … и финальным data: [DONE].
curl https://claude-api.io/v1/chat/completions \
-H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-8",
"stream": true,
"messages": [{"role": "user", "content": "Считай до пяти"}]
}'То же через requests (читаем поток построчно):
import json
import requests
with requests.post(
"https://claude-api.io/v1/chat/completions",
headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
json={
"model": "claude-opus-4-8",
"stream": True,
"messages": [{"role": "user", "content": "Считай до пяти"}],
},
stream=True,
timeout=120,
) as r:
for line in r.iter_lines():
if not line or not line.startswith(b"data: "):
continue
chunk = line[6:]
if chunk == b"[DONE]":
break
delta = json.loads(chunk)["choices"][0]["delta"].get("content")
if delta:
print(delta, end="", flush=True)Поддерживаемые клиенты
Инструкция по подключению Claude API к популярным AI-инструментам для кодинга: Claude Code, Codex, Cline, Kilo Code, OpenCode и Roo Code. Кликните по карточке, чтобы перейти к подробной инструкции по нужному инструменту. В примерах замените YOUR_API_KEY на ваш ключ sk-….
Claude Code
Официальный CLI от Anthropic · протокол Anthropic Messages
ANTHROPIC_AUTH_TOKEN и ANTHROPIC_BASE_URL. Если они есть в ~/.bashrc / ~/.zshrc — удалите их и перезапустите терминал.Установите Claude Code
Требуется Node.js 18+. Установка через npm:
npm install -g @anthropic-ai/claude-codeСоздайте файл конфигурации
Создайте файл ~/.claude/settings.json (на Windows: %USERPROFILE%\.claude\settings.json) и вставьте конфигурацию ниже. Замените YOUR_API_KEY на ваш API ключ.
{
"env": {
"ANTHROPIC_BASE_URL": "https://claude-api.io",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "claude-opus-4-8",
"ANTHROPIC_SMALL_FAST_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8"
}
}Альтернатива — экспортировать переменные окружения вручную:
export ANTHROPIC_BASE_URL="https://claude-api.io"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"Запустите Claude Code в проекте
cd /path/to/your/project
claudeCodex
Официальный CLI от OpenAI · протокол OpenAI Responses
Установите Codex
Требуется Node.js 18+. Установка через npm:
npm install -g @openai/codexОтредактируйте файл конфигурации
Откройте (или создайте) ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) и добавьте строки ниже. model и model_provider держите в самом верху, выше любой секции [...]. Замените YOUR_API_KEY на ваш ключ.
model = "claude-opus-4-8"
model_provider = "claude_api"
[model_providers.claude_api]
name = "Claude API"
base_url = "https://claude-api.io/v1"
experimental_bearer_token = "YOUR_API_KEY"Перезапустите Codex
Перезапустите Codex, чтобы применить конфигурацию — и всё готово к работе.
Cline
Расширение для VS Code · OpenAI-compatible
Установите расширение Cline
В VS Code откройте Extensions (Ctrl/Cmd + Shift + X), введите в поиск Cline и нажмите Install.
Откройте настройки API
В боковой панели Cline нажмите на иконку шестерёнки и выберите способ авторизации API Key.
Введите параметры подключения
- API Provider:
OpenAI Compatible - Base URL:
https://claude-api.io/v1 - API Key: ваш API ключ
- Model ID: например
claude-opus-4-8,gpt-5.2
Запустите чат
Сохраните настройки и в выпадающем списке моделей выберите подключённую. Cline готов к работе.
Kilo Code
Расширение для VS Code · OpenAI-compatible
Установите Kilo Code
В Marketplace VS Code найдите Kilo Code и нажмите Install.
Выберите способ авторизации — API Key
Заполните параметры провайдера
- API Provider:
OpenAI Compatible - Base URL:
https://claude-api.io/v1 - API Key: ваш API ключ
- Model ID: например
claude-opus-4-8,gpt-5.2
Начните работу
Сохраните и переключите модель в чате на ту, что вы только что добавили.
OpenCode
Open-source CLI-агент · OpenAI-compatible
Установите OpenCode
Через curl (рекомендуется):
curl -fsSL https://opencode.ai/install | bashЛибо через npm:
npm i -g opencode-aiСоздайте конфиг
Создайте файл ~/.config/opencode/opencode.json со следующим содержимым:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"claude-api": {
"npm": "@ai-sdk/openai-compatible",
"options": {
"baseURL": "https://claude-api.io/v1",
"apiKey": "YOUR_API_KEY"
},
"models": {
"claude-opus-5": { "name": "claude-opus-5" },
"claude-opus-4-8": { "name": "claude-opus-4-8" },
"gpt-5.2": { "name": "gpt-5.2" }
}
}
}
}Не забудьте подставить ваш YOUR_API_KEY. Список models можно расширять под себя.
Запустите и переключите модель
cd /path/to/your/project
opencodeВнутри OpenCode введите команду /models и выберите одну из моделей.
Roo Code
Расширение для VS Code · OpenAI-compatible
Установите Roo Code
В Marketplace VS Code найдите Roo Code и установите.
Откройте настройки провайдера
На боковой панели Roo Code откройте Settings → Providers.
Заполните параметры
- API Provider:
OpenAI Compatible - Base URL:
https://claude-api.io/v1 - API Key: ваш API ключ
- Model ID: например
claude-sonnet-4-6
Поехали
Сохраните настройки. В верхней панели чата выберите свою модель — и пишите задачи.
Cursor
IDE · OpenAI-compatible
Укажите наш API в настройках
Cursor → Settings → Models → OpenAI API:
• Override OpenAI Base URL: https://claude-api.io/v1
• API Key: sk-ВАШ_КЛЮЧ
• Model: claude-opus-4-8Выберите модель
В списке моделей выберите добавленную (например claude-opus-4-8) — и работайте как обычно.
Ошибки и лимиты
Ошибки возвращаются в стандартном формате с полями error.type и error.message. Коды: 401 — неверный ключ, 402 — закончился баланс, 429 — превышен лимит, 400 — некорректный запрос. Баланс и история доступны в личном кабинете.