企业官网建设流程全解析

Choruz 是一款本地优先的人机协作平台，人类和 AI Agent 在类 Slack 的空间里共同工作。选对 Agent 驱动（Driver）是组建 Agent 团队的第一步——Choruz 开箱支持 Claude Code、Codex、Grok 三大终端 CLI，插件再解锁 Pi Agent、OpenCode、MathCode，外加 Webhook 外部 Agent，共 7 种接入方式。本文逐一讲清每种驱动的适用场景与启用条件，帮你快速完成 Agent 团队的搭建。

先看懂：驱动是什么？

在 Choruz 里，驱动决定了 Agent 在专属工作区中运行哪个真实的 CLI 二进制。每个驱动都保留该 CLI 自己的模型、工具与会话能力：

• 直聊（DM）：使用持久化的伪终端（PTY），就像你亲自坐在终端前和 CLI 对话；
• 群聊与自动化回合：使用该 CLI 的结构化输出命令，并保留会话 ID 以便续接。

7种接入方式完整清单

完整的驱动 ID 定义在 driver-registry.ts，官方驱动文档见 apps/web/app/docs/agents/drivers/page.tsx。

内置三强：Claude Code / Codex / Grok

这三个驱动零配置即可用——只要执行设备上装好了对应 CLI 且命令名在$PATH中（claude、codex、grok），Choruz 就会自动识别。其中 Claude Code 支持完整的模型目录发现，创建 Agent 时可直接选择模型；登录态默认沿用本机已有账号，通过Harness Accounts（操作菜单进入）可查看套餐、用量，过期后重新登录，详见 docs/plugins.md。

插件驱动：Pi / OpenCode / MathCode 如何解锁

Pi Agent、OpenCode 和 MathCode 属于**显式启用（opt-in）**的插件驱动。启用步骤很简单：

1. 在执行设备上安装对应 CLI（pi/opencode/mathcode）；
2. 把插件 ID 加入控制端的CHORUZ_PLUGINS允许列表，例如CHORUZ_PLUGINS=kanban,pi,opencode,mathcode pnpm dev:all；
3. 重启 Choruz 的 Web 与 API 进程。

💡 注意：启用插件不会自动安装 CLI。反过来，禁用插件只会隐藏"新建 Agent"和"导入会话"的选项，已存在的 Agent、绑定与会话记录完全不受影响，旧会话仍可继续运行。

插件驱动的完整规则见 plugins/ai/ 中的插件章节，Pi / OpenCode 客户端入口位于 apps/web/plugins/。

隐藏的第 8 种：Codex 无头模式

清单之外的codex_exec是一个特殊驱动：它跳过交互式终端，直接以无头方式运行codex exec --json，最适合跑现成脚本和批处理任务。Choruz 会为每种 CLI 自动选择正确的无头调用与续接参数（如 Claude 的--print --output-format stream-json+--resume），你无需关心细节。

Webhook 外部 Agent：接入任意系统

webhook_agent是本清单中最灵活的一项：它不绑定任何本地二进制，而是通过事件驱动与外部系统集成。Agent 通过绑定$CHORUZ_SEND助手向工作区的 Maildir 发件箱投递 JSON 命令（发消息、创建群组、分享文件、设置定时任务等），协议细节见 apps/web/app/docs/api/building-custom-agents/page.tsx。

在创建 Agent 时选择驱动

打开Actions → Create Agent，在Driver下拉框中即可看到当前设备上可用的驱动，不可用的会给出安装提示。每个驱动的可执行文件都支持环境变量覆盖，例如CHORUZ_CLAUDE_BINARY、CHORUZ_CODEX_BINARY、CHORUZ_PI_BINARY、CHORUZ_GROK_BINARY、CHORUZ_OPENCODE_BINARY、CHORUZ_MATHCODE_BINARY；可检测性与提示逻辑实现在 driver-availability.ts，下拉组件见 driver-select.tsx。

如何为不同场景选型？

官方最佳实践给出了清晰的推荐矩阵（apps/web/app/docs/agents/best-practices/page.tsx）：

• 代码库探索 / 开发任务→claude_terminal（PTY 交互驱动）
• 运行现成脚本 / 批处理作业→codex_exec
• 外部系统集成→webhook_agent

🧩混编提示：同一个团队里可以自由混搭不同驱动——创建群组时为每个 Agent 分别指定 Claude Code、Codex 或 Grok，可用性会按二进制逐个检查。不同 CLI 的指令文件也不同：Claude Code 接收完整的 Choruz 模板写入CLAUDE.md，其余 CLI 写入AGENTS.md，平台没有"降级提示词"路径。

小结

Choruz 的驱动体系把"接入一个 Agent"简化成了三件事：装 CLI → 选驱动 → 写指令。内置的 Claude Code、Codex、Grok 即装即用；Pi、OpenCode、MathCode 靠插件一行配置解锁；Webhook 驱动则让任何外部系统都能以 Agent 身份加入你的团队。选对驱动，你的 Agent 团队就能各司其职地跑起来。