Claude Code

Claude Code — это терминальный/IDE-агент Anthropic для кодинга. Он использует Anthropic Messages API, поэтому работает с Anthropic-совместимой поверхностью ru-llm после переопределения двух переменных окружения.

Настройка

Задайте базовый URL шлюза и ваш ключ sk-ru-…, затем запускайте claude как обычно.

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.ru-llm.relay2.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-ru-YOUR_KEY"

claude

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL = "https://api.ru-llm.relay2.xyz"
$env:ANTHROPIC_AUTH_TOKEN = "sk-ru-YOUR_KEY"

claude

Заметка

Используйте ANTHROPIC_AUTH_TOKEN (отправляется как Authorization: Bearer …), а не ANTHROPIC_API_KEY. Шлюз принимает ключ sk-ru-… в любом из заголовков, но Claude Code отправляет ANTHROPIC_API_KEY в заголовке x-api-key — оба варианта работают с ru-llm; ANTHROPIC_AUTH_TOKEN наиболее надёжен.

Чтобы настройка сохранилась, добавьте две строки export в профиль оболочки (~/.zshrc, ~/.bashrc) или в блок env файла settings.json Claude Code.

Выбор модели

ru-llm отдаёт модели Claude по их ID из каталога. Выберите модель через ANTHROPIC_MODEL или переключитесь внутри сессии командой /model:

export ANTHROPIC_MODEL="claude-sonnet-4-6"
# более быстрые/дешёвые фоновые задачи:
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"

Доступные ID Claude: claude-opus-4-8, claude-opus-4-7, claude-sonnet-4-6, claude-haiku-4-5-20251001. Полный список — в разделе Модели и цены.

Проверка

Убедитесь, что шлюз отвечает на Anthropic-поверхности, перед запуском агента:

curl https://api.ru-llm.relay2.xyz/v1/messages \
  -H "x-api-key: sk-ru-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Reply with the single word: ok"}]
  }'

Ответ 200 с массивом content, содержащим ok, означает, что Claude Code подключится.

Устранение неполадок

Симптом	Причина	Решение
401 Unauthorized	Ключ отсутствует или неверен	Проверьте, что ANTHROPIC_AUTH_TOKEN содержит корректный ключ sk-ru-….
402 Payment Required	Нулевой баланс	Пополните в консоли → Billing.
400 неизвестная модель	ID модели нет в каталоге	Задайте ANTHROPIC_MODEL равным существующему ID Claude (GET /v1/models).
Подключается к api.anthropic.com	ANTHROPIC_BASE_URL не экспортирован в этой оболочке	Экспортируйте заново; проверьте через echo $ANTHROPIC_BASE_URL.