> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reclaude.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex（recodex）

> 用 recodex 以 ReClaude 分配的账号运行官方 Codex CLI：安装、浏览器登录、切换 Codex 组织、Codex CLI 自动下载与版本要求，以及 WebSocket 回落、设备台数等常见问题。

> [!NOTE]
>
> **Codex 支持内测中，暂不对外开放。** 已在内测中的用户按本页使用。

## recodex 是什么

客户端 v1.5.0 起，同一个 ReClaude 客户端多出一个命令 `recodex`（短别名 `recx`），用 ReClaude 分配的账号运行官方 Codex CLI。

* `recodex` 与 `reclaude` 平级：**各自登录、各自选组织、各自退出**，互不影响。
* 两个命令共用同一个后台 daemon。
* `recx` 之于 `recodex`，就像 `rec` 之于 `reclaude`：`recx login` 等价于 `recodex login`。

## 安装

**新装机**：用 [安装 CLI](https://docs.reclaude.ai/cli/install.md) 里的一键安装命令即可，装完同时得到 `reclaude`、`rec`、`recodex`、`recx` 四个命令。

**已装过旧版**：客户端升级到 v1.5.0 后，`recodex` / `recx` 会自动可用（新版本自动补建）。如果没有出现，运行一次 `reclaude setup` 即可。

```bash theme={null}
reclaude setup    # recodex / recx 没出现时运行一次
```

打开**新终端**后用 `recodex version` 验证。

**Codex CLI 不用单独安装**：本机没有合适的 Codex CLI 时，`recodex` 会自动下载官方版本（无需 VPN）。你已装了官方 Codex CLI 且版本够新的，会沿用你那份。详见下面的 [Codex CLI 从哪来](#codex-cli-从哪来)。

## 登录

```bash theme={null}
recodex login
```

终端会打印一条授权链接并尝试自动打开浏览器，在浏览器里：

1. 没登录的话，先用邮箱密码登录 ReClaude 账户。
2. 确认页面标题是 **授权 recodex 登录**，核对 **设备详情**。
3. 给这台设备起一个易记的名字 —— 之后会显示在 [设备](https://docs.reclaude.ai/account/devices.md) 页的 **Codex 设备** 分组里。
4. 如果你属于多个 Codex 组织，在组织下拉里**选择**用哪一个。
5. 点击 **批准**。

> [!TIP]
>
> 直接运行 `recodex` 时，如果本机还没有有效的 Codex 登录，会自动进入同一个登录流程。

* **与 Claude 登录互不影响**：`recodex login` 不会改动 Claude 侧的任何绑定与配置，已有的 `reclaude` 登录照常可用。
* 登录成功后，共用的后台 daemon 会停一次；再运行 `recodex` 或 `reclaude` 时会自动拉起。
* **不要**在 Codex 里执行 `codex login`：凭据由 ReClaude 代管，`recodex` 会拒绝这条命令（`codex login status` 可以用）。

## 使用

```bash theme={null}
recodex              # 启动后台 daemon 并打开 Codex
recodex <参数>        # 其余参数原样交给 Codex，例如 recodex exec "解释这个仓库"
```

* 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 侧的多组织绑定见 [命令参考 → 多组织绑定](https://docs.reclaude.ai/cli/commands.md#多组织绑定)）。

```bash theme={null}
recodex org list            # 列出你所在的 Codex 组织，* 标出本设备当前所在组织
recodex org use <org_id>    # 把本设备切到指定的 Codex 组织
```

* 只能在你是成员的 Codex 组织之间切换。
* 你属于多个 Codex 组织、但本设备还没选定时，`recodex` 会提示先用上面两条命令选定。
* 切换后，新的请求走新组织；已打开的 Codex 会话建议退出后重新打开。`recodex org use` 不影响 Claude 侧的任何绑定。

## 常用命令

| 命令 | 作用 |
| - | - |
| `recodex` | 启动后台 daemon 并打开 Codex（日常用法） |
| `recodex login` | 浏览器授权，登录本机的 Codex 身份 |
| `recodex logout` | 只退出本机的 Codex 登录，不影响 Claude |
| `recodex org` | 查看或切换本设备所在的 Codex 组织 |
| `recodex status` | 查看 daemon 与 Codex 侧状态（第一行是 `[codex]`） |
| `recodex stop` | 停止后台 daemon —— daemon 是两个命令共用的，`reclaude` 的接管也会一起停，下次运行任一命令会自动拉起 |
| `recodex config gateway` | 查看 / 锁定 / 重置 Codex 用的接入线路（用法同 [命令参考 → 配置 gateway](https://docs.reclaude.ai/cli/commands.md#配置-gateway)） |
| `recodex logs` | 打印 daemon 日志末尾几行 |
| `recodex update` | 升级 ReClaude 客户端 |
| `recodex help` | 打印帮助 |

> [!WARNING]
>
> `recodex uninstall` 与 `reclaude uninstall` **完全等价**：会停掉 daemon 并清除整个 ReClaude 的本地数据，**包括 Claude 侧各组织绑定的 Claude Code 配置、会话、记忆与 Claude 桌面端数据**（不碰你自己的 `~/.claude`；卸载前先把要留的东西拷走，见 [安装 CLI → 升级和卸载](https://docs.reclaude.ai/cli/install.md#升级和卸载)）。只想停用 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 设备**分开计数**，在 [设备](https://docs.reclaude.ai/account/devices.md) 页的 **Codex 设备** 分组里查看和撤销。

**网页端看不到 Codex 的用量和消息记录**

网页端的用量与消息记录暂不含 Codex。

**能用 Codex 桌面端吗？**

暂不支持，目前只支持通过命令行 `recodex` 使用 Codex。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.