# Вайб-кодинг в Claude code: Настройка через RouterAI (Claude, GPT-5, DeepSeek, Glm, Qwen)

## Claude Code

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

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

> **Можно автоматически.** Попробуйте [установщик RouterAI](/docs/guides/overview/agent-installer): одна команда поставит Claude Code и подключит его к RouterAI. Если что-то не подойдёт, настройте вручную по инструкции ниже.

## Требования

- macOS, Linux, Windows (WSL) или Windows (нативно)
- Node.js 22 или новее — для установки через npm (официальный установщик Node.js не требует)
- API-ключ из [личного кабинета](/settings/keys "личного кабинета")

## Установка Claude Code

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

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

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

Для нативного Windows — PowerShell:

```powershell
irm https://claude.ai/install.ps1 | iex
```

или cmd.exe:

```cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

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

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

### macOS / Linux / WSL

<ol markdown="0">
<li>
<p>Откройте профиль оболочки:</p>
<pre><code class="language-bash">nano ~/.zshrc   # zsh (macOS по умолчанию)
# или
nano ~/.bashrc  # bash</code></pre>
</li>
<li>
<p>Добавьте переменные окружения:</p>
<pre><code class="language-bash">export ANTHROPIC_BASE_URL="https://routerai.ru/api"
export ANTHROPIC_AUTH_TOKEN="ваш-api-ключ"
export ANTHROPIC_API_KEY=""  # Важно: оставьте пустым</code></pre>
<p>Замените <code>ваш-api-ключ</code> на ключ из <a title="личного кабинета" href="/settings/keys">личного кабинета</a>.</p>
</li>
<li>
<p>Перезапустите терминал или примените изменения:</p>
<pre><code class="language-bash">source ~/.zshrc</code></pre>
</li>
<li>
<p>Запустите Claude Code:</p>
<pre><code class="language-bash">cd /path/to/your/project
claude</code></pre>
</li>
</ol>

### Windows (нативно)

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

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

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

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

Замените `ваш-api-ключ` на ключ из [личного кабинета](/settings/keys "личного кабинета"). После этого:

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

#### Через cmd.exe (setx)

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

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

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

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

#### Через PowerShell

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

```powershell
notepad $PROFILE
```

И добавьте:

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

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

```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](/models "каталога RouterAI"). Для совместимости с Anthropic Messages API рекомендуем выбирать модели семейства `anthropic/*`.

### macOS / Linux / WSL

```bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-5.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-5.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-5.5"
export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-sonnet-5.5"
```

### Windows (cmd.exe)

```cmd
setx ANTHROPIC_DEFAULT_SONNET_MODEL "anthropic/claude-sonnet-5.5"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "anthropic/claude-opus-5.5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "anthropic/claude-haiku-5.5"
setx CLAUDE_CODE_SUBAGENT_MODEL "anthropic/claude-sonnet-5.5"
```

### Windows (settings.json)

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

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

Полный список моделей — в [каталоге RouterAI](/models "каталоге RouterAI").

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

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

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

```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:

```bash
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-5.5",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Привет!"}]
  }'
```

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

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

### macOS / Linux / WSL

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

```bash
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`:

```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-версию.

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

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

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

```cmd
node --version
```

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

```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.

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

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

Баланс обновляется не чаще раза в минуту (кэш в `~/.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-5.4-mini` или `deepseek/deepseek-v4-flash` без изменений в Claude Code.

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

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

- Убедитесь, что `ANTHROPIC_AUTH_TOKEN` содержит ваш ключ из [личного кабинета](/settings/keys "личного кабинета")
- Проверьте, что `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](/models "каталоге RouterAI")
- Убедитесь в правильности написания ID модели (например, `anthropic/claude-sonnet-5.5`)
- Если модель не относится к семейству `anthropic/*`, RouterAI автоматически переводит формат — но некоторые специфичные параметры Claude Code (например, расширенный thinking) могут быть проигнорированы

### 402 Payment Required

Недостаточно средств на балансе. Пополните баланс в разделе [Биллинг](/settings/billing "Биллинг").

### Статус-бар показывает ₽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` не работает

## Что дальше

- [Каталог моделей](/models "Каталог моделей") — выберите подходящую модель под задачу
- [Аутентификация](/docs/guides/overview/authentication "Аутентификация") — управление API-ключами и безопасность
- [Параметры](/docs/guides/overview/parameters "Параметры") — тонкая настройка генерации