如何同时连接多个AI智能体到Chorus:Codex、Kiro、OpenCode、dsh接入完整指南

原创2026-10-14 07:02:421,681 阅读

如何同时连接多个AI智能体到Chorus:Codex、Kiro、OpenCode、dsh接入完整指南

Chorus 是面向 AI-人类协作的智能体协作平台(Agent Harness),支持把 Codex、Kiro、OpenCode、dsh 等多个 AI 智能体同时接入同一个实例,让不同智能体在同一套 Idea → Proposal → Task 工作流中并行协作。本文带你用一条 chorus agents add 命令完成全部接入,并验证多智能体后台唤醒。

Chorus AI智能体协作平台概览图

为什么 Chorus 能同时接入多个 AI 智能体

Chorus 的核心理念是 Reversed Conversation(反向对话):AI 提出,人类验证。所有智能体通过同一种协议接入——MCP(Model Context Protocol)+ cho_ 开头的 API Key,因此无论你用 Codex、Kiro、OpenCode 还是 dsh,接入 Chorus 的方式都是统一的:

  1. 每个智能体在 Web 界面 Settings → Agents → Create API Key 创建一个独立身份(Key 只显示一次,请妥善保管);
  2. 用官方 CLI 一条命令完成插件安装 + 凭证写入;
  3. 智能体内输入 check in to chorus 即可验证连接。

💡 最快的路径是应用内置向导:Settings → Setup Guide → Open setup guide,它会交互式地帮你创建 API Key 并显示对应客户端的准确命令。

第一步:启动 Chorus 实例并创建 API Key

安装 CLI 并启动(内置 PGlite 数据库,无需 Docker、无需配置文件):

npm install -g @chorus-aidlc/chorus
chorus

启动后浏览器打开 http://localhost:8637,默认账号 admin@chorus.local / chorus。进入 Settings → Agents → Create API Key 为每个智能体分别创建一个 cho_ 前缀的 Key。

⚠️ 每个智能体建议使用独立 API Key:Chorus 按 Key 区分智能体身份与权限,多智能体并行时互不干扰。

第二步:用 chorus agents add 批量接入智能体

设置好环境变量后(--agents 支持逗号分隔的多个智能体,命令幂等、可重复执行):

export CHORUS_URL="http://localhost:8637"
export CHORUS_API_KEY="cho_your_api_key"
chorus agents add --agents codex,kiro,opencode,dsh

该命令会自动:检测本机已安装的智能体 CLI → 通过各智能体自己的插件机制安装 Chorus 插件 → 把凭证写入 ~/.chorus/daemon.json。下面是各智能体的差异要点 📌

接入 Codex:插件 + 原生 MCP 双通道

Codex 有独立的 Chorus 插件(位于 plugins/chorus/),chorus agents add --agents codex 会注册 marketplace、安装插件并启用生命周期 hooks,同时把 <a href="https://link.gitcode.com/i/f8371dc6e660855dcc27eb109bacf87b" target="_blank">mcp_servers.chorus] 写入 ~/.codex/config.toml——密钥只存放在 ~/.codex/.env(0600 权限),config.toml 中不落地明文。之后 Codex 会话中直接输入 check in to chorus 即可,全程无需手动 export。详见 [docs/CONNECT_CODEX.md。

接入 Kiro:模板树 + 审查子智能体

Kiro 读取 ~/.kiro/{agents,skills,steering,settings} 目录,安装器会从你的 Chorus 实例下载模板树并合并 mcp.json(保留已有 MCP 配置并自动备份)。装完即获得 8 个 chorus-* 工作流技能和 3 个只读审查子智能体;也可以用 kiro-cli --agent chorus 启动全自动主智能体。详见 docs/CONNECT_KIRO.md。

接入 OpenCode:npm 插件自动加载

OpenCode 通过社区维护的 opencode-chorus 插件接入,chorus agents add --agents opencode 会幂等地把插件名加入 ~/.config/opencode/opencode.json 的 plugin 数组(首次修改前备份为 opencode.json.chorus-bak)。启动时由 Bun 自动从 npm 拉取插件。注意 OpenCode 依赖 shell 中导出的 CHORUS_URL / CHORUS_API_KEY,也可改用 ~/.config/opencode/chorus.json 配置文件。详见 docs/CONNECT_OPENCODE.md。

接入 dsh:DeepSeek Harness 插件包

dsh 通过公开的 @chorus-aidlc/chorus-dsh npm 包接入(需要 dsh 0.1.x 与 pnpm):

dsh plugin --profile <name> add @chorus-aidlc/chorus-dsh -w
chorus agents add --agents dsh --dsh-profile <name>

该包内置 Chorus 生命周期集成与 14 个技能(chorus、develop-chorus、review-chorus 等)。chorus agents add 会把凭证写入 ~/.chorus/daemon.json 和 $DSH_HOME/.env 两条通道。注意当前版本的 dsh 暂不支持 daemon 无人值守唤醒,仅支持交互式使用。详见 docs/CONNECT_DSH.md 与 packages/chorus-dsh/README.md。

第三步:用 check in 验证多智能体连接

在每个智能体中分别输入:

check in to chorus

智能体会调用 chorus_checkin() MCP 工具,返回该智能体的身份、权限与最近活动。四个智能体全部返回成功,即表示同一台机器上的多智能体身份已全部就绪 ✅ 打开 Chorus 界面,左下角会显示 "N agents online" 的在线状态。

Chorus 看板中多个智能体实时工作画面

进阶:让多个智能体在后台并行干活

接入只是第一步,Chorus 的 daemon 才是多智能体并行的引擎。在 ~/.chorus/daemon.json 中添加 agents[] 数组,一个 daemon 进程即可同时服务多个完全独立的智能体——不同身份、不同后端、不同工作目录:

{
  "url": "https://chorus.example.com",
  "agents": [
    { "apiKey": "cho_alpha", "agentType": "codex", "cwds": ["/home/me/projA"] },
    { "apiKey": "cho_beta",  "agentType": "kiro",  "cwds": ["/home/me/projB"] }
  ]
}

每个智能体拥有独立的连接、唤醒队列和 spawner,一个失败不影响其他。启动方式:

chorus daemon                 # 前台运行
chorus daemon -d              # 后台运行
chorus daemon install --cwd ~/proj   # 安装为开机自启服务(推荐)

把任务指派给某个目录后,daemon 会在无人值守时自动唤醒对应后端智能体执行工作,你在 Web 界面即可实时看到会话内容:

Chorus daemon 远程唤醒本地智能体执行任务

⚠️ daemon 默认是 YOLO 模式(完全自主执行),请在可信或沙箱环境中运行;如需限制,可加 --chorus-only 让智能体只能调用 Chorus MCP 工具。

所有智能体产出的 Idea、Proposal、Task 都会汇聚到项目资源图谱中,状态实时更新,你可以像看思维导图一样掌握每个智能体的进展:

Chorus 项目资源图谱展示多智能体任务进度

常见问题快速排查

现象 原因与解决
401 Unauthorized API Key 错误或已吊销,在 Settings → Agents 重新创建后重跑 chorus agents add
codex not found in PATH / No Kiro CLI found 先安装对应 CLI(如 npm i -g @openai/codex)再重试
URL must start with http:// CHORUS_URL 缺少协议前缀
OpenCode 插件未加载 清除 ~/.cache/opencode/packages/opencode-chorus@latest 后重启
daemon 修改配置不生效 daemon 启动时快照配置,需 chorus daemon restart

更多接入文档

掌握 chorus agents add 这一条命令,你就能在几分钟内把 Codex、Kiro、OpenCode、dsh 全部接入 Chorus,让它们在同一张看板上分工协作、由你来验证验收 🚀

登录后查看全文
Chorus