opencodex

• 任意 LLM を Codex で使う — Anthropic / Google / xAI / Ollama / OpenRouter など。ストリーミング・ツール呼び出し・推論トークン・画像を双方向で橋渡し
• Claude Code も同じデーモン — /v1/messages と count_tokens。ocx claude で起動し、ゲートウェイ発見のモデル別名がネイティブ /model に出る
• ChatGPT アカウントプール — 既存スレッドはアフィニティ維持。新規セッションは 5h / weekly / 30d の使用量から健全な低使用アカウントへ自動割当可能
• 履歴安全な注入 — ローカルでは Codex 組み込み openai プロバイダの openai_base_url を自分向けに向ける。停止時はネイティブ設定へ復元
• ダッシュボード — ocx gui で localhost:10100。プロバイダ追加・OAuth・リクエストログ・Claude 設定

公開ユーザ向け手順は上流の docs-site、メンテナ向け形状の正は structure/。 プロキシはルーティングとアダプタブリッジを行い、上流プロバイダへ中継する。

Codex CLI / TUI / App / SDK
  → http://127.0.0.1:<port>/v1/responses
  → opencodex routing + adapter bridge
  → upstream provider

Claude Code (ocx claude)
  → /v1/messages (+ count_tokens)
  → 同じデーモン

明示ルーティングは provider/model。プレフィックス省略時は defaultProvider、 またはモデル名パターン（例: claude-* → Anthropic、gpt-* → OpenAI）で解決する。 内側に / を含むモデル ID（OpenRouter 等）は Codex 向けに - へエイリアスし、プロキシがネイティブ ID へ戻す。

codex -m "anthropic/claude-opus-4-8" "Explain this stack trace"
codex -m "google/gemini-3-pro" "Write unit tests for auth.ts"
codex -m "ollama-cloud/glm-5.2" "Write a SQL migration"
codex -m "ollama/llama3" "Refactor this function"

推論努力と ultra

Codex 側の low / medium / high / xhigh / max / ultra を、 モデルが広告する範囲で保持する。ultra は最大推論＋クライアント側マルチエージェント委譲の意味で、 プロバイダ到達前に max へ変換される。ルーティング済みモデルが ultra を出すのは reasoningEfforts でオプトインしたときだけ。

ダッシュボードまたは設定で最大 5 つの featured モデルを Codex のサブエージェントピッカーに出せる。 v2 マルチエージェント面では injectionModel / injectionEffort と featured 名簿、 fork_turns 規則をコンパクトに注入する。文言は injectionPrompt で {{model}} / {{effort}} / {{roster}} プレースホルダ付き上書きが可能。

• Pool — アフィニティ・クォータ・クールダウン・フェイルオーバー。モード未設定の新規は Pool
• Direct — プール状態を読まず、呼び出し元 / main ログインの bearer のみ
• レガシー公開 ID chatgpt は移行後に非表示。バックアップは ~/.opencodex/config.json.pre-openai-tiers-v2.bak
• 現行は openaiProviderTierVersion: 2。API 面の Pro 仮想 ID（例: gpt-5.6-sol-pro）は wire 上で base + reasoning.mode: "pro"

追加はダッシュボードの Add Provider、ocx init、または ~/.opencodex/config.json。 モデルはプロバイダの /v1/models から自動発見されることが多い。

{
  "port": 10100,
  "defaultProvider": "anthropic",
  "providers": {
    "anthropic": {
      "adapter": "anthropic",
      "baseUrl": "https://api.anthropic.com",
      "authMode": "oauth",
      "defaultModel": "claude-sonnet-4-6"
    },
    "ollama": {
      "adapter": "openai-chat",
      "baseUrl": "http://localhost:11434/v1",
      "authMode": "key",
      "apiKey": "",
      "defaultModel": "llama3"
    }
  }
}

JSON が壊れている場合は config.json.invalid-<timestamp> に退避してデフォルトへフォールバックする（元ファイルは黙って上書きしない）。 WebSocket は既定 false。"websockets": true のときだけ Responses WS を広告する。

アンインストール前に ocx uninstall してから npm uninstall -g @bitkyc08/opencodex。 ~/.opencodex も削除対象に含まれる。

• GitHub: lidge-jun/opencodex — ソースリポジトリ
• 公式ドキュメント — インストール・設定リファレンス
• npm: @bitkyc08/opencodex
• Configuration reference — フィールド一覧
• CONTRIBUTING.md — 開発セットアップ
• SECURITY.md — 脆弱性報告

出典: lidge-jun/opencodex の README.md / structure/00_overview.md / 01_runtime.md / 08_openai-provider-tiers.md（本ページ作成時点 v2.7.30）