> ## 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 と ChatGPT デスクトップアプリを実行します。インストール、ブラウザでのログイン、複数組織のバインディングと切り替え、Codex CLI の自動ダウンロードとバージョン要件、WebSocket のフォールバックやデバイス台数などのよくある質問。

> [!NOTE]
>
> Codex プランは現在販売しておらず、購入も更新もできません。開通済みの Codex 組織は有効期間内はそのまま使え、Claude のサブスクリプションとは互いに影響しません。対応範囲は [サブスクリプション → Codex プラン](https://docs.reclaude.ai/ja/account/subscription.md#codex-プラン) を参照してください。

## recodex とは

クライアント v1.5.0 から、同じ ReClaude クライアントに `recodex` コマンド（短いエイリアス `recx`）が加わりました。ReClaude が割り当てたアカウントで公式 Codex CLI を実行します。v1.7.1 からは ChatGPT デスクトップアプリも開けます（`recodex app`）。

* `recodex` と `reclaude` は対等です：**ログイン・組織のバインディング・ログアウトはそれぞれ独立**しており、互いに影響しません。Codex 組織と Claude 組織は別々の 2 つのセットです。
* 2 つのコマンドは同じバックグラウンドサービス（daemon）を共有します。
* `recx` と `recodex` の関係は、`rec` と `reclaude` の関係と同じです：`recx login` は `recodex login` と同じです。

## インストール

**新しいマシン**：[CLI のインストール](https://docs.reclaude.ai/ja/cli/install.md) のワンライナーを使えば、`reclaude`・`rec`・`recodex`・`recx` の 4 つのコマンドがまとめて使えるようになります。

**旧バージョンをインストール済みの場合**：クライアントが v1.5.0 以降に更新されると、`recodex` / `recx` は自動で使えるようになります（新バージョンが自動で作成します）。表示されない場合は `reclaude setup` を一度実行してください。常に最新版を使うことをおすすめします：ChatGPT デスクトップアプリには v1.7.1 以上、`recodex org bind`、`recodex logout --all`、`recodex service stop` には v1.7.3 以上が必要です。

```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/ja/account/devices.md) ページの **Codex デバイス** グループに表示されます。
4. 複数の Codex 組織に所属している場合は、組織のプルダウンからどれを使うか **選択** します。ログイン後、このパソコンにはその組織への最初のバインディングができます。ほかの Codex 組織は後から `recodex org bind` で追加します。
5. **承認** をクリックします。

> [!TIP]
>
> `recodex` をそのまま実行したとき、このマシンに有効な Codex ログインがなければ、同じログインの流れが自動で始まります。

* **Claude のログインとは独立**：`recodex login` は Claude 側のバインディングや設定を一切変更せず、既存の `reclaude` のログインもそのまま使えます。
* Codex の中で `codex login` を実行**しないでください**：認証情報は ReClaude が管理しており、`recodex` はこのコマンドを拒否します（`codex login status` は使えます）。

## 使い方

```bash theme={null}
recodex              # バックグラウンドサービスを起動して Codex CLI を開く
recodex <引数>        # その他の引数はそのまま Codex に渡されます。例：recodex exec "このリポジトリを説明して"
recodex app          # ChatGPT デスクトップアプリを開く（macOS / Windows）
```

* Codex は ReClaude が管理する専用の設定を使います。ご自身の `~/.codex` にある設定やプラグインは自動では引き継がれ**ません**。同じバインディングの Codex CLI と ChatGPT デスクトップアプリは設定とセッション履歴を共有します。
* `recodex update` が更新するのは ReClaude クライアント本体（`reclaude update` と同じ）で、Codex CLI では**ありません**。

### Codex CLI の入手元

`recodex` は、`PATH` 上にご自身でインストールした公式 Codex CLI を優先して使います。それがない場合、または ReClaude が要求する最低バージョン（現在は `0.160.0`）より古い場合は、ReClaude が管理する公式 Codex CLI（`~/.rec/codex/cli/<バージョン>/` に自動でダウンロード）を代わりに使います。ご自身のものが古い場合は「recodex: the local codex … is below the required …; using the managed … this time」と表示されますが、ご自身のものはそのまま残ります。

### ChatGPT デスクトップアプリ

`recodex app` は現在の Codex バインディングで ChatGPT デスクトップアプリを起動します。初回実行時に ReClaude が管理するインストーラーを自動でダウンロードします。`recodex app --org <org_id>` で組織を指定できます。デスクトップアプリの Codex はフルに使えます。Chat / Work モードは使えますが機能に制限があります。macOS と Windows のみ対応です。

* chatgpt.com のウェブ版、モバイルアプリ、VS Code 拡張機能は**非対応**です。
* `recodex app update` は管理対象のデスクトップインストーラーを更新し、`recodex app reset` はデスクトップアプリのログイン状態とキャッシュをリセットします（設定とセッション履歴は残ります。実行前に確認があり、非対話のターミナルでは `--yes` を付けます）。

## 複数組織のバインディングと切り替え

Codex 組織は Claude 組織とは別に管理されます：`recodex org` は **Codex 組織** だけを表示・バインドし、`reclaude org` は Claude 組織だけを扱います。使い方は Claude 側と同じです（[コマンドリファレンス → 複数組織のバインディング](https://docs.reclaude.ai/ja/cli/commands.md#複数組織のバインディング) を参照）：1 台のパソコンは複数の Codex 組織それぞれに 1 つずつバインディングを持て、`--org` なしで起動すると Codex 側のデフォルトのバインディングを使います。

```bash theme={null}
recodex org list            # 所属する Codex 組織（1 列目が org_id）と、このマシンがバインド済みかを一覧表示
recodex org bind <org_id>   # ブラウザで承認し、この Codex 組織へのバインディングをこのマシンに追加
recodex org use <org_id>    # デフォルトのバインディングを、バインド済みの Codex 組織に切り替え（このマシンの設定のみ変更）
recodex --org <org_id>      # 今回だけ指定した組織で Codex CLI を開く（--org は最初の引数にすること）
recodex app --org <org_id>  # 指定した組織で ChatGPT デスクトップアプリを開く
```

* バインドや切り替えができるのは、自分がメンバーである Codex 組織だけです。
* このマシンに複数の Codex バインディングがあってデフォルトが未設定のとき、`recodex` は選べる組織を一覧して終了します。`recodex org use <org_id>` でデフォルトを 1 つ設定してください。
* `recodex org use` が影響するのは、その後に起動する Codex CLI とデスクトップアプリだけです。すでに開いているものは影響を受けません。Claude 側のバインディングも変更しません。

## よく使うコマンド

| コマンド | 内容 |
| - | - |
| `recodex` | バックグラウンドサービスを起動して Codex CLI を開く（普段の使い方） |
| `recodex app` | ChatGPT デスクトップアプリを開く（macOS / Windows） |
| `recodex login` | ブラウザで認可し、このマシンの Codex バインディングにログインまたは再ログイン（`--org <org_id>` でどれかを指定） |
| `recodex logout` | このマシンの Codex バインディングからログアウト（既定ではデフォルトのバインディングのみ、`--all` ですべての Codex バインディング）。設定とセッション履歴は残り、Claude には影響しません |
| `recodex org` | このマシンの Codex 組織を表示・バインド・切り替え |
| `recodex status` | バックグラウンドサービスと 2 つのプラットフォームの状態を表示（Codex 側は `[chatgpt]` ブロック。`--check` を付けるとオンラインで照合） |
| `recodex service stop` | バックグラウンドサービスを停止 —— 2 つのコマンドで共有しているため、`reclaude` の中継も一緒に止まります。どちらかのコマンドを次に実行すると自動で起動します（旧来の `recodex stop` も使えます） |
| `recodex config gateway` | Codex が使う接続経路を表示 / 固定 / リセット（使い方は [コマンドリファレンス → gateway を設定](https://docs.reclaude.ai/ja/cli/commands.md#gatewayを設定) と同じ） |
| `recodex logs` | バックグラウンドサービスのログの最後の 200 行を表示（`-f` で追跡し続ける） |
| `recodex update` | ReClaude クライアントを更新 |
| `recodex help` | ヘルプを表示 |

> [!WARNING]
>
> `recodex uninstall` は `reclaude uninstall` と **まったく同じ** です：プログラムとバックグラウンドサービスを削除し、既定では両プラットフォームのローカルデータを残します。`--purge` を付けたときだけ、ReClaude が管理するすべてのデータと履歴を削除します。**Claude 側の各組織のバインディングの Claude Code 設定、セッション、メモリ、Claude Desktop のデータも含まれます**（自分の `~/.claude` には触れません。削除したデータは復元できません）。Codex だけをやめたい場合は `recodex logout` で十分です。

## よくある質問

**「有効なサブスクリプションがないか、期限切れです。reclaude.ai でお申し込み / 更新してください」と表示される、または承認ページに「Codex のプランは現在購入できません。」と表示される**

まだ Codex プランを持っていないか、このデバイスの Codex 組織の期限が切れています。Codex プランは現在販売しておらず、購入も更新もできません（Claude プランは Codex には使えません）。ほかに有効な Codex 組織に所属している場合は、`recodex` が切り替え可能な組織を表示するので、案内どおり `recodex org use <org_id>` を実行してください。

**「recodex: the local codex … is below the required …; using the managed … this time」と表示される**

ご自身でインストールした Codex CLI が ReClaude の要求する最低バージョンより古いため、`recodex` は今回、管理対象の公式バージョンを代わりに使っています。そのまま通常どおり使えます。ご自身のものを引き続き使いたい場合は、要求されるバージョン以上に更新してください。

**Codex のログに WebSocket の失敗 / `426` が出て、その後 HTTP に切り替わる**

v1.5.0 から、Codex の WebSocket 接続は既定で ReClaude をそのまま通ります。経路が一時的に WebSocket を通さない場合は `426` が返り、Codex は自動で HTTP ストリーミングに切り替えて続行します。会話には影響しません。経路がフォールバックしているときは、`recodex` の起動時にまずターミナルに `codex_transport: fallback (WebSocket falls back to HTTP; Codex CLI works normally)` という 1 行が表示されます。そのまま通っているときは表示されません。

**Codex は何台のデバイスで使えますか？**

**Codex アカウント 1 つにつき合計 4 台**：同じアカウントに紐づく全メンバー合計で最大 4 台のアクティブデバイスで、1 人で使い切ることもできます。専有 Max / Ultra と同じルールです。Codex デバイスは Claude デバイスとは **別に数えられ**、[デバイス](https://docs.reclaude.ai/ja/account/devices.md) ページの **Codex デバイス** グループで確認・取り消しができます。ルールは [デバイス → デバイス数の上限](https://docs.reclaude.ai/ja/account/devices.md#デバイス数の上限) を参照してください。

**サイトで Codex の使用量やメッセージ履歴を見られますか？**

はい。サイト上部の **組織を切り替え** で Codex 組織に切り替えると、ホームにそのアカウントの使用量が表示され、**使用量を同期** で更新できます。メッセージ履歴では両プラットフォームの記録が一緒に並び、それぞれにプラットフォームのラベルが付きます。Codex のリクエストには費用の統計は表示されません。

**ChatGPT デスクトップアプリは使えますか？**

はい。`recodex app` を実行してください。上の [ChatGPT デスクトップアプリ](#chatgpt-デスクトップアプリ) を参照。chatgpt.com のウェブ版、モバイルアプリ、VS Code 拡張機能は非対応です。


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