短い答え
model_provider は、Codex CLI が使用するプロバイダーを指定します。この値は [model_providers.<id>] で定義したプロバイダー ID と一致する必要があります。
base_url はモデルリクエストの送信先となる API エンドポイントです。OpenAI 互換プロバイダーでは、通常 /v1 形式のエンドポイントを指定します。
wire_api は、そのプロバイダーとの通信で Codex が使うプロトコル形式を指定します。Codex 設定リファレンスでは、responses はサポートされるプロバイダープロトコルの値です。
この情報が役立つ場面
- カスタムの OpenAI 互換プロバイダーを設定するとき
- Codex でプロバイダーが見つからない、またはモデルリクエストに失敗するとき
model_provider と model の違いが分からないとき- BetterToken、OpenAI、または他のプロバイダーを 1 つの
config.toml に設定するとき
- Base URL、API Key、モデル ID を区別する必要があるとき
項目の関係
ファイルの場所を確認してバックアップする
独自の CODEX_HOME を設定している場合は、そのディレクトリの config.toml と auth.json を編集してください。それ以外は macOS / Linux では ~/.codex、Windows では %USERPROFILE%\.codex を使用します。CLI と App は同じディレクトリを使用する必要があります。WSL のユーザーディレクトリは別です。
編集前に Codex を完全に終了し、両方のファイルを非公開の場所にバックアップしてください。ファイルがなければ作成します。既存の設定を置き換え、キーやテーブルを重複して追加しないでください。無関係な設定は残します。
この設定は ChatGPT ログインから API Key 認証に切り替えます。公式アカウントへのアクセスは維持されません。auth.json とバックアップを保護し、共有したりリポジトリにコミットしたりしないでください。
推奨パターン
config.toml を編集する
model_provider、model、cli_auth_credentials_store はプロファイル内ではなく、すべての TOML テーブルより前のトップレベルに記述してください。プロバイダー ID とテーブル名を一致させます。このファイル認証では、選択したプロバイダーから env_key と experimental_bearer_token を削除してください。
例では GPT-6 Astra（gpt-6-astra）を使用します。別のモデルでは、モデル広場から完全な ID をコピーして model を置き換えてください。GPT、Kimi、GLM のファイル認証構造は共通です。自動設定は GPT で利用できます。
auth.json を編集する
auth.json は config.toml と同じディレクトリにあります。auth.json がない場合は、そのディレクトリに新規作成してください。ファイルの内容を次の JSON にし、YOUR_API_KEY を自分の BetterToken API Key に置き換えて保存してください。
再起動して確認する
両方のファイルを保存し、ターミナルで新しい Codex CLI セッションを直接起動します。
バックグラウンドプロセスを含めて Codex App を完全に終了し、再度開いて新しいローカルタスクを作成してください。使用する各クライアントで短いプロンプトを送信します。正常な応答でそのクライアントの接続を確認してください。
トラブルシューティング
401、403、ログイン要求が出た場合は、使用中のディレクトリ、auth.json の Key、auth_mode = apikey、cli_auth_credentials_store = file、requires_openai_auth = true を確認してください。プロバイダーやモデルのエラーでは、プロバイダー ID の一致、https://bettertoken.ai/v1、wire_api = responses、モデルの利用可否を確認します。変更が反映されない場合は設定の上書きを調べ、CLI と App が同じ CODEX_HOME を使用していることを確認してください。
関連ドキュメント
