【开源】Codex Pocket：用 Android / iPhone 查看和控制编辑器里的 Codex 会话

LeoChen 2026-07-29 19:56 1

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

我的帖子已经打上开源推广标签： 是

我的开源项目完整开源，无未开源部分： 是

我的开源项目已链接认可 LINUX DO 社区： 是

我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

分享一个我开发的开源项目：Codex Pocket。

Codex Pocket 是一套面向编程工作流的第三方移动伴侣，由 Android / iPhone APP、Windows Bridge 和编辑器 Companion 组成。

它可以把 VS Code、Cursor、Antigravity、Windsurf 等 Code 系编辑器中运行的 Codex 插件会话连接到手机，让我离开电脑后，也能继续查看和控制正在运行的编程任务。

需要先说明：

Codex Pocket 不是 OpenAI 官方 Codex 桌面版的修改版或手机版。

OpenAI 官方 Codex 桌面应用是独立产品；Codex Pocket 是社区开发的开源项目，连接和控制的是 Code 系编辑器中的 Codex 插件会话。

本项目与 OpenAI、LINUX DO 均不存在官方隶属或合作关系。

为什么开发这个项目

使用 Codex 执行编译、重构、代码检索或批量修改时，一个任务可能需要运行很长时间。

有时候只是暂时离开电脑，却无法及时看到任务进度、审批请求或者错误信息，所以我开发了 Codex Pocket。

通过手机可以继续：

查看 Codex 的回复、思考和工具调用

查看命令执行与文件修改过程

在手机上继续发送编程要求

处理命令、文件修改和权限审批

查看工作区文件并在对话中引用

查看任务中断原因和重试状态

停止由 Codex Pocket 发起的任务

消息排队与引导

当 Codex 正在执行任务时，从手机发送的新消息会默认进入等待队列。

当前对话结束后，Bridge 会按照顺序自动发送等待中的消息，不需要一直保持 APP 打开。

如果某条消息是对当前任务的补充、纠正或额外限制，也可以手动点击“引导”，将消息直接追加到正在运行的回合。

简单来说：

等待： 当前任务结束后，作为下一条消息自动发送

引导： 立即补充到当前正在运行的任务中

异常重试

Codex Pocket 支持由 Windows Bridge 持久执行的自动重试。

当任务因为异常中断时，可以在手机上查看：

中断原因

已经重试的次数

当前重试状态

下一次重试时间

每次重试时需要发送的提示内容

还可以配置：

最大重试次数

每次重试的等待间隔

重试时发送的提示词

是否持续重试直到成功

这些设置保存在 Bridge 服务端。

即使退出手机 APP，等待队列和重试任务也可以继续运行，不依赖 APP 一直保持在前台。

支持的平台

组件	支持情况	说明
Android APP	支持	Release 提供正式签名 APK
iPhone APP	支持	Release 提供未签名 IPA，需要使用自己的 Apple ID 自签
Windows Bridge	支持	提供 Windows x64 自包含控制器
Code 系编辑器	支持	VS Code、Cursor、Antigravity、Windsurf 等

Android 和 iPhone 使用相同的共享业务逻辑和 Bridge API。

两个平台都支持消息同步、等待队列、手动引导、移动审批、中断状态和自动重试。

iPhone 安装说明

GitHub Release 提供的是未签名 IPA，不能直接安装，需要使用自己的 Apple ID 完成自签。

这里特别推荐使用：

Sideloadly

Sideloadly 可以在 Windows 或 macOS 上为 IPA 签名并安装到 iPhone，不需要 Xcode。

需要注意：

免费 Apple ID 也可以用于自签

免费 Apple ID 的签名通常只有 7 天有效期

到期前需要重新签名安装

重新安装前建议确认重要配置已经保存

完整安装说明：

github.com/LeoChen-CoreMind/codex-pocket

docs/IOS_SELF_SIGN_INSTALL.md

main

# iOS 自签安装



GitHub Release 中的 `CodexPocket-iOS-unsigned-*.ipa` 是未签名安装包，不能直接在 iPhone 上安装。用户必须使用自己的 Apple ID 重新签名；Android 的 `chennb.jks` 证书不能用于 iOS。



> **特别推荐：[Sideloadly](https://sideloadly.io/)**。Windows 用户使用这个工具完成 IPA 签名和安装即可，不需要 Xcode。其他签名工具仅作为备选，也不建议使用无法正常获取 Apple `XcodeToken` 的旧版本工具。



## 安装前检查



1. 下载 IPA 和同一 Release 中的 `SHA256SUMS.txt`。

2. 在 Windows PowerShell 中计算 SHA-256：



   ```powershell

   (Get-FileHash .\CodexPocket-iOS-unsigned-2026.07.8.ipa -Algorithm SHA256).Hash.ToLower()

   ```



3. 确认结果与 `SHA256SUMS.txt` 中该 IPA 的值完全一致。



## Windows + Sideloadly



1. 从 [Sideloadly 官方网站](https://sideloadly.io/) 下载并安装最新版。

此文件已被截断。显示原始文件

Windows Bridge 控制器

Windows Bridge 控制器负责连接手机、编辑器和 Codex 会话，可以：

扫描正在运行的编辑器进程和窗口

识别 VS Code、Cursor、Antigravity、Windsurf 等编辑器

动态分析编辑器 CLI、扩展目录和配置信息

自动安装或修复 Editor Companion

在自动识别不正确时允许用户手动配置

管理 Bridge 地址和访问密钥

管理局域网防火墙规则

查看在线编辑器和在线会话

管理 FTP 和 FRP 状态

在 APP 退出后继续执行消息队列和自动重试任务

MCP 手机交互

项目还提供 MCP 手机交互功能。

支持 MCP 的 AI 客户端可以向手机发送：

Markdown 内容

图片

单选和多选项

自由文字输入

用户确认请求

适合需要在长时间自动化任务中等待人工确认的场景。

界面预览

下方使用小图展示，点击图片可以查看原图。

界面	小图预览	用途
在线会话		查看在线编辑器、窗口、会话和工作区
实时对话		查看任务进度，发送、停止、排队或引导消息
移动审批		处理命令执行、文件修改和权限审批
MCP 交互		接收 Markdown、图片、选项和文字输入
Bridge 控制器		管理 Bridge、Codex、编辑器、访问密钥和 FRP

使用方法

在 Windows 电脑上运行 Codex Pocket Bridge。

启动 VS Code、Cursor、Antigravity 或 Windsurf。

在编辑器中打开一个 Codex 插件会话。

在 Bridge 中选择正在运行的编辑器。

点击“应用并启动”。

点击“复制连接信息”。

在 Android 或 iPhone APP 中填写 Bridge 地址和访问密钥。

从在线列表进入对应的 Codex 会话。

Bridge 默认使用局域网连接，不依赖项目提供的公共中转服务器。

手机和电脑位于同一个可信局域网时，可以直接连接。

如果需要从外网使用，可以自行通过 FRP 映射本机 TCP 47831。

MCP 远程访问需要额外映射 MCP 实际配置的端口。

公网使用时建议配置 TLS、访问白名单或 VPN，不要公开 Bridge 地址和访问密钥。

关于项目现阶段

Codex Pocket 目前仍是第一代产品，也是项目早期的公开版本。

部分功能可能还不够完善，在不同手机、系统版本和编辑器环境下，难免会遇到 Bug、兼容性问题或者体验不够顺畅的地方，还请各位佬友理解。

这是一个由个人利用业余时间维护的开源项目，并非商业团队产品。

我会根据问题影响、优先级和自己的时间安排持续维护，逐步修复问题和完善功能，但处理速度可能不会很快。

使用过程中遇到问题，可以在 GitHub 提交 Issue，也欢迎直接提交 PR、补充文档或者参与功能改进。

反馈问题时，如果能附上以下信息，会更方便定位：

手机平台和系统版本

使用的编辑器及版本

Bridge 版本

问题复现步骤

相关截图或日志

感谢各位佬友的体验、反馈和包容。

下载与源码

GitHub 项目：

最新正式版 v2026.07.8：

iPhone 自签安装说明：

github.com/LeoChen-CoreMind/codex-pocket

docs/IOS_SELF_SIGN_INSTALL.md

main

# iOS 自签安装



GitHub Release 中的 `CodexPocket-iOS-unsigned-*.ipa` 是未签名安装包，不能直接在 iPhone 上安装。用户必须使用自己的 Apple ID 重新签名；Android 的 `chennb.jks` 证书不能用于 iOS。



> **特别推荐：[Sideloadly](https://sideloadly.io/)**。Windows 用户使用这个工具完成 IPA 签名和安装即可，不需要 Xcode。其他签名工具仅作为备选，也不建议使用无法正常获取 Apple `XcodeToken` 的旧版本工具。



## 安装前检查



1. 下载 IPA 和同一 Release 中的 `SHA256SUMS.txt`。

2. 在 Windows PowerShell 中计算 SHA-256：



   ```powershell

   (Get-FileHash .\CodexPocket-iOS-unsigned-2026.07.8.ipa -Algorithm SHA256).Hash.ToLower()

   ```



3. 确认结果与 `SHA256SUMS.txt` 中该 IPA 的值完全一致。



## Windows + Sideloadly



1. 从 [Sideloadly 官方网站](https://sideloadly.io/) 下载并安装最新版。

此文件已被截断。显示原始文件

正式版提供：

Android 正式签名 APK

iPhone 未签名 IPA

Windows x64 自包含 Bridge 控制器

SHA-256 校验文件

项目使用 MIT License 完整开源，欢迎体验、提交 Issue 和参与改进。

如果觉得项目有帮助，也欢迎点一个 Star。

最新回复 (11)

KR 07-29 20:08

1楼

想问一下，有计划做支持 Linux 端的 Bridge吗。我当前是在Windows下使用 Cursor/VScode 但主要是通过SSH访问Linux环境，然后在上面运行 CodeX / Claude Code

改用 Codex 插件确实也是办法，但姑且还是先问问。

感谢你的开源项目
tina_summer 07-29 20:14

2楼

我的叫CodePocket，不过我的不支持codex，codex官方订阅很香啊，就没想着支持它。
LeoChen 楼主 07-29 20:17

3楼

Linux 端 Bridge 是可以做的。项目的 Bridge 核心本身就是用 Node.js 编写的，已经具备跨平台运行基础。目前主要是 Windows 控制器、编辑器进程识别、路径解析和 Companion 自动安装这些部分针对 Windows 做了适配，Linux 端补充一下相关逻辑就可以，整体改动量应该很小Codex一小时能搞定。

你这种通过 Cursor / VS Code Remote SSH 在 Linux 上运行 Codex 的场景，可以把 Bridge 和 Companion 直接部署到远程 Linux 环境。局域网内可以直接连接；需要从公网访问时，可以使用 FRP 映射服务器上的 Bridge 端口。
LeoChen 楼主 07-29 20:21

4楼

啥功能，codex最近很便宜，中转站，而且写项目太慢了，我就想着开发一个这个。
KR 07-29 20:21

5楼

好的，谢谢回复。

正在看项目内容，学习一下
djjd g 07-29 20:24

6楼

感觉很好的项目呀，但是只支持 windows 吗？能不能整个 linux 的，我现在日常可以通过手机 termius 连服务器，然后用 tmux 与 codex 对话，感觉打字什么的很不方便因为是 tui，佬友能做个映射吗？意思就是只要手机能通过终端链接的服务器，就能把 codex 对话映射到手机的这种对话 chat app的这种界面，感觉比 tui 好用很多也方便很多啊，把终端放在后台用户不可见的那种，毕竟我只是想与服务器的 codex 对下话，并不是想用终端发什么命令
LeoChen 楼主 07-29 20:27

7楼

目前我支持了windows，不过想要兼容linux工程量不大，因为用的是node.js写的支持跨平台，只需要做一下简单的适配，目前支持局域网，然后可以用frp映射到公网使用
hexinzhe 07-29 20:40

8楼
支持楼主，感谢开源。我关注这个方向有一段时间，各位如果有好的方案也可以交流一下。

我的需求是自己的项目，所有平台通用，可以查看和编辑，可以正常 codex 对话。总之就是我希望在移动平台上只需要手指点点点就能完成大部分操作，完成一个项目，这种在前 vibe 时代不可想象的事，现在慢慢有解了。我目前采用的方案是服务器部署 vscode server，在 mac 上使用 vscode ssh tunnel 连接 Linux 上的 workspace，使用 codex 插件；在 ipad 上使用 vscode server，同样是 codex 插件；iPhone 上原本使用一个开源项目 codex-web，后来失效就没在折腾了。

目前遇到的问题：
1. session 状态不能实时同步，这是最大的痛点。我希望 mac 上开启对话后，拿着 ipad 就可以继续观察和操作，不用一直坐在桌子前。但是 codex 插件并不支持无缝衔接，具体表现在我开启 codex 插件会话，再打开另一个 vscode 窗口，之前窗口的 codex 会话状态只能同步一部分，正在进行的状态无法同步过去。甚至有时候新开 vscode 窗口会导致之前进行的会话自动停止。这只是单端同步的，但同样的，我在 vscode server 上开启的 codex 会话，其最新状态无法实时显示在 mac 的 vscode 的 codex 插件里。
2. vscode server 跟 Safari 相性非常差，从 4.118.0 开始，vscode插件已经无法在 Safari 中正常使用了，我只能一直停留在 4.117.0。更别提时不时的卡死，无法操作。
  
  不过虽然 vscode server 的方案有这些问题，我直到现在也还是一直在用，因为他相比其他方案，还是更完整，更稳定。很多 web 方案其能力太简陋了，无法在 mac 上为我提供全量 ide 的能力，在移动设备上的操作便利性和功能性也都不如 vscode server。
  
  各位如果有什么更好的方案，可以交流一下。
chancat 07-29 21:15

9楼

感谢分享。

得空试试，之前用MobileVC和 Paseo
Kangnaixi 07-29 22:57

10楼

这个看起来有点爽准备试试 codex 已经慢到我坐在电脑前睡着了
LeoChen 楼主 07-29 22:58

11楼

就是因为这样子，我才要开发这个的

* 帖子来源Linux.do

附近帖子

↑有没有人从最近的 claude bug 发现了一点风控规律？
↑昨天刚冲了十块钱，今天一个问题就这样了
↑最近掌握了一个功能：入睡
↑闲着也是闲着想开个emby公益服
↑有佬有办法现在能订阅kimi-k3吗？一直是预约界面，小红薯刷到有人不停刷新买到了，是真的吗？
📍 【开源】Codex Pocket：用 Android / iPhone 查看和控制编辑器里的 Codex 会话
↓giffgaff 据说订阅任意套餐复活
↓（已拉闸）Gemini无脑白嫖一年
↓马斯克：已要求 SpaceXAI 团队以非破坏性的方式扫描书籍，而不是直接切除书脊
↓加班，全部门就剩我一个了，1亿token助我早下班。
↓linux下面，有什么好用的语音输入方案吗？

飞读

LeoChen

主题数
1

帖子数
1

注册排名
3

随机推荐