1. プロジェクト概要
OpenCodex は、開発者が Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama など、あらゆる大規模言語モデルを、通常は単一プロバイダーに固定されている Codex、Claude Code、Claude Desktop、Grok Build などのコーディングアシスタント経由でルーティングできるようにする軽量ローカルプロキシです。
2. 背景と位置づけ
プロプライエタリなコーディングアシスタントは通常、単一のモデルプロバイダーに固定されており、特定のタスクに別のモデルの方が適している場合でも、開発者はワークフロー全体で単一のベンダーを選択せざるを得ません。OpenCodex は、そのようなロックインを解消するために構築されました。プロバイダー間の API リクエスト形式を変換するユニバーサルアダプターとして機能し、ストリーミング応答、ツール呼び出し、推論トークン、画像入力の機能互換性を維持します。
単純な API キー切り替えツールや単一プロバイダーのラッパーとは異なり、OpenCodex はプロトコルレベルの変換(Responses API 形式との相互変換)、クォータ認識型のマルチアカウントプーリング、運用ツール(Web ダッシュボード、バックグラウンドサービス管理、ヘルスチェック)に重点を置いており、一回限りのスクリプトというよりは、小規模なセルフホスト型ゲートウェイに近いものです。
3. 機能カテゴリ
🔀 モデルルーティング — 40 以上のプロバイダー、無制限のモデル
provider/model というシンプルな構文を使用して、設定済みの任意のプロバイダーとモデルにルーティングします。代表的な例:anthropic/claude-opus-5、OpenAI、Google、xAI、カスタムの OpenAI 互換エンドポイント。目的:コード変更なしで、1 つのコーディングアシスタントから任意のバックエンドモデルを呼び出せるようにする。
👥 アカウント管理 — ChatGPT/Codex アカウント間のプーリング
複数の ChatGPT/Codex アカウントをプールし、クォータ使用量を追跡し、スレッドアフィニティを維持して、会話の途中でアカウントが切り替わらないようにします。使用量最小優先、ラウンドロビン、先着順の自動ルーティングポリシーを含みます。目的:複数アカウント間でスループットを最大化し、レート制限による中断を回避する。
🛡️ 信頼性機能 — フェイルオーバーと冗長性
重み付けラウンドロビンの「コンボ」とモデル間の自動フェイルオーバーに加え、同じルーティングルールを継承するサブエージェントサポート。目的:プロバイダーやアカウントが利用できなくなった場合でも、コーディングセッションを継続させる。
🔑 認証と拡張機能 — OAuth とサイドカー機能
xAI、Anthropic、Kimi 向けのネイティブ OAuth 統合に加え、ChatGPT サイドカーを介した非 OpenAI モデル向けの Web 検索とビジョンサポート。目的:OpenAI 限定機能(ビジョンや Web ブラウジングなど)を他のプロバイダーにも提供する。
⚙️ 運用 — ダッシュボードとサービス管理
localhost:10100 の Web ダッシュボード、systemd/launchd/Task Scheduler サービス統合、ヘルス/レディネスエンドポイント。目的:OpenCodex を一回限りの CLI 呼び出しではなく、永続的で監視可能なローカルサービスとして実行する。
4. 主なハイライト
- プロバイダー非依存のルーティング —
provider/model文字列で基盤モデルを交換可能。アシスタント側の再設定は不要。 - 機能互換の変換 — ストリーミング、ツール呼び出し、推論トークン、画像は、プレーンテキストだけでなく、プロバイダー形式変換全体で保持されます。
- クォータ認識型アカウントプーリング — 設定可能なルーティングポリシーを使用して、複数の ChatGPT/Codex アカウントに負荷を自動分散。
- メモリ制限付き状態管理 — 退避ポリシー、60 秒の有効期限スイープ、世代ベースの調整を備えたバイト単位のストアにより、古いデータを回避。
- クロスプラットフォームのネイティブサービス — macOS、Linux、Windows でフォアグラウンドプロセスだけでなく、適切なバックグラウンドサービスとしてインストール。
- 内蔵 Web ダッシュボード — 設定ファイルを手動編集する代わりに、ローカル UI でプロバイダー、アカウント、コンボを設定可能。
5. 役割別のユースケース
一般開発者 — ツールを切り替えることなく、同じコーディングアシスタント内でタスクに適したモデル(定型コードには安価なモデル、難しいバグには強力なモデルなど)を使用できます。
DevOps/SRE — OpenCodex を監視用のヘルス/レディネスエンドポイントを備えた管理対象バックグラウンドサービスとして実行し、フェイルオーバーコンボを使用して、プロバイダー障害時もコーディングアシスタントを利用可能に保ちます。
プロジェクトマネージャー — チームの ChatGPT/Codex アカウントをクォータ追跡付きでプールし、手動調整なしでチーム全体の使用量とコストを管理します。
6. はじめに
必要なものを見つける
ドキュメントサイトでプロバイダー設定ガイドと設定リファレンスを参照してください:
https://opencodex.me/
インストール / 統合
npm install -g @bitkyc08/opencodex
ocx start # プロキシとダッシュボードを起動
Node 18 以降が必要です(Bun ランタイムは自動的にバンドルされます)。次に、コーディングアシスタント経由でリクエストをルーティングします:
codex -m "anthropic/claude-opus-5" "プロンプトをここに入力"
貢献
リポジトリの CONTRIBUTING.md を読み、プルリクエストを開いてください:
https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md
7. プロジェクト構造
opencodex/
├── bin/ # バイナリ実行ファイル
├── dist/bin/ # 配布用バイナリ
├── docs/ # ドキュメントファイル
├── docs-site/ # 公開ドキュメントサイトのソース
├── gui/ # Web ダッシュボードインターフェース
├── readme/ # ローカライズされた README ファイル
├── src/ # ソースコード
├── structure/ # メンテナー用メモとアーキテクチャ
└── tests/ # テストスイート
src/ はコアプロキシと変換ロジックを保持し、gui/ はローカル Web ダッシュボードを実装し、docs-site/ は opencodex.me の公開ドキュメントを提供します。
8. 関連エコシステム
OpenCodex は、コーディングアシスタント(Codex、Claude Code、Claude Desktop、Grok Build)と LLM プロバイダー(OpenAI、Anthropic、Google、xAI、および Ollama、DeepSeek、Qwen、GLM、Kimi などのオープンソース/セルフホスト型オプション)の間に位置します。精神においては OpenRouter などのツールと補完的です。両者ともプロバイダーの違いを抽象化することを目指していますが、OpenCodex はホスト型 API ゲートウェイではなく、コーディングアシスタントの CLI やデスクトップアプリとのローカル統合に特化しています。
9. ライセンス
✅ ソフトウェアの使用、コピー、変更、結合、公開、配布、サブライセンスが可能(MIT ライセンス)
✅ 商用およびプライベートプロジェクトでの使用が可能
❌ ソフトウェアの使用に起因する損害について著者に責任を負わせることはできません
ℹ️ OpenCodex は独立したプロジェクトであり、OpenAI、Anthropic、その他のモデルプロバイダーとは提携していません。サードパーティのプロキシを介した API トラフィックのルーティングは、一部のプロバイダーの利用規約に違反する可能性があるため、使用前に各プロバイダーのポリシーを確認してください
10. よくある質問
Q: OpenCodex はどのコーディングアシスタントで動作しますか?
A: Codex、Claude Code、Claude Desktop、Grok Build で、ocx start で起動したローカルプロキシを介して動作します。
Q: OpenAI 以外のモデルも使用できますか?
A: はい。OpenCodex は Anthropic、Google、xAI、および DeepSeek、Qwen、GLM、Kimi、Ollama などのオープンソースモデルを含む 40 以上のプロバイダーをサポートしており、provider/model 構文(例:anthropic/claude-opus-5)で選択できます。
Q: OpenCodex を介してプロバイダーアカウントをルーティングしても安全ですか?
A: 機能的には安全ですが、一部のプロバイダーはサードパーティのプロキシを介してトラフィックをルーティングするアカウントを制限する場合があります。アカウントを接続する前に、各プロバイダーの利用規約を確認してください。
Q: 複数の ChatGPT/Codex アカウントを管理するにはどうすればよいですか?
A: ocx account <...> を使用してアカウントをプールします。OpenCodex はアカウントごとのクォータを追跡し、使用量最小優先、ラウンドロビン、先着順のポリシーで自動ルーティングできます。
Q: サポートされているプラットフォームは?
A: macOS(arm64/x64)、Linux(x64/arm64)、Windows(x64)で、それぞれネイティブのバックグラウンドサービス統合(launchd、systemd、Task Scheduler)に対応しています。
11. クイックリンク
- リポジトリ:https://github.com/lidge-jun/opencodex
- 公式サイト / ドキュメント:https://opencodex.me/
- 貢献ガイド:https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md
- npm パッケージ:https://www.npmjs.com/package/@bitkyc08/opencodex
12. まとめ
OpenCodex は、40 以上の LLM プロバイダーを完全な機能互換でサポートするローカル・プロトコル変換プロキシとして機能することで、人気のコーディングアシスタントにおける単一プロバイダーへのロックインを解消します。タスク間でモデルを柔軟に組み合わせ、複数のアカウントを効率的にプールし、プロバイダー固有の障害やクォータ制限に対してコーディングワークフローを堅牢に保ちたい開発者やチームにとって、最も価値のあるツールです。