Установщик агентов
Одна команда ставит AI-агента для программирования и подключает его к RouterAI: Claude Code, Codex, OpenCode, Kilo Code, Cline, Continue, Crush, Pi, Oh My Pi или Hermes Agent.
Установщик сам скачивает недостающий клиент или расширение 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 на Apple Silicon (M1 и новее) или на Intel | Windows x64 |
| Терминал | любой, с curl или wget |
«Терминал» (curl уже есть в системе) |
Windows PowerShell 5.1 или PowerShell 7 |
| Права | обычного пользователя | обычного пользователя | обычного пользователя, администратор не нужен |
Нужен доступ в интернет к routerai.ru и к сайтам, откуда ставятся клиенты: claude.ai, opencode.ai, omp.sh, npm, github.com и VS Code Marketplace.
Компьютеры на ARM с Linux или Windows пока не поддерживаются: установщик остановится с ошибкой Unsupported platform. На них настройте клиент вручную по инструкции из раздела Интеграции.
Некоторым клиентам нужны программы, которые установщик сам не ставит:
| Клиент | Что должно быть установлено заранее |
|---|---|
| Claude Code | ничего |
| Codex CLI | на Linux и macOS — ничего; на Windows — Node.js с npm. Если npm уже есть, Codex ставится через него, и npm должен ставить глобальные пакеты без sudo (например, Node.js из nvm или после npm config set prefix ~/.npm-global) |
| OpenCode | на Linux и macOS — ничего; на Windows — Node.js с npm |
| Kilo Code | VS Code (на Linux и macOS — с командой code в PATH); если Kilo Code уже стоит, то версии 7.8.8 или новее |
| Cline | VS Code (на Linux и macOS — с командой code в PATH) |
| Continue | ничего; расширение для VS Code ставится, если VS Code найден |
| Crush | Node.js с npm |
| Pi | Node.js 22.19 или новее с npm |
| Oh My Pi | ничего |
| Hermes Agent | около 4 ГБ свободного места; на Linux — git, curl и библиотека libatomic1 (см. Hermes Agent: долгая установка), на macOS — git из Command Line Tools, на Windows больше ничего |
| OpenAI-совместимый клиент | сам клиент: установщик только задаёт для него переменные окружения |
Совместимость
| Клиент | Linux x64 | macOS | Windows x64 | Настройка |
|---|---|---|---|---|
| Claude Code | ✅ | ✅ | ✅ | полностью автоматически |
| Codex CLI | ✅ | ✅ | ✅ | полностью автоматически |
| OpenCode | ✅ | ✅ | ✅ | полностью автоматически |
| Kilo Code (VS Code) | ✅ | ✅ | ✅ | полностью автоматически |
| Cline (VS Code) | ✅ | ✅ | ✅ | расширение ставится автоматически, ключ и модель вводятся вручную |
Continue (VS Code, IntelliJ IDEA, CLI cn) |
✅ | ✅ | ✅ | полностью автоматически |
| Crush | ✅ | ✅ | ✅ | полностью автоматически |
| Pi | ✅ | ✅ | ✅ | полностью автоматически |
| Oh My Pi | ✅ | ✅ | ✅ | полностью автоматически |
| Hermes Agent | ✅ | ✅ | ✅ | полностью автоматически; установка долгая |
| OpenAI-совместимый клиент | ✅ | ✅ | — | переменные OPENAI_BASE_URL и OPENAI_API_KEY для bash, zsh и fish |
Прочерк означает, что платформа не поддерживается: на Windows переменные для OpenAI-совместимого клиента задайте вручную.
Kilo Code и Cline для IntelliJ IDEA, Roo Code, Zed, Neovim и другие клиенты установщик не настраивает — для них есть пошаговые инструкции в разделе Интеграции.
Что меняет установщик
| Клиент | Что делает установщик | Где настройки |
|---|---|---|
| Claude Code | ставит CLI официальным установщиком Anthropic, настраивает Anthropic-совместимый API | ~/.claude/settings.json |
| Codex CLI | ставит CLI через npm, а без npm на Linux и macOS — официальным установщиком OpenAI в ~/.local/bin; добавляет провайдера 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 |
| Continue | ставит расширение VS Code, если VS Code найден, и добавляет модель RouterAI; ту же конфигурацию читают Continue для IntelliJ IDEA и CLI cn |
~/.continue/config.yaml, ключ — в ~/.continue/.env |
| Crush | ставит CLI через npm, добавляет провайдера RouterAI и выбирает модель | ~/.config/crush/crushrc |
| Pi | ставит CLI через npm, добавляет провайдера RouterAI и выбирает модель по умолчанию | ~/.pi/agent/models.json и settings.json |
| Oh My Pi | ставит CLI официальным установщиком, добавляет провайдера RouterAI и выбирает модель по умолчанию | ~/.omp/agent/models.yml и config.yml |
| Hermes Agent | ставит Hermes официальным скриптом Nous Research (проверенная версия), добавляет провайдера RouterAI и выбирает модель по умолчанию | ~/.hermes/config.yaml, на Windows — %LOCALAPPDATA%\hermes\config.yaml |
| OpenAI-совместимый клиент | записывает переменные OPENAI_BASE_URL и OPENAI_API_KEY |
~/.config/routerai-agent/openai.env |
Подробные инструкции по каждому клиенту — в разделе Интеграции.
Запуск без меню
Клиент и параметры можно передать сразу — это удобно для скриптов и настройки рабочих мест. Ключ передаётся флагом --api-key или переменной ROUTERAI_API_KEY:
curl -fsSL https://routerai.ru/agent-install/install.sh | sh -s -- install codex --api-key <ключ>
& ([scriptblock]::Create((irm https://routerai.ru/agent-install/install.ps1))) install codex
Имена клиентов: claude-code, codex, opencode, kilo, cline, continue, crush, pi, omp, hermes, 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, Crush, Pi, Oh My Pi и Hermes Agent сами читают ключ из этого файла, поэтому работают сразу, в том числе если VS Code запущен с рабочего стола. Если ключ уже задан переменной ROUTERAI_API_KEY, установщик не копирует его на диск: клиент берёт ключ из переменной.
Continue берёт ключ из своего файла ~/.continue/.env (права 600), куда его записывает установщик.
Cline хранит ключ сам, поэтому его вводят в окне Cline — см. ниже.
Cline: последний шаг вручную
После установки откройте Cline → Settings → API Provider → OpenAI Compatible и заполните поля значениями, которые напечатал установщик:
- Base URL —
https://routerai.ru/api/v1; - API Key — ваш ключ RouterAI;
- Model ID — выберите модель из списка явно, даже если она уже показана в поле.
Без явного выбора модели Cline отправит запрос своей модели по умолчанию.
Hermes Agent: долгая установка
Hermes ставится официальным скриптом Nous Research: он сам скачивает Python, Node.js и зависимости и занимает на диске около 3 ГБ. Установка идёт несколько минут на Linux и около 20 минут на Windows. Прерывать её не нужно — установщик печатает ход работы скрипта.
До начала установщик проверяет, хватает ли места и всё ли нужное установлено. Если нет — останавливается сразу и пишет, что поставить.
На Linux Hermes нужна библиотека libatomic1, а на минимальных системах её нет. Если вы работаете не от root, установщик предупредит и попросит пароль sudo, а Hermes поставит библиотеку сам. Если sudo нет или установка запущена с --non-interactive, поставьте библиотеку сами и запустите установщик ещё раз:
sudo apt-get install -y libatomic1 # Debian, Ubuntu
sudo dnf install -y libatomic # Fedora, RHEL
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.
Hermes Agent тоже остаётся установленным и занимает около 3 ГБ. Удалить сам Hermes можно его командой hermes uninstall.
Безопасность
- Установщик не ставит себя в систему и не меняет
PATH: он запускается из временной папки и удаляет её после работы. - Перед запуском скрипт сверяет SHA-256 скачанного файла с
checksums.txt. Это защищает от повреждённой или недокачанной загрузки, но не от подмены файлов на сервере. - Ключ, введённый в диалоге, не попадает в историю команд и не передаётся в URL. В вывод установщика ключ не печатается.
- Ключ записывается в конфигурацию клиента открытым текстом только по явному флагу
--allow-config-secret.
Решение проблем
curl: (22) The requested URL returned error: 404
Раздача установщика временно выключена. Повторите позже или настройте клиент вручную по инструкции из раздела Интеграции.
Portable binary checksum mismatch
Файл скачался не полностью или повреждён по дороге. Запустите команду ещё раз; если ошибка повторяется, напишите в поддержку.
Unsupported platform
Установщик собран для Linux и Windows на x64 и для macOS (Apple Silicon и Intel). На компьютерах с ARM под Linux или Windows настройте клиент вручную по инструкции из раздела Интеграции.
Клиент не найден после установки
Терминал, открытый до установки, не видит новую команду. Откройте новое окно терминала и запустите клиент там.
npm was not found
Клиент ставится через npm, а он не найден. Так ставятся Crush и Pi на всех системах, а на Windows — ещё Codex CLI и OpenCode (на Linux и macOS npm им не нужен). Установите Node.js установщиком с nodejs.org или менеджером пакетов, затем откройте новое окно терминала и запустите установщик ещё раз.
Node.js … is too old for this client
Pi нужен Node.js 22.19 или новее. Обновите Node.js, откройте новое окно терминала и запустите установщик ещё раз.
npm error code EACCES при установке Codex
npm пытается поставить Codex в системный каталог. Настройте каталог в домашней папке и запустите установщик ещё раз:
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
Строку с PATH добавьте и в ~/.bashrc или ~/.zshrc.
Hermes Agent needs the libatomic.so.1 library
На Linux Hermes нужна библиотека libatomic1. Выполните команду, которую напечатал установщик (например, sudo apt-get install -y libatomic1), и запустите установщик ещё раз.
Hermes Agent needs git или Hermes Agent needs curl
Скрипту Hermes нужны git и curl. Поставьте их менеджером пакетов (на macOS — командой xcode-select --install) и запустите установщик ещё раз.
Hermes Agent needs about 4.0 GB of free disk space
Освободите место в домашней папке и запустите установщик ещё раз.
Установка клиента прервалась
Установщик сам повторяет установку клиента до трёх раз при сетевых сбоях. Если не помогло, проверьте доступ в интернет и запустите команду ещё раз.
kilocode.kilo-code … is older than the supported 7.8.8
Обновите расширение командой code --install-extension kilocode.kilo-code --force и запустите установщик ещё раз.
VS Code was not found, VS Code CLI (code) was not found in PATH или VS Code CLI (code) is unavailable
Установщик не нашёл VS Code. Установите VS Code; на macOS выполните в VS Code команду Shell Command: Install ‘code’ command in PATH. Затем откройте новый терминал и повторите установку.
На Windows установщик ищет VS Code и вне PATH текущего окна — в стандартных папках установки, — поэтому, если VS Code только что установлен, сообщение означает, что он стоит в другом месте. Добавьте его папку bin в PATH или переустановите VS Code с отмеченным пунктом Add to PATH.
VS Code CLI (…) failed
VS Code найден, но его команда завершилась с ошибкой. Проверьте, что VS Code запускается, и повторите установку.
В Kilo Code нет провайдера RouterAI
Перезагрузите окно VS Code (Developer: Reload Window). Проверьте, что папка не открыта в Restricted Mode.