CheapAI
Все гайды
Официальный CLI

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:

bash
npm install -g @anthropic-ai/claude-code

Проверьте что установилось: claude --version.

На macOS / Linux добавьте переменные в shell rc (~/.bashrc или ~/.zshrc) и перезагрузите его (source ~/.zshrc):

bash
export ANTHROPIC_BASE_URL="https://cheapai.io"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

На Windows PowerShell — для текущей сессии:

powershell
$env:ANTHROPIC_BASE_URL = "https://cheapai.io"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"

Для постоянной настройки используйте [System.Environment]::SetEnvironmentVariable(...) или «Свойства системы → Переменные среды».

Альтернатива — поверх конкретного проекта через .claude/settings.json (глобальные переменные не нужны):

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cheapai.io",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

В папке проекта запустите claude — и задайте простой вопрос (например «какие файлы в проекте?»). Если получили ответ — интеграция работает.

bash
claude

Опционально — пин конкретных версий моделей. По умолчанию Claude Code обращается к latest-алиасу — он может разрезолвиться в модель, которая ещё не подключена у нас на шлюзе после очередного релиза Anthropic. Пин-версии нужны чтобы вы сами решали когда агент переходит на новую модель — через ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL:

bash
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

Claude Code — подключение дешёвого API Claude, GPT и Gemini | CheapAI