使用 Codex CLI
日常启动、给 Codex 传参数、在多个订阅之间切换、升级 gcodex，以及它会改动什么。
gcodex 是官方 Codex CLI 的启动器：它负责登录和转发，打开的仍然是官方 codex。你在 ~/.codex 中的 MCP、技能、全局指令、profiles 和历史会话都照常生效。
日常使用
写在 -- 之后的 --model、--profile 和 -c 参数会原样交给 Codex，但 -c 不能覆盖 model_provider、openai_base_url、chatgpt_base_url 和 cli_auth_credentials_store。以下用法会绕过 ReCodex，因此会被拒绝：--remote、--oss、--local-provider，以及 gcodex agents。
常用命令
| 命令 | 作用 |
|---|---|
gcodex | 打开 Codex CLI（第一次运行时会自动启动后台服务） |
gcodex login | 用浏览器授权这台电脑；加 --no-browser 只打印链接、不自动打开浏览器 |
gcodex status | 查看后台服务、订阅状态和 Codex 路径 |
gcodex sub list | 列出你名下的所有订阅，以及哪些已在本机绑定 |
gcodex sub bind <订阅ID> | 在这台电脑上再绑定一个订阅（需要在浏览器里批准） |
gcodex sub use <订阅ID> | 切换这台电脑默认使用的订阅（需已在本机绑定） |
gcodex logs -f | 实时查看后台服务日志，排查问题时有用 |
gcodex stop | 停止后台服务；正在运行的 Codex CLI / Desktop 会话会中断 |
gcodex update | 下载或更新官方 codex（见下文「升级」） |
gcodex logout | 退出这台电脑上的所有订阅，并把 ~/.codex 恢复成接入前的样子 |
gcodex version | 查看 gcodex 版本 |
gcodex help <命令> | 查看某个命令的详细帮助 |
gcodex logout 只清理本机，不会释放控制台里的设备名额；要释放名额，到控制台「设备」页解绑。
在多个订阅之间切换
也可以用 gcodex --subscription <订阅ID> 指定这一次启动用哪个订阅（同样需要已在本机绑定）。注意，CLI 和 Desktop 共用同一份登录配置：换订阅启动后，正在运行的 Codex CLI / Desktop 需要重新启动。
要换成另一个 ReCodex 账号，先运行 gcodex logout，再用另一个账号在浏览器里完成 gcodex login。
升级 gcodex
重新运行一次安装命令，会自动升级到最新版本：
curl -fsSL https://recodex.cc/install.sh | bash && . "$HOME/.recodex/env"- 升级后，已经在运行的后台服务不会自动换成新版本。结束手头的会话后运行
gcodex stop，下次启动时就会用上新版本；可以用gcodex version确认。 - Windows 上有 gcodex 会话在运行时，安装脚本会拒绝升级，请先结束会话。
- 升级后第一次运行
gcodex desktop run会再请求一次管理员授权。
升级 gcodex 和升级 Codex 是两件事
上面的命令只升级 gcodex 本身。运行过 gcodex update 后，gcodex（以及 macOS / Linux 终端里的 codex 命令）会优先使用它下载的 ~/.recodex/bin/codex，以后也请用 gcodex update 更新。只想用 npm 或 Homebrew 安装的版本，就不要运行 gcodex update；已经运行过的话，删除 ~/.recodex/bin/codex 即可。
它会改动什么
~/.codex的配置和登录：第一次gcodex login时，会先完整备份~/.codex/config.toml和auth.json（备份在~/.recodex-desktop/backup/），再写入 ReCodex 的托管设置和一个占位登录。MCP、技能、全局指令、profiles 和历史会话不受影响。- 同名设置会被替换：
config.toml顶层的model、model_provider、openai_base_url、chatgpt_base_url、cli_auth_credentials_store会换成托管值（原件已备份）。想换模型，请用gcodex -- --model …或 profile。 - 直接运行官方 codex 时：托管期间，直接运行
codex或从程序坞打开 Desktop，用的都是占位登录，不是你自己的 ChatGPT 账号。想恢复原样，运行gcodex logout；卸载 ReCodex 时也会自动恢复。 - Codex 进程的环境变量：通过 gcodex 启动的 Codex 不会读取你 shell 里的
OPENAI_API_KEY、OPENAI_BASE_URL、CODEX_HOME等变量，代理变量会换成本机的 ReCodex 代理。Codex 里运行的脚本或 MCP 访问api.openai.com会被拒绝。