Codex 远程连接卡在扫码页？开启 remote-control 试试这套处理办法

你是不是也遇到过这个场景：

打开 Codex 远程连接页面，页面让你扫码。

你扫了。

它还在那儿。

你再扫一次。

它还是一动不动。

这个时候别急着怀疑网络，也别急着重装。很多时候，是本地 Codex CLI 的远程控制能力没开，或者 CLI 版本太旧。

下面这套方法可以直接照着做。几分钟搞定。🛠️

适合解决什么问题？

如果你遇到下面这些情况，可以试试：

Codex 远程连接一直卡在扫码页面
扫码后页面没有反应
浏览器里看不到正常的连接状态
本地终端没启动远程控制服务
Codex CLI 版本比较旧

核心思路很简单：

升级 Codex CLI，打开 remote-control 功能，再从终端启动远程控制。

操作前准备

你需要能打开终端。

macOS、Linux 直接用系统终端就行。

Windows 用户如果用 WSL，也可以在 WSL 里操作。

另外，你本机需要已经安装过 Codex CLI。如果你连 codex 命令都不存在，那就不是这篇文章要解决的问题了，得先安装 Codex CLI。

可以先跑一下：

codex --version

如果能输出版本号，说明命令可用。

第一步：升级 Codex CLI 到新版

打开终端，执行：

codex update

这一步的目的，是把 Codex CLI 升到支持远程控制功能的版本。

原问题里提到的可用版本是 0.130。你执行更新后，可以再看一下版本：

codex --version

如果版本已经更新，就继续往下走。

如果 update 失败怎么办？

常见原因有几个：

网络访问不稳定
终端没有权限
当前安装方式不支持自动更新
代理配置有问题

可以先换个网络，或者重新打开终端再试一次。

如果你是通过包管理器安装的，比如 npm、brew 之类，那就用对应方式升级。

示例：

brew upgrade codex

或者：

npm update -g codex

具体命令以你的安装方式为准。

第二步：修改 Codex 配置文件

接下来要改配置文件：

vi ~/.codex/config.toml

如果你不熟悉 vi，也可以用更顺手的编辑器。

比如 macOS 可以用：

open ~/.codex/config.toml

或者用 VS Code：

code ~/.codex/config.toml

打开后，找到 [features] 这一段。

如果已经有 [features]，就在下面加一行：

remote-control = true

最后看起来类似这样：

[features]
remote-control = true

如果文件里没有 [features]，那就自己加上：

[features]
remote-control = true

保存文件。

vi 不会用？这里给你快捷版

很多人不是卡在 Codex，而是卡在 vi。

懂，太懂了。

打开文件后：

vi ~/.codex/config.toml

按键流程如下：

按 i 进入编辑模式
粘贴下面内容：

[features]
remote-control = true

按 Esc
输入：

:wq

回车保存退出

如果你不小心进去了又不知道怎么出来，按 Esc，然后输入：

:q!

回车，强制退出。

别慌，vi 吓人归吓人，不会吃电脑。😂

第三步：启动远程控制

配置改完后，回到终端执行：

codex remote-control

这一步很关键。

它会在本地启动 Codex 的远程控制能力。你可以理解成：让浏览器页面和你本机的 Codex CLI 对上话。

执行后，不要立刻关掉终端。

保持这个命令运行。

然后回到 Codex 远程连接页面。

第四步：回到页面点击连接

现在回到扫码页面，刷新一下也行。

如果页面出现“连接”按钮，就点它。

正常情况下，这时候就能连上了。

如果你前面扫码已经完成，页面可能会直接进入连接状态。

这里不要反复狂点。

点一次，等几秒。

很多连接失败不是失败，是你点太快，把状态搞乱了。

完整命令速查

懒得看上面长流程的话，看这里。

codex update

编辑配置：

vi ~/.codex/config.toml

加入：

[features]
remote-control = true

启动远程控制：

codex remote-control

然后回到页面，点击连接。

常见坑位排查

1. 配置写错位置

remote-control = true 要放在 [features] 下面。

正确写法：

[features]
remote-control = true

别写成这样：

remote-control = true

[features]

这样配置可能不会生效。

2. 写成了字符串

不要写成：

remote-control = "true"

建议写布尔值：

remote-control = true

少一个引号，少很多麻烦。

3. 修改配置后没启动命令

只改配置不够。

还要执行：

codex remote-control

这一步漏掉，页面可能还是卡住。

4. 终端命令被你关了

执行 codex remote-control 后，终端窗口要保持打开。

如果你把终端关了，本地服务也可能跟着停。

页面自然连不上。

5. 浏览器页面状态缓存了

如果你确定命令都没问题，页面还卡着，可以试试：

刷新页面
重新扫码
退出当前登录状态再进
换个浏览器
用无痕窗口打开

有些页面就是爱缓存旧状态，别跟它硬刚。

6. CLI 版本没真的升级

执行：

codex --version

确认版本。

如果版本还是旧的，说明 codex update 没成功。

这时候要回到安装方式上排查。

一个推荐的排障顺序

如果你现在已经卡住了，可以按这个顺序来：

关闭当前扫码页面
打开终端
执行 codex update
检查 codex --version
修改 ~/.codex/config.toml
确认 [features] 下有 remote-control = true
执行 codex remote-control
保持终端不要关
重新打开 Codex 远程连接页面
扫码或点击连接

这个顺序比较稳。

别一边改配置，一边疯狂刷新页面。容易把自己绕进去。

小结

Codex 远程连接卡在扫码页，重点看三件事：

Codex CLI 是否升级到支持远程控制的版本
~/.codex/config.toml 是否开启了 remote-control
是否执行了 codex remote-control 并保持运行

命令不多，关键是别漏步骤。

如果你已经被扫码页卡了半小时，直接按上面的流程走一遍，大概率能救回来。