在 Busabase 中与 Claude Code 或 Codex 对话
将本地编码智能体接入 Busabase，选择模型并安全完成第一次对话。
当你希望从 Busabase 的 Agents 页面直接与 Claude Code 或 Codex 对话时，请使用本指南。Busabase 会作为 ACP 客户端，在同一台电脑上启动编码智能体。
这是本地智能体连接
Claude Code 和 Codex 运行在承载 Busabase Desktop 或开源版 Busabase server 的电脑上。Busabase Cloud 不能直接启动你电脑上的程序。如果 Cloud 工作区需要使用本地智能体，请先通过 Local↔Cloud Tunnel 连接你的电脑。
这与接入你自己的智能体方向相反：后者是让智能体通过 skill、API 或 MCP server 调用 Busabase。
开始之前
- 安装当前版本的 Node.js，并确认终端可以运行
npx --version。 - 安装并登录你要使用的编码智能体。
- 正常打开 Desktop app 时，请使用智能体的持久登录；如果 custom gateway 只通过环境变量配置，请改为从专用终端启动开源版 Busabase server。
使用标准托管 provider 时，先检查 CLI：
claude --version
claude auth status
codex --version
codex login status配置模型 provider
如果 Claude Code 已经能在终端正常工作，Busabase 不需要额外设置。使用 Anthropic 兼容 gateway 时，请在启动 Busabase 之前导出变量：
export ANTHROPIC_BASE_URL="https://your-anthropic-compatible.example/v1"
export ANTHROPIC_AUTH_TOKEN="your-token"Codex 的长期 provider 设置应写在用户级 ~/.codex/config.toml 中。model_provider 对应 provider table 的名称，model 是该 provider 接受的准确模型 ID。
model = "gpt-5.6"
model_provider = "OpenAI1"
[model_providers.OpenAI1]
name = "OpenAI1"
base_url = "https://your-openai-compatible.example/v1"
env_key = "CUSTOM_OPENAI_API_KEY"
wire_api = "responses"在即将启动 Busabase 的 shell 中导出对应的 Key：
export CUSTOM_OPENAI_API_KEY="your-token"请把凭证保存在环境变量或智能体自身的登录存储中，不要把 token 写入仓库文件、截图或 WebSocket URL。
为 custom provider 使用专用 shell
本地 ACP adapter 会继承 Busabase server 进程的完整环境，而不只是上面列出的 provider 变量。不要从包含无关 GitHub、Cloud、数据库或生产 secret 的部署/管理 shell 启动 Busabase。通过 GUI 启动的 Desktop app 也不一定会继承终端中 export 的变量；仅通过环境变量配置 provider 时，请使用 shell 启动的 server。
启动 Busabase
如果 Claude Code 或 Codex 使用持久登录，请正常打开 Busabase Desktop。如果你在上一步导出了 custom-provider 变量，请从同一个专用终端启动开源版 server：
npx busabase server如果从本仓库运行，请使用：
pnpm --filter busabase dev保持 server 和终端运行。固定版本的 ACP adapter 作为 Busabase 的子进程运行，并继承该进程环境。
连接 Claude Code 或 Codex
- 打开 Dashboard → Agents。
- 选择 Add agent。
- 找到 Claude Code 或 Codex CLI，选择 Connect。
- 等待新对话显示
idle。
第一次连接可能稍慢，因为 npx 需要下载固定版本的 ACP adapter。启动命令由 Busabase 管理，无需粘贴 ACP WebSocket URL，也无需运行 acpremote mirror。
在第一条 prompt 之前选择模型
如果智能体通过 ACP 提供模型选项，附件按钮旁会显示 Model 菜单。选择模型，并等待所选名称稳定显示。Busabase 会先等待智能体确认模型变更，再允许发送 prompt。
如果智能体没有提供模型 option，界面不会显示模型菜单。Busabase 不会自行维护第二份模型目录。
发送第一条消息
输入并发送消息。你的消息应立即显示；智能体工作时状态会变化；回复会显示在同一个对话中。该轮结束后，状态会恢复为 idle，已选模型保持不变。
如果智能体申请执行命令或编辑文件，Busabase 会显示 permission card。检查请求内容，再从智能体提供的选项中作出选择。
故障排查
卡片提示找不到 npx
在运行 Busabase 的电脑上安装 Node.js，重启 Busabase，然后回到 Agents → Add agent。
Busabase Cloud 中无法使用本地智能体
Cloud 不能在共享基础设施上启动 Claude Code 或 Codex。请使用 Busabase Desktop、本地开源版 server，或通过 Local↔Cloud Tunnel 连接你的电脑。
连接过程中智能体退出
在相同账号和 shell 环境中运行 claude auth status 或 codex login status。使用 custom provider 时，请确认 Key 在 Busabase 启动前已导出，然后重启 Busabase。
没有显示 Model 菜单
当前 ACP adapter 没有提供模型配置 option。请更新智能体和 Busabase 后重新连接。即使没有菜单，仍可使用智能体配置的默认模型发送 prompt。