OpenCodeX（GitHub リポジトリ）

codex をオープンに！

OpenAI Codex と Claude Code 向けのユニバーサルプロバイダープロキシ — Codex CLI、App、SDK、そして Claude Code で、あらゆる LLM を利用可能にします。

npm install -g @bitkyc08/opencodex · ocx start · localhost:10100

English · 한국어 · 简体中文 · Русский · 日本語 · 📖 **完全なドキュメント →**

Codex や Claude Code を使いつつ、Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama、あるいはその他の LLM を、誰かがサポートを追加するのを待たずに利用できます。

opencodex は軽量なローカルプロキシで、Codex の Responses API を、お使いのプロバイダーが理解できる形式に変換します。ストリーミング、ツール呼び出し、推論トークン、画像 — 双方向すべてが機能します。

Codex で任意のモデルを実行。 プロバイダーを選んで開始するだけで、同じ Codex ワークフローを維持しつつ、バックエンドの「頭脳」だけを変更できます。

また、Codex の認証用として ChatGPT アカウントプール を管理することも可能です。複数の ChatGPT / Codex アカウントを追加し、ダッシュボードで各アカウントの 5 時間・週次・30 日間のクォータをリフレッシュします。新しいセッションは自動的に使用量が最も少なく、健全なアカウントにルーティングされます。

既存の Codex スレッドは、そのスレッドを開始したアカウントに固定されたままになります。これにより、SSH の長時間接続や tmux、モバイル端末からの接続であっても、会話中にアカウントが切り替わることはありません。

Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provider
                                              │
              Anthropic · Google · xAI · Kimi · Ollama Cloud · Groq
              OpenRouter · Azure · DeepSeek · GLM · …and OpenAI itself

flowchart LR
  codex[Codex session<br/>CLI, App, SSH, mobile] --> proxy[opencodex]
  proxy --> existing{Existing thread?}
  existing -->|yes| pinned[Keep the same<br/>ChatGPT account]
  existing -->|new session| quota[Refresh quota<br/>5h, weekly, 30d]
  quota --> pick[Pick lowest-usage<br/>healthy account]
  pick --> upstream[ChatGPT / Codex backend]
  pinned --> upstream
  upstream --> outcomes[Quota / auth outcome]
  outcomes -->|429| cooldown[Cooldown + failover]
  outcomes -->|401 / 403| reauth[Mark reauth needed]
  cooldown --> quota

対応プラットフォーム

Node 18 以上が必要です。Bun ランタイムは npm install で自動的にバンドルされるため、別途 Bun をインストールする必要はありません。Windows でも WSL は不要で、3 つのプラットフォームすべてがネイティブで動作します。

クイックスタート

# Install (bundles the Bun runtime automatically — only Node 18+ required)
# Prefer a user-owned Node (nvm/fnm) — avoid `sudo npm install -g …`
npm install -g @bitkyc08/opencodex

# Interactive setup (writes config, injects into Codex, and offers autostart shim install)
ocx init

# Start the proxy
ocx start

# If you skipped it during init, install the on-demand autostart shim later
ocx codex-shim install

# Use Codex normally — it now routes through opencodex
codex "Write a hello world in Rust"

「bundled Bun runtime is missing」エラー / npm によって Bun のインストールスクリプトがブロックされている場合？

opencodex は依存関係として Bun ランタイムをバンドルしており、Node ランチャーを通じて実行します。そのため、ユーザーが手動で Bun をインストールする必要はありません。

もし「bundled Bun runtime is missing」というエラーが表示される場合は、ライフサイクルスクリプト（allowScripts 下での npm による Bun の postinstall スクリプトのブロックなど）がスキップされたか、オプション依存関係のインストールが失敗した可能性があります。これらのフラグを指定せずに再インストールし、Bun のインストールスクリプトの実行を許可してください。

npm install -g --allow-scripts=bun @bitkyc08/opencodex   # no --ignore-scripts, no --omit=optional

# if the original install used sudo, keep using sudo:
sudo npm install -g --allow-scripts=bun @bitkyc08/opencodex

npm の警告メッセージには、パッケージ名を省略した略式コマンドの例が示されていますが、これは現在のディレクトリを再インストールする意味になるため、必ず @bitkyc08/opencodex を明示的に指定してください。

もし sudo を使ってルート所有のプレフィックスにインストールした場合、上記の sudo による再インストールでそのプレフィックスが解放されます。ただし可能であれば、ユーザー所有の Node 環境（nvm、fnm、またはユーザー npm プレフィックス）への移行を検討することをお勧めします。

プロバイダーを追加する

プロバイダーを追加する最速の方法は、Web ダッシュボードを利用することです：

ocx gui

これで http://localhost:10100 にダッシュボードが開きます。そこから以下の手順を実行してください。

• 「プロバイダーの追加」をクリック
• 40 種類以上の内蔵プロバイダーから選択するか、カスタムの OpenAI 互換エンドポイントを入力
• API キーを貼り付けるか、Anthropic、xAI、Kimi の場合は OAuth でログイン

• モデルは、プロバイダーの /v1/models エンドポイントから自動的に検出されます。

新しいプロバイダーはすぐに使用可能です。再起動の必要はありません。

また、ocx init（対話型 CLI）を使用するか、~/.opencodex/config.json を直接編集することで、プロバイダーを追加することもできます。

モデルルーティング

provider/model 構文を使用して、設定された任意のプロバイダーとモデルを指定します：

モデルIDにスラッシュ（/）を含むプロバイダー（zenmux、openrouter、nvidia など）は、Codex に対して内側のスラッシュがハイフン（-）に置換された形式で公開されます。例えば zenmux/moonshotai-kimi-k3-free のようになります。このプロキシは内部で元のネイティブIDへ自動的に転送するため、本来のスラッシュを含む完全な形式でも問題なく動作します。

# Use Claude Opus through Anthropic
codex -m "anthropic/claude-opus-4-8" "Explain this stack trace"

# Use Gemini through Google
codex -m "google/gemini-3-pro" "Write unit tests for auth.ts"

# Use GLM through Ollama Cloud
codex -m "ollama-cloud/glm-5.2" "Write a SQL migration"

# Use a local model through Ollama
codex -m "ollama/llama3" "Refactor this function"

provider/ プレフィックスを省略すると、opencodex はデフォルトのプロバイダーにルーティングされます。あるいは、モデル名のパターンに基づいて自動マッチングが行われます（例：claude-* は Anthropic へ、gpt-* は OpenAI へ）。

ルーティングされたモデルは、Codex App のモデル選択画面にも表示され、各モデルごとに推論の努力レベルを調整する機能も用意されています。

現在のCodexでは、推論レベルとして「low」「medium」「high」「xhigh」「max」「ultra」の6段階を指定できます。

モデルがそれらを謳うタイミングを制御する仕組みです。OpenCodeX では、プロバイダーが明示しない限り、xhigh と max は区別して扱います。

設定により、一方が他方へ明示的にマッピングされます。ultra はアップストリームの Codex セマンティクスをそのまま反映しており、これを選択します。

クライアント側で最大推論と能動的なマルチエージェント委任が行われ、プロバイダへのリクエストが到達する前に max に変換されます。ルーティングされたモデルは、プロバイダ設定が reasoningEfforts を経由してオプトインした場合のみこれを広告します。

GPT-5.6 Sol/Terra/Luna は、OpenAI API キーおよび OpenRouter プリセット用のロールアウト済みカタログエントリとして登録されています（gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna。OpenRouter では

「openai/...」などのリソースは、依然として上位サービスの利用状況に基づきプレビュー制限がかけられています。OpenCodeX は、これらのサービスを提供できるアカウントやプロバイダーに対して、ルーティングとカタログメタデータの準備のみを行います。

OpenAI プロバイダーのアカウントモード

プールには、メインの Codex ログインと追加されたアカウントが含まれており、アフィニティ、クォータ、クールダウン、フェイルオーバーの機能が備わっています。

直接ショートサーキットする場合は、プールの状態を無視し、現在の呼び出し元またはメインログインのベアラーのみを使用します。

新規インストールや設定では、永続化モードが指定されていない場合、デフォルトでプールモードが適用されます。このモードはダッシュボードのProvidersページで変更可能です。どちらのモードでも、モデル ID はそのまま（プレインな状態）で保持されます。

移行後、従来のパブリックプロバイダーID「chatgpt」は非表示になります。元の設定は ~/.opencodex/config.json.pre-openai-tiers-v2.bak に1 回だけ保持されます。必要に応じて以下のコマンドで復元してください。

cp ~/.opencodex/config.json.pre-openai-tiers-v2.bak ~/.opencodex/config.json。

現在の設定では openaiProviderTierVersion: 2 が使用されています。以前の v1 形式の 3 プロバイダー構成は、自動的に単一の openai 行へ移行されます。

API tier には、Pro 仮想モデル（gpt-5.6-sol-pro、gpt-5.6-terra-pro、gpt-5.6-luna-pro）が含まれています。

ワイヤーレベルでは、各リクエストが reasoning.mode: "pro" を指定してベースモデルに書き換えられます。

カタログに登録されているのは、8 つの ID に固定されています。具体的には gpt-5.5、gpt-5.6、Sol/Terra/Luna、そしてこれらに対応する 3 つの Pro バージョンです。汎用的なエイリアスとして gpt-5.6-pro は存在しません。

コンパクトなリクエストでは、選択されたティアは維持されますが、推論オブジェクトなしでベースモデルが送信されます。

公式 API のメタデータによると、コンテキストトークンは 1,050,000、最大入力トークンは 922,000 です。

openai アカウントモードでは gpt-5.6-sol を使用し、API キーの場合は openai-apikey/gpt-5.6-sol を指定してください。Codex のログイン情報と API 認証情報は互いに混在しません。

Pool account behavior

ダッシュボードで Codex Auth を開き、アカウントを追加して、次の Codex セッションをどのアカウントが処理するかを選択できます。opencodex は以下の機能を維持しています。

• 既存セッションの親和性を保持。スレッド ID が選択されたアカウントにバインドされ、その後のやり取りでも再利用されます。そのため、長時間のリクエストやモバイル/SSH 接続のセッションも、同じアカウントを継続して使用します。

• 新規セッションの自動ルーティングが可能。自動切り替えを有効にすると、opencodex は過去 5 時間、週単位、30 日間の利用状況から最も混雑しているクォータウィンドウを比較し、アクティブなアカウントが閾値を超えた時点で、使用量の少ない適切なアカウントを新規セッションに割り当てます。

• クォータ確認機能を内蔵。ダッシュボードではワンクリックですべてのアカウントのクォータを更新でき、リクエストログには非個人識別情報（PII）のアカウント順序番号が付与されてトラフィックが分類されます。

• 障害時は安全側に失敗。トークンエラーが発生すると、別の認証情報を自動的にフォールバックするのではなく再認証を要求します。429（クォータ超過）レスポンスを受けると、そのアカウントはクールダウン状態となり、将来の処理は他の適切なプールアカウントへフェイルオーバーされます。

Highlights

• Codex とあらゆる LLM を連携。5 つのプロトコルアダプターが、Anthropic Messages、Google Gemini、Azure、OpenAI Responses のパsthrough、および OpenAI 互換の Chat Completions エンドポイントすべてに対応しています。これにより、40 以上のプロバイダーをすぐに利用可能です。

• Claude Code を含むあらゆる LLM を利用可能に。 同じデーモンが Anthropic Messages API（/v1/messages および count_tokens）を提供します。ocx claude コマンドを実行すると、Claude Code が完全に接続された状態で起動し、ルーティングされたモデルが表示されます。

ゲートウェイモデルの検出機能（claude-ocx---エイリアス、Claude Code 2.1.129以降）を介して、ネイティブの /model ピッカーを利用できます。

ダッシュボードの Claude ページでスロットとモデルマップを設定します。

• ChatGPT アカウントを安全にプールする。 既存の Codex スレッドは1つのアカウントに固定し、新しいセッションでは使用量の少ないアカウントから自動的に選択できるようにします。これにより、クォータのリフレッシュや PII を含まないリクエストのラベル付けが可能になります。

一度ログインするだけで、API キーの入力は不要です。xAI、Anthropic、Kimi に対応した OAuth サポートにより、既存のアカウントで認証できます。トークンは自動的に更新されます。あるいは codex login を転送するか、API キーを貼り付けるか、${ENV_VAR} 参照を使用することも可能です。

Codex が動作するあらゆる場所で利用可能です。Codex CLI、TUI、App、SDK に自動的に組み込まれ、ルーティングされたモデルはネイティブのモデルと同様に Codex のモデル選択画面に表示されます。

• 履歴を安全に注入。 ローカルインストールでは、プロキシが単一の openai_base_url 行を通じて Codex 内蔵の openai プロバイダを自身へ指し示します。新しいスレッドはネイティブのプロバイダータグを引き継ぐため、進行中のチャット履歴は再マッピングされず、不整なシャットダウンによって隠蔽されることもありません。（古いバージョンでタグが付け直されたスレッドは、初回起動時に一度だけ元の状態へ移行されます。リモート/LAN 接続の場合は API キーヘッダーが必要となるため、専用のプロバイダーエントリを使用します。）

• 適切なモデルに委譲する。 ダッシュボードまたは設定から、Codex のサブエージェントピッカーで最大 5 つのルーティング済みまたはネイティブモデルを機能させます。複雑なタスクは推論モデルへ、高速処理が必要なタスクは低コストなモデルへと振り分けてください。

v2 マルチエージェント環境（GPT-5.6 Sol/Terra）では、プロキシがコンパクトな委任ガイダンスを注入します。これには、優先するサブエージェントモデルと作業量（injectionModel / injectionEffort）、そして注目されるモデルの一覧が含まれます。

各々が支えるエフォート・ラダーと、クロスモデル間の spawn_agent 呼び出しを可能にする fork_turns ルール。

それらのオーバーライド。

既知の制限事項：ネイティブ親がルーティングされた子を生成する場合、タスク本体がバックエンド側で暗号化されて届き、失われる可能性があります（#92）。信頼性の高いプロバイダ間委譲には v1 サーフェスを使用してください。

独自の文言を指定したい場合は、injectionPrompt に {{model}} / {{effort}} / {{roster}} のプレースホルダーを設定してください。

プレビュー制限付きの OpenAI ロールアウトに備える。GPT-5.6 Sol/Terra/Luna エントリーは、既存の上位互換性階層を維持する。Direct/Multi は 372k の Codex コントラクトを採用し、OpenAI API および OpenRouter は、上流データが存在する場合に 1.05M のメタデータを利用する。

アクセス可能です。

• どのモデルにも超能力を付与。非 OpenAI モデルでも、ChatGPT のログイン経由で gpt-5.4-mini をサイドカーとして利用し、リアルタイムの Web 検索や画像理解機能を獲得できます。

• 画像をネイティブ生成する。 Codex のスタンドアロンツール「image_gen」は、生成に POST /v1/images/generations を、編集に POST /v1/images/edits をそれぞれ使用します。

これは、ホストされたレスポンスの image_generation ツールとは別に扱われます。

• 何が起きているかを確認する。 Web ダッシュボードでは、プロバイダー、OAuth のステータス、モデル選択状況、そして生リクエストログが表示されます。さらに、アップストリーム側から報告がある場合はキャッシュ済みトークン数やキャッシュ書き込みトークン数も確認できます。これで、なぜリクエストが失敗したのかを推測する必要はなくなります。

バックグラウンドで動作します。システムサービスとしてインストール（launchd / systemd / Task Scheduler）すれば、設定後は忘れ去っても大丈夫です。macOS や Linux ではログイン時にプロキシが起動し、Windows のデフォルトではタスクスケジューラバックエンドがログオン時にウィンドウレスで起動します。あるいは、ocx service install --native を使用して、ブート時に起動する本物の Windows サービスとしてインストールすることも可能です。

cleanly 終了し、残滓はゼロです。ocx stop（またはダッシュボードの停止ボタン）を実行すると、プロキシがシャットダウンされ、インストールされている場合はバックグラウンドサービスも停止され、Codex は元の設定に戻ります。通常の codex コマンドは、以前と同じように動作します。残った設定ファイルや孤児化したプロセスはありません。

プロバイダーとアダプター

DeepSeek、Groq、OpenRouter、Together、Fireworks、Cerebras、Mistral、Hugging Face、NVIDIA NIM、MiniMax、Qwen Cloud など多数のサービスに対応しています。利用可能なプロバイダーの全リストは、ocx init コマンドを実行するか、プロバイダードキュメント で確認できます。

Cursor への対応は段階的に導入される実験的なブリッジ機能です。これは ocx init やダッシュボードの「プロバイダー追加」画面で、Cursor の静的な公開モデルカタログをローカル設定として利用可能になります。Cursor アクセストークンを設定すると、HTTP/2 トランスポートが有効化されます。ただし、Codex の承認プロセスやサンドボックス経路を迂回する可能性があるため、ネイティブの読み書き・削除・ファイル一覧取得・検索・シェル実行・フェッチ機能はデフォルトで無効になっています。信頼できるローカル実験を行う場合のみ、unsafeAllowNativeLocalExec: true を設定してください。

MCP（Model Context Protocol）、画面録画、コンピューター操作機能は、エグゼキューターフックを通じて公開されています。ローカルエグゼキューターが設定されていない場合、opencodex はリクエストをポリシーでブロックするのではなく、型付きの「実行不可」結果を返します。

実験的な Cursor アダプターでは、OAuth 認証とライブモデルディスカバリーが有効になっています。

ocx init                       # interactive setup
ocx start [--port 10100]       # start the proxy; falls back to a free port if busy
ocx stop                       # stop + restore native Codex
ocx restore                    # restore without stopping (alias: ocx eject)
ocx uninstall                  # remove service/shim/config and restore native Codex
ocx ensure                     # start if needed + refresh Codex config/cache
ocx sync                       # refresh models + re-inject into Codex
ocx codex-shim install         # run `ocx ensure` whenever `codex` is launched
ocx status                     # is the proxy running?
ocx login <provider>          # OAuth login (xai, anthropic, kimi, cursor, ...)
ocx logout <provider>          # remove a stored login
ocx account <list|current|use> # list/switch accounts & API-key pools (masked; also refresh/auto-switch/remove/add-key)
ocx gui                        # open the web dashboard
ocx claude [args...]           # launch Claude Code wired to the proxy (model discovery on)
ocx service [install|start|stop|status|uninstall]   # install/update/start background service
ocx update [--tag preview]     # update opencodex; preview installs stay on @preview

オートスタート：サービス vs シム

opencodex には、プロキシを自動的に起動する 2 つの方法があります。

サービスは、常時動作するプロキシとして利用してください（開発環境での使用が推奨されます）。一方、シムは、バックグラウンドデーモンを起動せず、必要な時に軽量にプロキシを開始するために使います。シムの自動起動はデフォルトで有効になっており、GUI ダッシュボードから無効化することも可能です。設定済みのプロキシポートが既に使用中の場合、ocx start コマンドは自動的に別の空きローカルポートを選択し、Codex に対してそのポートを使用するよう更新します。

アンインストール

npm パッケージを削除する前に、ローカルの状態をクリーンアップしてください。

ocx uninstall
npm uninstall -g @bitkyc08/opencodex

ocx uninstall コマンドは、プロキシを停止し、インストールされたサービスを削除し、Codex シム（shim）を取り除き、ネイティブの Codex 設定・カタログ・履歴を復元した上で、~/.opencodex ディレクトリを削除します。

設定

設定ファイルは ~/.opencodex/config.json に保存されます。このファイルが解析できない場合（例えば、途中で切れているか手動で破損している JSON の場合）、opencodex はそのファイルを config.json.invalid- という名前でバックアップし、警告を表示した上でデフォルト設定に切り替えます。これにより、元のファイルが気づかれずに失われることはありません。

一般的なマルチプロバイダー構成の例を以下に示します。

{
  "port": 10100,
  "defaultProvider": "anthropic",
  "providers": {
    "anthropic": {
      "adapter": "anthropic",
      "baseUrl": "https://api.anthropic.com",
      "authMode": "oauth",
      "defaultModel": "claude-sonnet-4-6"
    },
    "ollama-cloud": {
      "adapter": "openai-chat",
      "baseUrl": "https://ollama.com/v1",
      "apiKey": "${OLLAMA_API_KEY}",
      "defaultModel": "glm-5.2"
    }
  }
}

プロバイダーエントリでは、ルーティングされたカタログメタデータにも注釈を付けることができます。プロバイダー全体の Codex 可視コンテキストの上限には contextWindow を、モデル固有の上限には modelContextWindows を使用します。

modelInputModalities は、モデル固有のカタログ入力ヒントを指定するパラメータです。例として ["text"] や ["text", "image"] などが挙げられます。

コンテキスト値は、ライブの /models メタデータをキャップします。これらは決してより小さなライブを生成することはありません。

コンテキストウィンドウ。バンドルされた GPT-5.6 Sol/Terra/Luna のフォールバックメタデータは、OpenAI API キーおよび OpenRouter カタログエントリに対して 1,050,000 トークンのコンテキストウィンドウを使用します。これはアップストリームのプレビューアクセスを迂回するものではありません。完全なフィールドリストについては、設定リファレンスを参照してください。

GLM-5.2 の 100 万トークンコンテキストを Z.AI が提供: openai-chat アダプターを通じて、glm-5.2 と glm-5.2[1m] の両方が動作します。OpenCodeX は末尾の不要な部分を自動的に除去します。

リクエスト送信前に [1m] サフィックスを付与します。

OpenAI 互換のエンドポイントでは、括弧付きの ID（Z.AI エラーコード 1211）が拒否されます。

「[1m]」という接尾辞は、Claude-Code や Anthropic エンドポイントにおける慣例です。これをネイティブとして利用するには、anthropic アダプターを Z.AI のコーディング基盤（https://api.z.ai/api/coding/paas/v4）に指向させる必要があります。

コンテキストウィンドウはモデル名ではなく、モデルカタログの modelContextWindows を通じて 1M に設定してください。

ローカルモデルも利用可能です。opencodex を、お使いのマシン上で稼働している OpenAI 互換サーバーを指すように設定すれば問題ありません。

{
  "port": 10100,
  "defaultProvider": "ollama",
  "providers": {
    "ollama": {
      "adapter": "openai-chat",
      "baseUrl": "http://localhost:11434/v1",
      "authMode": "key",
      "apiKey": "",
      "defaultModel": "llama3"
    },
    "vllm": {
      "adapter": "openai-chat",
      "baseUrl": "http://localhost:8000/v1",
      "authMode": "key",
      "apiKey": "",
      "defaultModel": "Qwen/Qwen3-32B"
    }
  }
}

WebSocket による転送はデフォルトで無効になっています。Codex に HTTP/SSE の代わりにレスポンス WebSocket パスを利用・公開させる必要がある場合のみ、"websockets": true を設定してください。

リモートアクセス

デフォルトでは、opencodex は 127.0.0.1（ループバック）にバインドされ、追加の認証は不要です。

LAN 上でプロキシを公開するために "hostname": "0.0.0.0" を設定した場合、opencodex ではベアラートークンが必要です。

管理用 API（/api/*）とデータプレーン（/v1/responses、/v1/images/generations、/v1/images/edits）の両方を保護するために：

export OPENCODEX_API_AUTH_TOKEN="your-secret-token"
ocx start

この変数を指定しないと、ループバックを超えてバインドする際にプロキシが起動しません。LAN 経由でのアクセスを可能にするバックグラウンドサービスをインストールする場合は、ocx service install を実行する前に同じ変数をエクスポートし、サービスマネージャーに渡すようにしてください。

クライアント（スクリプトやリモートマシン）は、すべてのリクエストにトークンを含める必要があります：

x-opencodex-api-key: your-secret-token

トークンの比較には定時間処理を使用し、タイミング攻撃を防いでいます。

OpenCodex は、プロキシが有効な間も Codex アプリ上で過去の OpenAI チャットや OpenCodex で作成されたプロジェクトスレッドを常に表示できるよう、Codex の履歴を自動的に再マッピングします。また、元のプロバイダーやソースのメタデータを ~/.opencodex/codex-history-backup.json に記録しています。ocx stop または ocx restore コマンドを実行すると、バックアップされた OpenAI のデータが復元されます。

OpenAI へ送信し、残りの OpenCodex ユーザースレッドも OpenAI へ転送します。これにより、config.toml からプロバイダーが削除されたにもかかわらず、ネイティブの Codex が存在しないスレッドの再開を試みるのを防ぎます。

もしバックアップ機能が実装される前に履歴を再マッピングしていた古い開発ビルドでテストを行った場合、以下の明示的な復元コマンドを実行することもできます：

ocx recover-history --legacy-openai

（原文の技術表記: syncResumeHistory）

各フィールドの詳細は、設定リファレンス をご確認ください。

ドキュメント

インストール、プロバイダー、ルーティング、サイドカー、Codex 統合、Codex アプリモデルピッカー、CLI/設定リファレンスに関する公式ドキュメントは、`docs-site/` から構築され、lidge-jun.github.io/opencodex に公開されています。

メンテナーのソース・オブ・トゥルースとなるノートは、`structure/` ディレクトリ下に保存されています。歴史的な調査資料は `docs/` に残っています。

コントリビューターの設定は `CONTRIBUTING.md` に、セキュリティ報告のガイドラインは `SECURITY.md` に記載されています。

開発環境

git clone https://github.com/lidge-jun/opencodex.git
cd opencodex
bun install
bun run dev:proxy    # start the proxy API in dev mode
bun run dev:gui      # start the dashboard dev server in another terminal
bun x tsc --noEmit   # typecheck

bun run dev は、互換性のために引き続き bun run dev:proxy のエイリアスとして機能します。ソースコードのチェックアウト環境では、プロキシ API が /healthz、/v1/responses、および POST /v1/images/generations を公開しています。

POST /v1/images/edits および /api/*、そして GET / はパッケージ化されたダッシュボードのみを提供します。

bun run build:guiを実行すると、gui/distディレクトリが生成されます。ダッシュボードの修正作業中は、フロントエンドを別プロセスで実行してください。

bun run dev:gui

コントリビューションガイドをご覧ください。

免責事項

OpenCodeX は、独立したコミュニティ主導のプロジェクトであり、OpenAI や Anthropic、その他のプロバイダーとの公式な関係や承認は受けていません。

一部の提供者（特に Anthropic の Claude など）では、サードパーティのプロキシを介して API トラフィックが流れるアカウントを停止または制限する場合があります。利用は自己責任で行ってください (UAYOR)。接続前に各プロバイダーの利用規約を確認し、プロキシ経由でのアクセスが許可されているか必ず確認してください。OpenCodeX のメンテナーは、上位プロバイダーによるアカウントへの措置について一切の責任を負いません。

ライセンス

MIT