opencodex: OpenAI Codex と Claude Code のためのローカルプロバイダープロキシ

opencodex が Codex と Claude Code をリルーティングする仕組み

opencodex は OpenAI Codex と Claude Code のための TypeScript 製ローカルプロキシです。Codex クライアントと LLM プロバイダーの間に立ち、Codex が送る Responses API 呼び出しを、選択したプロバイダーのプロトコルに変換します。README によると、この変換はストリーミング、ツール呼び出し、推論トークン、画像について双方向に機能します。5 つのプロトコルアダプターは Anthropic Messages、Google Gemini、Azure OpenAI、OpenAI Responses のパススルー、および OpenAI 互換の Chat Completions エンドポイントをカバーし、合わせて 40 以上の内蔵プロバイダーがあります。Claude Code では、`ocx claude` コマンドがモデルディスカバリを有効にしてプロキシを起動します。README はベンチマーク数値やユーザー数を提供していないため、この記事ではそれらは確認されていません。 実行日時、版、環境、入力識別子、出力要約、警告を記録し、再現不能な結果は成功例として扱いません。 opencodex は OpenAI Codex と Claude Code のための TypeScript 製ローカルプロキシです。Codex クライアントと LLM プロバイダーの間に立ち、Codex が送る Responses API 呼び出しを、選択したプロバイダーのプロトコルに変換します。README によると、この変換はストリーミング、ツール呼び出し、推論トークン、画像について双方向に機能します。5 つのプロトコルアダプターは Anthropic Messages、Google Gemini、Azure OpenAI、OpenAI Responses のパススルー、および OpenAI 互換の Chat Completions エンドポイントをカバーし、合わせて 40 以上の内蔵プロバイダーがあります。Claude Code では、`ocx claude` コマンドがモデルディスカバリを有効にしてプロキシを起動します。README はベンチマーク数値やユーザー数を提供していないため、この記事ではそれらは確認されていません。 実行日時、版、環境、入力識別子、出力要約、警告を記録し、再現不能な結果は成功例として扱いません。 opencodex は OpenAI Codex と Claude Code のための TypeScript 製ローカルプロキシです。Codex クライアントと LLM プロバイダーの間に立ち、Codex が送る Responses API 呼び出しを、選択したプロバイダーのプロトコルに変換します。README によると、この変換はストリーミング、ツール呼び出し、推論トークン、画像について双方向に機能します。5 つのプロトコルアダプターは Anthropic Messages、Google Gemini、Azure OpenAI、OpenAI Responses のパススルー、および OpenAI 互換の Chat Completions エンドポイントをカバーし、合わせて 40 以上の内蔵プロバイダーがあります。Claude Code では、`ocx claude` コマンドがモデルディスカバリを有効にしてプロキシを起動します。README はベンチマーク数値やユーザー数を提供していないため、この記事ではそれらは確認されていません。 実行日時、版、環境、入力識別子、出力要約、警告を記録し、再現不能な結果は成功例として扱いません。 opencodex は OpenAI Codex と Claude Code のための TypeScript 製ローカルプロキシです。Codex クライアントと LLM プロバイダーの間に立ち、Codex が送る Responses API 呼び出しを、選択したプロバイダーのプロトコルに変換します。README によると、この変換はストリーミング、ツール呼び出し、推論トークン、画像について双方向に機能します。5 つのプロトコルアダプターは Anthropic Messages、Google Gemini、Azure OpenAI、OpenAI Responses のパススルー、および OpenAI 互換の Chat Completions エンドポイントをカバーし、合わせて 40 以上の内蔵プロバイダーがあります。Claude Code では、`ocx claude` コマンドがモデルディスカバリを有効にしてプロキシを起動します。README はベンチマーク数値やユーザー数を提供していないため、この記事ではそれらは確認されていません。 実行日時、版、環境、入力識別子、出力要約、警告を記録し、再現不能な結果は成功例として扱いません。

インストールと重要な2つのコマンド

README の人間向けクイックスタートは 2 つのコマンドです: `npm install -g @bitkyc08/opencodex` と `ocx start`。これでプロキシが起動し、`http://localhost:10100` に Web ダッシュボードが開きます。エージェントワークフロー向けには、`ocx init` が対話的に `~/.opencodex/config.json` を書き込み、Codex を接続しますが、プロキシ自体は起動しません。`ocx provider add` や `ocx combo set` などのヘッドレスコマンドは、実行中のプロキシと通信し、アクセスできない場合は非ゼロで終了します。`ocx status`、`ocx doctor`、`ocx health` は実行状態を報告します。Node 18 以上が必要で、README は Bun が `npm install` 中に自動でバンドルされるため、別途インストールする必要がないと述べています。このインストール方法は macOS、Linux、Windows でネイティブに動作し、Windows では WSL が不要です。 README の人間向けクイックスタートは 2 つのコマンドです: `npm install -g @bitkyc08/opencodex` と `ocx start`。これでプロキシが起動し、`http://localhost:10100` に Web ダッシュボードが開きます。エージェントワークフロー向けには、`ocx init` が対話的に `~/.opencodex/config.json` を書き込み、Codex を接続しますが、プロキシ自体は起動しません。`ocx provider add` や `ocx combo set` などのヘッドレスコマンドは、実行中のプロキシと通信し、アクセスできない場合は非ゼロで終了します。`ocx status`、`ocx doctor`、`ocx health` は実行状態を報告します。Node 18 以上が必要で、README は Bun が `npm install` 中に自動でバンドルされるため、別途インストールする必要がないと述べています。このインストール方法は macOS、Linux、Windows でネイティブに動作し、Windows では WSL が不要です。 README の人間向けクイックスタートは 2 つのコマンドです: `npm install -g @bitkyc08/opencodex` と `ocx start`。これでプロキシが起動し、`http://localhost:10100` に Web ダッシュボードが開きます。エージェントワークフロー向けには、`ocx init` が対話的に `~/.opencodex/config.json` を書き込み、Codex を接続しますが、プロキシ自体は起動しません。`ocx provider add` や `ocx combo set` などのヘッドレスコマンドは、実行中のプロキシと通信し、アクセスできない場合は非ゼロで終了します。`ocx status`、`ocx doctor`、`ocx health` は実行状態を報告します。Node 18 以上が必要で、README は Bun が `npm install` 中に自動でバンドルされるため、別途インストールする必要がないと述べています。このインストール方法は macOS、Linux、Windows でネイティブに動作し、Windows では WSL が不要です。 README の人間向けクイックスタートは 2 つのコマンドです: `npm install -g @bitkyc08/opencodex` と `ocx start`。これでプロキシが起動し、`http://localhost:10100` に Web ダッシュボードが開きます。エージェントワークフロー向けには、`ocx init` が対話的に `~/.opencodex/config.json` を書き込み、Codex を接続しますが、プロキシ自体は起動しません。`ocx provider add` や `ocx combo set` などのヘッドレスコマンドは、実行中のプロキシと通信し、アクセスできない場合は非ゼロで終了します。`ocx status`、`ocx doctor`、`ocx health` は実行状態を報告します。Node 18 以上が必要で、README は Bun が `npm install` 中に自動でバンドルされるため、別途インストールする必要がないと述べています。このインストール方法は macOS、Linux、Windows でネイティブに動作し、Windows では WSL が不要です。

プロバイダー選択、モデルルーティング、推論 effort

モデルは `provider/model` の形式で指定します。README の例には `codex -m "anthropic/claude-opus-5"`、`codex -m "google/gemini-3-pro"`、`codex -m "ollama/llama3"` があります。プロバイダー接頭辞を省略すると、opencodex はデフォルトプロバイダーにルーティングするか、モデル名のパターンで自動マッチングします。たとえば `claude-*` は Anthropic、`gpt-*` は OpenAI です。ルーティングされたモデルは、推論 effort コントロールとともに Codex App のモデルピッカーに表示されます。README は `ultra` がアップストリームの Codex と同じ意味を持つと説明しています。つまりクライアントで最大推論と能動的なマルチエージェント委譲を有効にし、実際のリクエストは `max` として送信されます。`ultra` は、`reasoningEfforts` 設定でオプトインしたプロバイダーだけが広告します。GPT-5.6 Sol/Terra/Luna は OpenAI API キーと OpenRouter プリセットのカタログ項目としてシードされますが、実際の利用可否はアップストリームのプレビューゲートに従います。opencodex はルーティングとカタログメタデータを準備するだけです。 モデルは `provider/model` の形式で指定します。README の例には `codex -m "anthropic/claude-opus-5"`、`codex -m "google/gemini-3-pro"`、`codex -m "ollama/llama3"` があります。プロバイダー接頭辞を省略すると、opencodex はデフォルトプロバイダーにルーティングするか、モデル名のパターンで自動マッチングします。たとえば `claude-*` は Anthropic、`gpt-*` は OpenAI です。ルーティングされたモデルは、推論 effort コントロールとともに Codex App のモデルピッカーに表示されます。README は `ultra` がアップストリームの Codex と同じ意味を持つと説明しています。つまりクライアントで最大推論と能動的なマルチエージェント委譲を有効にし、実際のリクエストは `max` として送信されます。`ultra` は、`reasoningEfforts` 設定でオプトインしたプロバイダーだけが広告します。GPT-5.6 Sol/Terra/Luna は OpenAI API キーと OpenRouter プリセットのカタログ項目としてシードされますが、実際の利用可否はアップストリームのプレビューゲートに従います。opencodex はルーティングとカタログメタデータを準備するだけです。 モデルは `provider/model` の形式で指定します。README の例には `codex -m "anthropic/claude-opus-5"`、`codex -m "google/gemini-3-pro"`、`codex -m "ollama/llama3"` があります。プロバイダー接頭辞を省略すると、opencodex はデフォルトプロバイダーにルーティングするか、モデル名のパターンで自動マッチングします。たとえば `claude-*` は Anthropic、`gpt-*` は OpenAI です。ルーティングされたモデルは、推論 effort コントロールとともに Codex App のモデルピッカーに表示されます。README は `ultra` がアップストリームの Codex と同じ意味を持つと説明しています。つまりクライアントで最大推論と能動的なマルチエージェント委譲を有効にし、実際のリクエストは `max` として送信されます。`ultra` は、`reasoningEfforts` 設定でオプトインしたプロバイダーだけが広告します。GPT-5.6 Sol/Terra/Luna は OpenAI API キーと OpenRouter プリセットのカタログ項目としてシードされますが、実際の利用可否はアップストリームのプレビューゲートに従います。opencodex はルーティングとカタログメタデータを準備するだけです。 モデルは `provider/model` の形式で指定します。README の例には `codex -m "anthropic/claude-opus-5"`、`codex -m "google/gemini-3-pro"`、`codex -m "ollama/llama3"` があります。プロバイダー接頭辞を省略すると、opencodex はデフォルトプロバイダーにルーティングするか、モデル名のパターンで自動マッチングします。たとえば `claude-*` は Anthropic、`gpt-*` は OpenAI です。ルーティングされたモデルは、推論 effort コントロールとともに Codex App のモデルピッカーに表示されます。README は `ultra` がアップストリームの Codex と同じ意味を持つと説明しています。つまりクライアントで最大推論と能動的なマルチエージェント委譲を有効にし、実際のリクエストは `max` として送信されます。`ultra` は、`reasoningEfforts` 設定でオプトインしたプロバイダーだけが広告します。GPT-5.6 Sol/Terra/Luna は OpenAI API キーと OpenRouter プリセットのカタログ項目としてシードされますが、実際の利用可否はアップストリームのプレビューゲートに従います。opencodex はルーティングとカタログメタデータを準備するだけです。

ChatGPT アカウントプール: アフィニティ、クォータ、フェイルオーバー

Codex 認証では、opencodex は ChatGPT と Codex のアカウントプールを管理できます。既存のスレッドは開始したアカウントに固定されるため、長時間の SSH、tmux、モバイルセッションが会話の途中でアカウントを切り替えることはありません。自動切り替えが有効な場合、新規セッションは 5 時間、週次、30 日のクォータウィンドウのうち最も使用率が高いものを比較し、使用量が少ない適格なアカウントにルーティングします。ダッシュボードはすべてのアカウントのクォータを一度に更新でき、リクエストログはプールトラフィックを非 PII のアカウント序数でラベル付けします。トークン失敗はフェイルクローズです。別の資格情報に静かにフォールバックせず、再認証が必要と表示します。429 クォータ応答はアカウントをクールダウンに入れ、別の適格なプールアカウントへのフェイルオーバーを可能にします。また、`openai-apikey` モードはアカウントルーティングを完全に迂回し、API キーまたはキープールを使用します。README はプールに保持できるアカウント数や具体的なクォータしきい値を示していません。 Codex 認証では、opencodex は ChatGPT と Codex のアカウントプールを管理できます。既存のスレッドは開始したアカウントに固定されるため、長時間の SSH、tmux、モバイルセッションが会話の途中でアカウントを切り替えることはありません。自動切り替えが有効な場合、新規セッションは 5 時間、週次、30 日のクォータウィンドウのうち最も使用率が高いものを比較し、使用量が少ない適格なアカウントにルーティングします。ダッシュボードはすべてのアカウントのクォータを一度に更新でき、リクエストログはプールトラフィックを非 PII のアカウント序数でラベル付けします。トークン失敗はフェイルクローズです。別の資格情報に静かにフォールバックせず、再認証が必要と表示します。429 クォータ応答はアカウントをクールダウンに入れ、別の適格なプールアカウントへのフェイルオーバーを可能にします。また、`openai-apikey` モードはアカウントルーティングを完全に迂回し、API キーまたはキープールを使用します。README はプールに保持できるアカウント数や具体的なクォータしきい値を示していません。 Codex 認証では、opencodex は ChatGPT と Codex のアカウントプールを管理できます。既存のスレッドは開始したアカウントに固定されるため、長時間の SSH、tmux、モバイルセッションが会話の途中でアカウントを切り替えることはありません。自動切り替えが有効な場合、新規セッションは 5 時間、週次、30 日のクォータウィンドウのうち最も使用率が高いものを比較し、使用量が少ない適格なアカウントにルーティングします。ダッシュボードはすべてのアカウントのクォータを一度に更新でき、リクエストログはプールトラフィックを非 PII のアカウント序数でラベル付けします。トークン失敗はフェイルクローズです。別の資格情報に静かにフォールバックせず、再認証が必要と表示します。429 クォータ応答はアカウントをクールダウンに入れ、別の適格なプールアカウントへのフェイルオーバーを可能にします。また、`openai-apikey` モードはアカウントルーティングを完全に迂回し、API キーまたはキープールを使用します。README はプールに保持できるアカウント数や具体的なクォータしきい値を示していません。 Codex 認証では、opencodex は ChatGPT と Codex のアカウントプールを管理できます。既存のスレッドは開始したアカウントに固定されるため、長時間の SSH、tmux、モバイルセッションが会話の途中でアカウントを切り替えることはありません。自動切り替えが有効な場合、新規セッションは 5 時間、週次、30 日のクォータウィンドウのうち最も使用率が高いものを比較し、使用量が少ない適格なアカウントにルーティングします。ダッシュボードはすべてのアカウントのクォータを一度に更新でき、リクエストログはプールトラフィックを非 PII のアカウント序数でラベル付けします。トークン失敗はフェイルクローズです。別の資格情報に静かにフォールバックせず、再認証が必要と表示します。429 クォータ応答はアカウントをクールダウンに入れ、別の適格なプールアカウントへのフェイルオーバーを可能にします。また、`openai-apikey` モードはアカウントルーティングを完全に迂回し、API キーまたはキープールを使用します。README はプールに保持できるアカウント数や具体的なクォータしきい値を示していません。

設定、リモートアクセス、アンインストール

設定ファイルは `~/.opencodex/config.json` にあります。ファイルが無効な JSON の場合、opencodex は `config.json.invalid-<timestamp>` としてバックアップし、デフォルトで起動するため、元のファイルが静かに失われることはありません。デフォルトではプロキシは `127.0.0.1` にバインドされ、個別の認証はありません。`"hostname": "0.0.0.0"` を設定して LAN に公開する場合、opencodex は `OPENCODEX_API_AUTH_TOKEN` で bearer トークンを設定することを要求し、管理 API とデータプレーンパスの両方に使用します。この変数がないと起動を拒否します。README は、タイミング攻撃を減らすためにトークン比較が定数時間で行われると述べています。`ocx uninstall` はプロキシを停止し、インストール済みのサービスとシムを削除し、Codex の設定・カタログ・履歴を復元し、`~/.opencodex` を削除します。自動起動には 2 つの方法があります。OS サービス管理（launchd、systemd、Task Scheduler）で常時実行する方法と、codex シムが `codex` 呼び出しごとに `ocx ensure` を実行する方法です。README はまた、プロキシ使用中に古い OpenAI スレッドを保持し、停止時にそれらを OpenAI に戻す resume 履歴の再マッピングについて説明しています。 設定ファイルは `~/.opencodex/config.json` にあります。ファイルが無効な JSON の場合、opencodex は `config.json.invalid-<timestamp>` としてバックアップし、デフォルトで起動するため、元のファイルが静かに失われることはありません。デフォルトではプロキシは `127.0.0.1` にバインドされ、個別の認証はありません。`"hostname": "0.0.0.0"` を設定して LAN に公開する場合、opencodex は `OPENCODEX_API_AUTH_TOKEN` で bearer トークンを設定することを要求し、管理 API とデータプレーンパスの両方に使用します。この変数がないと起動を拒否します。README は、タイミング攻撃を減らすためにトークン比較が定数時間で行われると述べています。`ocx uninstall` はプロキシを停止し、インストール済みのサービスとシムを削除し、Codex の設定・カタログ・履歴を復元し、`~/.opencodex` を削除します。自動起動には 2 つの方法があります。OS サービス管理（launchd、systemd、Task Scheduler）で常時実行する方法と、codex シムが `codex` 呼び出しごとに `ocx ensure` を実行する方法です。README はまた、プロキシ使用中に古い OpenAI スレッドを保持し、停止時にそれらを OpenAI に戻す resume 履歴の再マッピングについて説明しています。 設定ファイルは `~/.opencodex/config.json` にあります。ファイルが無効な JSON の場合、opencodex は `config.json.invalid-<timestamp>` としてバックアップし、デフォルトで起動するため、元のファイルが静かに失われることはありません。デフォルトではプロキシは `127.0.0.1` にバインドされ、個別の認証はありません。`"hostname": "0.0.0.0"` を設定して LAN に公開する場合、opencodex は `OPENCODEX_API_AUTH_TOKEN` で bearer トークンを設定することを要求し、管理 API とデータプレーンパスの両方に使用します。この変数がないと起動を拒否します。README は、タイミング攻撃を減らすためにトークン比較が定数時間で行われると述べています。`ocx uninstall` はプロキシを停止し、インストール済みのサービスとシムを削除し、Codex の設定・カタログ・履歴を復元し、`~/.opencodex` を削除します。自動起動には 2 つの方法があります。OS サービス管理（launchd、systemd、Task Scheduler）で常時実行する方法と、codex シムが `codex` 呼び出しごとに `ocx ensure` を実行する方法です。README はまた、プロキシ使用中に古い OpenAI スレッドを保持し、停止時にそれらを OpenAI に戻す resume 履歴の再マッピングについて説明しています。 設定ファイルは `~/.opencodex/config.json` にあります。ファイルが無効な JSON の場合、opencodex は `config.json.invalid-<timestamp>` としてバックアップし、デフォルトで起動するため、元のファイルが静かに失われることはありません。デフォルトではプロキシは `127.0.0.1` にバインドされ、個別の認証はありません。`"hostname": "0.0.0.0"` を設定して LAN に公開する場合、opencodex は `OPENCODEX_API_AUTH_TOKEN` で bearer トークンを設定することを要求し、管理 API とデータプレーンパスの両方に使用します。この変数がないと起動を拒否します。README は、タイミング攻撃を減らすためにトークン比較が定数時間で行われると述べています。`ocx uninstall` はプロキシを停止し、インストール済みのサービスとシムを削除し、Codex の設定・カタログ・履歴を復元し、`~/.opencodex` を削除します。自動起動には 2 つの方法があります。OS サービス管理（launchd、systemd、Task Scheduler）で常時実行する方法と、codex シムが `codex` 呼び出しごとに `ocx ensure` を実行する方法です。README はまた、プロキシ使用中に古い OpenAI スレッドを保持し、停止時にそれらを OpenAI に戻す resume 履歴の再マッピングについて説明しています。

ライセンス、保証、プロバイダー規約

このリポジトリは MIT ライセンスです。ライセンスの抜粋は、ソフトウェアの複製、変更、統合、公開、配布、サブライセンス、販売の権利を許可し、ソフトウェアは現状のまま提供され、商品性、特定目的への適合性、非侵害性を含むいかなる種類の保証もないと述べています。README は、opencodex が独立したコミュニティプロジェクトであり、OpenAI、Anthropic、その他のプロバイダーとは提携も承認もされていないと補足しています。また、特に Anthropic など一部のプロバイダーが、サードパーティのプロキシを介した API トラフィックのルーティングに対してアカウントを停止または制限する可能性があると警告し、プロバイダーの利用規約を確認する責任はユーザーにあるとしています。README とライセンスは、LAN モードで説明されている定数時間のトークン比較を除いて、サポートの約束、稼働時間の保証、本番稼働の主張を確立していません。 このリポジトリは MIT ライセンスです。ライセンスの抜粋は、ソフトウェアの複製、変更、統合、公開、配布、サブライセンス、販売の権利を許可し、ソフトウェアは現状のまま提供され、商品性、特定目的への適合性、非侵害性を含むいかなる種類の保証もないと述べています。README は、opencodex が独立したコミュニティプロジェクトであり、OpenAI、Anthropic、その他のプロバイダーとは提携も承認もされていないと補足しています。また、特に Anthropic など一部のプロバイダーが、サードパーティのプロキシを介した API トラフィックのルーティングに対してアカウントを停止または制限する可能性があると警告し、プロバイダーの利用規約を確認する責任はユーザーにあるとしています。README とライセンスは、LAN モードで説明されている定数時間のトークン比較を除いて、サポートの約束、稼働時間の保証、本番稼働の主張を確立していません。 このリポジトリは MIT ライセンスです。ライセンスの抜粋は、ソフトウェアの複製、変更、統合、公開、配布、サブライセンス、販売の権利を許可し、ソフトウェアは現状のまま提供され、商品性、特定目的への適合性、非侵害性を含むいかなる種類の保証もないと述べています。README は、opencodex が独立したコミュニティプロジェクトであり、OpenAI、Anthropic、その他のプロバイダーとは提携も承認もされていないと補足しています。また、特に Anthropic など一部のプロバイダーが、サードパーティのプロキシを介した API トラフィックのルーティングに対してアカウントを停止または制限する可能性があると警告し、プロバイダーの利用規約を確認する責任はユーザーにあるとしています。README とライセンスは、LAN モードで説明されている定数時間のトークン比較を除いて、サポートの約束、稼働時間の保証、本番稼働の主張を確立していません。 このリポジトリは MIT ライセンスです。ライセンスの抜粋は、ソフトウェアの複製、変更、統合、公開、配布、サブライセンス、販売の権利を許可し、ソフトウェアは現状のまま提供され、商品性、特定目的への適合性、非侵害性を含むいかなる種類の保証もないと述べています。README は、opencodex が独立したコミュニティプロジェクトであり、OpenAI、Anthropic、その他のプロバイダーとは提携も承認もされていないと補足しています。また、特に Anthropic など一部のプロバイダーが、サードパーティのプロキシを介した API トラフィックのルーティングに対してアカウントを停止または制限する可能性があると警告し、プロバイダーの利用規約を確認する責任はユーザーにあるとしています。README とライセンスは、LAN モードで説明されている定数時間のトークン比較を除いて、サポートの約束、稼働時間の保証、本番稼働の主張を確立していません。

編集部の結論

opencodex は MIT ライセンスのローカルプロキシで、Codex の Responses API を複数のプロバイダープロトコルに変換し、アフィニティとフェイルオーバーを備えた ChatGPT アカウントプールを管理し、停止時に元の Codex 設定を復元します。特定のプロバイダーが使えるかどうかは、そのプロバイダーの利用規約とプレビューゲートに依存し、README はその判断を明確にユーザーに委ねています。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes