Codex CLI でサードパーティ API を使う設定ガイド

~/.codex/config.toml の二か所です。トップレベルの model_provider を自分のプロバイダー id に向け、model_providers の下にその id のテーブルを作って base_url、wire_api、env_key を書きます。公式の設定リファレンスでは、wire_api の値は responses だけで、env_key は API キーを渡す環境変数の名前です。requires_openai_auth はプロバイダーが OpenAI 認証を使うことを示し、既定は false、QCode のドキュメントでは true にしています。

QCode なら https://api.qcode.cc/openai を書き、/v1 も末尾のスラッシュも付けません。QCode のドキュメントは Codex の base_url をこの値に限っており、Codex は /openai/v1/responses のパスを使います。エンドポイントのドキュメントは一般論として、末尾にスラッシュを付けると二重スラッシュのパスになり 404 になると注意しています。404 はたいていパスの接頭辞の誤りです。アジアの予備は https://asia.qcode.cc/openai、北米・欧州向けには us.qcode.cc があります。

三点を確かめます。キーが cr_ で始まっているか、auth.json のキーに余分な空白や改行がないか。環境変数を使う場合は、変数名が config.toml の env_key と同じか（QCode のドキュメントでは CRS_OAI_KEY）、今のシェルで本当に設定されているか。最後に QCode のコンソールでキーの状態を確認します。auth.json と環境変数が両方あると auth.json が優先されるので、環境変数を使うなら auth.json の OPENAI_API_KEY を null にしてください。

一番多いのはトップレベルのキーの位置です。公式ドキュメントは model と model_provider を最初の TOML テーブルより前に置くよう求めており、テーブル見出しの後のキーはそのテーブルに属します。次に、プロジェクトの .codex/config.toml では model_provider と model_providers が無視されるため、プロバイダーはユーザー単位の ~/.codex/config.toml に書く必要があり、テーブル名を openai にすることもできません。また QCode のドキュメントによると、Codex 0.134.0 以降は config.toml 内の古い profiles テーブルの書き方は廃止され、残したまま --profile を使うとエラーで止まります。起動後は /status で有効な model と provider を確認できます。

QCode では使えません。QCode のドキュメントによると、Codex は OpenAI Responses プロトコルを使い、このプロトコルが扱うのは GPT 系だけで、Claude と GLM、Kimi、DeepSeek、Qwen は対象外です。Claude モデルは Anthropic プロトコルでしか使えません。ドキュメントの例では、Claude モデルを /openai/v1/chat/completions に送ると model_not_available_on_endpoint が返ります。この検査は認証より前に行われるので、キーではなくプロトコルの選び方が誤っているという意味です。Claude を使うなら、同じキーで Claude Code を使ってください。

2026-10-07 時点で、QCode のドキュメントの既定のおすすめは gpt-6-sol（1.05M コンテキスト、汎用・複雑なタスク向け）です。gpt-6.1-sol は 2026-09-29 の GPT-6 Sol 更新版で、同じく 1.05M コンテキスト、ドキュメントではキャッシュ読み取りがより安いとされ、公式 Codex でも 0.159.1 から同梱カタログの既定モデルです。gpt-5.6-sol は GPT-5.6 フラッグシップ系列、gpt-5.6-terra はコード向けに最適化、gpt-6-astra は最上位で価格も高め、gpt-6-luna は公式には集中的で大量の処理向けと位置づけられ、単価は /models で確認してください。いずれも QCode で呼び出せ、model を変えるか codex --model で切り替えます。