Claude Code AI и другие агенты в одном окне: как устроена открытая IDE BB

BB (Beyond Bourne) распространяется под открытой лицензией MIT, репозиторий get-bb/bb за семь месяцев набрал около четырёх тысяч звёзд на GitHub. Программа не заменяет агентов, а надстраивается сверху: снизу работают агенты, которые у вас уже есть (Claude Code AI, Codex, Pi, ACP-совместимые), каждый со своими инструментами. Сверху одно окно, которое с ними разговаривается через единый протокол. Все факты ниже проверены по репозиторию по состоянию на конец сентября 2026 года.

Что понадобится

• Node.js актуальной версии (BB запускается командой npx bb-app)
• Доступ к хотя бы одному агенту: Claude Code AI (нужен API-ключ Anthropic), Codex (ключ OpenAI) или локальная модель через ACP (Agent Client Protocol, протокол подключения агентов от компании Zed)
• Git установленный и настроенный, BB использует его для изоляции рабочих веток
• Около 30 минут на установку и первый запуск
• Операционная система: macOS или Linux (демон регистрируется через launchd или systemd)

Как запустить и подключить агентов?

1. Выполните в терминале команду запуска:

npx bb-app

Лаунчер поднимает два процесса: сервер на фреймворке Hono (по умолчанию слушает 127.0.0.1:38886) и хост-демон. Сервер хранит всё состояние в SQLite (файл ~/.bb/bb.db). Демон управляет файлами, git-операциями, терминалами и запуском агентов.

1. Откройте веб-интерфейс в браузере по адресу http://127.0.0.1:38886 или запустите десктопное приложение на Electron, оно показывает тот же интерфейс.

2. Добавьте агента через настройки. Для Claude Code AI укажите API-ключ Anthropic. Для Codex добавьте ключ OpenAI. Локальные модели подключаются через ACP.

3. Если нужна вторая машина, сгенерируйте в настройках BB однострочник установки:

curl <адрес_сервера>/install.sh | sh

Скрипт ставит демон как сервис и выдаёт ему ключ машины. Открывать порты не нужно: не сервер ходит к демону, а демон сам открывает WebSocket к серверу и получает команды.

1. Начните диалог в любом клиенте. BB поддерживает несколько клиентов одновременно: веб-интерфейс на React 19, Electron, CLI bb, SDK и мобильное приложение на Expo. Все обращаются к одному /api/v1, поэтому тред (диалог с агентом), начатый в браузере, продолжается с телефона.

Как BB управляет разными агентами из одного окна?

У каждого агента свой интерфейс, и BB не заставляет их говорить на одном языке напрямую. Вместо этого демон запускает для каждого агента отдельный процесс-мост и общается с ним по JSON-RPC 2.0 (стандарт удалённых вызовов) через стандартный ввод и вывод.

Мост входит в плагин провайдера. Демон скачивает его с сервера и перед запуском сверяет хэш файла.

Нормализация (приведение к единому формату) идёт в два шага. Сначала мост переводит родной поток агента в набор событий: открыть ход, открыть элемент, дописать текст, закрыть элемент, сообщить расход токенов (единиц текста, которыми оперирует модель). Потом ассемблер внутри демона выдаёт идентификаторы и склеивает поток окнами по 100 миллисекунд.

Документация описывает это разделение одной фразой: «мост знает диалект, среда исполнения знает таймлайн».

ACP (Agent Client Protocol) при этом не основа BB, а лишь один из диалектов, которые мосты переводят в собственный протокол. Это значит, что добавить нового агента можно, написав только мост, не трогая ни ядро, ни интерфейс.

Плагины подхватываются без перезапуска

Протокол между демоном и сервером версионирован: сейчас HOST_DAEMON_PROTOCOL_VERSION = 220. Если версии разошлись, демон сам скачивает подходящую сборку, сверяет SHA-256 и перезапускается. Для второй машины это критично: обновлять вручную после каждого релиза сервера не нужно.

Тред хранится как журнал: таблица events только дописывается, у каждого события есть номер sequence. Когда демон присылает новые события, сервер рассылает по WebSocket уведомление changed без самих данных. Клиент помечает интерфейс устаревшим и дочитывает таймлайн по HTTP. Такая схема проще потоковой, потому что у клиента нет копии треда, которая может разойтись с сервером.

Разрешения и навыки: каждый агент по своим правилам

BB не навязывает единую модель разрешений. Мост при подключении сообщает поле approvalEnforcedBy. У Claude Code AI там стоит provider: решения принимает собственный движок разрешений Claude, а BB подключается через колбэк canUseTool. У Codex, Pi и ACP-агентов стоит runtime, и политику применяет сам BB.

Навыки устроены похоже. Демон собирает все навыки в один каталог и передаёт мосту командой skills/configure. Мост раскладывает их на язык агента: для Claude Code AI на лету собирается плагин с симлинком на каталог навыков, Codex получает skills/extraRoots/set, Pi получает флаг --skill, а ACP-агенту список навыков дописывается в инструкции. Навык, добавленный в BB один раз, виден любому агенту.

Песочницы: где именно агент выполняет код?

Место работы агента определяют плагины окружения (environment). Встроенный git-worktree создаёт для треда отдельную рабочую копию. Плагин project-checkout работает прямо в чекауте проекта и не даёт сменить ветку, пока есть незакоммиченные правки.

Вариант modal-sandbox регистрирует не каталог, а целую машину: BB поднимает песочницу Modal, ставит туда свой демон и дальше обращается с ней как с любым другим компьютером.

Что делать с этим прямо сейчас?

Автору Дзена. Плагин, расшифровывающий созвоны и собирающий письма, это готовый шаблон для автоматизации рутины. Можно по аналогии собрать плагин, который превращает голосовые заметки в черновики постов, и подключить его к Claude Code AI прямо внутри BB.

Маркетологу. Единый журнал событий и доступ с любого устройства означают, что команда может работать с одним агентом без пересылки скриншотов и пересказов. Тред начали на десктопе, продолжили с телефона, результат в одной базе.

Предпринимателю в РФ. BB работает локально, сервер поднимается на вашей машине. Это снимает вопрос блокировок интерфейса. Вопрос доступа к самим моделям остаётся: API Anthropic и OpenAI из России требуют обходных путей. Из доступных в РФ аналогов агентного подхода стоит смотреть на YandexGPT API и GigaChat API, но они пока не поддерживают протокол ACP и не подключаются к BB напрямую.

Четыре тысячи звёзд за семь месяцев для инструмента без венчурного маркетинга говорят о том, что спрос на единую оболочку для агентов реален, и если вы давно хотели попробовать Claude Code AI не из голого терминала, BB даёт рабочую точку входа прямо сейчас.