Claude Code: подключить дешёвый AI API
Claude Code ходит в нативный /v1/messages, поэтому extended thinking и native tool_use доезжают без потерь, а prompt caching реально считается как кэш. Подключение — две переменные окружения, аккаунт Anthropic не нужен.
Claude Code
Официальный CLI от Anthropic
Создайте API-ключ — на странице «Ключи» нажмите Создать ключ, задайте имя (например claude-code), скопируйте полученный ключ. В plaintext больше не покажем.
Установите Node.js 18+ (в него входит npm) — nodejs.org/download. Проверьте: node -v. Затем поставьте Claude Code:
npm install -g @anthropic-ai/claude-codeПроверьте что установилось: claude --version.
На macOS / Linux добавьте переменные в shell rc (~/.bashrc или ~/.zshrc) и перезагрузите его (source ~/.zshrc):
export ANTHROPIC_BASE_URL="https://cheapai.io"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"На Windows PowerShell — для текущей сессии:
$env:ANTHROPIC_BASE_URL = "https://cheapai.io"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"Для постоянной настройки используйте [System.Environment]::SetEnvironmentVariable(...) или «Свойства системы → Переменные среды».
Альтернатива — поверх конкретного проекта через .claude/settings.json (глобальные переменные не нужны):
{
"env": {
"ANTHROPIC_BASE_URL": "https://cheapai.io",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
}
}В папке проекта запустите claude — и задайте простой вопрос (например «какие файлы в проекте?»). Если получили ответ — интеграция работает.
claudeОпционально — пин конкретных версий моделей. По умолчанию Claude Code обращается к latest-алиасу — он может разрезолвиться в модель, которая ещё не подключена у нас на шлюзе после очередного релиза Anthropic. Пин-версии нужны чтобы вы сами решали когда агент переходит на новую модель — через ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL:
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"Или добавьте их в .claude/settings.json в блок env рядом с ANTHROPIC_BASE_URL. Сверьтесь с актуальным каталогом на странице «Модели» — пин-имя должно реально существовать у нас.
Замените YOUR_API_KEY на ваш реальный ключ из раздела «Ключи».
Claude Code — частые вопросы
Почему base URL без /v1?
SDK сам дописывает /v1/messages. Если указать https://cheapai.io/v1, получится https://cheapai.io/v1/v1/messages и запрос упадёт с «Invalid URL». Это самая частая ошибка подключения Claude Code.
Что делать, если Claude Code рвёт соединение?
Запустите claude --debug — он покажет настоящую ошибку вместо общей «API error». Обрывы через 15-20 секунд после первого байта лечатся таймаутами: API_TIMEOUT_MS, CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS, CLAUDE_STREAM_IDLE_TIMEOUT_MS.
Можно ли закрепить конкретные версии моделей?
Да, через ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL. Это спасает, когда Anthropic выпускает новую модель, а на шлюзе её ещё нет: алиас без версии разрешится в несуществующее имя.
Получите ключ и подключите Claude Code
Claude, GPT, Gemini и Grok по одному ключу · оплата в ₽, USDT или картой · без VPN
Получить API-ключГайды по другим инструментам
Смотрите также: цены на модели · справочник API и FAQ