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-hostCodexHost 是一个让你在 Codex Desktop 中直接运行 Pi、Claude Code、Grok 等十余个 AI 编码 AgentHarness的开源工具它的核心亮点是跨 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 / Linuxnpm 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 协作的核心操作在聊天输入框中输入#弹出浮层菜单先列出所有可委派的 Agent再列出当前 Harness 的命令与技能继续输入关键词即可筛选如#cl快速定位 Claude Code选中后#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 自动发现普通用户无感知命令作用codexhost delegate start --harness id --task text发起委派创建子会话后立即返回codexhost thread read thread只读查看子会话最新结果codexhost thread wait thread --timeout-ms n有界等待子任务完成codexhost thread list --parent thread列出某个会话委派出的所有子会话codexhost thread send / cancel向子会话追加消息 / 取消当前回合完整的委派契约幂等去重、无人值守执行策略、结果回流边界等记录在 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它验证了#菜单从按钮打开、筛选、选中到执行的完整链路。八、总结你想知道答案委派入口输入框打#或点右下角命令按钮能委派给谁所有已安装且可用的 HarnessCodex、Claude Code、Pi、OpenCode、Grok 等并行吗是每个任务独立会话、独立运行能追进度吗能子会话在列表中随时可打开、可继续对话现在打开 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考