OpenCodexとは？Codex・Claude Code対応のLLMプロキシ設定と使い方

OpenCodexはOpenAI Codex CLI・App・SDKとClaude Codeに、Claude・Gemini・Grok・Ollama・OpenRouterなど任意のLLMバックエンドを接続できるローカルプロキシです。わずか3コマンドで起動でき、40以上のプロバイダーをWebダッシュボードからGUI管理できます。2026年7月時点でv2.7.36がリリースされ、24名のコントリビューターによる活発な開発が続いています。

GitHubで急上昇した背景には、OpenAI Codexのトークン制限や特定LLMへのロックインを回避したいエンジニアの需要があります。本記事ではインストールから設定・実際の使い方まで解説します。

opencodex とは何か — 3コマンドで動くLLMプロキシ

OpenCodexの本質は「Codex APIとLLMプロバイダーの間に挟まるローカルプロキシ」です。Codex CLI・App・SDKは常に localhost:10100 にリクエストを送り、OpenCodexがそれを設定済みのバックエンド（Anthropic・Google・xAI等）の形式に変換してルーティングします。

アーキテクチャの概要

Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ 任意のLLMプロバイダー
Claude Code           ──/v1/messages──▶  （ポート10100）  Anthropic / Google / Ollama ...
GitHub Copilot App    ──/v1/chat──▶

Codex側の設定変更は一切不要で、OpenCodexが自動でCodexのプロバイダー設定に openai_base_url を注入します。

対応プラットフォームと動作要件

OS	対応状況	サービス管理
macOS (arm64/x64)	完全対応	launchd
Linux (x64/arm64)	完全対応	systemd
Windows (x64)	完全対応	Task Scheduler / WinSW

Node.js 18以上が必須です。Bunランタイムは npm install 時に自動バンドルされるため、別途インストール不要です。WindowsでもWSLは不要です。

インストールと初期セットアップの手順

インストールからプロキシ起動まで

# グローバルインストール（Bunランタイムが自動バンドル）
npm install -g @bitkyc08/opencodex

# 対話型初期設定（プロバイダー追加・Codex自動注入・自動起動シム設定）
ocx init

# プロキシ起動
ocx start

ocx init を実行すると対話形式でプロバイダー（Anthropic・Google等）とAPIキーを設定でき、Codexへの注入まで自動で完了します。

Webダッシュボードでプロバイダーを追加する

ocx gui

ブラウザで http://localhost:10100 が開きます。「Add Provider」→ 40以上の組み込みプロバイダーから選択 → APIキーをペーストするだけで、再起動なしに即座に利用可能になります。

モデルの指定方法（provider/model 構文）

# Anthropicのclaude-sonnet-5を使う
codex -m "anthropic/claude-sonnet-5" "このスタックトレースを説明して"

# Googleのgemini-3-proを使う
codex -m "google/gemini-3-pro" "auth.tsのユニットテストを書いて"

# ローカルOllamaのllama3を使う
codex -m "ollama/llama3" "この関数をリファクタリングして"

プロバイダープレフィックスを省略した場合はデフォルトプロバイダーにルーティングされます。claude-* はAnthropic、gpt-* はOpenAIに自動マッチングされます。

ChatGPTアカウントプールで複数アカウントを自動切り替えする

OpenCodexの特徴的な機能が「ChatGPTアカウントプール」です。複数のChatGPT/Codexアカウントを登録し、使用量に応じて自動切り替えすることで、トークン制限を実質的に回避できます。

プールの動作原理

セッション継続性: 既存スレッドは開始したアカウントに固定されるため、長時間のSSH・tmuxセッションでも途中でアカウントが変わりません
自動切り替え: 新規セッションはアクティブアカウントが閾値を超えた時点で、使用量が少ない別アカウントに自動ルーティングされます
クォータ管理: ダッシュボードから全アカウントのクォータ（5h/週次/30d）を一括更新できます
障害時フェイルオーバー: 429エラー時はクールダウンして別アカウントにフェイルオーバーします

なぜ今OpenCodexが注目されているのか — 類似ツールとの違い

Claude Code・GitHub Copilotとの比較

OpenCodexは直接の競合ではなく、これらのツールを「強化」するプロキシです。

ツール	接続LLM	コスト管理	自動切り替え
Claude Code（単体）	Anthropic APIのみ	API従量課金	なし
GitHub Copilot	GitHubが管理	サブスクリプション	なし
OpenCodex経由	40以上から選択	自社でコスト最適化	プール機能あり

LiteLLM・OpenRouterとの違い

LiteLLMやOpenRouterはサーバー型のプロキシですが、OpenCodexはCodex CLI・Claude Codeへの自動注入機能を持ち、ChatGPTアカウントプールによるコスト管理も可能な点が差別化ポイントです。ローカルで動作するためAPIキーが外部に漏れるリスクも低減されます。

こんな人に向いている — 職種別活用シナリオ

バックエンドエンジニア・SREの活用シーン

毎日Codex CLIを使いながら、月途中でトークン制限に達することが多いバックエンドエンジニアに向いています。複数のChatGPTアカウントをプールに追加しておけば、制限到達時に手動でログインし直す作業が不要になります。また、ollama/llama3 をデフォルトに設定してオフライン環境でのコーディングにも対応できます。

AIツール研究者・LLMエンジニアの活用シーン

異なるLLMのコーディング能力を比較検証したいLLMエンジニアに最適です。codex -m "google/gemini-3-pro" と codex -m "anthropic/claude-sonnet-5" を切り替えながら同一タスクを実行し、出力品質の差を評価できます。ローカルのOllamaモデルと商用APIを組み合わせることでコストを抑えた検証環境も構築できます。

フリーランス開発者の活用シーン

予算に応じてLLMを使い分けたいフリーランス開発者にも向いています。通常作業はOpenRouter経由の無料モデルで、重要なコードレビューはclaude-sonnet-5に切り替えるといった柔軟なコスト管理が可能です。

使う前に知っておきたいこと — 制限と注意点

AnthropicのToSに関するリスク

READMEに明記されているとおり、AnthropicはAPIトラフィックをサードパーティプロキシ経由でルーティングすることでアカウントを停止・制限する可能性があります。商用利用前はAnthropicの利用規約を必ず確認してください。同様のリスクが他プロバイダーにも存在する場合があります。

技術的な制限事項

Node.js 18以上が必須: 古いNode.jsでは動作しません
v2クロスプロバイダー委任の既知バグ: ネイティブ親が別プロバイダーの子エージェントを生成する場合、タスク本文が暗号化されて届かない問題がIssue #92として報告されています。信頼性が必要な場合はv1サーフェスを使用してください
Cursorアダプターは実験的: ネイティブローカル実行（読み書き・シェル実行）はデフォルト無効で、信頼できるローカル環境でのみオプトインすべきです
リモートアクセス時は認証必須: "hostname": "0.0.0.0" を設定してLAN公開する場合は OPENCODEX_API_AUTH_TOKEN の設定が必須です

ライセンス

MIT ライセンスで商用利用も可能です。ただしプロバイダー側のToSは別途確認が必要です。

まとめ — OpenCodexでCodexをLLM不問のツールに

OpenCodexは3コマンドで起動できるシンプルさと、40以上のプロバイダー対応・ChatGPTアカウントプール・Claude CodeおよびGitHub Copilot対応という多機能性を両立しています。

Codex CLIのトークン制限に悩むエンジニア、LLMコストを最適化したいチーム、異なるLLMを比較検証したいAI研究者に特に向いています。利用前にAnthropicなど各プロバイダーの利用規約を確認することを忘れずに。

GitHubリポジトリ: lidge-jun/opencodex
npmパッケージ: @bitkyc08/opencodex
公式ドキュメント: lidge-jun.github.io/opencodex