Claude Code

Подключение Claude Code к RouterAI — официальный CLI-ассистент Anthropic для разработки прямо из терминала. Умеет читать и редактировать файлы, запускать команды, работать с git и решать многошаговые задачи.

RouterAI предоставляет Anthropic-совместимый эндпоинт POST /api/v1/messages, поэтому Claude Code подключается без модификаций — достаточно подменить базовый URL.

Требования

macOS, Linux, Windows (WSL) или Windows (нативно)
Node.js 18 или новее
API-ключ из личного кабинета

Установка Claude Code

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

Или через официальный установщик (macOS / Linux / WSL):

curl -fsSL https://claude.ai/install.sh | bash

Подключение к RouterAI

Claude Code конфигурируется через переменные окружения. RouterAI выступает в роли стандартного Anthropic-эндпоинта.

macOS / Linux / WSL

Откройте профиль оболочки:

nano ~/.zshrc   # zsh (macOS по умолчанию)
# или
nano ~/.bashrc  # bash

Добавьте переменные окружения:

export ANTHROPIC_BASE_URL="https://routerai.ru/api"
export ANTHROPIC_AUTH_TOKEN="ваш-api-ключ"
export ANTHROPIC_API_KEY=""  # Важно: оставьте пустым

Замените ваш-api-ключ на ключ из личного кабинета.

Перезапустите терминал или примените изменения:
```
source ~/.zshrc
```
Запустите Claude Code:
```
cd /path/to/your/project
claude
```

Windows (нативно)

На Windows Claude Code работает без WSL — через cmd.exe или PowerShell. Рекомендуем настраивать переменные через settings.json — это надёжнее системных переменных.

Через settings.json (рекомендуется)

Создайте или откройте файл %USERPROFILE%\.claude\settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerai.ru/api",
    "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
    "ANTHROPIC_API_KEY": ""
  }
}

Замените ваш-api-ключ на ключ из личного кабинета. После этого:

cd C:\path\to\your\project
claude

Через cmd.exe (setx)

setx ANTHROPIC_BASE_URL "https://routerai.ru/api"
setx ANTHROPIC_AUTH_TOKEN "ваш-api-ключ"
setx ANTHROPIC_API_KEY ""

⚠ setx записывает переменные постоянно, но они применяются только в новом окне cmd.exe. Текущую сессию нужно перезапустить.

После перезапуска cmd.exe:

cd C:\path\to\your\project
claude

Через PowerShell

Откройте профиль:

notepad $PROFILE

И добавьте:

$env:ANTHROPIC_BASE_URL = "https://routerai.ru/api"
$env:ANTHROPIC_AUTH_TOKEN = "ваш-api-ключ"
$env:ANTHROPIC_API_KEY = ""

Перезапустите PowerShell, затем:

cd C:\path\to\your\project
claude

Некоторые функции Claude Code (интерактивный ввод, цвета терминала) работают лучше в cmd.exe, чем в PowerShell. При проблемах с интерфейсом — запускайте через cmd.exe.

⚠ Переменная ANTHROPIC_API_KEY="" должна быть явно пустой строкой. Если она не установлена, Claude Code попытается подключиться к серверам Anthropic напрямую.

Настройка моделей

По умолчанию Claude Code использует семейство моделей Claude. Вы можете направить любую роль на любую модель из каталога RouterAI. Для совместимости с Anthropic Messages API рекомендуем выбирать модели семейства anthropic/*.

macOS / Linux / WSL

export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"
export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-sonnet-4.6"

Windows (cmd.exe)

setx ANTHROPIC_DEFAULT_SONNET_MODEL "anthropic/claude-sonnet-4.6"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "anthropic/claude-opus-4.7"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "anthropic/claude-haiku-4.5"
setx CLAUDE_CODE_SUBAGENT_MODEL "anthropic/claude-sonnet-4.6"

Windows (settings.json)

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerai.ru/api",
    "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "anthropic/claude-sonnet-4.6"
  }
}

Переменная	Применяется для
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Основные задачи (код, анализ)
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Сложные и ресурсоёмкие задачи
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Быстрые операции и автодополнение
`CLAUDE_CODE_SUBAGENT_MODEL`	Субагенты внутри сессии

Полный список моделей — в каталоге RouterAI.

Настройка через settings.json

Альтернативно, конфигурацию можно держать целиком в файле — это работает на всех платформах без изменения переменных окружения.

Платформа	Путь к файлу
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`
Проект (все ОС)	`.claude/settings.local.json`

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerai.ru/api",
    "ANTHROPIC_AUTH_TOKEN": "ваш-api-ключ",
    "ANTHROPIC_API_KEY": ""
  }
}

⚠ Не добавляйте settings.local.json с API-ключом в git-репозиторий. Добавьте файл в .gitignore.

Проверка подключения

Внутри запущенной сессии выполните:

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://routerai.ru/api

Если значения совпадают — подключение настроено корректно. Дополнительно можно убедиться в работе эндпоинта обычным curl:

curl https://routerai.ru/api/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Статус-бар с расходами сессии

RouterAI предоставляет скрипт для нижней строки Claude Code, который показывает текущую модель, потраченные токены, кэш и баланс аккаунта в реальном времени. Стоимость текущей сессии вычисляется как разница между балансом на старте и текущим — поэтому отображает ровно то, что списалось.

macOS / Linux / WSL

Скачайте скрипт и сделайте его исполняемым:

mkdir -p ~/.local/bin
curl -fsSL https://routerai.ru/scripts/claude-statusline.sh -o ~/.local/bin/claude-statusline.sh
chmod +x ~/.local/bin/claude-statusline.sh

Подключите его в ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "/home/USER/.local/bin/claude-statusline.sh"
  }
}

Замените USER (или весь путь) на актуальный — раскрытие ~ в command не работает.

Зависимости: bash, curl, jq, awk — обычно уже установлены. Если jq не найден, поставьте через пакетный менеджер (brew install jq, apt install jq).

Windows (нативно)

На нативном Windows bash-скрипты недоступны — используйте Node.js-версию.

Скачайте скрипт:

curl -fsSL https://routerai.ru/scripts/claude-statusline-win.mjs -o %USERPROFILE%\.claude\claude-statusline-win.mjs

Убедитесь, что Node.js 18+ установлен:

node --version

Подключите в %USERPROFILE%\.claude\settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "\"C:\\Program Files\\nodejs\\node.exe\" \"C:\\Users\\ВАШ_ПОЛЬЗОВАТЕЛЬ\\.claude\\claude-statusline-win.mjs\""
  }
}

Замените ВАШ_ПОЛЬЗОВАТЕЛЬ на имя учётной записи Windows.

⚠ Используйте полный абсолютный путь к node.exe и к скрипту. Claude Code запускает статус-бар в окружении без стандартного PATH, поэтому команда node без полного пути не работает. Узнать точный путь — where node в cmd.exe.

Что показывает статус-бар

Элемент	Пример	Описание
Сервис	`routerai.ru`	Всегда отображается
Модель	`anthropic/claude-sonnet-4.6`	Текущая модель сессии
Стоимость сессии	`₽12.86`	`initial_balance − current_balance`
Токены	`47.8k tok`	Сумма input + output из transcript
Кэш	`(cache: 24.2k)`	`cache_read + cache_creation` токены
Баланс	`баланс: ₽9993`	Текущий баланс с `/api/v1/credits`

Баланс обновляется не чаще раза в минуту (кэш в ~/.cache/routerai/balance), стоимость сессии — после каждого завершённого запроса, как только баланс рефетчится. На старте сессии стоимость показывается как ₽0.00, инкрементальный сейв initial-баланса лежит в ~/.cache/routerai/session-<id>-init.

Скрипт читает ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN из окружения — те же, что Claude Code использует для запросов. Никакой дополнительной конфигурации не требуется.

Что доступно

RouterAI прозрачно проксирует Anthropic Messages API, поэтому в Claude Code сразу работают:

Стриминг ответов (SSE)
Tool use и tool_result в нативном Anthropic-формате
Изображения в сообщениях (image-блоки)
Расширенное мышление (thinking) для совместимых моделей
Кэширование промтов через cache_control (для моделей, поддерживающих кэш)

Если выбранная модель не относится к семейству anthropic/*, RouterAI автоматически переводит запрос в формат Chat Completions и обратно. Это означает, что вы можете направить, например, ANTHROPIC_DEFAULT_HAIKU_MODEL на openai/gpt-4o-mini или deepseek/deepseek-chat без изменений в Claude Code.

Решение проблем

Ошибка аутентификации (401)

Убедитесь, что ANTHROPIC_AUTH_TOKEN содержит ваш ключ из личного кабинета
Проверьте, что ANTHROPIC_API_KEY явно установлен в пустую строку ("")
Если ранее выполняли вход через Anthropic — выполните /logout внутри Claude Code

Claude Code не видит переменные окружения

macOS / Linux: перезапустите терминал после изменения профиля и проверьте echo $ANTHROPIC_BASE_URL
Windows (setx): setx применяется только в новом окне cmd.exe — текущую сессию нужно закрыть и открыть заново
Windows (PowerShell): переменные могут не пробрасываться в дочерние процессы — используйте settings.json вместо профиля PowerShell
Самый надёжный способ — прописать переменные в ~/.claude/settings.json (macOS/Linux) или %USERPROFILE%\.claude\settings.json (Windows)

Проблемы с интерфейсом на Windows (цвета, ввод, артефакты)

Claude Code лучше работает в cmd.exe, чем в PowerShell. Если интерфейс отображается с артефактами или не реагирует на клавиши:

Запускайте claude из cmd.exe, а не из PowerShell или Windows Terminal с PowerShell-профилем
В Windows Terminal можно добавить профиль cmd.exe и запускать сессии через него
Альтернативно — используйте WSL с bash/zsh

Ошибка модели (model not found)

Проверьте, что модель присутствует в каталоге RouterAI
Убедитесь в правильности написания ID модели (например, anthropic/claude-sonnet-4.6)
Если модель не относится к семейству anthropic/*, RouterAI автоматически переводит формат — но некоторые специфичные параметры Claude Code (например, расширенный thinking) могут быть проигнорированы

402 Payment Required

Недостаточно средств на балансе. Пополните баланс в разделе Биллинг.

Статус-бар показывает ₽0.00

На самом старте сессии это нормально: цена считается как initial_balance − current_balance, поэтому до первого списания будет ₽0.00
Баланс обновляется раз в минуту — стоимость инкрементируется только после рефетча. Чтобы форсировать обновление, удалите ~/.cache/routerai/balance
Проверьте, что ANTHROPIC_AUTH_TOKEN и ANTHROPIC_BASE_URL доступны скрипту: запустите его вручную и подайте на stdin тестовый JSON
Windows: используйте полный путь к node.exe (например C:\Program Files\nodejs\node.exe) — Claude Code запускает скрипт без стандартного PATH, и просто node не работает

Что дальше

Каталог моделей — выберите подходящую модель под задачу
Аутентификация — управление API-ключами и безопасность
Параметры — тонкая настройка генерации