無料モデルでCodex CLIを使う
Codex CLIは、ターミナル向けのOpenAIのオープンソースのコーディングエージェントです。独自のモデルプロバイダーを使えます。このガイドでは、FreeLLMAPIを通じて、Codex CLIを他のプロバイダーの無料モデルに接続します。Codexは Responses API を使い、FreeLLMAPIは/v1/responsesでこれを提供します。
コード、モデル名、ライブのカタログラベルは英語で表示します。
仕組み
Codex CLIは、OpenAI Responses形式でリクエストを送信します。Codexのドキュメントには、responsesが唯一サポートされるwire_apiの値であると記載されています。そのため、Codex用のプロバイダーは/v1/responsesを提供する必要があります。FreeLLMAPIは、このエンドポイントを提供します。各リクエストを変換し、無料モデルに送信します。例えば、Gemini、GPT-OSS、Qwen、GLMです。
- 得られるもの: 無料モデルで動く、Codex CLIのエージェント、そのツール、編集のループ。
- 得られないもの: ChatGPTプランを通じたOpenAI独自のGPTモデル。リクエストは、FreeLLMAPIのプール内の無料プロバイダーに送られます。
- 制限:
/v1/responsesでの画像入力は、まだサポートされていません。テキストのプロンプトを使ってください。
手順1: FreeLLMAPIとCodex CLIをインストールする
両方をインストールする
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexhttp://localhost:3001を開いてください。Keysページで、少なくとも2つの無料プロバイダーのキーを追加してください。同じページから統合キーをコピーしてください。macOSでは、brew install --cask codexでCodexをインストールすることもできます。
手順2: Codex CLIを接続する
セットアップコマンドは、~/.codex/config.tomlにプロバイダーを追加します。最初にバックアップを作成し、新しいブロックをマージするため、他の設定は残ります。
1つのコマンド
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexこのコマンドは、ライブのカタログの値を使って、次の設定を書き込みます。キーはファイルに含まれません。Codexは、FREELLMAPI_API_KEY環境変数からキーを読み取ります。そのため、Codexを実行する各シェルで、この変数をエクスポートしてください。
~/.codex/config.toml
model = "auto"
model_provider = "freellmapi"
model_context_window = 128000
model_auto_compact_token_limit = 115200
tool_output_token_limit = 20000
[model_providers.freellmapi]
name = "FreeLLMAPI"
base_url = "http://localhost:3001/v1"
wire_api = "responses"
env_key = "FREELLMAPI_API_KEY"
requires_openai_auth = false| キー | 役割 |
|---|---|
model_provider | model_providersからプロバイダーを選択します。既定値はopenaiです。 |
env_key | プロバイダーのAPIキーを保持する環境変数 |
requires_openai_auth | falseは、Codexが OpenAI へのログインを求めないことを意味します |
model_context_window | 有効なモデルのコンテキストのトークン数。このコマンドは、ライブのカタログから値を取得します。 |
model_auto_compact_token_limit | 自動の履歴圧縮を開始するトークン数。このコマンドは、コンテキストウィンドウの90%を設定します。 |
tool_output_token_limit | Codexが履歴に保持する、各ツール出力のトークン予算 |
キーをファイルやシェルのプロファイルに残さないようにするには、ランチャーを使ってください。キーを環境変数にだけ入れて、Codexを起動します:
永続化しないランチャー
npx freellmapi launch-codexリクエストがゲートウェイに届いていることを確認するには、npx freellmapi doctorを実行してください。このコマンドは、ルーティングされたAuthorizationヘッダー、カタログ、ライブのプローブを確認します。その後、ダッシュボードのリクエストログに、各Codexの呼び出しが表示されます。レスポンスヘッダーX-Routed-Viaには、応答したプロバイダーとモデルが示されます。リクエストがフェイルオーバーした場合は、X-Fallback-Trailに、失敗した各ホップと理由が示されます。
[profiles.NAME]テーブルをconfig.tomlから読み取らなくなったと記載されています。プロファイルは、現在は別のファイルになっています。例えば、~/.codex/NAME.config.tomlです。最新のCodexのバージョンでは、上記の既定の設定を使ってください。モデルのメタデータの警告を消す
Codexは、実行するたびに"Model metadata for auto not found"を表示します。Codexは、ゲートウェイのモデルIDを知りません。コンテキストウィンドウや画像のサポートなど、実際のメタデータを与えるには、プロバイダーにモデルカタログのURLを追加してください:
[model_providers.freellmapi]に追加する
model_catalog_url = "http://localhost:3001/v1/codex/models"カタログは、Codex独自の既定のシステムプロンプトとツールの設定を保持します。変わるのは、警告とコンテキストウィンドウだけです。
Codex CLI向けのモデルを選ぶ
Codexはエージェントです。シェルコマンドを実行し、ツール呼び出しによってファイルを編集します。ツール呼び出しに対応し、大きなコンテキストウィンドウを持つモデルを使ってください。表には、現時点で両方の条件を満たす無料モデルを示しています。
| モデル | 無料で利用可能 | コンテキスト | 無料枠の上限(最良の条件) | ツール | 画像入力 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 リクエスト/分 1 req/min per model | はい | いいえ |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 リクエスト/分 40 RPM | はい | はい |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | はい | はい |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | はい | いいえ |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | はい | はい |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | はい | はい |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 リクエスト/分 50 リクエスト/日 50 req/day account-wide (1,000 after a $10 purchase) | はい | はい |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 リクエスト/分 50 リクエスト/日 Shared rate limit | はい | いいえ |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 リクエスト/分 250 リクエスト/日 70,000 トークン/分 ~6M | はい | はい |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 リクエスト/分 20 リクエスト/日 250,000 トークン/分 ~3M | はい | はい |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | はい | はい |
一致する無料モデル 109 件のうち 12 件を表示しています。 すべてのモデルを見る.
FreeLLMAPI カタログのライブデータ(バージョン 2026.11.19、確認日 2026-11-19)。無料枠の上限は頻繁に変わります。カタログは毎日確認されます。
model = "auto"のままにすると、ルーターが各リクエストのモデルを選択します。1つのモデルに固定するには、npx freellmapi setup-codex --url http://localhost:3001 --model <id>を実行してください。model = "auto:smart"またはmodel = "auto:fast"を、config.tomlに設定することもできます。
無料ティアには、毎分と1日ごとの制限があります。プロバイダーが429エラーを返すと、FreeLLMAPIは、そのリクエストをチェーン内の次のモデルに送ります。長いCodexのセッションには、4つ以上のプロバイダーのキーを追加してください。Codexは、履歴がmodel_auto_compact_token_limitに達すると、履歴を圧縮します。値を小さくすると、リクエストが小さくなります。これは、毎分のトークン数の制限が低い無料ティアで役立ちます。
トラブルシューティング
| 問題 | 原因 | 対処 |
|---|---|---|
| Codexが、ChatGPTでのサインインを求めます | model_providerが設定されていないため、Codexはopenaiを使います | model_provider = "freellmapi"を設定してください |
401 "Invalid API key" | このシェルでFREELLMAPI_API_KEYが設定されていません | 変数をエクスポートするか、npx freellmapi launch-codexを使ってください |
"Model metadata for auto not found" | Codexは、ゲートウェイのモデルIDを知りません | model_catalog_urlを追加してください |
wire_api = "chat"でのエラー | Codexは、Responses APIだけをサポートします | wire_api = "responses"を設定してください |
| プロファイルの設定が無視されます | Codex 0.134.0以降は、[profiles.NAME]テーブルを無視します | 既定のプロバイダーの設定、または別のプロファイルファイルを使ってください |
| N回の試行後の「すべてのモデルがレート制限されました」("All models rate-limited after N attempts") | すべてのキーが制限に達しています | より多くのプロバイダーのキーを追加するか、クールダウンの終了を待ってください |
よくある質問
Codex CLIを無料で使えますか?
はい。Codex CLIはオープンソースです。config.tomlで、FreeLLMAPIをカスタムのモデルプロバイダーとして追加してください。ゲートウェイは、各リクエストを無料のプロバイダーティアに送るため、推論のコストは$0です。
Codex CLIは、他のプロバイダーのモデルを使えますか?
はい。base_url、env_key、wire_api = "responses"を含む[model_providers.
Codex CLIは、Chat Completions APIをサポートしますか?
いいえ。Codexの設定リファレンスには、responsesが唯一サポートされるwire_apiの値であると記載されています。FreeLLMAPIは/v1/responsesを提供するため、Codexのプロバイダーとして動作します。
Codex CLIに最適な無料モデルはどれですか?
ツール呼び出しに対応し、少なくとも128Kのコンテキストを持つモデルを使ってください。このページの表には、現時点で両方の条件を満たす、最も強力な無料モデルを示しています。
「Model metadata for auto not found」を解決するには、どうすればよいですか?
~/.codex/config.tomlのプロバイダーブロックに、model_catalog_url = "http://localhost:3001/v1/codex/models"を追加してください。その後、Codexは、ゲートウェイのモデルの実際のメタデータを読み取ります。
関連ガイド
出典
- Codex docs: config reference (確認日 20 November 2026)
- Codex docs: advanced config and profiles (確認日 20 November 2026)
- Codex CLI repository (確認日 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (確認日 20 November 2026)
- FreeLLMAPI CLI generators (確認日 20 November 2026)