toolin.ai logo
toolin.ai

OpenAI Codexのオープンソースモード：設定1行でローカルモデルに接続

·Toolin 編集部

CodexにOSSモードが追加。OllamaやLM Studioなどのローカルモデルサービスに対応し、オフライン実行とコスト制御を実現する

OpenAI Codexのオープンソースモード：設定1行でローカルモデルに接続
核心的な変化：「モデル紐付け」から「着脱可能なインターフェース」へ2つの接続方式方式その1：--ossショートカットスイッチ方式その2：model_providersを手動設定現実の制約：プロトコルが噛み合わないハイブリッドルーティング：コスト削減のカギとなる使い方こんな人に向いています
AI製品

OpenAI Codexは自社のGPTモデルしか使えない工具ではなくなりました。新しく追加されたオープンソースモード（OSS mode）を使えば、設定1行でOllamaやLM Studioなどのローカルモデルサービスに切り替えられ、コード生成と推論を完全オフラインで行うことすら可能です。APIコストを抑えたい、コードのプライバシーを守りたい開発者にとって、これは実質的な朗報です。

核心的な変化：「モデル紐付け」から「着脱可能なインターフェース」へ

これまでCodexはOpenAI自社のGPTモデルしか呼び出せませんでした。今回のアップデートの本質は、OpenAIがCodexに着脱可能なモデル接続レイヤーを追加したことです。モデル自体は開放しませんが、「モデルを乗り換える」能力は開放しました。

具体的には、開発者はmodel_providers設定項目を使って複数の「モデルプロバイダー」を登録できます。各プロバイダーは4種類の情報で構成されます：

  • アクセス先（base_url）：モデルサービスのURL
  • 通信プロトコル（wire_api）：現時点では主にResponses APIをサポート
  • 認証方式（env_key）：APIキーの環境変数名
  • モデルマッピング（model）：モデル名の対応関係

Codexのmodel_providers設定例

Codexのmodel_providers設定例。base_urlでモデルのアドレスを指定し、wire_apiは現状responsesプロトコルのみ認識します。

2つの接続方式

方式その1：--ossショートカットスイッチ

最も直接的な方法は、コマンドラインに--ossパラメータを付けることです。Codexが自動的にローカルモデルサービスへ接続します。デフォルトで2つの主要ツールに対応しています：

  • Ollama：ローカルで大規模モデルを動かす最も人気のあるコマンドラインツール
  • LM Studio：GUI付きのデスクトップモデル管理ツール

Codexが--ossでローカルモデルに接続する実戦の様子

左側のCodex CLIが--ossでローカルモデルを呼び出し、右側のLM Studioがローカルの1234番ポートでモデルをロードしてサービスを提供。すべてローカルかつオフラインです。

方式その2：model_providersを手動設定

DeepSeekやMistralなどのサードパーティモデルにつなぐには、設定ファイルを手動で編集する必要があります。これらの設定は「設定プロファイル」（profile）として保存でき、デバッグ時にコマンドラインから素早く切り替えられます。

Codex CLIインターフェースでのモデル切り替え

Codex CLIの起動情報に現在使用中のモデルが表示され、/modelコマンド1つで切り替えられます。

現実の制約：プロトコルが噛み合わない

コンセントは付いたが、どんな家電を刺しても動くわけではありません。現在最大の障害はプロトコルの互換性です：

  • Codexは主にOpenAIのResponses APIプロトコルをベースにしている
  • 大多数のオープンソースモデル（DeepSeekなど）はChat Completionsインターフェースを使用
  • 2つのプロトコルはリクエスト構造、ストリーミング出力、ツール呼び出しの仕組みのいずれもが一致しない

コミュニティの解法は、中間に「プロトコル変換器」（LiteLLM、claude-code-routerなど）を1枚挟むことです。基本的なフローは次のとおりです：

  1. CodexがResponses APIに従ってリクエストを送出
  2. ルーティングレイヤーがそれをChat Completions形式に変換
  3. DeepSeekなどのオープンソースモデルへ転送
  4. 返ってきた結果を再度Codexが認識できる形式に変換

現時点でこれらのプロトコル変換ソリューションはコミュニティの自主的な取り組みであり、OpenAI公式はまだ推奨していません。利用時は安定性を自分で検証する必要があります。

ハイブリッドルーティング：コスト削減のカギとなる使い方

さらに価値が高いのがハイブリッドルーティングです。GPTにタスクの計画（要件の分解、アーキテクチャ設計）を担当させ、オープンソースモデルに実行（コードを書く、ファイルを一括変更）を担当させます。この組み合わせにより、同じタスクのコストを半分以上削減できる可能性があり、しかもコードは一切ローカルから出ません。

こんな人に向いています

  • APIコストを削減したい個人開発者
  • コードのプライバシーが理由でクラウドにアップロードしたくない企業チーム
  • オフライン環境でAIコーディングを使いたいユーザー
  • 異なるモデルの強みを掛け合わせたい技術探求者

公式ドキュメントは公開されています。アドレス：https://developers.openai.com/codex/config-advanced#oss-mode-local-providers

すべての記事