support@routerai.ru

Загрузка...

AionUi: агентное рабочее место с Claude, GPT и DeepSeek через RouterAI

Содержание статьи

AionUi — бесплатное десктопное приложение с открытым кодом (Apache-2.0), которое превращает работу с моделью из переписки в «Cowork»: агент действует прямо на вашем компьютере — читает и правит файлы, собирает документы, ищет в интернете, вызывает MCP-инструменты. Агентский движок встроен, ставить CLI не нужно: достаточно вставить API-ключ.

Через RouterAI приложение получает доступ к Claude, GPT, DeepSeek и GLM из России без VPN, с оплатой картами РФ, СБП и безналом для юрлиц. Ниже — установка, подключение провайдера, выбор моделей под задачу и разбор типичных ошибок.

Что такое AionUi

AionUi — приложение на Electron для macOS, Windows и Linux. На GitHub у проекта около 33 тыс. звёзд, лицензия Apache-2.0, актуальный релиз — v2.2.2.

  • Встроенный агент (движок Aion CLI): доступ к файлам, веб-поиск, генерация изображений, MCP-инструменты. Работает сразу после установки.
  • 21 готовый ассистент: Cowork для автономных задач, PPT Creator и Morph PPT, Word Creator, Excel Creator, Academic Paper Writer, Financial Model Creator и другие.
  • Мультиагентный режим: установленные Claude Code, Codex, Qwen Code, Hermes Agent, OpenClaw и другие CLI-агенты приложение находит само и открывает в одном интерфейсе. В режиме Team Mode агент-Leader разбивает задачу на подзадачи и раздаёт их тиммейтам, которые работают параллельно в общей папке.
  • Единое управление MCP-тулами: транспорты stdio, sse, http, streamable_http, подключение по JSON в формате mcpServers.
  • Удалённый доступ и автоматизация: WebUI в браузере, каналы Telegram, Lark, DingTalk, WeChat, задачи по cron.
  • Панель предпросмотра на 10+ форматов: PDF, Word, Excel, PPT, Markdown, код, изображения, diff.

Данные хранятся локально в SQLite, наружу уходят только запросы к выбранному провайдеру моделей.

Требования

Параметр Значение
macOS 10.15 и новее
Windows Windows 10 и новее
Linux Ubuntu 18.04+ / Debian 10+ / Fedora 32+
Память от 4 ГБ
Диск от 500 МБ
Аккаунт ключ API RouterAI и положительный баланс

Ключ создаётся в разделе «Ключи API» после регистрации на RouterAI. Он показывается один раз — сохраните его сразу.

Установка

Установщик берётся на официальном сайте: откройте aionui.com и скачайте сборку для своей платформы. С версии 2.2.x файлы релизов на GitHub больше не публикуются — там остаются исходники и список изменений, а страница Releases полезна для проверки актуальной версии.

На macOS удобнее через Homebrew:

brew install --cask aionui

На сервере без графики приложение запускается в режиме WebUI под виртуальным дисплеем; порт веб-интерфейса печатается в консоли при старте:

xvfb-run --auto-servernum --server-args="-screen 0 1920x1080x24" \
  /usr/bin/AionUi --webui --remote --no-sandbox

📷 [Скриншот: главный экран AionUi после первого запуска — левая панель с иконками разделов, список ассистентов с карточкой Cowork, поле выбора папки проекта «Work in a project» и кнопка начала задачи]

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

Провайдер добавляется один раз и дальше доступен во всех ассистентах и агентах.

  1. Нажмите иконку Settings на левой панели и откройте раздел Model — здесь перечислены подключённые платформы и их модели.
  2. Нажмите Add Model, чтобы открыть окно выбора платформы.
  3. В поле Model Platform выберите Custom — это тип для любого сервиса с OpenAI-совместимым интерфейсом. Этим же способом подключают локальные Ollama (http://localhost:11434/v1) и LM Studio (http://localhost:1234/v1).
  4. В поле API Endpoint введите https://routerai.ru/api/v1. Тумблер Full URL оставьте выключенным: тогда приложение само добавляет путь запроса к адресу. Во включённом состоянии адрес используется как есть, то есть указывать нужно полный путь до /chat/completions.
  5. В поле API Key вставьте свой ключ RouterAI (заглушка для примера — sk-xxxxxxxxxxxxxxxx). Поле поддерживает несколько ключей по одному в строке; при ошибке 401 или 429 приложение переключится на следующий и на время заблокирует сбойный.
  6. В поле Model Name выберите модель из подгрузившегося списка или вставьте идентификатор вручную, например anthropic/claude-sonnet-5.5.
  7. Нажмите Confirm.

📷 [Скриншот: окно Add Model — поле Model Platform со значением Custom, поле API Endpoint с адресом https://routerai.ru/api/v1, поле API Key с заглушкой sk-xxxxxxxxxxxxxxxx, поле Model Name со списком моделей RouterAI]

Если в окне есть поле Request Protocol, оставьте OpenAI-совместимый вариант — именно его предоставляет RouterAI по адресу /api/v1. Отдельный тип New API в списке платформ — это шлюз-агрегатор с набором моделей за одним ключом; RouterAI играет ту же роль, но ему достаточно Custom с явным адресом эндпоинта.

Выбор модели

Модель задаётся не глобально, а на уровне задачи, поэтому дешёвую можно держать для рутины, а флагман включать для сложных разборов. Переключатель — в селекторе модели у поля ввода; там же, если агент это поддерживает, меняется интенсивность рассуждений (reasoning effort). Приложение запоминает выбор для каждого диалога.

Идентификаторы ниже сверены с каталогом RouterAI:

Модель Контекст Для чего
anthropic/claude-sonnet-5.5 1M Основная для агентных задач: файлы, код, многошаговые поручения
anthropic/claude-haiku-5.5 1M Быстрая и дешёвая: сортировка файлов, короткие ответы, черновики
openai/gpt-6.1-sol 1,05M Альтернативный флагман: анализ документов, длинные тексты
deepseek/deepseek-v4-flash 1M Очень экономичная: рутинные операции и массовые прогоны
z-ai/glm-5.3 1M Недорогая универсальная модель для повседневных задач

📷 [Скриншот: селектор модели у поля ввода в начатом диалоге — раскрытый список с моделями RouterAI и отмеченной anthropic/claude-sonnet-5.5, рядом строка «Reasoning effort»]

Важная деталь: собственные модели провайдера использует встроенный агент (Aion CLI). Внешние CLI-агенты — Claude Code, Codex, Qwen Code — работают со своими моделями и своим способом авторизации.

Практика: Cowork-сценарий

Разберём типичную задачу — сводка по папке с документами.

  1. На главном экране выберите ассистента Cowork.
  2. В поле Work in a project укажите папку: агент получит доступ к её файлам.
  3. Опишите задачу естественным языком: «Просмотри документы в этой папке, найди счета за сентябрь, сведи их в таблицу Excel и отметь позиции, где сумма расходится с договором».
  4. Если нужны данные из интернета — курсы, условия, справка, — так и напишите: встроенный агент умеет искать в вебе.
  5. Следите за шагами: агент показывает, какие файлы читает и что собирается выполнить, а на опасные действия спрашивает подтверждение.
  6. Результат открывается в панели предпросмотра — таблицу можно править, не переключаясь в другое приложение.

📷 [Скриншот: диалог Cowork с выполненной задачей по папке проекта — выбранная папка в шапке, цепочка шагов агента с вызовами инструментов и панель предпросмотра с готовой таблицей Excel справа]

Для повторяющихся сценариев есть расписание: cron-выражение, фиксированный интервал или разовый запуск. Пока задача активна, приложение не даёт системе уснуть.

MCP-серверы

MCP-инструменты подключаются в Settings → Tools → MCP Management — одним JSON-блоком в формате mcpServers или импортом:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"],
      "env": {}
    }
  }
}

Для локальных серверов используется транспорт stdio (command + args + env), для удалённых — sse, http или streamable_http с полем url и, при необходимости, headers. После добавления AionUi сам проверяет соединение и показывает список инструментов; включать и выключать серверы можно пакетно. Подробности — в гайде по MCP.

📷 [Скриншот: раздел Settings → Tools → MCP Management со списком серверов, статусом подключения и раскрытым списком инструментов одного из них]

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

После сохранения провайдера вернитесь в раздел Model: платформа и её модели должны появиться в общем списке. Дальше проще всего проверить запросом — начните новый диалог с ассистентом Cowork, выберите модель RouterAI и отправьте короткое поручение вроде «Перечисли файлы в папке проекта». Ответ без ошибки означает, что связка работает.

Ключ и адрес можно проверить и отдельно, минуя приложение. Если такой запрос отвечает, а приложение нет — дело в настройках провайдера внутри AionUi:

curl -s https://routerai.ru/api/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-haiku-5.5","messages":[{"role":"user","content":"ping"}],"max_tokens":8}'

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

  • Пустой список моделей. Проверьте адрес в поле API Endpoint (ровно https://routerai.ru/api/v1, без /chat/completions), затем ключ и баланс. Если список всё равно не подгружается, вставьте ID модели в поле Model Name вручную.
  • Ошибка 401. Ключ скопирован не полностью, удалён или относится к другому аккаунту — создайте новый в разделе «Ключи API». Если ключей несколько, они должны быть разделены переводом строки.
  • Ошибка 404 после сохранения. Дублирование пути: /v1 уже есть в адресе, а включённый тумблер Full URL заставляет использовать его как есть. Выключите тумблер или укажите полный путь до /chat/completions.
  • Модель настроена, но в диалоге её нет. Провайдер отключён либо ассистенту не разрешены эти модели — проверьте список Available Models в настройках ассистента. Модель должна поддерживать вызов инструментов (function calling), иначе агентский режим не заработает.
  • Сбои с локальным эндпоинтом. Сервис Ollama или LM Studio должен быть запущен, адрес — с /v1, а в поле API Key для локальной модели достаточно любой непустой заглушки.

Что дальше