Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验,并让它们协作完成任务

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MITLINUX DO

PiCodexClaude CodeDeepSeek HarnessGrokOh My Pi

简体中文 · English · 한국어

快速导航:界面预览快速使用功能状态跨 Agent 协作远程连接加入交流群开发

界面预览

无需切换应用,Pi、Claude Code、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。

codexhost-demo-github.mp4

界面

Pi、Oh My Pi、Grok Build 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

快速使用

使用 npm

支持 macOS、Windows 和 x64/ARM64 Linux

npm install -g @codexhost/cli
codexhost

或下载安装包(macOS、Windows)

安装问题排查

macOS - Apple 验证问题

首次打开时如提示应用无法验证,请执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

Windows - 绿色解压版 Codex Desktop

如使用绿色版本,将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录:

[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT","D:\CodexPortable","User")

然后完全退出 Codex Desktop,重新打开终端并启动 codexhost。

交互展示

完整工作界面

Codex Desktop 中 codexhost 的完整工作界面,展示项目结构、对话区域和多个 Agent 选择器

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model,Codex、Pi、Claude Code、DeepSeek Harness、Grok 和 Oh My Pi 均可选择

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算
五小时与七天窗口的剩余额度和重置时间

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

功能状态

能力CodexPiOh My PiClaude CodeGrokDeepSeek Harness
流式回复原生
工具状态原生
Edit Diff原生
提问 / 取消原生— / ✅
Model / Thinking 选择原生
工具审批原生
权限模式原生
Agent 间任务协作
Usage原生
Fork原生
上下文压缩原生
斜杠命令原生
修订上一条消息原生

跨 Agent 协作

你可以让当前 Agent 把独立任务交给另一个 Harness。例如:

@claude-code 独立审查这次修改,并指出兼容性风险。

@pi 调查这个测试为什么偶发失败。

@omp 实现这个功能,我继续整理文档。

CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中,你可以随时打开、查看进度或继续对话。

远程连接 Harness

在本机的 Codex Desktop 中使用远程节点上的 Harness,在远程机器执行任务,同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。

支持两种连接方式:

1️⃣ SSH 远程(推荐用于 Mac/Linux 服务器)

通过 SSH 连接并控制其他开发节点上的 Harness,需要 Codex Desktop 原生 SSH 工作区。

客户端 ↓ / 远程 Host →macOSLinuxWindows
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。

查看 SSH 配置、诊断与卸载文档 →

2️⃣ Remote Control 远程(实验 · 推荐用于 Windows)

Windows 作为被控 Host 时,可以保留 Codex Desktop 官方配对、账号认证和 relay,在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。

这条链路不新增公网服务或 TCP 端口;Harness 凭据仍保留在被控 Windows 上。

查看 Remote Control 配置、传输边界与诊断文档 →

怎么做的

多数「多 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 用法、功能感兴趣的开发者可以扫码加入微信群交流。
  • 安装问题可以加群询问
  • 功能建议与反馈
  • 开发问题讨论
  • Bug 问题建议提交 issue
欢迎一起贡献~
7ba6eda891ba4c8d091f2a71a8b8e81d

开发

环境要求:官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验,并让它们协作完成任务

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MITLINUX DO

PiCodexClaude CodeDeepSeek HarnessGrokOh My Pi

简体中文 · English · 한국어

快速导航:界面预览快速使用功能状态跨 Agent 协作远程连接加入交流群开发

界面预览

无需切换应用,Pi、Claude Code、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。

codexhost-demo-github.mp4

界面

Pi、Oh My Pi、Grok Build 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

快速使用

使用 npm

支持 macOS、Windows 和 x64/ARM64 Linux

npm install -g @codexhost/cli
codexhost

或下载安装包(macOS、Windows)

安装问题排查

macOS - Apple 验证问题

首次打开时如提示应用无法验证,请执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

Windows - 绿色解压版 Codex Desktop

如使用绿色版本,将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录:

[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT","D:\CodexPortable","User")

然后完全退出 Codex Desktop,重新打开终端并启动 codexhost。

交互展示

完整工作界面

Codex Desktop 中 codexhost 的完整工作界面,展示项目结构、对话区域和多个 Agent 选择器

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model,Codex、Pi、Claude Code、DeepSeek Harness、Grok 和 Oh My Pi 均可选择

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算
五小时与七天窗口的剩余额度和重置时间

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

功能状态

能力CodexPiOh My PiClaude CodeGrokDeepSeek Harness
流式回复原生
工具状态原生
Edit Diff原生
提问 / 取消原生— / ✅
Model / Thinking 选择原生
工具审批原生
权限模式原生
Agent 间任务协作
Usage原生
Fork原生
上下文压缩原生
斜杠命令原生
修订上一条消息原生

跨 Agent 协作

你可以让当前 Agent 把独立任务交给另一个 Harness。例如:

@claude-code 独立审查这次修改,并指出兼容性风险。

@pi 调查这个测试为什么偶发失败。

@omp 实现这个功能,我继续整理文档。

CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中,你可以随时打开、查看进度或继续对话。

远程连接 Harness

在本机的 Codex Desktop 中使用远程节点上的 Harness,在远程机器执行任务,同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。

支持两种连接方式:

1️⃣ SSH 远程(推荐用于 Mac/Linux 服务器)

通过 SSH 连接并控制其他开发节点上的 Harness,需要 Codex Desktop 原生 SSH 工作区。

客户端 ↓ / 远程 Host →macOSLinuxWindows
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。

查看 SSH 配置、诊断与卸载文档 →

2️⃣ Remote Control 远程(实验 · 推荐用于 Windows)

Windows 作为被控 Host 时,可以保留 Codex Desktop 官方配对、账号认证和 relay,在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。

这条链路不新增公网服务或 TCP 端口;Harness 凭据仍保留在被控 Windows 上。

查看 Remote Control 配置、传输边界与诊断文档 →

怎么做的

多数「多 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 用法、功能感兴趣的开发者可以扫码加入微信群交流。
  • 安装问题可以加群询问
  • 功能建议与反馈
  • 开发问题讨论
  • Bug 问题建议提交 issue
欢迎一起贡献~
7ba6eda891ba4c8d091f2a71a8b8e81d

开发

环境要求:官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验,并让它们协作完成任务

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MITLINUX DO

PiCodexClaude CodeDeepSeek HarnessGrokOh My Pi

简体中文 · English · 한국어

快速导航:界面预览快速使用功能状态跨 Agent 协作远程连接加入交流群开发

界面预览

无需切换应用,Pi、Claude Code、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。

codexhost-demo-github.mp4

界面

Pi、Oh My Pi、Grok Build 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

快速使用

使用 npm

支持 macOS、Windows 和 x64/ARM64 Linux

npm install -g @codexhost/cli
codexhost

或下载安装包(macOS、Windows)

安装问题排查

macOS - Apple 验证问题

首次打开时如提示应用无法验证,请执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

Windows - 绿色解压版 Codex Desktop

如使用绿色版本,将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录:

[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT","D:\CodexPortable","User")

然后完全退出 Codex Desktop,重新打开终端并启动 codexhost。

交互展示

完整工作界面

Codex Desktop 中 codexhost 的完整工作界面,展示项目结构、对话区域和多个 Agent 选择器

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model,Codex、Pi、Claude Code、DeepSeek Harness、Grok 和 Oh My Pi 均可选择

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算
五小时与七天窗口的剩余额度和重置时间

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

功能状态

能力CodexPiOh My PiClaude CodeGrokDeepSeek Harness
流式回复原生
工具状态原生
Edit Diff原生
提问 / 取消原生— / ✅
Model / Thinking 选择原生
工具审批原生
权限模式原生
Agent 间任务协作
Usage原生
Fork原生
上下文压缩原生
斜杠命令原生
修订上一条消息原生

跨 Agent 协作

你可以让当前 Agent 把独立任务交给另一个 Harness。例如:

@claude-code 独立审查这次修改,并指出兼容性风险。

@pi 调查这个测试为什么偶发失败。

@omp 实现这个功能,我继续整理文档。

CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中,你可以随时打开、查看进度或继续对话。

远程连接 Harness

在本机的 Codex Desktop 中使用远程节点上的 Harness,在远程机器执行任务,同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。

支持两种连接方式:

1️⃣ SSH 远程(推荐用于 Mac/Linux 服务器)

通过 SSH 连接并控制其他开发节点上的 Harness,需要 Codex Desktop 原生 SSH 工作区。

客户端 ↓ / 远程 Host →macOSLinuxWindows
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。

查看 SSH 配置、诊断与卸载文档 →

2️⃣ Remote Control 远程(实验 · 推荐用于 Windows)

Windows 作为被控 Host 时,可以保留 Codex Desktop 官方配对、账号认证和 relay,在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。

这条链路不新增公网服务或 TCP 端口;Harness 凭据仍保留在被控 Windows 上。

查看 Remote Control 配置、传输边界与诊断文档 →

怎么做的

多数「多 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 用法、功能感兴趣的开发者可以扫码加入微信群交流。
  • 安装问题可以加群询问
  • 功能建议与反馈
  • 开发问题讨论
  • Bug 问题建议提交 issue
欢迎一起贡献~
7ba6eda891ba4c8d091f2a71a8b8e81d

开发

环境要求:官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验,并让它们协作完成任务

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MITLINUX DO

PiCodexClaude CodeDeepSeek HarnessGrokOh My Pi

简体中文 · English · 한국어

快速导航:界面预览快速使用功能状态跨 Agent 协作远程连接加入交流群开发

界面预览

无需切换应用,Pi、Claude Code、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。

codexhost-demo-github.mp4

界面

Pi、Oh My Pi、Grok Build 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

快速使用

使用 npm

支持 macOS、Windows 和 x64/ARM64 Linux

npm install -g @codexhost/cli
codexhost

或下载安装包(macOS、Windows)

安装问题排查

macOS - Apple 验证问题

首次打开时如提示应用无法验证,请执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

Windows - 绿色解压版 Codex Desktop

如使用绿色版本,将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录:

[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT","D:\CodexPortable","User")

然后完全退出 Codex Desktop,重新打开终端并启动 codexhost。

交互展示

完整工作界面

Codex Desktop 中 codexhost 的完整工作界面,展示项目结构、对话区域和多个 Agent 选择器

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model,Codex、Pi、Claude Code、DeepSeek Harness、Grok 和 Oh My Pi 均可选择

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算
五小时与七天窗口的剩余额度和重置时间

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

功能状态

能力CodexPiOh My PiClaude CodeGrokDeepSeek Harness
流式回复原生
工具状态原生
Edit Diff原生
提问 / 取消原生— / ✅
Model / Thinking 选择原生
工具审批原生
权限模式原生
Agent 间任务协作
Usage原生
Fork原生
上下文压缩原生
斜杠命令原生
修订上一条消息原生

跨 Agent 协作

你可以让当前 Agent 把独立任务交给另一个 Harness。例如:

@claude-code 独立审查这次修改,并指出兼容性风险。

@pi 调查这个测试为什么偶发失败。

@omp 实现这个功能,我继续整理文档。

CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中,你可以随时打开、查看进度或继续对话。

远程连接 Harness

在本机的 Codex Desktop 中使用远程节点上的 Harness,在远程机器执行任务,同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。

支持两种连接方式:

1️⃣ SSH 远程(推荐用于 Mac/Linux 服务器)

通过 SSH 连接并控制其他开发节点上的 Harness,需要 Codex Desktop 原生 SSH 工作区。

客户端 ↓ / 远程 Host →macOSLinuxWindows
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。

查看 SSH 配置、诊断与卸载文档 →

2️⃣ Remote Control 远程(实验 · 推荐用于 Windows)

Windows 作为被控 Host 时,可以保留 Codex Desktop 官方配对、账号认证和 relay,在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。

这条链路不新增公网服务或 TCP 端口;Harness 凭据仍保留在被控 Windows 上。

查看 Remote Control 配置、传输边界与诊断文档 →

怎么做的

多数「多 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 用法、功能感兴趣的开发者可以扫码加入微信群交流。
  • 安装问题可以加群询问
  • 功能建议与反馈
  • 开发问题讨论
  • Bug 问题建议提交 issue
欢迎一起贡献~
7ba6eda891ba4c8d091f2a71a8b8e81d

开发

环境要求:官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验,并让它们协作完成任务

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MITLINUX DO

PiCodexClaude CodeDeepSeek HarnessGrokOh My Pi

简体中文 · English · 한국어

快速导航:界面预览快速使用功能状态跨 Agent 协作远程连接加入交流群开发

界面预览

无需切换应用,Pi、Claude Code、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。

codexhost-demo-github.mp4

界面

Pi、Oh My Pi、Grok Build 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

快速使用

使用 npm

支持 macOS、Windows 和 x64/ARM64 Linux

npm install -g @codexhost/cli
codexhost

或下载安装包(macOS、Windows)

安装问题排查

macOS - Apple 验证问题

首次打开时如提示应用无法验证,请执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

Windows - 绿色解压版 Codex Desktop

如使用绿色版本,将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录:

[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT","D:\CodexPortable","User")

然后完全退出 Codex Desktop,重新打开终端并启动 codexhost。

交互展示

完整工作界面

Codex Desktop 中 codexhost 的完整工作界面,展示项目结构、对话区域和多个 Agent 选择器

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model,Codex、Pi、Claude Code、DeepSeek Harness、Grok 和 Oh My Pi 均可选择

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算
五小时与七天窗口的剩余额度和重置时间

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

功能状态

能力CodexPiOh My PiClaude CodeGrokDeepSeek Harness
流式回复原生
工具状态原生
Edit Diff原生
提问 / 取消原生— / ✅
Model / Thinking 选择原生
工具审批原生
权限模式原生
Agent 间任务协作
Usage原生
Fork原生
上下文压缩原生
斜杠命令原生
修订上一条消息原生

跨 Agent 协作

你可以让当前 Agent 把独立任务交给另一个 Harness。例如:

@claude-code 独立审查这次修改,并指出兼容性风险。

@pi 调查这个测试为什么偶发失败。

@omp 实现这个功能,我继续整理文档。

CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中,你可以随时打开、查看进度或继续对话。

远程连接 Harness

在本机的 Codex Desktop 中使用远程节点上的 Harness,在远程机器执行任务,同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。

支持两种连接方式:

1️⃣ SSH 远程(推荐用于 Mac/Linux 服务器)

通过 SSH 连接并控制其他开发节点上的 Harness,需要 Codex Desktop 原生 SSH 工作区。

客户端 ↓ / 远程 Host →macOSLinuxWindows
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。

查看 SSH 配置、诊断与卸载文档 →

2️⃣ Remote Control 远程(实验 · 推荐用于 Windows)

Windows 作为被控 Host 时,可以保留 Codex Desktop 官方配对、账号认证和 relay,在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。

这条链路不新增公网服务或 TCP 端口;Harness 凭据仍保留在被控 Windows 上。

查看 Remote Control 配置、传输边界与诊断文档 →

怎么做的

多数「多 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 用法、功能感兴趣的开发者可以扫码加入微信群交流。
  • 安装问题可以加群询问
  • 功能建议与反馈
  • 开发问题讨论
  • Bug 问题建议提交 issue
欢迎一起贡献~
7ba6eda891ba4c8d091f2a71a8b8e81d

开发

环境要求:官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验,并让它们协作完成任务

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MITLINUX DO

PiCodexClaude CodeDeepSeek HarnessGrokOh My Pi

简体中文 · English · 한국어

快速导航:界面预览快速使用功能状态跨 Agent 协作远程连接加入交流群开发

界面预览

无需切换应用,Pi、Claude Code、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。

codexhost-demo-github.mp4

界面

Pi、Oh My Pi、Grok Build 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

快速使用

使用 npm

支持 macOS、Windows 和 x64/ARM64 Linux

npm install -g @codexhost/cli
codexhost

或下载安装包(macOS、Windows)

安装问题排查

macOS - Apple 验证问题

首次打开时如提示应用无法验证,请执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

Windows - 绿色解压版 Codex Desktop

如使用绿色版本,将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录:

[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT","D:\CodexPortable","User")

然后完全退出 Codex Desktop,重新打开终端并启动 codexhost。

交互展示

完整工作界面

Codex Desktop 中 codexhost 的完整工作界面,展示项目结构、对话区域和多个 Agent 选择器

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model,Codex、Pi、Claude Code、DeepSeek Harness、Grok 和 Oh My Pi 均可选择

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算
五小时与七天窗口的剩余额度和重置时间

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

功能状态

能力CodexPiOh My PiClaude CodeGrokDeepSeek Harness
流式回复原生
工具状态原生
Edit Diff原生
提问 / 取消原生— / ✅
Model / Thinking 选择原生
工具审批原生
权限模式原生
Agent 间任务协作
Usage原生
Fork原生
上下文压缩原生
斜杠命令原生
修订上一条消息原生

跨 Agent 协作

你可以让当前 Agent 把独立任务交给另一个 Harness。例如:

@claude-code 独立审查这次修改,并指出兼容性风险。

@pi 调查这个测试为什么偶发失败。

@omp 实现这个功能,我继续整理文档。

CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中,你可以随时打开、查看进度或继续对话。

远程连接 Harness

在本机的 Codex Desktop 中使用远程节点上的 Harness,在远程机器执行任务,同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。

支持两种连接方式:

1️⃣ SSH 远程(推荐用于 Mac/Linux 服务器)

通过 SSH 连接并控制其他开发节点上的 Harness,需要 Codex Desktop 原生 SSH 工作区。

客户端 ↓ / 远程 Host →macOSLinuxWindows
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。

查看 SSH 配置、诊断与卸载文档 →

2️⃣ Remote Control 远程(实验 · 推荐用于 Windows)

Windows 作为被控 Host 时,可以保留 Codex Desktop 官方配对、账号认证和 relay,在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。

这条链路不新增公网服务或 TCP 端口;Harness 凭据仍保留在被控 Windows 上。

查看 Remote Control 配置、传输边界与诊断文档 →

怎么做的

多数「多 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 用法、功能感兴趣的开发者可以扫码加入微信群交流。
  • 安装问题可以加群询问
  • 功能建议与反馈
  • 开发问题讨论
  • Bug 问题建议提交 issue
欢迎一起贡献~
7ba6eda891ba4c8d091f2a71a8b8e81d

开发

环境要求:官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验,并让它们协作完成任务

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MITLINUX DO

PiCodexClaude CodeDeepSeek HarnessGrokOh My Pi

简体中文 · English · 한국어

快速导航:界面预览快速使用功能状态跨 Agent 协作远程连接加入交流群开发

界面预览

无需切换应用,Pi、Claude Code、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。

codexhost-demo-github.mp4

界面

Pi、Oh My Pi、Grok Build 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

快速使用

使用 npm

支持 macOS、Windows 和 x64/ARM64 Linux

npm install -g @codexhost/cli
codexhost

或下载安装包(macOS、Windows)

安装问题排查

macOS - Apple 验证问题

首次打开时如提示应用无法验证,请执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

Windows - 绿色解压版 Codex Desktop

如使用绿色版本,将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录:

[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT","D:\CodexPortable","User")

然后完全退出 Codex Desktop,重新打开终端并启动 codexhost。

交互展示

完整工作界面

Codex Desktop 中 codexhost 的完整工作界面,展示项目结构、对话区域和多个 Agent 选择器

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model,Codex、Pi、Claude Code、DeepSeek Harness、Grok 和 Oh My Pi 均可选择

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算
五小时与七天窗口的剩余额度和重置时间

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

功能状态

能力CodexPiOh My PiClaude CodeGrokDeepSeek Harness
流式回复原生
工具状态原生
Edit Diff原生
提问 / 取消原生— / ✅
Model / Thinking 选择原生
工具审批原生
权限模式原生
Agent 间任务协作
Usage原生
Fork原生
上下文压缩原生
斜杠命令原生
修订上一条消息原生

跨 Agent 协作

你可以让当前 Agent 把独立任务交给另一个 Harness。例如:

@claude-code 独立审查这次修改,并指出兼容性风险。

@pi 调查这个测试为什么偶发失败。

@omp 实现这个功能,我继续整理文档。

CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中,你可以随时打开、查看进度或继续对话。

远程连接 Harness

在本机的 Codex Desktop 中使用远程节点上的 Harness,在远程机器执行任务,同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。

支持两种连接方式:

1️⃣ SSH 远程(推荐用于 Mac/Linux 服务器)

通过 SSH 连接并控制其他开发节点上的 Harness,需要 Codex Desktop 原生 SSH 工作区。

客户端 ↓ / 远程 Host →macOSLinuxWindows
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。

查看 SSH 配置、诊断与卸载文档 →

2️⃣ Remote Control 远程(实验 · 推荐用于 Windows)

Windows 作为被控 Host 时,可以保留 Codex Desktop 官方配对、账号认证和 relay,在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。

这条链路不新增公网服务或 TCP 端口;Harness 凭据仍保留在被控 Windows 上。

查看 Remote Control 配置、传输边界与诊断文档 →

怎么做的

多数「多 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 用法、功能感兴趣的开发者可以扫码加入微信群交流。
  • 安装问题可以加群询问
  • 功能建议与反馈
  • 开发问题讨论
  • Bug 问题建议提交 issue
欢迎一起贡献~
7ba6eda891ba4c8d091f2a71a8b8e81d

开发

环境要求:官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Repository files navigation

CodexHost

在 Codex Desktop 中运行 Pi 和其他 Harness

我们认为 Codex Desktop 提供了目前最好的桌面开发交互体验。

Codex 并不是唯一优秀的 Agent Harness,也有人偏好 Claude CodePi Agent

CodexHost 让你在 Codex Desktop 中选择真正执行任务的 Agent,同时保留 Codex 的原生体验,并让它们协作完成任务

⭐ 如果这个项目对你有帮助,请给我们一个 Star!⭐

license MITLINUX DO

PiCodexClaude CodeDeepSeek HarnessGrokOh My Pi

简体中文 · English · 한국어

快速导航:界面预览快速使用功能状态跨 Agent 协作远程连接加入交流群开发

界面预览

无需切换应用,Pi、Claude Code、OMP、Grok Build 和 DeepSeek Harness 都可以在同一个 Codex Desktop 窗口中直接使用。

codexhost-demo-github.mp4

界面

Pi、Oh My Pi、Grok Build 和 DeepSeek Harness 作为独立 Thread 运行在 Codex Desktop 中

快速使用

使用 npm

支持 macOS、Windows 和 x64/ARM64 Linux

npm install -g @codexhost/cli
codexhost

或下载安装包(macOS、Windows)

安装问题排查

macOS - Apple 验证问题

首次打开时如提示应用无法验证,请执行:

xattr -dr com.apple.quarantine /Applications/codexhost.app

Windows - 绿色解压版 Codex Desktop

如使用绿色版本,将 CODEXHOST_INSTALL_ROOT 设置为 Codex Desktop 的解压目录:

[Environment]::SetEnvironmentVariable("CODEXHOST_INSTALL_ROOT","D:\CodexPortable","User")

然后完全退出 Codex Desktop,重新打开终端并启动 codexhost。

交互展示

完整工作界面

Codex Desktop 中 codexhost 的完整工作界面,展示项目结构、对话区域和多个 Agent 选择器

Agent 与 Model 选择

提交前选择真正执行任务的 Agent 与 Model,Codex、Pi、Claude Code、DeepSeek Harness、Grok 和 Oh My Pi 均可选择

Usage 与费用信息

Usage 面板展示上下文、缓存命中与费用估算
五小时与七天窗口的剩余额度和重置时间

Mermaid 图表可视化渲染

Pi + Codex Desktop 与 Pi Agent TUI 的 Mermaid 图表可视化渲染对比

功能状态

能力CodexPiOh My PiClaude CodeGrokDeepSeek Harness
流式回复原生
工具状态原生
Edit Diff原生
提问 / 取消原生— / ✅
Model / Thinking 选择原生
工具审批原生
权限模式原生
Agent 间任务协作
Usage原生
Fork原生
上下文压缩原生
斜杠命令原生
修订上一条消息原生

跨 Agent 协作

你可以让当前 Agent 把独立任务交给另一个 Harness。例如:

@claude-code 独立审查这次修改,并指出兼容性风险。

@pi 调查这个测试为什么偶发失败。

@omp 实现这个功能,我继续整理文档。

CodexHost 会为目标 Harness 创建独立的 Native Session。委派会话将出现在 Codex Desktop 的会话列表中,你可以随时打开、查看进度或继续对话。

远程连接 Harness

在本机的 Codex Desktop 中使用远程节点上的 Harness,在远程机器执行任务,同时继续使用 Codex Desktop 的统一界面。两端需要安装相同版本的 codexhost。

支持两种连接方式:

1️⃣ SSH 远程(推荐用于 Mac/Linux 服务器)

通过 SSH 连接并控制其他开发节点上的 Harness,需要 Codex Desktop 原生 SSH 工作区。

客户端 ↓ / 远程 Host →macOSLinuxWindows
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。

查看 SSH 配置、诊断与卸载文档 →

2️⃣ Remote Control 远程(实验 · 推荐用于 Windows)

Windows 作为被控 Host 时,可以保留 Codex Desktop 官方配对、账号认证和 relay,在另一台已配对电脑的 Codex Desktop 中使用 Windows 上的 Harness。需先确保官方 Remote Control 已经可以运行原生 Codex 任务。

这条链路不新增公网服务或 TCP 端口;Harness 凭据仍保留在被控 Windows 上。

查看 Remote Control 配置、传输边界与诊断文档 →

怎么做的

多数「多 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 用法、功能感兴趣的开发者可以扫码加入微信群交流。
  • 安装问题可以加群询问
  • 功能建议与反馈
  • 开发问题讨论
  • Bug 问题建议提交 issue
欢迎一起贡献~
7ba6eda891ba4c8d091f2a71a8b8e81d

开发

环境要求:官方 Codex Desktop、Node.js 22.19+ 或 24、Rust。

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

鸣谢

  • 感谢 LINUX DO 社区一直以来的支持。
  • 感谢 Paseo 项目在多 Harness 接入思路与架构设计方面带来的启发与参考。

About

Run Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages