# 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»](https://routerai.ru/settings/keys) после регистрации на RouterAI. Он показывается один раз — сохраните его сразу.

## Установка

Установщик берётся на официальном сайте: откройте [aionui.com](https://www.aionui.com) и скачайте сборку для своей платформы. С версии 2.2.x файлы релизов на GitHub больше не публикуются — там остаются исходники и список изменений, а страница [Releases](https://github.com/iOfficeAI/AionUi/releases) полезна для проверки актуальной версии.

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

```bash
brew install --cask aionui
```

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

```bash
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](https://routerai.ru/models):

| Модель | Контекст | Для чего |
| --- | --- | --- |
| `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` или импортом:

```json
{
  "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](https://github.com/iOfficeAI/AionUi/wiki/MCP-Configuration-Guide).

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

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

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

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

```bash
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»](https://routerai.ru/settings/keys). Если ключей несколько, они должны быть разделены переводом строки.
- **Ошибка 404 после сохранения.** Дублирование пути: `/v1` уже есть в адресе, а включённый тумблер **Full URL** заставляет использовать его как есть. Выключите тумблер или укажите полный путь до `/chat/completions`.
- **Модель настроена, но в диалоге её нет.** Провайдер отключён либо ассистенту не разрешены эти модели — проверьте список **Available Models** в настройках ассистента. Модель должна поддерживать вызов инструментов (function calling), иначе агентский режим не заработает.
- **Сбои с локальным эндпоинтом.** Сервис Ollama или LM Studio должен быть запущен, адрес — с `/v1`, а в поле **API Key** для локальной модели достаточно любой непустой заглушки.

## Что дальше

- [Каталог моделей RouterAI](https://routerai.ru/models) — актуальные идентификаторы, контекст и цены.
- [Cherry Studio через RouterAI](https://routerai.ru/pages/cherry-studio-routerai) — если нужен в первую очередь чат-клиент, а не агент на файлах.
- [Goose: настройка ИИ-агента через RouterAI](https://routerai.ru/pages/goose-routerai) — агентский клиент с другим подходом к расширениям.
- [Hermes Agent через RouterAI](https://routerai.ru/pages/hermes-agent-routerai) — вариант с Telegram-ботом и веб-поиском.
- [Вайб-кодинг в Claude Code](https://routerai.ru/pages/vibe-coding-claude-code) — если AionUi нужен как оболочка для уже установленных CLI-агентов.
- [Документация AionUi](https://github.com/iOfficeAI/AionUi/wiki) и [FAQ](https://github.com/iOfficeAI/AionUi/wiki/FAQ).