Codex App 的移动端能力不是一个单独的新应用,而是集成在 ChatGPT iOS 里。手机端更像一个远程控制台:你在手机上发任务,真正执行代码读写、命令运行、浏览器自动化的,仍然可以是电脑上的 Codex App,也可以是云端 Codex。
这种形态解决的是一个很实际的问题:人不在电脑前,也能给本地项目或云端环境派发开发任务,而不是依赖即时通讯工具转发命令、保持会话不断线。
整体结构可以这样理解:
flowchart LR
Phone[ChatGPT iOS<br/>Codex 入口] -->|派发任务 / 查看状态| Desktop[电脑上的 Codex App]
Desktop -->|读写代码| Repo[(本地项目目录)]
Desktop -->|需要浏览器操作时| Browser[浏览器自动化扩展]
Phone -->|无需本地电脑时| Cloud[云端 Codex]
手机端负责下达意图,电脑端负责真正接触本地文件和运行环境。只要这个边界想清楚,后面的权限、配对、多电脑连接就都容易理解了。
使用前需要准备什么
要让移动端 Codex 正常出现,两个地方都要更新到支持该能力的版本:
| 组件 | 要求 | 作用 |
|---|---|---|
| Codex App 桌面端 | 更新到最新版 | 负责连接本地项目、执行任务 |
| ChatGPT iOS | 更新到最新版 | 提供移动端 Codex 入口 |
| 浏览器自动化扩展 | 按桌面端提示安装 | 让 Codex 在需要时操作浏览器 |
| 同一账号权限 | 需要具备对应 Codex / 模型能力 | 决定手机端是否显示相关入口 |
桌面端更新后,Codex App 可能会弹出移动端配置引导。如果之前没有安装浏览器自动化扩展,也可以在这一步顺手装好。这个扩展不是每个任务都必须用,但涉及网页调试、浏览器交互、页面验证时会很有用。
手机端 Codex 的权限模式
ChatGPT iOS 里的 Codex 对话会出现和桌面端不同的权限选项。核心差异在于:手机端到底按照自己的默认授权方式执行,还是沿用桌面端对某个项目文件夹已经设置好的权限。
常见可以分成两类:
| 权限模式 | 含义 | 适合场景 | 注意点 |
|---|---|---|---|
| 自动模式 | 由移动端 Codex 按默认策略处理任务 | 临时任务、风险较低的代码修改 | 需要确认它能执行哪些操作 |
| 继承文件夹权限 | 沿用电脑端 Codex App 对该项目目录的权限配置 | 已经在桌面端配置过项目边界 | 桌面端权限过宽或过窄,手机端也会继承影响 |
如果一个项目已经在电脑端配置过允许访问的目录、命令边界和确认策略,更推荐让手机端继承该文件夹权限。这样同一个项目在电脑和手机上使用时,安全边界是一致的,不容易出现“桌面端限制了,手机端却绕开了”的情况。
连接第一台电脑
移动端连接电脑的流程可以概括为三步:
sequenceDiagram
participant Desktop as 电脑端 Codex App
participant Phone as ChatGPT iOS
participant Project as 本地项目目录
Desktop->>Desktop: 更新并打开移动端配置引导
Phone->>Desktop: 读取电脑端配对二维码
Desktop-->>Phone: 返回远程地址与连接状态
Phone->>Project: 通过桌面端 Codex 执行项目任务
配置成功后,ChatGPT iOS 的 Codex 页面顶部会显示当前连接的电脑远程地址,并展示连接状态。在线时通常会显示为绿色状态,这个状态很重要:它表示手机端已经能把任务发到这台电脑上的 Codex App。
连接完成后,手机端并不是直接访问你的文件系统,而是通过桌面端 Codex App 间接操作项目目录。换句话说,电脑端 Codex App 是否运行、项目目录权限是否正确、电脑是否在线,都会影响手机端任务能不能顺利执行。
连接第二台或更多电脑
如果你有多台电脑,比如一台 MacBook Pro 和一台 Mac mini,移动端 Codex 可以尝试分别连接它们。每台电脑都需要安装并更新 Codex App。
有时第二台电脑更新后也会出现移动端配置步骤,但不一定自动展示配对二维码。可以尝试完全退出 Codex App,再重新打开。进入主界面后,左侧对话区域的右下角可能会出现一个手机图标,点开后会生成新的配对二维码,用 ChatGPT iOS 读取即可绑定这台新主机。
多电脑连接可以这样理解:
flowchart TB
Phone[ChatGPT iOS<br/>Codex 移动端]
Phone -->|连接| HostA[电脑 A<br/>Codex App]
Phone -->|连接| HostB[电脑 B<br/>Codex App]
Phone -->|派发任务| Cloud[云端 Codex]
HostA --> RepoA[(项目 A)]
HostB --> RepoB[(项目 B)]
不过,用配对二维码添加新电脑时,存在覆盖或替换已有连接的可能。如果你需要长期稳定地管理多台主机,SSH(Secure Shell,安全外壳协议)会更适合。
为什么 SSH 更适合多电脑连接
二维码配对适合快速上手,尤其是只连接一台常用电脑时,操作成本很低。但多台机器长期使用时,SSH 的优势更明显:主机地址、用户名、端口、密钥都可以固定下来,连接关系不容易被新的配对流程影响。
| 连接方式 | 优点 | 缺点 | 适合场景 |
|---|---|---|---|
| 配对二维码 | 设置快,适合新手 | 多主机时可能覆盖旧连接 | 临时连接、单电脑使用 |
| SSH | 稳定、可控、适合多主机 | 初次配置门槛更高 | 多电脑、长期远程开发 |
| 云端 Codex | 不依赖本地电脑在线 | 不能直接访问本地未同步文件 | 云端任务、轻量修改、远程派发 |
SSH 的准备工作主要包括三件事:
- 目标电脑开启 SSH 服务。
- 准备好用户名、主机地址和端口。
- 尽量使用密钥登录,而不是密码登录。
在另一台电脑上可以先用命令验证 SSH 是否可用:
ssh your-user@192.168.1.20
如果使用固定别名,可以在 ~/.ssh/config 里写清楚主机信息:
Host codex-mac-mini
HostName 192.168.1.20
User your-user
Port 22
IdentityFile ~/.ssh/id_ed25519
配置完成后,再用别名测试连接:
ssh codex-mac-mini
如果这一步能连通,移动端 Codex 通过 SSH 添加主机时,就可以使用相同的主机地址、用户名、端口和密钥信息。不同系统的 SSH 服务开关位置不一样,macOS 通常在“系统设置 -> 通用 -> 共享 -> 远程登录”里开启,Linux 服务器一般需要确认 sshd 服务正在运行。
云端 Codex 适合处理什么任务
移动端不只能连接本地电脑,也可以直接给云端 Codex 派发任务。云端方式的最大好处是:不需要本地电脑保持在线,也不需要维护本地远程连接。
适合云端 Codex 的任务包括:
| 任务类型 | 是否适合云端 | 原因 |
|---|---|---|
| 解释代码思路 | 适合 | 不一定需要本地运行环境 |
| 生成小段函数或脚本 | 适合 | 输入输出清晰,依赖少 |
| 修改云端仓库中的代码 | 适合 | 文件可由云端环境访问 |
| 调试本地未提交代码 | 不适合 | 云端拿不到本地最新文件 |
| 操作本机浏览器或本地服务 | 不适合 | 需要电脑端环境配合 |
如果任务依赖本地项目、浏览器状态、本机数据库或本地开发服务,就应该连接电脑端 Codex App。若只是让 Codex 生成代码、分析问题、整理方案,云端 Codex 会更省事。
常见问题与处理办法
| 问题 | 可能原因 | 处理方式 |
|---|---|---|
| ChatGPT iOS 里没有 Codex 入口 | 应用版本旧,或账号权限未开放 | 更新 ChatGPT iOS,确认账号具备相关能力 |
| Codex App 没有弹出移动端配置引导 | 桌面端版本旧,或引导已被关闭 | 更新桌面端;完全退出后重新打开 |
| 第二台电脑没有显示配对二维码 | 配置引导没有自动进入对应步骤 | 在左侧对话区域右下角找手机图标 |
| 手机端顶部没有绿色在线状态 | 电脑端未运行、电脑休眠、网络不可达 | 保持 Codex App 打开,检查网络和系统休眠设置 |
| 新连接顶掉旧电脑 | 配对方式对多主机管理不够稳定 | 改用 SSH 连接多台主机 |
| 手机端操作权限不符合预期 | 权限模式选择不对 | 使用继承文件夹权限,或回到桌面端调整项目权限 |
安全边界要提前想清楚
移动端 Codex 的便利性来自“手机远程控制电脑执行开发任务”,风险也来自这里。配置时至少要关注三点:
- 项目目录不要给得太宽:只授权当前项目目录,不要直接开放整个用户目录。
- 自动执行权限要谨慎:涉及删除文件、批量改动、运行脚本时,最好保留确认步骤。
- SSH 密钥要妥善保存:不要把私钥放进项目仓库,也不要把连接信息发到不可信渠道。
移动端入口让 Codex 更像一个随身开发控制台。单电脑使用时,配对二维码最快;多电脑长期使用时,SSH 更稳;不依赖本地环境的任务,则可以直接交给云端 Codex。把这三种方式分清楚,手机端 Codex 才能既方便,又不把本地开发环境暴露得过宽。