Установщик агентов
Одна команда ставит AI-агента для программирования и подключает его к RouterAI: Claude Code, Codex, OpenCode, Kilo Code или Cline.
Установщик сам скачивает недостающий клиент или расширение VS Code, подбирает рекомендованную модель и аккуратно дописывает в конфигурацию клиента только настройки RouterAI. Остальные ваши настройки не меняются.
Быстрая установка
Понадобится API-ключ. Выполните команду в терминале:
curl -fsSL https://routerai.ru/agent-install/install.sh | sh
irm https://routerai.ru/agent-install/install.ps1 | iex
Дальше установщик:
- покажет меню — выберите клиент;
- спросит API-ключ (или возьмёт его из переменной
ROUTERAI_API_KEY); - получит у RouterAI рекомендованную модель;
- установит клиент или расширение, если его ещё нет;
- запишет настройки RouterAI и проверит их;
- напечатает, где лежат изменённые файлы и как запустить клиент.
Права администратора не нужны: клиенты ставятся в профиль текущего пользователя.
Требования к системе
| 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. На них настройте клиент вручную по инструкции из раздела Интеграции.
Некоторым клиентам нужны программы, которые установщик сам не ставит:
| Клиент | Что должно быть установлено заранее |
|---|---|
| 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 и другие клиенты установщик не настраивает — для них есть пошаговые инструкции в разделе Интеграции.
Что меняет установщик
| Клиент | Что делает установщик | Где настройки |
|---|---|---|
| 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 |
Подробные инструкции по каждому клиенту — в разделе Интеграции.
Запуск без меню
Клиент и параметры можно передать сразу — это удобно для скриптов и настройки рабочих мест:
curl -fsSL https://routerai.ru/agent-install/install.sh | sh -s -- install codex
& ([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
curl -fsSL https://routerai.ru/agent-install/install.sh | sh -s -- remove codex
& ([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
Раздача установщика временно выключена. Повторите позже или настройте клиент вручную по инструкции из раздела Интеграции.
Portable binary checksum mismatch
Файл скачался не полностью или повреждён по дороге. Запустите команду ещё раз; если ошибка повторяется, напишите в поддержку.
Unsupported platform
Установщик собран только для x64. На Mac с Apple Silicon и других ARM-машинах настройте клиент вручную по инструкции из раздела Интеграции.
Клиент не найден после установки
Терминал, открытый до установки, не видит новую команду. Откройте новое окно терминала и запустите клиент там.
npm error code EACCES при установке Codex
npm пытается поставить Codex в системный каталог. Настройте каталог в домашней папке и запустите установщик ещё раз:
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.