Claude Code

Claude Code — агент для программирования от Anthropic, который работает в терминале. К Infergate он подключается через Anthropic Messages: достаточно задать несколько переменных окружения.

Что понадобится

Установка

Claude Code ставится через npm, нужен Node.js 22 или новее. Другие способы установки описаны в документации Claude Code.

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

Настройка

Задайте адрес, ключ и модели и запустите Claude Code:

export ANTHROPIC_BASE_URL="https://infergate.ru/api"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"
claude
  • ANTHROPIC_BASE_URL — адрес без /v1: Claude Code сам допишет /v1/messages.
  • ANTHROPIC_AUTH_TOKEN — ключ Infergate, он уходит в заголовке Authorization: Bearer. Не кладите ключ в ANTHROPIC_API_KEY: оттуда он попадёт в заголовок x-api-key, который Infergate не читает.
  • ANTHROPIC_MODEL — модель, с которой начинается сессия.
  • ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL — модели за псевдонимами opus, sonnet и haiku в команде /model. Модель haiku Claude Code использует ещё и для фоновых задач, например для названий сессий. Если её не задать, он запросит модель, которой нет в каталоге.

Чтобы не задавать переменные в каждом терминале, добавьте эти строки в ~/.zshrc или ~/.bashrc либо перенесите значения в блок env файла ~/.claude/settings.json. В файл проекта .claude/settings.json ключ не кладите: он попадает в репозиторий.

Проверка

В сессии выполните /status: в строке «Anthropic base URL» должен стоять https://infergate.ru/api. Проверить без интерактивной сессии можно так:

claude -p "Привет! Ответь одним предложением."

Каждый запрос агента появится в разделе «Запросы» личного кабинета — с моделью, токенами и стоимостью.

Выбор модели и расход

Claude Code рассчитан на модели Claude и лучше всего работает с ними. Другие модели каталога тоже подойдут, если они умеют вызывать инструменты (capabilities.tools в списке моделей). Сменить модель на один запуск можно флагом --model.

Claude Code просит у модели длинный ответ: для моделей, которых он не знает, — 32 000 токенов. Если у модели предел ответа меньше, запрос получит 422 с кодом invalid_max_tokens. Тогда уменьшите запрашиваемую длину:

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=16000

Каждый запрос агента несёт большой системный промпт и описания инструментов — это тысячи токенов даже на короткую задачу. Для фоновых задач хватит недорогой модели, например deepseek/deepseek-v4-flash. А чтобы агент не потратил больше, чем вы готовы, задайте ключу лимит расхода.

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

  • 404 и путь /api/v1/v1/messages в логе — в ANTHROPIC_BASE_URL лишний /v1.
  • Claude Code просит войти в аккаунт — не задан ANTHROPIC_AUTH_TOKEN.
  • 401 — ключ неверный, отключён или удалён либо записан в ANTHROPIC_API_KEY вместо ANTHROPIC_AUTH_TOKEN.
  • 402 — на балансе не хватает денег или исчерпан лимит ключа.
  • 404 с кодом model_not_found — опечатка в идентификаторе или не задана одна из переменных ANTHROPIC_DEFAULT_*_MODEL.
  • 422 с кодом invalid_max_tokens — см. раздел о выборе модели.
  • 422 с кодом server_tools — серверные инструменты Anthropic (веб-поиск и загрузка страниц) не поддерживаются.