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

为什么 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，同时把[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-dshnpm 包接入（需要 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 的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 界面即可实时看到会话内容：

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

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

常见问题快速排查

更多接入文档

• Codex 完整指南：docs/CONNECT_CODEX.md
• Kiro 完整指南：docs/CONNECT_KIRO.md
• OpenCode 完整指南：docs/CONNECT_OPENCODE.md
• dsh 完整指南：docs/CONNECT_DSH.md
• Claude Code 接入：docs/CONNECT_CLAUDE_CODE.md
• 其他 MCP 客户端（Cursor、Continue 等）：docs/CONNECT_OTHER_AGENTS.md
• daemon 多智能体运维：docs/DAEMON.md
• MCP 工具清单：docs/MCP_TOOLS.md

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