跳转到主要内容
Codex 支持内测中,暂不对外开放。 已在内测中的用户按本页使用。

recodex 是什么

客户端 v1.5.0 起,同一个 ReClaude 客户端多出一个命令 recodex(短别名 recx),用 ReClaude 分配的账号运行官方 Codex CLI。
  • recodex 与 reclaude 平级:各自登录、各自选组织、各自退出,互不影响。
  • 两个命令共用同一个后台 daemon。
  • recx 之于 recodex,就像 rec 之于 reclaude:recx login 等价于 recodex login。

安装

新装机:用 安装 CLI 里的一键安装命令即可,装完同时得到 reclaude、rec、recodex、recx 四个命令。 已装过旧版:客户端升级到 v1.5.0 后,recodex / recx 会自动可用(新版本自动补建)。如果没有出现,运行一次 reclaude setup 即可。
打开新终端后用 recodex version 验证。 Codex CLI 不用单独安装:本机没有合适的 Codex CLI 时,recodex 会自动下载官方版本(无需 VPN)。你已装了官方 Codex CLI 且版本够新的,会沿用你那份。详见下面的 Codex CLI 从哪来。

登录

终端会打印一条授权链接并尝试自动打开浏览器,在浏览器里:
  1. 没登录的话,先用邮箱密码登录 ReClaude 账户。
  2. 确认页面标题是 授权 recodex 登录,核对 设备详情。
  3. 给这台设备起一个易记的名字 —— 之后会显示在 设备 页的 Codex 设备 分组里。
  4. 如果你属于多个 Codex 组织,在组织下拉里选择用哪一个。
  5. 点击 批准。
直接运行 recodex 时,如果本机还没有有效的 Codex 登录,会自动进入同一个登录流程。
  • 与 Claude 登录互不影响:recodex login 不会改动 Claude 侧的任何绑定与配置,已有的 reclaude 登录照常可用。
  • 登录成功后,共用的后台 daemon 会停一次;再运行 recodex 或 reclaude 时会自动拉起。
  • 不要在 Codex 里执行 codex login:凭据由 ReClaude 代管,recodex 会拒绝这条命令(codex login status 可以用)。

使用

  • Codex 使用 ReClaude 托管的独立配置,你自己 ~/.codex 里的配置、插件不会自动带过来。
  • recodex update 升级的是 ReClaude 客户端本身(与 reclaude update 相同),不是 Codex CLI。

Codex CLI 从哪来

recodex 优先使用 PATH 上你自己装的官方 Codex CLI;本机没有、或版本低于 ReClaude 要求的最低版本(目前是 0.160.0)时,改用 ReClaude 托管的官方 Codex CLI(自动下载到 ~/.rec/codex/cli/<版本>/)。你那份过旧时会提示一行,但原样不动。

切换组织

Codex 组织与 Claude 组织分开管理:recodex org 只列、只切 Codex 组织;reclaude org 只管 Claude 组织。Codex 侧没有多组织绑定:本设备同一时刻只走一个 Codex 组织,也没有 recodex org bind(Claude 侧的多组织绑定见 命令参考 → 多组织绑定)。
  • 只能在你是成员的 Codex 组织之间切换。
  • 你属于多个 Codex 组织、但本设备还没选定时,recodex 会提示先用上面两条命令选定。
  • 切换后,新的请求走新组织;已打开的 Codex 会话建议退出后重新打开。recodex org use 不影响 Claude 侧的任何绑定。

常用命令

recodex uninstall 与 reclaude uninstall 完全等价:会停掉 daemon 并清除整个 ReClaude 的本地数据,包括 Claude 侧各组织绑定的 Claude Code 配置、会话、记忆与 Claude 桌面端数据(不碰你自己的 ~/.claude;卸载前先把要留的东西拷走,见 安装 CLI → 升级和卸载)。只想停用 Codex,用 recodex logout 即可。

常见问题

提示「内测中,暂不对外开放」,或批准页提示没有可用的 Codex 组织 你的账号不在 Codex 内测范围内,或本设备所在的 Codex 组织已到期。如果你还在别的在役 Codex 组织里,recodex 会直接列出可以切换的组织,按提示运行 recodex org use <org_id> 即可;否则 Codex 支持内测中,暂不对外开放。 提示「当前 codex 版本 … 过旧」 升级官方 Codex CLI 后重试。 Codex 日志里出现 WebSocket 失败 / 426,然后改用 HTTP v1.5.0 起,Codex 的 WebSocket 连接默认经 ReClaude 直通。个别情况下线路暂时不走 WebSocket 时会返回 426,Codex 自动改用 HTTP 流式继续,对话不受影响。recodex status 的 codex_transport 一行显示当前情况:passthrough 表示 WebSocket 直通,fallback 表示回落到 HTTP、可正常使用。 Codex 能用几台设备? 每位 Codex 组织成员最多 4 台 Codex 设备;同一个 Codex 账号下所有成员合计也最多 4 台。Codex 设备与 Claude 设备分开计数,在 设备 页的 Codex 设备 分组里查看和撤销。 网页端看不到 Codex 的用量和消息记录 网页端的用量与消息记录暂不含 Codex。 能用 Codex 桌面端吗? 暂不支持,目前只支持通过命令行 recodex 使用 Codex。
最后修改于 2026年10月22日