问题排查

重新打开一个终端窗口。或者在当前终端执行 . "$HOME/.recodex/env"（fish 用 source "$HOME/.recodex/env.fish"）。Windows 请重新打开 PowerShell。

请使用 https://recodex.cc/install.sh（Windows 为 install.ps1）这个地址，不要使用 GitHub 上的脚本链接。

gcodex 需要先装好官方 Codex CLI。可以按官方方式安装，也可以执行 gcodex update 下载。如果装在不常见的位置，设置环境变量 RECODEX_CODEX_PATH 指向 codex 的完整路径。

授权链接 5 分钟内有效、只能使用一次。回到终端重新运行 gcodex login。

只有已分配账号、没有暂停、也没有过期的订阅才能选择。新订阅在分配账号前也显示「计时暂停」，等收到「账号已分配」消息后再登录；其它暂停或已过期的订阅，先到控制台处理（见 订阅状态说明）。

这个订阅的设备数已经达到上限。到控制台「设备」页解绑不再使用的电脑，然后重新运行 gcodex login。同一台电脑重复登录不会额外占用名额。

运行 gcodex login --no-browser，把终端里打印的授权链接复制到任意设备的浏览器里打开并批准。

你在 ReCodex 接管期间，直接在官方 Codex 里登录了自己的账号。gcodex 为了不覆盖它而停了下来。如果要继续用 ReCodex，按提示先自行备份并移走 ~/.codex/auth.json，再重试。

订阅暂停时 gcodex 无法启动 Codex，冒号后面是原因，在控制台首页也能看到：

• 等待人工分配账号：新订阅正在等待分配，不计时，也不需要你操作。
• 账号封禁：请在「支持工单」里选择「账号使用异常」提交工单。
• 授权失效、上游套餐到期、账号暂停等：管理员会处理，期间不计时；等待较久时可以提交工单询问。

详见 订阅状态说明。

订阅已经到期，会话中途也会被拒绝。兑换同档卡密续费后即可继续使用，原账号和已登录的设备都保留。

常见原因：

• 卡密已经被使用过；
• 续费时卡密和订阅不同档（例如用 Pro 200 的卡密续 Pro 100）；
• 这张卡密已经兑换成功，但你换了一个目标重新提交，这时到「订阅」页刷新确认即可；
• 卡密已过有效期。

上游的 5 小时 / 7 天额度用完属于正常情况，不是故障。在控制台首页的「额度窗口」或 Codex CLI 里输入 /status，可以看到额度何时恢复。

为了不打断正在进行的会话，gcodex 不会强行重启后台服务。保存并结束当前的 CLI 和 Desktop 工作，执行 gcodex stop，再重新运行 gcodex。

ReCodex 只支持官方 Codex CLI 和 Codex Desktop。请不要修改客户端的请求头，也不要用其它工具直接调用。

通过 gcodex 启动的 Codex 里，以及 ReCodex 接管的 Desktop 运行期间（对整台电脑生效），访问 api.openai.com 都会被拒绝。需要时先完全退出 Desktop，并在 gcodex 之外运行你的程序。

ReCodex 目前不支持实时语音（Realtime Voice）。

执行 gcodex config network current 查看当前使用的网络。切换 VPN 后，在新设置生效的终端里执行 gcodex config network reload。详见 VPN 与代理。

如果 gcodex status 提示 本机网络不可用: localnet: system PAC/WPAD is enabled…，通常是 Windows 的「自动检测设置」开着。使用代理的话，用 gcodex config network set 指定地址；不使用代理的话，在「设置 → 网络和 Internet → 代理」里关闭「自动检测设置」，再运行 gcodex config network auto。

每次都要用 gcodex desktop run 打开 Desktop。从程序坞、开始菜单直接打开，或 Desktop 自动更新后自己重启，都不会经过 ReCodex。先完全退出 Desktop，再运行 gcodex desktop run。

提示原文为 This account's Chat is in use on another device. Wait for its lease to expire.。网页对话同一时间只允许一台设备使用，原设备每次使用都会续期。回到原设备继续使用，或在原设备停止使用约 30 分钟后再切换。

以 MSIX 方式安装（例如从 Microsoft Store 安装）的 Desktop，需要在「设置 → 应用 → 高级应用设置 → 应用执行别名」中启用 Codex 的别名后重试。

这通常出现在从旧版本升级之后。先完全退出 Desktop，然后：

gcodex repair --dry-run   # 先预览要修复什么
gcodex repair             # 执行修复，原文件会自动备份