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

·Toolin 編集部

OpenAI CodexにOSSモードが追加され、model_providers設定でOllamaやLM Studioなどのローカルモデルサービスに接続可能になった。モデルを切り替えてコストを削減できる。

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

OpenAIのコーディングエージェントCodexは、これまで自社のGPTモデルしか認めなかったが、いま「モデル接続層」を開放した。model_providers という設定により、CodexをOllamaやLM Studioなどのローカルモデルサービスに、さらにはDeepSeekなどのサードパーティAPIに接続できる。つまり、必要に応じてモデルを切り替え、トークンを節約し、コーディングエージェントを完全オフラインで動かすことすら可能だ。

Codexオープンソースモードとは

本質的に見れば、OpenAIが今回開放したのはモデルそのものではなく、Codexに「着脱可能なモデルインターフェース層」を追加したことだ。設定ファイルに複数の「モデルプロバイダー」を登録すると、Codexは起動時に設定に基づいて対応するプロバイダーを選び、リクエストを異なるモデルサービスへルーティングする。

CodexのOSSモード設定。コマンドラインに--ossを加えるだけでローカルでオープンソースモデルが動く

中核機能

--oss スイッチ

最も直接的な使い方:コマンドラインに --oss パラメータを1つ加えると、Codexはローカルのオープンソースモデルサービスに直接接続する。デフォルトで2つに対応している:

  • Ollama:ローカルで大規模モデルを動かす最も人気のあるツール
  • LM Studio:GUI付きのデスクトップ向け代替

model_providers設定

より柔軟な方法は、設定ファイルでの「モデルプロバイダー」登録だ。各プロバイダーは4種類の情報を含む:

  • base_url:アクセス先のアドレス
  • wire_api:通信プロトコル(現在は responses という1つの値のみ受け付ける)
  • env_key:認証方式
  • model:モデルの対応関係

model_providers設定の例。base_urlがモデルのアドレスを指し、wire_apiフィールドはresponsesのみ受け付ける

Mistral、企業自前のプロキシ、サードパーティの中継サービスも、この方法で接続できる。また、設定を「構成プロファイル」として保存しておけば、デバッグ時にコマンドラインから名前を指定して切り替えられる。

実戦:--ossでローカルモデルに接続

ローカルのモデルサービスとネットワーク権限の設定を通じて、Codexに自前のマシンでコード生成と推論を完結させ、オフライン実行とローカル処理を実現できる。

実際の体験

強み

  • 1社にロックインされない:必要に応じてモデルを切り替えられ、プライバシーとコストは自分で決める
  • 節約:GPTに計画(タスクの分解、アーキテクチャ設計)を担わせ、オープンソースモデルに実行(コードを書く、ファイルを一括変更)を担わせれば、同じタスクのコストは大きく削減できる可能性がある
  • ローカルオフライン:コードの1行も自分のPCの外に出ない。私的なプロジェクトをクラウドに上げたくない個人開発者に向く

制限

コンセントが付いたからといって、どんな家電を挿しても動くわけではない。接続するモデルには通常、**対話補完(Chat Completions)**のインターフェース形式との互換性が必要で、**ツール呼び出し(function calling)**のようなより複雑な能力が完全に動くかどうかについて、公式は保証しない。1つずつ試すしかない。

DeepSeekへの接続方法

DeepSeekは、多くの中国語圏開発者に最も馴染みのあるオープンソースモデルの1つだ。だがDeepSeekのアドレスをそのままCodexに入れても順調には動かない——新版Codexは主にOpenAIの Responses API に基づいており、DeepSeekをはじめ大半のオープンソースモデルのインターフェースは、今も Chat Completions が主流だ。

CC Switchコミュニティチュートリアル:Codexでローカルルーターを使ってDeepSeekを動かす

コミュニティの解法は、間にローカルの「ルーティング層」ないし「プロトコル変換器」を1枚挟むことで、基本的な流れは次のとおり:

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

同様の能力を提供するのはCC Switchだけではない。LiteLLM、claude-code-router、そして開発者自作の各種プロキシサービスも、本質的には同じ問題を解いている。

応用シーン

  • 個人開発者:ローカルのオープンソースモデルでCodexを動かし、節約とプライバシー保護を両立
  • ハイブリッドルーティングの遊び方:GPTが計画 + オープンソースモデルが実行で、コストを半減
  • 企業内配備:model_providersで企業自前のプロキシに接続し、モデルアクセスを一元管理

💡 ヒント:OpenAIが今回開放したのは「モデル接続層」であって、モデルそのものではない。どのモデルをつなぐ場合でも、OpenAIが定義するリクエストとレスポンスの構造に揃える必要がある。このインターフェース層のプロトコルは、AIコーディングツールの新たな競争焦点になりつつある。

関連記事

Codex Computer Use が Windows に登場:実践ガイド
AIチュートリアル

Codex Computer Use が Windows に登場:実践ガイド

OpenAI Codex が Windows PC の操作を正式サポート。完全な有効化手順、制限事項の説明、スマホからのリモートコントロール方法を紹介

Toolin 編集部
Gamma-World:オープンソースのマルチエージェント世界モデル
AI製品

Gamma-World:オープンソースのマルチエージェント世界モデル

NVIDIA が清華大学と共同でマルチエージェント世界モデルをオープンソース化。2人での訓練から4人へ直接汎化し、ゼロショットでの多人数シーンのリアルタイム推演をサポート

Toolin 編集部
Step 3.7 Flash を Claude Code に接続:実測ガイド
AIチュートリアル

Step 3.7 Flash を Claude Code に接続:実測ガイド

StepFun のオープンソース Flash モデルを Claude Code に接続する実測レポート。複雑な Agent ワークフローで、中国製モデルがクローズドソース基盤の代わりを果たせるかを検証

Toolin 編集部
Syll:清華大学がオープンソース化したマルチモーダル全インタラクションエージェントフレームワーク
AI製品

Syll:清華大学がオープンソース化したマルチモーダル全インタラクションエージェントフレームワーク

GUI、CLI、MCP の3つの操作方式をサポートし、デモンストレーションによる教示で再利用可能なスキルを自動生成。ローカルデプロイでデータプライバシーを保護

Toolin 編集部
SkillOpt:ニューラルネットワークのようにAgentスキル文書を訓練する
AI製品

SkillOpt:ニューラルネットワークのようにAgentスキル文書を訓練する

Microsoftがオープンソース化したテキスト空間最適化フレームワーク。Agentのスキル文書を自動進化させ、52項目の評価すべてで最高性能を達成。

Toolin 編集部
ToolCUA:AgentがGUIとツールの間で正しく経路を選べるようになる
AI製品

ToolCUA:AgentがGUIとツールの間で正しく経路を選べるようになる

復旦大学×通義がオープンソース化したCUA訓練パラダイム。8BモデルがOSWorld-MCPで46.85%の精度を達成し、Claude-4-Sonnetを上回りました。コードとモデル重みは公開済みです。

Toolin 編集部