Claude Code

Claude Code умеет ходить в Anthropic-совместимый API по кастомному адресу. Достаточно задать две переменные окружения — дальше агент работает как обычно, без VPN.

Установка

Нужен Node.js 18 или новее. Сам Claude Code ставится одной командой:

терминал

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

Проверьте версию: claude --version. Ключ cai-... возьмите в разделе API-ключи.

Настройка через переменные окружения

Claude Code читает базовый адрес и токен из окружения:

macOS / Linux

Добавьте в ~/.zshrc (или ~/.bashrc / ~/.bash_profile):

~/.zshrc

export ANTHROPIC_BASE_URL="https://api.cheapai.io"
export ANTHROPIC_AUTH_TOKEN="cai-..."

Перезапустите терминал (или source ~/.zshrc) и запустите:

терминал

claude   # дальше как обычно

Windows (PowerShell)

powershell

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.cheapai.io", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "cai-...", "User")

Закройте и откройте PowerShell заново, затем — claude.

Выбор модели

Имя модели — как в каталоге. Указать модель на запуск:

терминал

claude --model claude-3-5-sonnet

Или зафиксировать модель по умолчанию в ~/.claude/settings.json:

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.cheapai.io",
    "ANTHROPIC_AUTH_TOKEN": "cai-..."
  },
  "model": "claude-3-5-sonnet"
}

Так настройку можно держать в одном файле, не трогая окружение.

Настройка на уровне проекта

Чтобы у конкретного репозитория были свои настройки — положите рядом .claude/settings.json с тем же содержимым. Этот файл можно закоммитить (без ключа — ключ оставьте в окружении), и вся команда будет ходить через шлюз с одинаковой моделью.

Если при первом запуске ошибка подключения

При самом первом старте Claude Code иногда показывает что-то вроде Unable to connect to Anthropic services или Failed to connect to api.anthropic.com — это онбординг-проверка, которая ещё не учитывает кастомный BASE_URL. Откройте и добавьте поле: