Linux 下 Codex CLI 连接手机:用手机 ChatGPT 远程连接 Linux 开发环境
2026/9/9 6:29:41 网站建设 项目流程

前言

我的主要开发环境一直是Linux + VS Code,平时使用 VS Code 中的 Codex 插件辅助开发。

最近发现 Codex CLI 已经加入了一个很有意思的实验性功能:

Remote Control

它可以在 Linux 上启动 Codex App Server,并生成手机端使用的配对信息,使 ChatGPT 手机 App 能够访问支持 Remote 的 Codex 会话。

这样我们的开发方式就有机会变成:

┌───────────────────────┐ │ ChatGPT 手机 App │ │ Remote │ └───────────┬───────────┘ │ │ Remote Control ▼ ┌───────────────────────┐ │ Linux 开发机 │ │ │ │ Codex CLI │ │ ↓ │ │ app-server daemon │ │ ↓ │ │ Linux 项目 / Git │ │ C++ / ROS 2 / Python │ └───────────────────────┘

也就是说:

代码和开发环境仍然放在 Linux 上,而手机只作为 Codex 的远程控制端。

对于 Linux、ROS、服务器、嵌入式、机器人开发用户来说,这个工作流还是非常有吸引力的。

需要注意的是,截至本文测试时,OpenAI 仍然将 App Server 中的 Remote Control API 标记为experimental(实验性),因此后续命令、界面和配对流程都有可能发生变化。


一、我的使用环境

本文测试环境:

系统:Linux x86_64 开发方式:VS Code Codex:VS Code Codex Extension + Codex CLI Codex CLI:0.147.0 登录方式:ChatGPT Account

在安装 CLI 之前,我一直只有:

Linux └── VS Code └── Codex 插件

VS Code 插件本身可以正常使用 Codex,但是插件界面目前并没有提供一个明显的 Linux → 手机 Remote Control 配对入口。

所以这里额外安装Codex CLI

最终结构变成:

Linux ├── VS Code │ └── Codex Extension │ └── Codex CLI └── Remote Control

平时仍然可以继续使用 VS Code 开发,而 CLI 主要负责 Remote Control。


二、安装 Codex CLI

这里我没有使用:

npm install -g @openai/codex

而是使用 OpenAI 当前提供的 standalone installer:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安装指令有可能会由于网络原因失败,可以多试几次,官方安装脚本默认将 Codex standalone 包安装到:

~/.codex/packages/standalone/

同时在:

~/.local/bin/

创建 Codex 的可执行入口。官方安装脚本源码中也可以看到默认BIN_DIR$HOME/.local/bin,Standalone 包目录为$HOME/.codex/packages/standalone

我实际安装时输出:

==> Installing Codex CLI ==> Detected platform: Linux (x64) ==> Resolved version: 0.147.0 ==> Downloading Codex CLI curl: (56) OpenSSL SSL_read: error:0A000126:SSL routines::unexpected eof while reading, errno 0 WARNING: Could not download or verify https://releases.openai.com/codex/releases/0.147.0/codex-package-x86_64-unknown-linux-musl.tar.gz; retrying from GitHub Releases. ==> Installing standalone package to /home/zuimo/.codex/packages/standalone/releases/0.147.0-x86_64-unknown-linux-musl ==> /home/zuimo/.local/bin is already on PATH ==> Current terminal: codex ==> Future terminals: open a new terminal and run: codex Codex CLI 0.147.0 installed successfully. Start Codex now? [y/N] y ==> Launching Codex

说明安装已经成功。


三、安装后提示“找不到 codex 命令”

这里我遇到了第一个坑。

安装完成之后执行:

codex --version

终端却提示:

找不到命令 “codex”,但可以通过以下软件包安装它: sudo snap install codex

千万不要看到这个提示就直接执行:

sudo snap install codex

实际上 Codex 已经安装好了。

原因只是:

安装程序修改了~/.bashrc,但是当前 Shell 还没有重新读取配置。

执行:

source ~/.bashrc

然后重新检查:

codex --version

这时正常输出:

codex-cli 0.147.0

也可以检查命令位置:

which codex

通常应该位于:

/home/你的用户名/.local/bin/codex

例如:

/home/ws/.local/bin/codex

四、npm安装Codex,删除方法

首先需要确定是通过npm安装的codex,在终端输入下面的指令

npm list -g --depth=0 | grep codex

输出中有下面这样一行,就说明确实是通过npm安装的

├── @openai/codex@0.144.5

接下来输入以下指令卸载codex:

sudo npm uninstall -g @openai/codex

之后输入下列指令删除可能的残留文件和验证是否删除成功:

sudo rm -f /usr/local/bin/codex which codex

没有反馈信息就说明使用npm安装的codex以及删除成功了,这时按照章节二的standalone installer重新安装codex即可。

五、检查 Codex 登录状态

接下来检查 Codex 是否已经登录:

codex login status

我的输出:

Logged in using ChatGPT

说明 CLI 当前已经使用 ChatGPT Account 登录。

如果这里还没有登录,可以先按照 Codex CLI 给出的登录流程完成 ChatGPT 授权,再继续配置 Remote Control。


六、检查 Remote Control 是否可用

执行:

codex remote-control --help

在我当前使用的 Codex CLI 0.147.0 中,输出如下:

[experimental] Manage the app-server daemon with remote control enabled Usage: codex remote-control [OPTIONS] [COMMAND] Commands: start Start the app-server daemon with remote control enabled stop Stop the app-server daemon pair Create and print a short-lived manual pairing code help Print this message or the help of the given subcommand(s)

这里最值得注意的是三个命令:

start stop pair

尤其是:

pair

它的作用是:

Create and print a short-lived manual pairing code

即:

创建一个短时间有效的手动配对码。

这也是 Linux CLI Remote Control 非常关键的一步。

实际上,2026 年 7 月初还有 Linux 用户反馈,当时的 CLI 只有startstop,并没有pair命令,因此 Linux 主机很难重新和新的手机 Remote 配对。

而现在我测试的:

codex-cli 0.147.0

已经出现:

pair

说明这一部分正在快速完善。


七、启动 Linux Remote Control

执行:

codex remote-control start

这个命令会启动带 Remote Control 功能的Codex app-server daemon,需要等待一会儿,成功启动后输出如下:

Starting app-server daemon with remote control enabled... This machine is available for remote control as zuimo-Legion-Y7000P-IRX9. Daemon used app-server: path: /home/zuimo/.codex/packages/standalone/current/codex version: 0.147.0

可以理解为:

codex remote-control start │ ▼ app-server daemon │ ▼ Remote Control │ ▼ OpenAI Remote Service

OpenAI 当前的 App Server 文档中已经存在:

remoteControl/enable remoteControl/disable remoteControl/status/read remoteControl/pairing/start remoteControl/pairing/status remoteControl/client/list remoteControl/client/revoke

等接口,而且这些接口目前都标记为 experimental。

Remote Control 的状态包括:

disabled connecting connected errored

因此如果使用 JSON 模式:

codex remote-control start --json

就可以更方便地查看当前连接状态。


八、生成手机配对码

Remote Control 启动以后执行:

codex remote-control pair

CLI 会生成:

short-lived manual pairing code

也就是一个短时间有效的配对码。

如果需要程序处理,也可以尝试:

codex remote-control pair --json

普通用户手动连接手机的话,直接:

codex remote-control pair

就够了。

目前 OpenAI Codex 社区甚至已经有人提出,希望:

codex remote-control start

启动的时候就直接生成 pairing code,而不是要求用户再运行一次:

codex remote-control pair

这也侧面说明当前 CLI 的典型流程就是:

start ↓ pair

如果没有pair之后没有看到配对码,或者出现如下报错:

Error: timed out waiting for remoteControl/pairing/start response Caused by: deadline has elapsed

可以先杀掉codex app-serve,等待一段时间或者切换节点,重新再试一次:

pkill -f "codex app-server"

九、手机 ChatGPT 连接

接下来打开手机上的ChatGPT App

在手机 App 中侧滑找到codex入口,点击进入

OpenAI 当前帮助中心明确说明:

ChatGPT 手机端可以通过Remote tab访问支持 Remote 的 Codex chats。

进去之后在右上角点击添加连接,然后按照手机端界面提示改为手动配对,并使用 Linux 上:

codex remote-control pair

生成的配对码完成配对。

整个过程就变成:

Linux: codex remote-control start ↓ codex remote-control pair ↓ 生成配对码 │ │ ▼ 手机 ChatGPT ↓ Remote ↓ 输入配对码 ↓ Linux Codex

如果配对成功,以后手机就可以作为 Codex Remote 的控制端。


十、为什么推荐 standalone 安装?

这里还有一个很重要的问题。

如果目标只是普通使用 Codex CLI,那么 npm 安装当然也可以。

但是如果目标涉及:

app-server daemon Remote Control

目前更建议使用 OpenAI 的 standalone installer:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

因为 OpenAI 当前app-server-daemon的实现明确假设 Codex 是通过install.sh安装的,并从:

CODEX_HOME/packages/standalone/current/

启动 managed Codex binary。

之前也有用户手动安装 tarball 后运行:

codex remote-control start

出现:

managed standalone Codex install not found

的问题。

所以如果目标就是尝试 Linux Remote Control,我个人更推荐直接使用 standalone installer。


十一、Remote Control 和 VS Code Codex 插件是什么关系?

这里非常容易产生一个误解:

安装 Codex CLI 并不意味着以后必须放弃 VS Code Codex 插件。

实际上完全可以:

Linux │ ┌───────────┴───────────┐ │ │ ▼ ▼ VS Code Codex CLI │ │ Codex Extension Remote Control │ ▼ ChatGPT Mobile

我的使用思路就是:

坐在电脑前:

VS Code + Codex 插件

离开电脑后:

ChatGPT 手机 ↓ Codex Remote ↓ Linux

Linux 仍然是唯一真正的开发环境。

代码、Git Repository、ROS 2 环境、CMake、GCC、Python、Docker 等东西全部继续放在 Linux 上。

手机只是远程控制 Codex。


十二、目前仍然存在的限制

虽然这个功能非常有意思,但目前还不能把它理解成一个已经完全成熟的正式功能。

最明显的一点就是:

[experimental]

OpenAI App Server 文档目前也仍然把:

remoteControl/enable remoteControl/pairing/start remoteControl/client/list ...

标记为 experimental。

社区目前也还有一些相关问题,例如 daemon 更新、连接稳定性,以及多个客户端共享同一个 App Server 等。

所以如果出现:

pairing failed daemon error remote disconnected

之类的问题,不一定是自己的 Linux 配置有问题,也有可能是当前 Remote Control 本身仍然处在快速迭代阶段。

建议遇到问题时首先确认:

codex --version codex login status codex remote-control --help

然后再尝试:

codex remote-control stop codex remote-control start

重新启动 Remote Control。


十三、常用命令整理

安装 Codex:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

刷新 Shell:

source ~/.bashrc

查看版本:

codex --version

查看登录状态:

codex login status

查看 Remote Control:

codex remote-control --help

启动:

codex remote-control start

启动并输出 JSON:

codex remote-control start --json

生成手机配对码:

codex remote-control pair

停止:

codex remote-control stop

十四、最终效果

以前我的开发方式是:

Linux ↓ VS Code ↓ Codex Extension

离开电脑之后,基本就无法继续控制 Linux 上正在工作的 Codex。

现在则可以尝试:

┌───────────────────┐ │ ChatGPT 手机 │ │ Remote │ └─────────┬─────────┘ │ ▼ ┌───────────────────┐ │ Codex Remote │ │ Control │ └─────────┬─────────┘ │ ▼ ┌─────────────────────────────────────────┐ │ Linux │ │ │ │ Codex CLI / app-server daemon │ │ │ │ │ ▼ │ │ Linux 开发环境 │ │ │ │ VS Code / Git / ROS 2 / C++ / Python │ └─────────────────────────────────────────┘

对于主要使用 Linux 开发的人来说,我认为这比:

手机 ↓ Windows/macOS ↓ SSH ↓ Linux

要自然很多。

Linux 本身就是开发主机,就应该直接作为 Codex Remote Host。


总结

这次折腾下来,最让我意外的是:

Codex CLI 在 Linux 上的 Remote Control 能力实际上已经比之前完善了很多。

尤其是新版 CLI 已经出现:

codex remote-control pair

Linux 主机终于具备了比较明确的手动配对入口。

目前完整流程可以概括为:

安装 standalone Codex CLI ↓ source ~/.bashrc ↓ codex --version ↓ codex login status ↓ codex remote-control start ↓ codex remote-control pair ↓ 手机 ChatGPT Remote ↓ 连接 Linux Codex

当然,目前 Remote Control 依旧属于 experimental 功能,距离真正的 Linux 一等公民体验还有一些距离。

我更期待以后 OpenAI 能进一步做到:

VS Code Codex Extension │ Codex CLI │ ChatGPT Mobile │ Codex Desktop │ ▼ 共享同一套 Linux Codex Session

这样对于 Linux、服务器、ROS、机器人、嵌入式和后端开发用户来说,Codex 的完整体验才算真正打通。


参考资料

OpenAI Codex GitHub Repository — install.sh
Codex standalone 安装脚本

OpenAI Codex App Server
Codex app-server README

OpenAI Codex App Server Daemon
Codex app-server-daemon README

OpenAI Help Center
ChatGPT Work and Codex

注:Codex Remote Control 目前仍在快速迭代。本文基于 Codex CLI 0.147.0 的实际测试结果整理,后续版本的命令、手机界面和配对方式可能发生变化。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询