ホーム / ガイド / 無料モデルでCodex CLIを使う

無料モデルで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/codex

http://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_providermodel_providersからプロバイダーを選択します。既定値はopenaiです。
env_keyプロバイダーのAPIキーを保持する環境変数
requires_openai_authfalseは、Codexが OpenAI へのログインを求めないことを意味します
model_context_window有効なモデルのコンテキストのトークン数。このコマンドは、ライブのカタログから値を取得します。
model_auto_compact_token_limit自動の履歴圧縮を開始するトークン数。このコマンドは、コンテキストウィンドウの90%を設定します。
tool_output_token_limitCodexが履歴に保持する、各ツール出力のトークン予算

キーをファイルやシェルのプロファイルに残さないようにするには、ランチャーを使ってください。キーを環境変数にだけ入れて、Codexを起動します:

永続化しないランチャー

npx freellmapi launch-codex

リクエストがゲートウェイに届いていることを確認するには、npx freellmapi doctorを実行してください。このコマンドは、ルーティングされたAuthorizationヘッダー、カタログ、ライブのプローブを確認します。その後、ダッシュボードのリクエストログに、各Codexの呼び出しが表示されます。レスポンスヘッダーX-Routed-Viaには、応答したプロバイダーとモデルが示されます。リクエストがフェイルオーバーした場合は、X-Fallback-Trailに、失敗した各ホップと理由が示されます。

プロファイル: Codexのドキュメントには、Codex 0.134.0以降は、[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はエージェントです。シェルコマンドを実行し、ツール呼び出しによってファイルを編集します。ツール呼び出しに対応し、大きなコンテキストウィンドウを持つモデルを使ってください。表には、現時点で両方の条件を満たす無料モデルを示しています。

Codex CLI向けの無料モデル: ツール呼び出しと128K以上のコンテキスト
モデル無料で利用可能コンテキスト無料枠の上限(最良の条件)ツール画像入力
GLM 5.3UnoRouter1M1 リクエスト/分
1 req/min per model
はいいいえ
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 リクエスト/分
40 RPM
はいはい
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaはいはい
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceはいいいえ
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditはいはい
Gemini 3.7 FlashGoogle AI Studio1M10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditはいはい
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 リクエスト/分
50 リクエスト/日
50 req/day account-wide (1,000 after a $10 purchase)
はいはい
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 リクエスト/分
50 リクエスト/日
Shared rate limit
はいいいえ
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 リクエスト/分
250 リクエスト/日
70,000 トークン/分
~6M
はいはい
Gemini 3.6 FlashGoogle AI Studio1M10 リクエスト/分
20 リクエスト/日
250,000 トークン/分
~3M
はいはい
Qwen 3.8 27BCloudflare Workers AI262KShared 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")すべてのキーが制限に達していますより多くのプロバイダーのキーを追加するか、クールダウンの終了を待ってください
これらすべてを 1 つのキーで利用できます。 FreeLLMAPI は、オープンソースのセルフホスト型ルーターです。これらの無料枠すべてを 1 つの OpenAI 互換エンドポイントの背後にまとめ、レート制限に達した場合は自動的に別のプロバイダーへ切り替えます。 カタログを見る または 公開.

よくある質問

Codex CLIを無料で使えますか?

はい。Codex CLIはオープンソースです。config.tomlで、FreeLLMAPIをカスタムのモデルプロバイダーとして追加してください。ゲートウェイは、各リクエストを無料のプロバイダーティアに送るため、推論のコストは$0です。

Codex CLIは、他のプロバイダーのモデルを使えますか?

はい。base_url、env_key、wire_api = "responses"を含む[model_providers.]ブロックを追加し、次にmodel_providerを設定してください。プロバイダーは、Responses APIを提供する必要があります。

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は、ゲートウェイのモデルの実際のメタデータを読み取ります。

関連ガイド

出典

すべてのガイド · 無料モデルをすべて見る