# bb: настройка через RouterAI — модели каталога и Claude Code в тредах

[bb](https://getbb.app "bb") — среда для работы с кодинг-агентами: задачи ведутся в тредах, у каждого треда свой агент, проект и рабочая папка. Агентов в bb несколько — Codex, Claude Code, OpenCode и другие, — и каждый обычно требует собственной подписки или ключа.

Плагин [bb-plugin-routerai](https://github.com/router-ai/bb-plugin-routerai "bb-plugin-routerai на GitHub") подключает bb к RouterAI. После установки в выборе модели появляется вкладка **RouterAI** с моделями каталога — DeepSeek, Claude, GPT, Qwen, Kimi и другими, — а штатный Claude Code можно одним переключателем перевести на баланс RouterAI. Ключ копировать не нужно: вход выполняется в один клик, оплата идёт в рублях.

<figure markdown="0"><img src="https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/f075726e2980c8ed76d63cd3480e0d56.gif" alt="Новый тред bb на модели RouterAI: выбор модели на вкладке RouterAI, запрос, агент пишет и запускает скрипт, над полем ввода виден расход в рублях" width="880" height="495"><figcaption>Новый тред на модели RouterAI: выбираем модель, пишем задачу, агент создаёт и запускает скрипт. Над полем ввода — расход треда в рублях.</figcaption></figure>

## Что даёт плагин

* **Вход без копирования ключей.** Нажали кнопку — подтвердили доступ на routerai.ru — ключ сохранился сам. Лимит расходов ключа задаётся там же.
* **Модели каталога в тредах.** Около 300 моделей, умеющих вызывать инструменты, с ценами в рублях. Свой список и порядок в выборе модели.
* **Claude Code на балансе RouterAI.** Штатный провайдер Claude Code в bb работает на моделях Claude из RouterAI — без подписки Claude и со всеми своими возможностями.
* **Деньги на виду.** Остаток на счёте — в боковой панели, расход каждого треда — над полем ввода.
* **Понятные отказы.** Если вход не выполнен, ключ отозван или не установлен агент, сообщение не уходит, а bb объясняет, что сделать.

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

* bb версии 0.49 или новее
* Аккаунт на routerai.ru с положительным [балансом](/settings/billing "балансом")
* [OpenCode](https://opencode.ai/docs "документация OpenCode") на машине, где bb выполняет треды, — на нём работают модели вкладки RouterAI
* Claude Code — только если нужен режим «Claude Code через RouterAI»

OpenCode ставится одной командой:

```bash
npm install -g opencode-ai
```

Плагин сам настраивает OpenCode на RouterAI и не трогает ваши собственные настройки OpenCode.

## Установка плагина {#ustanovka}

```bash
bb plugin install "git:https://github.com/router-ai/bb-plugin-routerai@>=0.1.0"
```

bb скачает, соберёт и запустит последнюю выпущенную версию плагина. Обновление до новой версии:

```bash
bb plugin update routerai
```

## Вход в RouterAI {#vhod}

Откройте **Settings → Plugins → RouterAI** и нажмите **Sign in with RouterAI**.

<figure markdown="0"><img src="https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/7eac4b3f403b9c23c5957d8067b06df3.png" alt="Раздел Account на странице плагина RouterAI до входа: кнопки Sign in with RouterAI и Sign in with a code" width="760" height="197" loading="lazy"><figcaption>Страница плагина до входа. Основная кнопка — <strong>Sign in with RouterAI</strong>; <strong>Sign in with a code</strong> нужна, когда bb работает на другой машине.</figcaption></figure>

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

<figure markdown="0"><img src="https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/d4c0acf0eb21d4468f8f762a24d8f041.png" alt="Страница плагина после входа: баланс, имя ключа, остаток дневного лимита и список моделей с ценами за миллион токенов" width="760" height="562" loading="lazy"><figcaption>После входа: баланс, ключ и остаток лимита, ниже — список моделей для выбора в тредах.</figcaption></figure>

У каждой установки bb свой ключ с именем вида `bb-<имя машины>-<4 знака>`. Вход на втором компьютере не отключает первый, а нужный ключ легко найти в [личном кабинете](/settings/keys "личном кабинете").

### Если bb работает на сервере или в Docker

После согласия routerai.ru возвращает браузер на адрес сервера bb. Если браузеру этот адрес недоступен, страница не откроется — вход завершается кодом:

1. Нажмите **Sign in with a code**. После согласия routerai.ru покажет код.
2. Вставьте код в поле на странице плагина и нажмите **Finish**.

Если вы уже нажали **Sign in with RouterAI** и страница возврата не открылась, скопируйте адрес, который пытался открыть браузер, и вставьте его в то же поле целиком.

То же самое из терминала:

```bash
bb routerai login --manual
bb routerai login --code <код>
```

## Выбор моделей {#modeli}

Сначала в списке несколько популярных моделей. Ниже на странице плагина — поиск по каталогу RouterAI: добавьте нужные модели, расставьте их по порядку стрелками, лишние уберите. Первая в списке — модель по умолчанию для новых тредов. Цены указаны в рублях за миллион токенов: вход и выход. Кнопка **Reset** возвращает исходный набор.

<figure markdown="0"><img src="https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/06df06777077ab0e6a355e816e72975a.png" alt="Список выбранных моделей и поиск по каталогу RouterAI: найденные модели Claude с ценами и размером контекста, кнопки Add" width="760" height="553" loading="lazy"><figcaption>Поиск по каталогу: у каждой модели — цена за миллион токенов и размер контекста. <strong>Add</strong> добавляет модель в выбор.</figcaption></figure>

В списке показаны только модели, которые умеют вызывать инструменты: без этого агент не сможет читать файлы и запускать команды. Полный перечень с описаниями — в [каталоге моделей](/models "каталоге моделей").

## Первый тред

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

<figure markdown="0"><img src="https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/eac4d827186396fdf5fad23a02292ce7.png" alt="Выбор модели в bb: вкладка RouterAI со списком моделей и уровнями рассуждения" width="520" height="400" loading="lazy"><figcaption>Выбор модели в новом треде: вкладка RouterAI, список моделей и уровни рассуждения.</figcaption></figure>

Дальше всё как в обычном треде bb: агент читает и правит файлы проекта, запускает команды, спрашивает разрешения в зависимости от выбранного режима доступа.

## Расход и баланс

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

<figure markdown="0"><img src="https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/287ca8ccbc4583cfd35a95d44992e822.png" alt="Тред на модели RouterAI: агент выполнил задачу, над полем ввода строка Spent 0,24 ₽" width="880" height="495" loading="lazy"><figcaption>Тред на DeepSeek V4 Flash: задача выполнена, над полем ввода — <strong>Spent 0,24 ₽</strong>.</figcaption></figure>

Расход считается по числу токенов, которое сообщает агент, и ценам каталога. Служебный запрос OpenCode на заголовок сессии в него не входит, поэтому списание в кабинете может быть немного больше. Итоговые списания всегда можно сверить в [личном кабинете](/settings/billing "личном кабинете").

Остаток на счёте и остаток лимита ключа показывает кнопка со знаком RouterAI в нижней части боковой панели. Там же ссылка на пополнение.

<figure markdown="0"><img src="https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/a52f7c44c75ffbd54ada91982080581d.png" alt="Баланс RouterAI и остаток дневного лимита ключа в боковой панели bb, ссылка Top up" width="320" height="106" loading="lazy"><figcaption>Баланс и остаток лимита ключа в боковой панели.</figcaption></figure>

## Claude Code через RouterAI {#claude-code}

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

Включается режим на странице плагина, в разделе **Claude Code through RouterAI**, или командой:

```bash
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](/pages/vibe-coding-claude-code "Вайб-кодинг в 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 в каталоге данных плагина — агент читает его оттуда сам. В настройки провайдера, окружение треда и события треда ключ не попадает. При выходе файл удаляется.

Ключ, созданный в кабинете вручную, тоже подойдёт:

```bash
bb plugin config routerai set apiKey <ключ>
```

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

### Сообщение не отправляется: «RouterAI is not signed in»

Вход не выполнен. Откройте **Settings → Plugins → RouterAI** и войдите, либо выполните `bb routerai login`. Текст сообщения остаётся в поле ввода — после входа его можно отправить снова.

<figure markdown="0"><img src="https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/59250a48980881685afa444fb14066c1.png" alt="Сообщение не отправлено: всплывающее уведомление Failed to send message, RouterAI is not signed in, подсказка где войти" width="760" height="230" loading="lazy"><figcaption>Отказ с подсказкой: сообщение не ушло, текст остался в поле ввода.</figcaption></figure>

### «RouterAI rejected the key»

RouterAI больше не принимает сохранённый ключ: его удалили, отключили или перевыпустили в [личном кабинете](/settings/keys "личном кабинете"). Войдите заново — плагин получит новый ключ. Отозванный ключ плагин замечает по первому неудавшемуся запросу, поэтому один тред может успеть завершиться ошибкой 401.

### «OpenCode is not installed on this machine»

На машине, где bb выполняет тред, нет OpenCode. Установите его командой `npm install -g opencode-ai` и отправьте сообщение ещё раз.

### После согласия страница не открылась

Браузер не смог вернуться на адрес сервера bb — так бывает, когда bb запущен на другой машине или в контейнере. Завершите вход кодом, как описано в разделе [Вход в RouterAI](#vhod).

### Тред завершается ошибкой, хотя вход выполнен

Проверьте [баланс](/settings/billing "баланс") и остаток лимита ключа: оба видны в боковой панели bb и в выводе `bb routerai status`. Лимит ключа меняется в [личном кабинете](/settings/keys "личном кабинете").

### Claude Code перестал использовать подписку Claude

Включён режим «Claude Code через RouterAI». Выключите его на странице плагина или командой `bb routerai claude-code off`.

## Что дальше

* [Каталог моделей](/models "Каталог моделей") — цены и возможности моделей, которые можно добавить в список
* [Вайб-кодинг в Claude Code](/pages/vibe-coding-claude-code "Вайб-кодинг в Claude Code") — Claude Code в терминале через RouterAI
* [DeepSeek Harness](/pages/deepseek-harness-routerai "DeepSeek Harness через RouterAI") — ещё один агент с плагином RouterAI
* [router-ai/bb-plugin-routerai](https://github.com/router-ai/bb-plugin-routerai "bb-plugin-routerai") — исходники плагина, история версий и сообщения об ошибках
* [getbb.app](https://getbb.app "bb") — сайт bb
