跳到正文
ReCodexDocs

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、技能和历史会话都在。

下一步

本页目录