AI 2026年7月2日 2 分钟阅读

bb 入门教程：用一个 Agent IDE 统一管理 Claude Code、Codex 和 Cursor

tinyash 0 条评论

如果你同时用 Claude Code、Codex、Cursor 等多个 AI 编程 Agent，你一定遇到过这样的问题：每个工具各自为政，上下文互不相通，在 A 工具里调通的代码到 B 工具里又要重新解释一遍。更麻烦的是，想在一个任务中切换不同 Agent 的能力——比如用 Codex 写代码、用 Claude Code 做 Code Review——就得手动复制粘贴，完全谈不上流程化。

bb 就是为解决这个问题而生的——它是一个自管理的 Agent IDE，让你在统一的界面和 API 上同时编排多个 AI 编程 Agent，任务可以实时追踪、随时切换 Agent、甚至让 Agent 之间互相协作。

项目托管在 GitHub（MIT 开源，105+ Stars），npm 包名 bb-app，最新版本 0.0.26，macOS 和 Linux 均可使用。

快速开始

bb 的使用门槛极低——它不带走你已有的工具配置，而是直接对接你本地已认证的 Claude Code、Codex 或 Cursor。

安装与启动

只需一条命令：

npx bb-app@latest

启动后，在浏览器打开 http://localhost:38886，就能看到 bb 的 Web 界面。macOS 用户也可以下载桌面客户端，提供原生窗口体验。

bb 会自动检测你本地已安装的 AI 编程 Agent，并读取已有的认证凭据——你不需要额外配置 API Key。

支持的 Agent 类型

  • Claude Code（Anthropic 官方 CLI）
  • Codex（OpenAI 官方 CLI）
  • Cursor（通过 ACP 协议）
  • Pi（开源编码 Agent）
  • 以及其他 ACP 兼容的 Agent 工具

如果你安装了多个，可以在不同任务中混合使用——一个线程用 Codex 生成代码，另一个用 Claude Code 做审查。

核心概念：线程（Thread）

bb 的核心抽象是线程（Thread）。每个线程代表一个独立的工作流，你在线程中可以：

  1. 分配任务给某个 Agent：在这个线程里用 Codex 帮我写一个 REST API
  2. 实时查看进度：Agent 的每一步操作都会实时推送到线程中
  3. 中途切换 Agent：写到一半想换 Claude Code 来审查？随时在同一个线程中切换
  4. 移交任务：把当前线程交给另一个 Agent 继续处理

这种设计让多 Agent 协作不再是「手动复制粘贴」，而是变成了一条可视化的流水线。

三种使用模式

bb 提供了三种同等级别的使用模式，每种都是一等公民，覆盖桌面、Web 和自动化场景。

1. 桌面客户端（macOS）

下载最新的 macOS 桌面 App，获得原生窗口和菜单栏体验。目前支持 Apple Silicon（arm64），Intel Mac 用户可通过 npx 使用。

2. Web 界面

在任何浏览器中打开 http://localhost:38886，即可使用完整的线程管理功能。Web 界面包含：

  • 线程侧边栏：展示所有活动线程和会话历史
  • 对话面板：与当前 Agent 实时交互
  • STATUS 仪表盘：展示各 Agent 运行状态和资源使用情况

3. CLI 与 HTTP API

bb 的所有功能都可通过 CLI 或 HTTP API 调用，方便集成到自动化流程中：

npx bb-app config list

npx bb-app config set BB_INFERENCE codex/gpt-5.4-mini

npx bb-app env set OPENAI_API_KEY <你的密钥>

HTTP API 让它能与其他工具联动——比如在你的 CI/CD 流程中，用一个 Agent 做 Code Review，另一个 Agent 根据 Review 结果自动修复。

配置详解

bb 的配置系统分三层，按优先级从高到低依次覆盖：

第一层：启动参数

在 npx bb-app 时直接传入：

npx bb-app --data-dir /path/to/data --server-port 38886

第二层：持久配置

通过 config 子命令写入 ~/.bb/config.json：

npx bb-app config set BB_APP_URL http://my-machine.tailnet.ts.net:38886

npx bb-app config set BB_TRANSCRIPTION codex/gpt-4o-mini-transcribe

npx bb-app config list

第三层：环境变量

Provider 凭据和专属环境变量存入 ~/.bb/env.json：

npx bb-app env set OPENAI_API_KEY sk-xxx
npx bb-app env list     # 查看已设置的变量名（值会被隐藏）

对于 SSH 远程场景，还可以配置客户端 SSH 目标，让本地编辑器能打开远程服务器上的文件：

npx bb-app client ssh-target set https://bb.example.com devbox

实际场景：代码生成 + 代码审查流水线

以下是一个真实的工作流示例，展示如何用 bb 串联两个 Agent：

步骤 1：启动 bb，创建一个新线程，指定用 Codex 编写一个 Python 模块。

步骤 2：Codex 完成后，不退出线程，直接在同一个线程中切换到 Claude Code：

「Claude Code，请 review 上述 Codex 生成的代码，检查安全漏洞和性能问题」

步骤 3：Claude Code 的审查结果实时显示在线程中。如果发现问题，可以继续让 Claude Code 或 Codex 修复。

整个过程在同一个线程中完成，所有 Agent 的对话历史、生成结果和上下文都在同一个界面中可追溯——不再需要手动保存和传递上下文。

多设备支持

bb 允许你在多个设备上运行同一实例。通过 bb-app config 设置 BB_APP_URL 后，其他设备上的 bb CLI 或编辑器可以连接到主实例，实现远程办公或团队协作场景。

隐私与遥测

正式运行（桌面 App 或 npx bb-app）会发送匿名使用遥测数据（启动次数、线程创建数、用户消息数），帮助作者了解使用情况。标识符是随机生成的每安装 ID，不包含用户、主机、项目或消息内容。通过 BB_TELEMETRY=false 环境变量可完全关闭。源码中可用 export BB_TELEMETRY=false 禁用它。

适用场景总结

场景推荐用法
多 Agent 切换写作创建线程 → 分配不同 Agent 分阶段处理
代码生成 + 审查流水线同一线程内切换 Codex/Claude Code
远程开发设置 BB_APP_URL 远程连接
自动化集成通过 HTTP API 与 CI/CD 联动
团队协作多设备连接同一实例共享工作空间

写在最后

bb 目前仍在活跃开发中，核心架构已经稳定，但工作流和用户界面还在持续迭代。对于已经在使用多个 AI 编程 Agent 的开发者来说，bb 提供了一个极具吸引力的统一编排层——不再需要在不同工具之间来回切换和复制上下文，一个界面就能管理所有 Agent 的工作。

如果你觉得这个工具对你有帮助，可以去 GitHub 上给项目点个 Star，关注后续更新。同时需要注意的是，Node.js 22 LTS 是推荐运行环境，Windows 用户需在 WSL2 下使用。

相关链接

AI AI 工具 AI 编程 开发工具 开发者工具 教程

发表评论

你的邮箱地址不会被公开，带 * 的为必填项。