使用 Codex Desktop
用 ReCodex 打开官方 Codex Desktop，了解它会改动什么、对整台电脑有什么影响，以及如何恢复原样。
开始前确认：已经装好官方 Codex Desktop（macOS 或 Windows），已经用 gcodex login 登录，并且 gcodex status 里订阅显示「有效」。
打开 Desktop
先完全退出 Codex Desktop
如果 Desktop 正在运行，先完全退出：macOS 按 ⌘Q，Windows 从系统托盘退出。只关窗口不算退出。
运行 gcodex desktop run
第一次运行时系统会请求管理员授权（macOS 输入密码，Windows 在 UAC 弹窗里确认），用于安装一个后台网络组件。同一版本之后不再询问；升级 gcodex 后第一次运行、以及卸载时会再请求一次。Desktop 会在后台启动，终端可以直接关闭。
以后每次都用这条命令打开
每次都要用 gcodex desktop run 打开 Desktop。 从程序坞、开始菜单直接打开，或者 Desktop 自动更新后自己重启，都不会经过 ReCodex。对话、MCP、技能和历史记录与 CLI 共用。
它会改动什么
为了让 Desktop 走你的订阅，ReCodex 会做以下改动：
| 改动 | 说明 |
|---|---|
~/.codex 中的配置 | 和 CLI 共用 ReCodex 的托管设置与占位登录；首次改动前会完整备份原文件 |
| 当前用户的证书信任 | 添加一个只在本机生成、从不上传的证书，仅对当前用户生效 |
| 后台网络组件 | 安装一次后常驻；只在通过 gcodex desktop run 打开的 Desktop 运行期间接管 OpenAI / ChatGPT 相关域名，Desktop 完全退出或崩溃后自动恢复 |
ReCodex 不会修改 Desktop 程序本身，也不会关闭系统的证书校验。
接管期间会影响整台电脑访问 OpenAI
Desktop 运行期间，域名接管对整台电脑生效，不区分是哪个程序：这台电脑上所有程序访问 OpenAI / ChatGPT 域名都会经过 ReCodex。用你自己的 API Key 调用 api.openai.com 会被拒绝，浏览器里的 ChatGPT 也可能受影响。需要时先完全退出 Desktop，接管会自动解除。
恢复原样
不想再通过 ReCodex 使用 Desktop 时：
它会还原 ~/.codex 配置（你在使用期间新增的 MCP、技能会保留）、关闭网络接管并移除添加的证书。后台网络组件不再接管，但仍保留安装，gcodex uninstall 时才会移除。之后如果继续使用 gcodex 打开 CLI，~/.codex 会再次写入托管设置。想彻底卸载 ReCodex，请看 停用与卸载。
其它命令
| 命令 | 作用 |
|---|---|
gcodex desktop status | 查看 Desktop 当前是否由 ReCodex 接管 |
gcodex desktop run --foreground | 在前台运行并实时显示日志，关闭终端会同时关闭 Desktop |
Desktop 的日志在 ~/.recodex/logs/desktop.log。
网页对话一次只能在一台设备上使用
Desktop 内的网页对话（Web Chat）同一时间只允许一台设备使用，原设备每次使用都会续期。在另一台设备上提示冲突时，回到原设备继续使用，或在原设备停止使用约 30 分钟后再切换。