# Установщик агентов

> Одна команда ставит AI-агента для программирования и подключает его к RouterAI: Claude Code, Codex, OpenCode, Kilo Code или Cline.

Установщик сам скачивает недостающий клиент или расширение VS Code, подбирает рекомендованную модель и аккуратно дописывает в конфигурацию клиента только настройки RouterAI. Остальные ваши настройки не меняются.

## Быстрая установка

Понадобится [API-ключ](https://routerai.ru/settings/keys). Выполните команду в терминале:


```bash
curl -fsSL https://routerai.ru/agent-install/install.sh | sh
```

```powershell
irm https://routerai.ru/agent-install/install.ps1 | iex
```


Дальше установщик:

1. покажет меню — выберите клиент;
2. спросит API-ключ (или возьмёт его из переменной `ROUTERAI_API_KEY`);
3. получит у RouterAI рекомендованную модель;
4. установит клиент или расширение, если его ещё нет;
5. запишет настройки RouterAI и проверит их;
6. напечатает, где лежат изменённые файлы и как запустить клиент.

Права администратора не нужны: клиенты ставятся в профиль текущего пользователя.

## Требования к системе

| | Linux | macOS | Windows |
|---|---|---|---|
| Система и процессор | x64 (Intel или AMD) | Mac на Intel (x64) | Windows x64 |
| Терминал | любой, с `curl` или `wget` | «Терминал» (`curl` уже есть в системе) | Windows PowerShell 5.1 или PowerShell 7 |
| Права | обычного пользователя | обычного пользователя | обычного пользователя, администратор не нужен |

Нужен доступ в интернет к `routerai.ru` и к сайтам, откуда ставятся клиенты: `claude.ai`, `opencode.ai`, npm и VS Code Marketplace.

Mac на Apple Silicon (M1 и новее) и другие ARM-компьютеры пока не поддерживаются: установщик остановится с ошибкой `Unsupported platform`. На них настройте клиент вручную по инструкции из раздела [Интеграции](/docs/integrations).

Некоторым клиентам нужны программы, которые установщик сам не ставит:

| Клиент | Что должно быть установлено заранее |
|---|---|
| Claude Code | ничего |
| Codex CLI | Node.js с `npm`, который ставит глобальные пакеты без `sudo` (например, Node.js из nvm или после `npm config set prefix ~/.npm-global`) |
| OpenCode | на Linux и macOS — ничего; на Windows — Node.js с `npm` |
| Kilo Code | VS Code с командой `code` в `PATH`; если Kilo Code уже стоит, то версии 7.8.8 или новее |
| Cline | VS Code с командой `code` в `PATH` |
| OpenAI-совместимый клиент | сам клиент: установщик только задаёт для него переменные окружения |

## Совместимость

| Клиент | Linux x64 | macOS (Intel) | Windows x64 | Настройка |
|---|:---:|:---:|:---:|---|
| Claude Code | ✅ | ✅ | ✅ | полностью автоматически |
| Codex CLI | ✅ | ✅ | ✅ | полностью автоматически |
| OpenCode | ✅ | ✅ | ✅ | полностью автоматически |
| Kilo Code (VS Code) | ✅ | ✅ | ✅ | полностью автоматически |
| Cline (VS Code) | ✅ | ✅ | ✅ | расширение ставится автоматически, ключ и модель вводятся вручную |
| OpenAI-совместимый клиент | ✅ | ✅ | — | переменные `OPENAI_BASE_URL` и `OPENAI_API_KEY` для bash, zsh и fish |

Прочерк означает, что платформа не поддерживается: на Windows переменные для OpenAI-совместимого клиента задайте вручную.

Kilo Code и Cline для IntelliJ IDEA, Roo Code, Continue, Zed, Neovim и другие клиенты установщик не настраивает — для них есть пошаговые инструкции в разделе [Интеграции](/docs/integrations).

## Что меняет установщик

| Клиент | Что делает установщик | Где настройки |
|---|---|---|
| Claude Code | ставит CLI официальным установщиком Anthropic, настраивает Anthropic-совместимый API | `~/.claude/settings.json` |
| Codex CLI | ставит CLI через npm, добавляет провайдера `routerai` | `~/.codex/config.toml` |
| OpenCode | ставит CLI, добавляет провайдера RouterAI | `~/.config/opencode/opencode.json` |
| Kilo Code | ставит расширение VS Code, добавляет провайдера RouterAI | `~/.config/kilo/kilo.json` или `kilo.jsonc` |
| Cline | ставит расширение VS Code и печатает значения для ручного ввода | настройки Cline в VS Code |
| OpenAI-совместимый клиент | записывает переменные `OPENAI_BASE_URL` и `OPENAI_API_KEY` | `~/.config/routerai-agent/openai.env` |

Подробные инструкции по каждому клиенту — в разделе [Интеграции](/docs/integrations).

## Запуск без меню

Клиент и параметры можно передать сразу — это удобно для скриптов и настройки рабочих мест:


```bash
curl -fsSL https://routerai.ru/agent-install/install.sh | sh -s -- install codex
```

```powershell
& ([scriptblock]::Create((irm https://routerai.ru/agent-install/install.ps1))) install codex
```


Имена клиентов: `claude-code`, `codex`, `opencode`, `kilo`, `cline`, `openai-compatible`.

| Параметр | Что делает |
|---|---|
| `--api-key KEY` | передать ключ параметром |
| `--model MODEL` | выбрать модель вместо рекомендованной |
| `--dry-run` | показать, что изменится, ничего не записывая |
| `--non-interactive` | не задавать вопросов; без ключа установка завершится ошибкой |
| `--shell-profile` | дописать переменные RouterAI в профиль оболочки (bash, zsh, fish) |
| `--json` | вывести итог одной JSON-строкой, без ключа |

Другие команды: `verify` — проверить настройки, `models` — показать рекомендованные модели, `doctor` — диагностика, `remove` — отключить RouterAI.

## Где хранится ключ

Ключ лежит в отдельном файле, доступном только вашему пользователю, а не в конфигурации клиента:

- Linux и macOS — `~/.config/routerai-agent/credentials` (права `600`);
- Windows — `%LOCALAPPDATA%\RouterAI\credentials`.

Claude Code, Codex, OpenCode и Kilo Code сами читают ключ из этого файла, поэтому работают сразу, в том числе если VS Code запущен с рабочего стола. Если ключ уже задан переменной `ROUTERAI_API_KEY`, установщик не копирует его на диск: клиент берёт ключ из переменной.

Cline хранит ключ сам, поэтому его вводят в окне Cline — см. ниже.

## Cline: последний шаг вручную

После установки откройте Cline → **Settings** → **API Provider** → **OpenAI Compatible** и заполните поля значениями, которые напечатал установщик:

- **Base URL** — `https://routerai.ru/api/v1`;
- **API Key** — ваш ключ RouterAI;
- **Model ID** — выберите модель из списка явно, даже если она уже показана в поле.

Без явного выбора модели Cline отправит запрос своей модели по умолчанию.

## Kilo Code и Cline: Restricted Mode

Если VS Code открыл папку в Restricted Mode (ограниченном режиме), расширения Kilo Code и Cline отключены, и их значки пропадают с боковой панели. Нажмите **Manage** в баннере Restricted Mode и выберите **Trust**: после этого расширения включатся.

Если VS Code был открыт во время установки, перезагрузите окно (**Developer: Reload Window**), чтобы Kilo Code перечитал настройки.

## Повторный запуск и обновление

Команда всегда скачивает текущую версию установщика, поэтому для обновления достаточно запустить её ещё раз. Повторный запуск безопасен: настройки RouterAI перезаписываются, остальные остаются как были.

Перед изменением файла рядом сохраняется его копия `<файл>.routerai-backup` — из неё можно вернуть прежнюю конфигурацию.

## Отключение RouterAI


```bash
curl -fsSL https://routerai.ru/agent-install/install.sh | sh -s -- remove codex
```

```powershell
& ([scriptblock]::Create((irm https://routerai.ru/agent-install/install.ps1))) remove codex
```


`remove` убирает из конфигурации клиента только то, что добавил установщик. Файл с ключом удаляется, когда RouterAI не настроен больше ни в одном клиенте. Сам клиент остаётся установленным. Настройки Cline вводились вручную, поэтому и убираются вручную: Cline → **Settings** → **API Provider**.

## Безопасность

- Установщик не ставит себя в систему и не меняет `PATH`: он запускается из временной папки и удаляет её после работы.
- Перед запуском скрипт сверяет SHA-256 скачанного файла с `checksums.txt`. Это защищает от повреждённой или недокачанной загрузки, но не от подмены файлов на сервере.
- Ключ, введённый в диалоге, не попадает в историю команд и не передаётся в URL. В вывод установщика ключ не печатается.
- Ключ записывается в конфигурацию клиента открытым текстом только по явному флагу `--allow-config-secret`.

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

### `curl: (22) The requested URL returned error: 404`

Раздача установщика временно выключена. Повторите позже или настройте клиент вручную по инструкции из раздела [Интеграции](/docs/integrations).

### `Portable binary checksum mismatch`

Файл скачался не полностью или повреждён по дороге. Запустите команду ещё раз; если ошибка повторяется, напишите в поддержку.

### `Unsupported platform`

Установщик собран только для x64. На Mac с Apple Silicon и других ARM-машинах настройте клиент вручную по инструкции из раздела [Интеграции](/docs/integrations).

### Клиент не найден после установки

Терминал, открытый до установки, не видит новую команду. Откройте новое окно терминала и запустите клиент там.

### `npm error code EACCES` при установке Codex

`npm` пытается поставить Codex в системный каталог. Настройте каталог в домашней папке и запустите установщик ещё раз:

```bash
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
```

Строку с `PATH` добавьте и в `~/.bashrc` или `~/.zshrc`.

### Установка клиента прервалась

Установщик сам повторяет установку клиента до трёх раз при сетевых сбоях. Если не помогло, проверьте доступ в интернет и запустите команду ещё раз.

### `kilocode.kilo-code … is older than the supported 7.8.8`

Обновите расширение командой `code --install-extension kilocode.kilo-code --force` и запустите установщик ещё раз.

### `VS Code CLI (code) is unavailable`

Установщик не нашёл команду `code`. Установите VS Code; на macOS выполните в VS Code команду **Shell Command: Install 'code' command in PATH**. Затем откройте новый терминал и повторите установку.

### В Kilo Code нет провайдера RouterAI

Перезагрузите окно VS Code (**Developer: Reload Window**). Проверьте, что папка не открыта в Restricted Mode.