Codex CLI でサードパーティ API を使う設定ガイド
2026年11月20日時点で、Codex CLI rust-v0.171.0(2026-11-20 公開)は GPT-6.2 Sol と Astra をモデルカタログに追加し、Sol をカタログの既定の選択肢としています。カスタムプロバイダーでモデルを固定するには、~/.codex/config.toml に model = "gpt-6.2-sol" と明示的に記述するか、単発実行なら codex --model gpt-6.2-sol を使用します。Codex リレーとは、Codex CLI を OpenAI Responses プロトコルに対応するエンドポイントに向け、cr_ で始まるキーでトークン単位の料金を支払うことを指し、ChatGPT サブスクリプションとは別のシステムです。2026-11-04 時点で、QCode のドキュメントは Codex の base_url を https://api.qcode.cc/openai に設定しています。2026-10-07 時点で、Codex CLI をサードパーティまたはカスタムエンドポイントに接続するには、~/.codex/config.toml の model_providers 配下に独自のテーブルを追加し、base_url、wire_api、env_key(キーを保持する環境変数の名前)を記述して、最上位の model_provider をそこに向けます。公式の設定リファレンスによると、wire_api でサポートされる値は responses のみです。QCode の場合、base_url は https://api.qcode.cc/openai です。QCode のドキュメントでは、そのテーブルに requires_openai_auth = true を設定し、キーを ~/.codex/auth.json に置きます。代わりに環境変数でキーを渡す場合は、その行を env_key に置き換えます。どちらか一方を使用してください。このページでは、各キー、よくあるエラー、選ぶべきモデルについて順に説明します。
更新日 2026-11-20
このツールを QCode エンドポイントに接続。Claude・GPT・中国系モデルを 1 キーで。
- トークン単位の課金・最新単価は /models
- カード(Visa / Mastercard)・Apple Pay・Google Pay・暗号資産で支払い可能
- チャージ後すぐにセルフサービスで開通
まず押さえる四つの値
wire_api の唯一の値
公式の設定リファレンスは、responses が唯一サポートされる値で、省略時の既定値でもあると明記しています。QCode のドキュメントも wire_api を responses とし、/openai/v1/responses のパスに対応します。
キーを入れる環境変数の名前
env_key に書くのは環境変数の名前で、キーそのものではありません。公式の説明は「プロバイダーの API キーを渡す環境変数」です。QCode のキーは cr_ で始まります。 変数名は自由に決められます。QCode ドキュメントの例では QCODE_API_KEY を使っています。
QCode の base_url の末尾
QCode のドキュメントは、Codex の base_url は https://api.qcode.cc/openai でなければならないとしています。Codex は Responses プロトコルを使うため、リクエストは /openai/v1/responses に届きます。
公式リリースで最新の CLI
2026-11-04 時点で、OpenAI 公式 GitHub のリリースで最新なのは 2026-10-29 公開の Codex CLI 0.166.0 です。その前は 2026-10-05 の 0.160.1 が最新でした。2026-09-29 の 0.159.1 以降、同梱のモデルカタログは GPT-6.1 Sol を既定モデルにしています。
Codex がエンドポイントを決める仕組み
2026-10-07 時点で、Codex CLI はリクエストの送り先を config.toml の model_provider で決めます。値は model_providers の下にあるテーブルの id で、未指定なら openai です。公式ドキュメントによると、モデルプロバイダーは Codex がモデルにどう接続するか(ベース URL、wire API、認証、任意の HTTP ヘッダー)を定義するもので、カスタムプロバイダーは予約済みの組み込み id である openai、ollama、lmstudio を使えません。
ユーザー単位の設定は ~/.codex/config.toml(Windows では %USERPROFILE%\.codex\)にあり、プロジェクト内の .codex/config.toml はプロジェクトを信頼した後にだけ読み込まれ、そこに書いた model_provider と model_providers は無視されます。
QCode のドキュメントではプロバイダー名を qcode とし、OpenAI Responses プロトコルを使います。同じキーが api.qcode.cc、us.qcode.cc、asia.qcode.cc の三つのドメインで使えます。
プロバイダーに関わる最近のリリース
2026年11月20日時点:Codex CLI rust-v0.171.0 は 2026-11-20 にリリースされ、GPT-6.2 Sol と Astra をモデルカタログに追加し、Sol をカタログの既定の選択肢としました。OpenAI 公式 API では、gpt-6.2-sol の Standard 料金は入力 $2.00、出力 $10.00、キャッシュ入力 $0.10 で、gpt-6.1-sol の Standard 料金と同じです。
以前のリリース変更は次のとおりです。公式変更ログによると、2026-09-22 から GPT-6 Sol と GPT-6 Luna が Codex に展開され始め、CLI で /model または codex --model gpt-6-sol を指定して選択できました。2026-09-29 の Codex CLI 0.159.1 は、同梱カタログの既定モデルを GPT-6.1 Sol にしました。
2026-10-01 の 0.160.0 は、env_key が API キーの環境変数をどのように特定するかを明確化し、明示的なプロバイダーのモデルカタログにサポート対象外の同梱モデルが含まれないようにし、ターミナル UI がサーバーのプロバイダー設定を保持するようにしました。2026-10-05 に 0.160.1 が続き、その後 2026-10-23 に 0.164.0、2026-10-29 に 0.166.0 が続きました。
2026-11-04 時点で、公式 GitHub releases の最新は 0.166.0 です。別途、2026-09-14 の公式通知は、GPT-5.5 が ChatGPT、ChatGPT Work、Codex から退役する日を 2026-10-14 とし(この退役は OpenAI API には適用されません)、gpt-5.5 をまだ選択している保存済みのモデル設定、カスタムエージェント、スクリプトを更新するよう求めています。ローカルのバージョンは codex --version で確認してください。
タイムライン
GPT-6 Sol と GPT-6 Luna の Codex への提供が始まる。公式は複雑なコーディングとエージェント型ワークフローには Sol を勧め、CLI では /model か codex --model gpt-6-sol で切り替えます。
GPT-6.1 Sol が Codex に登場。同日の Codex CLI 0.159.1 で同梱カタログの既定モデルになりました。QCode のドキュメントは gpt-6.1-sol を GPT-6 Sol の更新版として載せています。
Codex CLI 0.160.1 がリリース。2026-10-07 の確認時点で公式変更履歴にある最新の CLI です。その前の 2026-10-01 の 0.160.0 で env_key の説明が補われています。その後 2026-10-23 に 0.164.0、2026-10-29 に 0.166.0 が出ており、2026-11-04 時点の最新は 0.166.0 です。
確認済み vs 未確認
確認済み(公式ページと QCode ドキュメントで一字一句照合可)
公式の Codex ドキュメント:model_provider の既定は openai。openai、ollama、lmstudio は予約済みの id で上書きできない。wire_api は responses だけがサポートされ、省略時も responses。env_key は API キーを渡す環境変数。requires_openai_auth の既定は false。
experimental_bearer_token にトークンを直接書くのは非推奨。model と model_provider は最初の TOML テーブルより前に置く。公式変更履歴:0.159.1 から GPT-6.1 Sol が同梱カタログの既定モデル、0.160.1 は 2026-10-05 リリース。QCode ドキュメント:base_url は https://api.qcode.cc/openai、wire_api は responses、requires_openai_auth は true、キーは cr_ で始まり ~/.codex/auth.json の OPENAI_API_KEY に書く。
環境変数方式では requires_openai_auth = true を env_key = "QCODE_API_KEY" に置き換え、どちらか一方だけにする。
未確認とドキュメントに記載のない点
次の四点は確認できていないため、これを前提にしないでください。
- 12026-10-07 に取得した公式の設定リファレンスには preferred_auth_method の項目が見当たらず、QCode の現行の設定例にもこの行はもうありません。古い設定に残っている場合、現行バージョンでどう働くかは未確認です。
- 2公式リファレンスにはコマンドでトークンを取得する auth テーブル、http_headers、supports_websockets などもありますが、QCode のドキュメントには記載がなく、本ページは QCode との組み合わせで動くとは約束しません。
- 30.159.1 より前の Codex が
gpt-6.1-solという名前を認識するかは未確認で、公式のゲートウェイ文書は、カスタムのモデルカタログを使わない場合、使う Codex のバージョンがそのモデルを認識するか先に確かめるよう述べるだけです。 - 4GPT-6.1 Sol は Astra に近い性能を Astra より低いコストで出すと公式は述べていますが、これは OpenAI 自身の申告で、第三者の計測はありません。
二つの選択の決め方
カスタムプロバイダー vs openai_base_url
公式は二つの道を示しています。組み込みの openai プロバイダーをプロキシやルーターに向けたいだけなら、新しいプロバイダーを定義せず openai_base_url を設定します。独自のキー変数やプロトコル設定が必要なら、model_providers の下にテーブルを追加します。組み込み id は上書きできないので、openai という名前のテーブルは作れません。QCode のドキュメントは後者(プロバイダー名 qcode)を使い、openai_base_url での接続は記載していないため、本ページも QCode にはそれを勧めません。
auth.json vs 環境変数
QCode のドキュメントは、どちらか一方だけにするよう書いています。provider テーブルに requires_openai_auth = true を書いて ~/.codex/auth.json に OPENAI_API_KEY を書く方法(ドキュメントの基本の書き方)か、requires_openai_auth = true を env_key = "QCODE_API_KEY" に置き換えて QCODE_API_KEY を export する方法です。
公式ドキュメントには requires_openai_auth = true のとき Codex は env_key を無視するとあるので、両方を書くと環境変数は使われません。公式は資格情報を TOML やリポジトリに入れないよう勧め、ターミナルで設定した変数はデスクトップから起動したアプリでは読めないことがあると注意しています。
QCode につなぐ五つの手順
2026年11月20日時点で、同梱カタログの既定は GPT-6.2 Sol です。モデルを固定する必要がある場合は、設定でモデルを固定してください。QCode のドキュメントに従う手順は次のとおりです。
- 1設定フォルダー
~/.codexを作成します(Windows では %USERPROFILE%\.codex)。 - 2
config.tomlの先頭に最上位キーを記述します。model_provider は qcode、model はgpt-6.2-sol(2026-11-20 時点の rust-v0.171.0 カタログ既定)、gpt-6.1-solまたはgpt-6-solを明示し、必要に応じて model_reasoning_effort を記述します。単発実行では codex--modelgpt-6.2-solを使用します。これらのキーは最初のテーブルヘッダーより前に置く必要があり、そうでない場合はそのテーブルの一部として読み取られます。 - 3model_providers.qcode テーブルを追加し、name を qcode、base_url を
https://api.qcode.cc/openai、wire_api を responses、requires_openai_auth を true にします(北米と欧州ではホストを us.qcode.cc に置き換えられます)。 - 4キーを用意します。cr_ キーを
OPENAI_API_KEYとして~/.codex/auth.jsonに記述します。代わりに環境変数でキーを渡す場合は、テーブル内の requires_openai_auth = true を env_key = "QCODE_API_KEY" に置き換え、QCODE_API_KEYを export します。どちらか一方を使用してください。公式ドキュメントでは、requires_openai_auth = true の場合に Codex が env_key を無視すると記載されています。 - 5codex を起動して /status を実行し、有効なモデルとプロバイダーを確認するか、codex doctor を実行して設定を確認します。
QCode で Codex を使う
QCode のコンソールで cr_ から始まるキーをコピーし、上の五つの手順どおりに書けば完了です。QCode ドキュメントのワンクリック設定スクリプトを使えば、CLI のインストール、~/.codex への設定の書き込み、接続確認まで自動で行います。Codex は OpenAI Responses プロトコルを使うため、QCode で動くのは GPT 系です。
gpt-6.2-sol、gpt-6.2-astra、gpt-6.2-sol、gpt-6.2-astra、gpt-6.2-sol、gpt-6.2-astra、gpt-6.1-sol、gpt-6.1-terra、gpt-6-sol、gpt-6-astra、gpt-5.6-terra(2026-11-04 時点の docs の Codex ページにあるモデル表)と、今も /models に載っている gpt-5.6-sol はいずれも QCode で利用でき、切り替えは model を変えるだけです。
gpt-6-luna と gpt-5.6-luna は現在 QCode で提供していないため、これらの GPT モデルをご利用ください。Claude や GLM、Kimi、DeepSeek、Qwen はこのプロトコルを通りません。同じキーは Claude Code でも使えます。料金はトークン課金で、各モデルの単価は /models をご覧ください。
2026-11-04 時点で、チャージ画面の支払方法は Alipay、WeChat Pay、カード、暗号通貨です。Alipay、WeChat Pay、カード、Apple Pay、Google Payは通常1分以内に反映されます。SBPとロシアのカードは数分かかる場合があります。暗号通貨は手動で確認し、1日以内に入金されます。
月額プランをご希望でない場合は、クォータパックが $4 から。7 日以内に使い切る一度限りの枠です。個人プランをお使いで枠が足りないときはブースターパックを追加できます。接続先の選び方は /how-to-choose-ai-api-relay に書いています。
よくある質問
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 です。true のとき Codex は env_key を無視するので、どちらか一方だけにします。QCode のドキュメントは requires_openai_auth = true にしてキーを ~/.codex/auth.json に書く方法が基本で、環境変数方式のときだけ env_key に置き換えます。
base_url には何を書きますか? /v1 は付けますか?
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 があります。
401 や API key not found が出たらどうしますか?
三点を確かめます。キーが cr_ で始まっているか、auth.json のキーに余分な空白や改行がないか。環境変数方式なら、変数名が config.toml の env_key と同じか(QCode のドキュメントでは QCODE_API_KEY)、テーブルに requires_openai_auth = true が残っていないか(あると Codex は env_key を無視します)、今のシェルで本当に設定されているか。最後に QCode のコンソールでキーの状態を確認します。
config.toml を直したのに、プロバイダーが反映されないのはなぜですか?
一番多いのはトップレベルのキーの位置です。公式ドキュメントは 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 を確認できます。
同じキーを Codex と Claude Code の両方で使えますか?
使えます。2026-11-04 に再確認した QCode のドキュメントでは、Claude Code と Codex は同じキーを共用でき、モデルを切り替えるときに追加の手順は不要です。ただし Claude モデルを Codex に送ることはできません。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 を使ってください。
Codex の中継と Claude Code の中継はどう違いますか?
2026年11月20日時点で、カタログの既定は GPT-6.2 Sol(rust-v0.171.0)であり、gpt-6.2-sol は gpt-6.1-sol と同じ OpenAI 公式 API の Standard 料金です。違いはプロトコルと提供されるモデルです。Codex は OpenAI Responses プロトコルを使用し、GPT ファミリーのみを扱います。一方、Claude Code は Anthropic プロトコルを使用し、Claude モデルを扱います。その他の点は従来どおりです。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 は OpenAI が集中的な大量処理タスク向けに位置付けています。gpt-6-luna を除くこれらはすべて QCode で呼び出せます。切り替えは model を変更するか、codex --model を使用します。QCode は現在 gpt-6-luna または gpt-5.6-luna をサポートしていません(QCode では未サポート)。gpt-6.1-sol、gpt-6-sol、gpt-5.6-terra など別の GPT モデルを使用してください。2026-11-04 に再確認したところ、docs の Codex ページの model 行は既定モデルとして gpt-6.1-sol を推奨しています。2026-11-04 時点で、QCode の docs の Codex ページにあるモデル表には gpt-6.1-sol、gpt-6.1-terra、gpt-6-sol、gpt-6-astra、gpt-5.6-terra が記載されています。gpt-6.1-terra は GPT-6.1 の中間層で、日常的なコーディングとバッチ作業向けです。gpt-5.6-sol はその表にはありませんが、/models にはまだ掲載されています。
情報源
2026-11-20 に確認:Codex CLI rust-v0.171.0 の公式リリース(github.com/openai/codex/releases/tag/rust-v0.171.0、2026-11-20 公開)、OpenAI 公式の Codex モデルページ(developers.openai.com/codex/models、codex --model gpt-6.2-sol と model = "gpt-6.2-sol" の形式を含む)、OpenAI 公式の API 料金ページ(Standard 階層、gpt-6.2-sol は gpt-6.1-sol と同じ料金)。Codex の設定キー:OpenAI 公式の Codex 設定リファレンスと高度な設定ドキュメント(learn.chatgpt.com、2026-10-07 確認)。model_provider の既定値、予約 ID、wire_api の値、env_key と requires_openai_auth、openai_base_url、プロジェクトレベルで無視されるキーを扱っています。最上位キーの配置、認証情報の扱い、/status の確認:公式の Connect to a gateway ドキュメント(同日確認)。バージョンとモデル:公式の ChatGPT および Codex 変更ログ(同日確認。0.159.1、0.160.0、0.160.1、GPT-6 Sol と GPT-6.1 Sol の発表、GPT-5.5 の退役通知)。QCode の設定、base_url、env_key 名、キープレフィックス、モデル一覧:docs.qcode.cc の Codex 完全ガイド、Codex クイックスタート、エンドポイントと API 形式のページ(2026-10-07 確認)。2026-11-04 に docs.qcode.cc の四つのページ(Codex 完全ガイド、エンドポイントと API パス、支払い方法、サブスクリプションと API キーの比較)に対して再確認しました。
関連記事
Codex CLI 完全ガイド
OpenAI Codex CLI のインストールと設定、Claude Code との比較。
Codex CLI 0.171.0 の既定 GPT-6.2 Sol: 外部 base_url 向け config.toml(2026-11)
2026-11-20 確認: 0.171.0 以降 Sol がカタログの既定で、カスタム provider にはユーザー単位の config.toml で model、model_provider、base_url、wire_api = "responses"、env_key が必要です。
クラウドサーバーで Codex CLI を動かす
2026 年 10 月確認:クラウドサーバーで Codex CLI を動かす手順、config.toml と auth.json の設定、codex exec による非対話実行、試し利用と期間のルール。
暗号資産チャージガイド
9 通貨・56 ネットワーク、手数料 0 で AI コーディング API クレジットを購入。
本ページの設定項目とバージョン情報は 2026-10-07 に、OpenAI 公式の Codex ドキュメントと変更履歴、QCode のドキュメントで照合したものです。公式ページを優先してください。公式側の変更は予告なく行われることがあります。ドキュメントに書かれていない互換性は約束しません。モデルの提供状況は /models をご確認ください。