把 Claude Code 和 Pi 装进 Codex Desktop（codex-host）

Codex Desktop 里的 Codex 只是众多 Agent Harness 中的一个。Claude Code、Pi、Oh My Pi、Grok Build、DeepSeek Harness 各有各的用法和擅长场景，实际工作里很难只留一个。麻烦在于每换一个 Harness，就要多开一个终端、多维护一套配置、多记一份会话历史，跨 Harness 的上下文还得靠人脑串。

CodexHost 是用 TypeScript 写的开源工具，让 Pi、Claude Code 等 Agent Harness 在 Codex Desktop 里原生运行，多 Harness 的会话、Diff 审阅与用量统计都收在同一个窗口内。

这篇把它和几个同样围绕 Agent Harness 做集成的项目放在一起对照，说明它擅长什么、在哪些环节不如同类、以及什么情况下值得装。

仓库在 https://github.com/BytePioneer-AI/codex-host，采用 LGPL-3.0 许可证，主要语言是 TypeScript，语言占比 82.7%。当前 Star 数 2802，Fork 245，开放 Issue 79 个，最近一次提交是 2026-10-12。

这几个项目分别在解决什么

CodexHost 的做法是在 Codex Desktop 外面包一层 Host，不去替换它。装好之后，Codex、Pi、Oh My Pi、Claude Code、Grok Build、DeepSeek Harness 的会话出现在同一个侧边栏，切换 Agent 的入口在输入框右下角。README 徽章里列的名字还要更长，OpenCode、Antigravity、Kiro、CodeBuddy、WorkBuddy、Cursor、Hermes、Qoder、Kimi Code 都在其中。

最短的安装路径是一条 npm 命令，macOS、Windows、Linux 都适用；不想用 npm 的可以从 Releases 页面下载对应平台的安装包，Linux 支持 x64 与 ARM64，细节写在 docs/platforms/linux/linux.md。

npm install -g @codexhost/cli
codexhost

启动之后如果 Codex 打开了却没有 codexhost 的功能，可以运行 codexhost console，在本地控制台 http://127.0.0.1:4399/ 里看到上一次启动失败的原因、Codex Desktop 版本和 Host Runtime 日志，也能在 Codex 未运行时更新 codexhost。更新本身走 codexhost update，它会先检查最新版本再准备升级，升级前需要先退出 Codex Desktop。macOS 首次启动提示应用无法验证时，执行 xattr -dr com.apple.quarantine /Applications/codexhost.app；Windows 上如果用便携版 Codex Desktop，需要把环境变量 CODEXHOST_INSTALL_ROOT 指向解压目录，彻底退出 Codex Desktop，另开终端再运行 codexhost。

dashi-taskboard 走的是另一条路。它的官方描述是可灵活嵌入的任务面板，支持 Codex 与 DeepSeek Harness，管的是任务这一层，把待办和状态摆到面板上，不去接管某个桌面 App 的会话视图。

bestruirui/octopus 的定位是 LLM API 聚合网关，自我描述是「为个人打造的 LLM API 聚合网关」。它解决模型接入层的问题，把多家模型的 API 收拢成一个入口，方便统一调用和计费，不碰 Agent 会话管理，也不做桌面端界面。milisp/codexia 自称轻量 Agent 工作站，覆盖 Codex、Claude code 和 keke-agent。AMAP-ML/LongHorizon-Harness 的目标是跨桌面应用的长周期 computer-use，让 Agent 在桌面应用之间执行任务，不局限于代码编辑器。

逐项对照

下表按主要用途、上手成本、明显短板和地址列了五个项目。上手成本一列，只有 CodexHost 的安装方式在素材里有明确写法，其余几个仓库描述里没有说明安装步骤。

差距出现在哪

第一处差距在集成深度。CodexHost 接管的东西比同类多：会话层面，不同 Harness 共享同一个侧边栏；代码层面，每一轮对话都会生成变更摘要，点 Review 就能在右侧打开完整 Diff；版本层面，任意一条消息都能 Fork 出去，可以在当前工作区开分支，也可以新建 Worktree 并行推进。v0.13.0 之后 Harness 插件改成动态加载，远程 Host 的线程可以从任意 Harness 打开；v0.13.1 把 Claude Code 的 Ultracode 接了进来，能同时跟进多个并行 Agent 的进度并打开它们的对话。

用量统计是它另一处拉开距离的地方。v0.13.0 起，codexhost 会跟踪 Claude Code、OpenCode 这类外部 Harness 的用量，显示每次请求的成本与速度，模型价格可以刷新，还有整机总计；v0.13.2 给 Hermes 补上了全局用量统计。Desktop 设置里能看到本地用量、估算成本、缓存用量与输出速度。面板型和网关型的同类项目都不覆盖这一层。

它不如同类的地方同样具体。前提是 Codex Desktop，不用这个 App 的人完全用不上它，而 octopus 这类网关对任何客户端都成立，dashi-taskboard 也不需要接管桌面应用。仓库当前有 79 个开放 Issue，里面能看到不少兼容性摩擦：mac ARM 更新之后找不到 Pi、Windows 11 上 Claude 会话的排队消息投递失败并报 thread not found、远程连接无法使用、codexhost 启动 codex 时报 Official request failed; retry explicitly、内置浏览器访问网页被管理员安全策略拦截。这些条目在当前都标记为已解决，只是它们说明项目要覆盖的边界很多，版本迭代也快。

什么情况下选它

• 你日常就在 Codex Desktop 里写代码，同时有 Claude Code 或 Pi 的使用习惯，想把两边的会话并到同一个窗口，装它是直接对口的做法。
• 你需要按 Harness 看单次请求的成本与速度，并把这台机器的总体花销算清楚，codexhost 的用量统计覆盖了这一层。
• 你有自己的远程开发机，愿意在设置里的 Remote Connections 页面填连接信息，让 codexhost 在远程机器上一键装好，本地与远程的会话保持同步。

这些条件也划出了边界。已经在 Codex Desktop 上工作、手上又有多个 Harness 的人，是它的目标用户；把模型接入统一入口当成主要诉求的人，用 octopus 这类网关更省事；需要一个独立任务面板的人，dashi-taskboard 的体积和概念都更小。对升级频率敏感、希望装上就不管的，要先算上 79 个开放 Issue 和几乎每周一版的发布节奏带来的维护成本。

远程连接与内置浏览器这类能力只用在自有设备或已获得授权的目标上。把连接信息指向他人机器、或在未获授权的站点上做自动化操作，可能触碰法律与平台规则。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.1 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。