企业官网建设流程全解析

CodexHost跨Agent协作完全使用教程：用#把任务委派给多个AI编码Agent并行执行

【免费下载链接】codex-hostRun Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。项目地址: https://gitcode.com/gh_mirrors/co/codex-host

CodexHost 是一个让你在 Codex Desktop 中直接运行 Pi、Claude Code、Grok 等十余个 AI 编码 Agent（Harness）的开源工具，它的核心亮点是跨 Agent 协作：在聊天框输入#即可把任务委派给其他 Agent 并行执行。本教程将带你从安装到实战，完整掌握 CodexHost 的多 Agent 任务委派玩法。

一、CodexHost 是什么？

简单说：多个 AI 编码 Agent，共用一个 Codex Desktop 窗口。

以往你想同时用 Codex 和 Claude Code，只能来回切换应用、手动复制上下文。CodexHost 把不同 Agent 的会话放进同一个侧边栏，还能让它们互相派活：让 Claude Code 审查代码、让 Pi 调查测试失败，各自独立会话、并行运行。

项目背景与完整功能介绍可参阅 README.md 和中文说明 docs/project/README.zh-CN.md。

二、三步快速安装 CodexHost

前置条件：已安装官方 Codex Desktop。

方式一：npm 安装（macOS / Windows / Linux）

npm install -g @codexhost/cli codexhost

运行codexhost后会直接以 CodexHost 增强模式启动 Codex Desktop。

方式二：安装包（macOS / Windows）

从 Releases 页面下载对应平台的安装包即可。

💡 如果启动失败或功能未生效，运行codexhost console打开本地控制台（默认http://127.0.0.1:26339/），可以查看失败原因、日志，并在 Codex 未运行时更新 CodexHost。Linux 支持 x64 和 ARM64，详见 docs/platforms/linux/linux.zh-CN.md。

三、用 # 把任务委派给另一个 Agent

这是 CodexHost 跨 Agent 协作的核心操作：

1. 在聊天输入框中输入#
2. 弹出浮层菜单，先列出所有可委派的 Agent，再列出当前 Harness 的命令与技能
3. 继续输入关键词即可筛选（如#cl快速定位 Claude Code）
4. 选中后，#query会变成一个原生的 Agent 提及标签（chip）

除了手打#，输入框右下角还有一个命令按钮，点击它同样能打开委派菜单——对不熟悉快捷键的入门用户非常友好。该菜单由渲染层组件实现，源码见 packages/renderer-extension/src/renderer-delegation-mention.ts。

然后，用自然语言描述你想委派的独立任务即可。

四、4 个经典委派场景

委派的关键是任务要自包含——目标 Agent 没有当前对话的记忆，你需要把上下文交代清楚。参考 README 给出的示例：

• 📋 「让#claude-code独立审查这次修改，并指出兼容性风险」
• 🐛 「让#pi调查这个测试为什么偶发失败」
• ⚡ 「让#omp实现这个功能，我继续整理文档」
• ✅ 「让#opencode在独立 Thread 中验证这个修复，并运行相关测试」

发送后，CodexHost 会为目标 Harness 创建一个独立的原生会话。发起方可以选择：

• 等待结果：让当前 Agent 有界等待（thread wait），任务完成后汇总给你
• 后台运行：委派后立即继续当前对话，稍后自己查看子会话进度

五、如何跟踪委派任务的进度

委派产生的子会话不是孤岛，它有完整的可观测性：

• ✅ 子会话出现在 Codex Desktop 会话列表中，随时点开看进度
• ✅ 子会话是普通可写会话，可以直接继续对话、追加需求
• ✅ 每轮改动自动汇总，点开 Diff 审查面板查看完整变更
• ✅ 每个 Agent 有独立图标，一眼区分谁在干什么

如果你习惯用命令行，CodexHost 还提供了一套面向 Agent 的 CLI（由安装的委派 Skill 自动发现，普通用户无感知）：

完整的委派契约（幂等去重、无人值守执行策略、结果回流边界等）记录在 openspec/specs/cross-harness-delegation/spec.md，委派协调逻辑位于 packages/host-runtime/ 目录。

六、相关功能：切换 Agent 与并行开发

除了#委派，还有两个高频操作值得了解：

1. 输入框右下角直接切换 Agent

不想委派、只想换一个人干活？点输入框右下角的 Agent 选择器，直接在同一个会话里切换当前 Agent 和模型。

2. 从任意消息 Fork，多工作树并行

对某个回合的结果不满意？右键消息可以从该点 Fork 出新分支——在当前工作空间继续，或新建一个 Git Worktree 并行开发，互不干扰。

📖 各 Harness 的能力边界（哪些支持 Fork、审批、用量查询）汇总在 docs/harnesses/capability-boundaries.md。

七、它是怎么做到的？（一分钟了解原理）

多数「多 Agent 客户端」自己重做一套聊天界面，CodexHost 的做法完全不同：

• 不重做 UI：通过 CDP / Electron Inspector 增强官方 Codex Desktop，流式输出、Diff、审批全部投影到原生界面
• 不改请求：CLI Shim 接入官方 app-server，原生 Codex 请求原样透传
• 独立会话编排：委派任务在目标 Harness 中作为独立原生会话运行，父子会话身份完全隔离，每个会话只归属一个 Agent

端到端测试可见 tests/e2e/composer-hash-menu.spec.ts，它验证了#菜单从按钮打开、筛选、选中到执行的完整链路。

八、总结

现在打开 Codex Desktop，输入#，把第一个任务派出去吧 ⚡

【免费下载链接】codex-hostRun Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。项目地址: https://gitcode.com/gh_mirrors/co/codex-host