bb: настройка через RouterAI — модели каталога и Claude Code в тредах
bb — среда для работы с кодинг-агентами: задачи ведутся в тредах, у каждого треда свой агент, проект и рабочая папка. Агентов в bb несколько — Codex, Claude Code, OpenCode и другие, — и каждый обычно требует собственной подписки или ключа.
Плагин bb-plugin-routerai подключает bb к RouterAI. После установки в выборе модели появляется вкладка RouterAI с моделями каталога — DeepSeek, Claude, GPT, Qwen, Kimi и другими, — а штатный Claude Code можно одним переключателем перевести на баланс RouterAI. Ключ копировать не нужно: вход выполняется в один клик, оплата идёт в рублях.

Что даёт плагин
- Вход без копирования ключей. Нажали кнопку — подтвердили доступ на routerai.ru — ключ сохранился сам. Лимит расходов ключа задаётся там же.
- Модели каталога в тредах. Около 300 моделей, умеющих вызывать инструменты, с ценами в рублях. Свой список и порядок в выборе модели.
- Claude Code на балансе RouterAI. Штатный провайдер Claude Code в bb работает на моделях Claude из RouterAI — без подписки Claude и со всеми своими возможностями.
- Деньги на виду. Остаток на счёте — в боковой панели, расход каждого треда — над полем ввода.
- Понятные отказы. Если вход не выполнен, ключ отозван или не установлен агент, сообщение не уходит, а bb объясняет, что сделать.
Требования
- bb версии 0.49 или новее
- Аккаунт на routerai.ru с положительным балансом
- OpenCode на машине, где bb выполняет треды, — на нём работают модели вкладки RouterAI
- Claude Code — только если нужен режим «Claude Code через RouterAI»
OpenCode ставится одной командой:
npm install -g opencode-ai
Плагин сам настраивает OpenCode на RouterAI и не трогает ваши собственные настройки OpenCode.
Установка плагина
bb plugin install "git:https://github.com/router-ai/bb-plugin-routerai@>=0.1.0"
bb скачает, соберёт и запустит последнюю выпущенную версию плагина. Обновление до новой версии:
bb plugin update routerai
Вход в RouterAI
Откройте Settings → Plugins → RouterAI и нажмите Sign in with RouterAI.

В браузере откроется routerai.ru. Выберите аккаунт, при желании измените лимит расходов ключа (по умолчанию 1000 ₽ в день) и подтвердите доступ. Ключ сохранится в bb автоматически, а на странице плагина появятся баланс, имя ключа и остаток лимита.

У каждой установки bb свой ключ с именем вида bb-<имя машины>-<4 знака>. Вход на втором компьютере не отключает первый, а нужный ключ легко найти в личном кабинете.
Если bb работает на сервере или в Docker
После согласия routerai.ru возвращает браузер на адрес сервера bb. Если браузеру этот адрес недоступен, страница не откроется — вход завершается кодом:
- Нажмите Sign in with a code. После согласия routerai.ru покажет код.
- Вставьте код в поле на странице плагина и нажмите Finish.
Если вы уже нажали Sign in with RouterAI и страница возврата не открылась, скопируйте адрес, который пытался открыть браузер, и вставьте его в то же поле целиком.
То же самое из терминала:
bb routerai login --manual
bb routerai login --code <код>
Выбор моделей
Сначала в списке несколько популярных моделей. Ниже на странице плагина — поиск по каталогу RouterAI: добавьте нужные модели, расставьте их по порядку стрелками, лишние уберите. Первая в списке — модель по умолчанию для новых тредов. Цены указаны в рублях за миллион токенов: вход и выход. Кнопка Reset возвращает исходный набор.

В списке показаны только модели, которые умеют вызывать инструменты: без этого агент не сможет читать файлы и запускать команды. Полный перечень с описаниями — в каталоге моделей.
Первый тред
В новом треде откройте выбор модели и перейдите на вкладку RouterAI — она отмечена знаком RouterAI. Выберите модель и уровень рассуждения, напишите задачу и отправьте.

Дальше всё как в обычном треде bb: агент читает и правит файлы проекта, запускает команды, спрашивает разрешения в зависимости от выбранного режима доступа.
Расход и баланс
Над полем ввода видно, сколько рублей потратил тред; сумма растёт по ходу работы. Она же показана в окне контекста bb (строка «Session cost») и в выводе bb thread context.

Расход считается по числу токенов, которое сообщает агент, и ценам каталога. Служебный запрос OpenCode на заголовок сессии в него не входит, поэтому списание в кабинете может быть немного больше. Итоговые списания всегда можно сверить в личном кабинете.
Остаток на счёте и остаток лимита ключа показывает кнопка со знаком RouterAI в нижней части боковой панели. Там же ссылка на пополнение.

Claude Code через RouterAI
В bb есть собственный провайдер Claude Code. Плагин умеет направить его в RouterAI: модели Claude оплачиваются в рублях с баланса RouterAI, подписка Claude не нужна. Режим план, вопросы агента, откат и остальные возможности этого провайдера работают как обычно.
Включается режим на странице плагина, в разделе Claude Code through RouterAI, или командой:
bb routerai claude-code on
После этого создайте тред на провайдере Claude Code и выберите модель как обычно. Сам Claude Code должен быть установлен на машине, где bb выполняет треды; входить в аккаунт Claude не нужно.
Что важно знать:
- Пока режим включён, все треды на провайдере Claude Code идут через RouterAI. Чтобы вернуться к своей подписке Claude, выключите его:
bb routerai claude-code off. - Личные настройки из
~/.claude— общийCLAUDE.md, навыки, серверы MCP — в этом режиме не действуют: Claude Code запускается с отдельным каталогом настроек. Настройки из папки проекта работают. - Расход такого треда тоже виден над полем ввода. Он считается по токенам, которые записывает bb, и ценам каталога.
⚠ У Claude Code большой системный промпт: даже короткий запрос расходует десятки тысяч токенов. На старших моделях Claude это заметные деньги — следите за расходом треда и держите разумный лимит ключа.
Если нужен именно Claude Code как отдельный инструмент в терминале, без bb, — смотрите гайд Вайб-кодинг в Claude Code.
Команда bb routerai
Всё, что есть на странице плагина, доступно и из терминала — удобно на сервере и для самих агентов.
| Команда | Что делает |
|---|---|
bb routerai status |
Вход, баланс, лимит ключа, модели в списке. С --json — в машинном виде. |
bb routerai login |
Начать вход; с --manual код показывается на routerai.ru. |
bb routerai login --code <код> |
Завершить вход вставкой кода или адреса возврата. |
bb routerai logout |
Выйти и удалить ключ с машин. |
bb routerai models |
Показать модели в списке. |
bb routerai models search <текст> |
Найти модель в каталоге. |
bb routerai models set <slug>… |
Задать свой список; первая модель — по умолчанию. |
bb routerai models reset |
Вернуть исходный набор. |
bb routerai claude-code [on\|off] |
Режим «Claude Code через RouterAI»: состояние, включить, выключить. |
Где хранится ключ
Ключ RouterAI хранится в секретах bb. На машину с агентом сервер передаёт его отдельным вызовом, и там он лежит в файле с правами 0600 в каталоге данных плагина — агент читает его оттуда сам. В настройки провайдера, окружение треда и события треда ключ не попадает. При выходе файл удаляется.
Ключ, созданный в кабинете вручную, тоже подойдёт:
bb plugin config routerai set apiKey <ключ>
Решение проблем
Сообщение не отправляется: «RouterAI is not signed in»
Вход не выполнен. Откройте Settings → Plugins → RouterAI и войдите, либо выполните bb routerai login. Текст сообщения остаётся в поле ввода — после входа его можно отправить снова.

«RouterAI rejected the key»
RouterAI больше не принимает сохранённый ключ: его удалили, отключили или перевыпустили в личном кабинете. Войдите заново — плагин получит новый ключ. Отозванный ключ плагин замечает по первому неудавшемуся запросу, поэтому один тред может успеть завершиться ошибкой 401.
«OpenCode is not installed on this machine»
На машине, где bb выполняет тред, нет OpenCode. Установите его командой npm install -g opencode-ai и отправьте сообщение ещё раз.
После согласия страница не открылась
Браузер не смог вернуться на адрес сервера bb — так бывает, когда bb запущен на другой машине или в контейнере. Завершите вход кодом, как описано в разделе Вход в RouterAI.
Тред завершается ошибкой, хотя вход выполнен
Проверьте баланс и остаток лимита ключа: оба видны в боковой панели bb и в выводе bb routerai status. Лимит ключа меняется в личном кабинете.
Claude Code перестал использовать подписку Claude
Включён режим «Claude Code через RouterAI». Выключите его на странице плагина или командой bb routerai claude-code off.
Что дальше
- Каталог моделей — цены и возможности моделей, которые можно добавить в список
- Вайб-кодинг в Claude Code — Claude Code в терминале через RouterAI
- DeepSeek Harness — ещё один агент с плагином RouterAI
- router-ai/bb-plugin-routerai — исходники плагина, история версий и сообщения об ошибках
- getbb.app — сайт bb