Перейти к содержимому
Ручка — документация

Claude Code — интеграция с Ручкой

Claude Code — терминальный агент Anthropic. Он говорит не OpenAI-форматом, а Anthropic Messages API (/v1/messages) — Ручка отдаёт этот формат на том же api.ruchka.dev, поэтому хватает переменных окружения.

Быстрый старт

В ~/.zshrc / ~/.bashrc:

Окно терминала
export ANTHROPIC_BASE_URL=https://api.ruchka.dev
export ANTHROPIC_AUTH_TOKEN=sk-ruchka-YOUR_KEY_HERE
export ANTHROPIC_API_KEY=""

Три вещи, о которые спотыкаются:

  • ANTHROPIC_API_KEY="" — не опечатка: переменная должна быть явно пустой, иначе непустой ключ перебьёт токен авторизации и запросы не пройдут.
  • ANTHROPIC_BASE_URL — без /v1: путь /v1/messages Claude Code добавляет сам.
  • Переменные читаются при старте — после правки профиля открой новый терминал.

Windows: те же переменные в %USERPROFILE%\.claude\settings.json, блок env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ruchka.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-ruchka-YOUR_KEY_HERE",
    "ANTHROPIC_API_KEY": ""
  }
}

Запуск с моделью из каталога:

Окно терминала
claude --model claude-sonnet-4.6

Роли моделей по умолчанию — тоже через окружение:

Окно терминала
export ANTHROPIC_MODEL=claude-sonnet-4.6            # основная
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4.5  # фоновые задачи

API-ключ (sk-ruchka-...) на раннем доступе выдаём в @ruchkadev_bot.

Проверка

Формат напрямую, без Claude Code:

Окно терминала
curl https://api.ruchka.dev/v1/messages \
  -H "Authorization: Bearer sk-ruchka-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4.6", "max_tokens": 64, "messages": [{"role": "user", "content": "Привет"}]}'

Ответ 200 + текст в content[0].text — работает. Внутри Claude Code набери /status: он покажет, куда смотрит ANTHROPIC_BASE_URL.

Если не работает

  • Запросы уходят мимо Ручки или падают с 401 — проверь, что ANTHROPIC_API_KEY задана пустой строкой, а ANTHROPIC_AUTH_TOKEN начинается с sk-ruchka- и скопирован целиком.
  • Уже залогинен подпиской Anthropic — выполни /logout: залогиненная сессия может ходить мимо переменных окружения.
  • Переменные не подхватились — новый терминал; на Windows перезапусти сессию после правки settings.json.
  • model not found — id модели точно как в каталоге, строчными: claude-sonnet-4.6.

Claude Code рассчитан на модели Anthropic — начинай с Claude из каталога: claude-sonnet-4.6, claude-opus-4.8, claude-haiku-4.5 и остальные.

Что-то не так? Пиши в @ruchkadev_bot — разберём по request_id.