企业官网建设流程全解析

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-host

CodexHost是一款免费开源的 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 的核心亮点：

• 🪟一个窗口跑多 Agent：Pi、Claude Code、Grok Build 等十余个 Harness 共用同一个工作区和会话列表
• 🔀跨 Agent 协作：在输入框打#即可把任务委派给其他 Agent，各自独立会话并行执行
• 🔍原生 Diff 审查：每个回合自动汇总文件变更，点开 Review 查看完整 Diff
• 🌲任意消息 Fork：在当前工作区或新建 Worktree 中分叉，支持并行开发
• ⚡用量一目了然：缓存命中率、上下文占用、成本估算实时可见
• 🔑一键导入账号：把本地已登录的凭据复制到 Pi 等 Harness，免去重复配置
• 🖥️远程开发：把 VPS 添加为项目，直接在远程机器上运行 Agent

安装 CodexHost：3 条命令快速开始

前提条件：

1. 已安装Node.js 22+（22.19 或 24）并可用 npm
2. 已安装官方Codex Desktop（ChatGPT App）
3. 支持平台：macOS、Windows、Linux（x64 / ARM64）

命令 1：通过 npm 全局安装 CodexHost

npm install -g @codexhost/cli

命令 2：启动 CodexHost

codexhost

启动后 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）

更多文档与源码

• 项目入口（中文）：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