在 Codex Desktop 中运行 Pi 和其他 Harness
我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。
但 Codex 并不是唯一优秀的 Agent Harness，也有人偏好 Claude Code 和 Pi Agent。
CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent，同时保留 Codex 的原生体验，并让它们协作完成任务
⭐ 如果这个项目对你有帮助，请给我们一个 Star！⭐
快速导航： 界面预览 • 快速使用 • 功能状态 • 跨 Agent 协作 • 远程连接 • 加入交流群 • 开发
无需切换应用，Pi、Claude Code、OpenCode、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。
codexhost-demo-github.mp4
下载安装包（macOS、Windows）
前往 最新版本 下载与系统和 CPU 架构匹配的安装包：macOS 选择 DMG，Windows 选择 EXE。
安装问题排查
**macOS**首次打开时如提示应用无法验证，请执行：
xattr -dr com.apple.quarantine /Applications/codexhost.appWindows - 绿色解压版 Codex Desktop
如使用绿色版本，将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录：
[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT", "D:\CodexPortable", "User")然后完全退出 Codex Desktop，重新打开终端并启动 codexhost。
|
完整工作界面 |
|
|
macOS 会在原生 ChatGPT 菜单栏图标内追加剩余额度百分比，Windows 则使用任务栏覆盖图标；优先使用 5 小时窗口，没有时回退到 7 天窗口。 |
|
|
Mermaid 图表可视化渲染 |
| 能力 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 流式回复 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 工具状态 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Edit Diff | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 提问 / 取消 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Model / Thinking 选择 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 工具审批 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ |
| 权限模式 | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Agent 间任务协作 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | ✅ |
| Usage | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ |
| Fork | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 上下文压缩 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅ | — | ✅ | ✅ |
| 斜杠命令 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 修订上一条消息 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
你可以让当前 Agent 把独立任务交给另一个 Harness。例如：
让
claude-code独立审查这次修改，并指出兼容性风险。让
pi调查这个测试为什么偶发失败。让
omp实现这个功能，我继续整理文档。让
opencode在独立 Thread 中验证这个修复，并运行相关测试。
CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中，你可以随时打开、查看进度或继续对话。
在本机的 Codex Desktop 中使用远程节点上的 Harness，在远程机器执行任务，同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。
支持两种连接方式：
通过 SSH 连接并控制其他开发节点上的 Harness，需要 Codex Desktop 原生 SSH 工作区。
| 客户端 ↓ / 远程 Host → | macOS | Linux | Windows |
|---|---|---|---|
| macOS | ✅ | ✅ | ❌ |
| Linux | ✅ | ✅ | ❌ |
| Windows | ✅ | ✅ | ❌ |
在 SSH 远程主机上执行：
npm install -g @codexhost/cli
codexhost remote install
codexhost remote start
codexhost remote status然后通过本地 codexhost 启动 Codex Desktop，打开 SSH 工作区，在远程输入框的 Agent/Model 选择器中选择目标 Harness。
Windows 作为被控 Host 时，可以保留 Codex Desktop 官方配对、账号认证和 relay，在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。
这条链路不新增公网服务或 TCP 端口；Harness 凭据仍保留在被控 Windows 上。
多数「多 Agent 客户端」通过 ACP 协议接入不同 Harness。接入快，但工具、审批、权限、Diff、提问等原生能力会先被削平。
CodexHost 尽量不走这条路：
- Desktop 侧：用 CDP / Electron Inspector 在官方 Codex Desktop 上增强 Agent 选择与会话界面，不重做聊天壳，也不改官方安装包
- 协议侧：用 CLI Shim 透明接入官方 app-server；Codex 请求原样转发
- Harness 侧：按各自原生接口接入。Pi 走官方 RPC，Claude Code 走 Agent SDK / CLI，再投影到 Desktop 已有的流式输出、工具、Diff、审批和提问
- 编排侧：为被委派的 Harness 创建独立 Native Session 与普通可写 Thread，并单独保存委派关系。创建与结果观察彼此分离，发起方显式选择读取、等待或后台运行
目标是保真，不只「能聊」。流式、工具状态、可靠 Patch、原生审批和提问，都尽量来自 Harness 自己，而不是 Host 猜测或伪造。
|
加入交流群 对 CodexHost 用法、功能感兴趣的开发者可以扫码加入微信群交流。
|
|
提交 Issue 或 PR 前可阅读贡献说明；PR 标题标签、简短 CI 结果和发布前校验见仓库维护自动化。
环境要求：官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。
git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start以 Pi 为例。从左到右是一次请求的调用链：Desktop → 公共层 → Pi 插件 → 原生进程。
主要实现插件的 Manifest、工厂、Adapter、Session 及原生通信与转换逻辑。当前 Renderer 仍有静态接线，完整 Desktop 接入还需单独处理。 新增 Harness 时，可以让编码 Agent 使用仓库内的 codexhost-add-harness Skill。它说明了插件结构、公共 Adapter 接口、能力实现与测试要求。