CodexHost快速开始：3条命令安装，在Codex Desktop里直接用Claude Code和Pi

CodexHost快速开始3条命令安装在Codex Desktop里直接用Claude Code和Pi【免费下载链接】codex-hostRun Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。项目地址: https://gitcode.com/gh_mirrors/co/codex-hostCodexHost是一款免费开源的 Agent 宿主工具它让你在 Codex Desktop 里直接运行 Claude Code 和 Pi还支持 Grok、OpenCode 等十余种 Agent Harness。装好之后你不再需要在多个终端和 App 之间来回切换所有 Agent 的会话都跑在同一个 Codex Desktop 窗口里共享侧边栏、Diff 审查、Fork 工作区等能力还能互相委派任务。CodexHost 是什么为什么值得装一句话概括CodexHost 把其他 AI 编程 Agent 原生地接进 Codex Desktop而不是再造一个聊天界面。它通过扩展官方 Codex Desktop 实现集成因此你熟悉的一切交互——流式输出、工具调用状态、编辑 Diff、审批、提问——都保留在 Codex Desktop 的原生 UI 中。CodexHost 的核心亮点一个窗口跑多 AgentPi、Claude Code、Grok Build 等十余个 Harness 共用同一个工作区和会话列表跨 Agent 协作在输入框打#即可把任务委派给其他 Agent各自独立会话并行执行原生 Diff 审查每个回合自动汇总文件变更点开 Review 查看完整 Diff任意消息 Fork在当前工作区或新建 Worktree 中分叉支持并行开发⚡用量一目了然缓存命中率、上下文占用、成本估算实时可见一键导入账号把本地已登录的凭据复制到 Pi 等 Harness免去重复配置️远程开发把 VPS 添加为项目直接在远程机器上运行 Agent安装 CodexHost3 条命令快速开始前提条件已安装Node.js 2222.19 或 24并可用 npm已安装官方Codex DesktopChatGPT App支持平台macOS、Windows、Linuxx64 / ARM64命令 1通过 npm 全局安装 CodexHostnpm install -g codexhost/cli命令 2启动 CodexHostcodexhost启动后 Codex Desktop 就会带上 CodexHost 的全部增强功能直接开始使用。命令 3打开本地控制台检查状态codexhost console控制台会打开本地页面http://127.0.0.1:26339/展示上次启动失败原因、Codex Desktop 版本和 Host Runtime 日志是排查安装问题的第一站Windows 下也可从开始菜单的codexhost console打开。备选方案图形化安装包macOS 和 Windows 用户也可以从官方 Releases 下载对应平台的安装包双击安装后由安装包自动拉起 Codex Desktop。Linux 则统一通过上面的 npm 方式安装且需先安装官方 ChatGPT App 的.deb/.rpm包详见 docs/platforms/linux/linux.md。第一次使用 Claude Code 和 Pi如何切换 Agent安装完成后在输入框右下角的 Agent / Model 选择器里就能看到你本机已安装的 Harness例如 Claude Code、Pi选择一个后新会话就运行在该 Harness 中界面与 Codex 完全一致。首次使用时Codex Desktop 会按 Harness 可执行文件发现机制 自动探测本机 CLI如果某个 Agent 未安装连接页会给出安装指引。跨 Agent 协作一句话把任务委派给另一个 Agent这是 CodexHost 最上头的玩法——在聊天输入框输入#即可选择要委派的 Agent例如让#claude-code独立审查这次改动的兼容性风险让#pi排查一个不稳定的测试为什么时好时坏让#omp在后台实现某个功能你继续写文档CodexHost 会在目标 Harness 中创建一个独立的原生会话它会出现在 Codex Desktop 的对话列表里你可以随时打开查看进度或继续对话也可以让调用方等待结果。进阶功能Diff 审查、账号导入与用量面板Diff 审查每个回合结束后对话中会出现一张变更汇总卡片点击 Review 即可在右侧打开完整 Diff——Claude Code 和 Pi 的文件改动都支持原生 Edit Diff 展示。一键账号导入在账号设置中可以把本地已登录的 Codex 等凭据复制到 Pi并实时查看剩余额度省去重复登录的麻烦。远程开发连接 VPS在远程机器上直接跑 Agent如果你有 VPS 或远程开发机CodexHost 支持把 Harness 跑在远程机器上而界面留在本地两台机器需为相同版本。先在本机 Codex Desktop 的Settings → Connections → SSH中添加远程机器然后在远程机器上执行npm install -g codexhost/cli codexhost remote install codexhost remote start codexhost remote status回到本地通过 codexhost 启动 Codex Desktop打开 SSH 工作区即可在 composer 中选择 Harness 直接操作远程项目。完整配置、诊断与卸载步骤见 docs/platforms/remote/remote-ssh-host.md。常见问题排查FAQ问题解决方法CodexHost 启动失败 / Codex 打开后没有增强功能运行codexhost console查看失败原因与日志macOS 首次打开提示应用无法验证执行xattr -dr com.apple.quarantine /Applications/codexhost.appWindows 使用绿色解压版 Codex Desktop设置环境变量CODEXHOST_INSTALL_ROOT指向解压目录完全退出 Codex 后重新运行codexhostLinux 启动前注意需先完全退出 ChatGPT AppCodexHost 不会接管独立运行的实例更多文档与源码项目入口中文docs/project/README.zh-CN.md文档总目录docs/index.md领域术语表Harness、Thread、Provider 等概念docs/project/领域术语表.md贡献指南CONTRIBUTING.md如果你想从源码构建 CodexHost需要 Node.js 22.19 / 24 与 Rust可以克隆仓库git clone https://gitcode.com/gh_mirrors/co/codex-host cd codex-host npm ci npm start至此CodexHost 安装、Agent 切换、跨 Agent 委派与远程开发这条快速开始路线就走通了。建议先在一个小项目里试试让#claude-code审查、让#pi修 bug的组合拳——体验过多 Agent 同屏协作后就很难回到单 Agent 时代了。【免费下载链接】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），仅供参考