5 分钟快速开始
从零开始:开通订阅、安装 gcodex、浏览器授权,然后打开官方 Codex。
开始前确认
- 电脑是 macOS、Linux 或 Windows(x86_64 或 arm64)。
- 已经装好官方 Codex CLI(
codex命令可用)。ReCodex 不会替你安装它;没有装的话,可以在第 2 步装好 gcodex 后运行gcodex update下载。要用 Codex Desktop,还需要装好官方 Codex Desktop(仅 macOS 和 Windows)。 - 有一个 ReCodex 账号,以及一张卡密(形如
RCX-XXXX-XXXX-XXXX)。
开通订阅,等待分配账号
在 recodex.cc 注册(目前只支持 QQ 邮箱 @qq.com;需要邮箱验证码,可选填邀请码和卡密),或登录后进入 套餐与账单 → 兑换卡密 兑换。
新订阅需要等管理员为你分配账号,分配前不计时。收到「账号已分配」消息后再进行第 3 步:分配前,授权页里这个订阅显示「计时暂停」,无法选择。详见 订阅状态说明。
安装 gcodex
复制对应系统的命令到终端执行。脚本会自动把 gcodex 加入 PATH;以后要升级,重新运行同一条命令即可。
curl -fsSL https://recodex.cc/install.sh | bash && . "$HOME/.recodex/env"安装后提示 gcodex: command not found?重新打开一个终端窗口即可。
用浏览器批准这台电脑
浏览器会自动打开授权页,选中订阅后批准,再回到终端。授权链接 5 分钟内有效、只能用一次,过期了重新运行 gcodex login 就行。
没有图形界面(例如通过 SSH 登录的服务器)时,运行 gcodex login --no-browser,把终端里打印的链接复制到任意设备的浏览器里打开批准即可。
登录时 gcodex 会先备份 ~/.codex 里的配置和登录文件,再写入 ReCodex 的设置,你的 MCP、技能和历史会话不受影响。详见 它会改动什么。
确认一切就绪
gcodex status看 订阅 这一行:显示「有效」(快到期时显示「即将到期」,同样可以使用)就没问题。此时 Daemon 显示「未运行」是正常的,第一次运行 gcodex 或 gcodex desktop run 时会自动启动。
如果显示「已暂停计时:…」,说明账号需要管理员处理,冒号后面是原因,参见 订阅状态说明。
打开 Codex
gcodex就是你熟悉的官方 Codex CLI,原有的 MCP、技能和历史会话都在。