# Bench + RouterAI: подключение AI-агента к моделям через API

[Bench](https://getbench-ai.ru) — десктопное приложение-агент для macOS, Windows и Linux. Приложение работает с файлами в открытых ему папках: читает и редактирует код и документы, выполняет многошаговые задачи, по запросу подключается к внешним системам — трекерам задач, вики, базам данных. Bench поддерживает любой OpenAI-совместимый API, поэтому RouterAI подключается к нему напрямую: один ключ API даёт доступ ко всем моделям каталога, включая Claude, GPT, DeepSeek и Gemini.

Инструкция описывает установку Bench, подключение RouterAI в качестве провайдера моделей, выбор моделей и решение типичных проблем. Настройка занимает несколько минут.

## Содержание

* [Требования](#требования)
* [Шаг 1. Установка Bench](#шаг-1-установка-bench)
* [Шаг 2. Ключ API RouterAI](#шаг-2-ключ-api-routerai)
* [Шаг 3. Подключение RouterAI к Bench](#шаг-3-подключение-routerai-к-bench)
* [Шаг 4. Выбор моделей](#шаг-4-выбор-моделей)
* [Шаг 5. Проверка подключения](#шаг-5-проверка-подключения)
* [Выбор модели под задачу](#выбор-модели-под-задачу)
* [Безопасность и контроль расходов](#безопасность-и-контроль-расходов)
* [Решение проблем](#решение-проблем)
* [Полезные ссылки](#полезные-ссылки)

## Требования

* Компьютер на macOS, Windows или Linux.
* Установленное приложение Bench — дистрибутив доступен на [getbench-ai.ru/download](https://getbench-ai.ru/download).
* Аккаунт RouterAI с положительным балансом — [регистрация](https://routerai.ru).
* Ключ API RouterAI — создаётся в [личном кабинете](https://routerai.ru/settings/keys).

VPN и зарубежная банковская карта не требуются: запросы к моделям проходят через RouterAI, оплата производится в рублях.

## Шаг 1. Установка Bench

1. Скачайте дистрибутив для своей операционной системы на [getbench-ai.ru/download](https://getbench-ai.ru/download).
2. Установите и запустите приложение.
3. При первом запуске укажите папку (одну или несколько), с которой будет работать агент. Bench имеет доступ только к указанным папкам; остальная файловая система приложению недоступна.

## Шаг 2. Ключ API RouterAI

1. Зарегистрируйтесь или войдите на [routerai.ru](https://routerai.ru).
2. Откройте в личном кабинете раздел [«Ключи API»](https://routerai.ru/settings/keys).
3. Нажмите «Создать ключ» и скопируйте его.
4. Пополните баланс. Оплата начисляется за фактически использованные токены; фиксированная подписка не требуется.

Ключ начинается с `sk-` и отображается только один раз — при создании. Если ключ не был скопирован, создайте новый, а прежний удалите.

## Шаг 3. Подключение RouterAI к Bench

1. Откройте Bench и перейдите в **Настройки** (значок профиля в нижнем левом углу).

`[Скриншот: окно настроек Bench — step1-settings.jpg]`

2. Откройте страницу **«Модели»** и нажмите **«Добавить»**.

`[Скриншот: страница «Модели», кнопка «Добавить» — step2-models-add.jpg]`

3. Заполните поля подключения:

`[Скриншот: форма подключения провайдера — step3-form.jpg]`

| Поле     | Значение                                                                              |
| :------- | :------------------------------------------------------------------------------------ |
| Тип      | `OpenAI-совместимый`                                                                  |
| Адрес    | `https://routerai.ru/api/v1`                                                          |
| API-ключ | ключ `sk-…`, созданный на шаге 2                                                      |
| Название | произвольное, например `RouterAI` — под этим именем подключение отображается в списке |

4. Нажмите **«Дальше»**.

## Шаг 4. Выбор моделей

На следующем экране Bench автоматически загрузит каталог моделей RouterAI и покажет его списком с поиском. Отметьте модели, которые планируете использовать, — например, одну для сложных задач и одну недорогую для массовых операций.

Нажмите **«Добавить провайдера»**. Настройка завершена: выбранные модели доступны в списке моделей чата. Состав моделей можно изменить в любой момент в том же разделе настроек.

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

1. Создайте в Bench новый чат.
2. Выберите одну из подключённых моделей.
3. Отправьте короткое тестовое сообщение и убедитесь, что модель отвечает.

Если вместо ответа возвращается ошибка, см. раздел [«Решение проблем»](#решение-проблем).

## Выбор модели под задачу

Модель в RouterAI выбирается под конкретную задачу. Ориентировочное разделение:

| Задача                                                    | Рекомендуемые модели                     | Обоснование                                                             |
| :-------------------------------------------------------- | :--------------------------------------- | :---------------------------------------------------------------------- |
| Архитектура, анализ незнакомого проекта, длинный контекст | Claude (`anthropic/…`)                   | Устойчиво работают с большим контекстом и многошаговыми рассуждениями   |
| Универсальные задачи, работа с инструментами              | GPT (`openai/…`)                         | Стабильный вызов инструментов, качественная генерация кода и текста     |
| Массовые правки, тесты, однотипные операции               | Модели семейства DeepSeek (`deepseek/…`) | Существенно ниже стоимость при сопоставимом качестве на простых задачах |
| Обработка сверхдлинных документов                         | Модели с контекстом от 1 млн токенов     | Позволяют обрабатывать документ целиком, без разбиения на части         |

Состав каталога и идентификаторы моделей периодически меняются — актуальный список приведён на странице [«Модели»](https://routerai.ru/models).

Рекомендации по сокращению расхода токенов:

* **Закрывайте файлы, не относящиеся к задаче.** Агент учитывает открытые вкладки, и лишние файлы увеличивают объём контекста.
* **Сжимайте длинные диалоги** командой `/compact` — она заменяет полную историю переписки кратким пересказом.
* **Зафиксируйте правила проекта** в файле инструкций для агента, чтобы не повторять одни и те же требования в каждом запросе.

## Безопасность и контроль расходов

* Ключ API хранится локально в защищённом хранилище Bench, не записывается в логи и используется только для запросов к API RouterAI. В интерфейсе после сохранения ключ отображается как `••••••••`.
* В сеть передаётся содержимое запроса: текст задачи и фрагменты файлов, необходимые модели для ответа. Запросы направляются в RouterAI, который проксирует их к выбранной модели.
* Степень самостоятельности агента настраивается режимами доступа: от режима «только чтение» до автономной работы. В ограниченных режимах изменение файлов, выполнение команд и обращения в сеть требуют подтверждения пользователя.
* Баланс и расходы отображаются в [личном кабинете RouterAI](https://routerai.ru). Для контроля остатка рекомендуется включить уведомления о низком балансе в разделе «Финансы».

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

**Ошибка 401 при первом запросе.** Ключ введён неверно или отозван. Создайте новый ключ в разделе [«Ключи API»](https://routerai.ru/settings/keys) и обновите подключение в Bench.

**Каталог моделей не загружается (пустой список).** Ключ не сохранился или скопирован с лишним пробелом. Вернитесь на предыдущий экран, проверьте поле «API-ключ» и нажмите «Обновить».

**Ошибка 402.** Недостаточно средств на балансе. Пополните баланс в личном кабинете RouterAI.

**Ошибка «Модель не найдена».** Модель переименована или исключена из каталога. Выберите актуальную модель на странице [«Модели»](https://routerai.ru/models) и добавьте её к подключению в настройках Bench.

**Модель отвечает медленно.** Используйте для текущей задачи более лёгкую модель или сократите объём контекста, закрыв файлы, не относящиеся к задаче.

**Расход токенов выше ожидаемого.** Сожмите диалог командой `/compact`, закройте неиспользуемые файлы, разносите независимые задачи по отдельным чатам.

## Полезные ссылки

* [Документация Bench](https://getbench-ai.ru/docs) — режимы доступа, настройки, подключение внешних систем
* [Каталог моделей RouterAI](https://routerai.ru/models) — список моделей и идентификаторы
* [Ключи API](https://routerai.ru/settings/keys) — создание и управление ключами
* [Документация RouterAI](https://routerai.ru/docs) — API, аутентификация, биллинг