Codex CLI の設定
Codex CLI はターミナルで動作する Codex です。ローカルプロジェクト内のコードの読み込み、ファイルの修正、テストの実行、エラーの解説などに適しています。デスクトップクライアントの設定は Codex クライアントページをご参照ください。本ページではターミナル CLI の設定を解説します。
公式情報 ダウンロードや最新ドキュメントは公式サイトをご確認ください。
ツール概要と主な用途
ターミナル版 Codexconfig.tomlカスタムプロバイダープロジェクト内での利用
設定ファイルの保存場所
| OS | パスの例 | 説明 |
|---|---|---|
| Windows | C: \Users\YourUsername\. codex\config.toml | ユーザー名はご自身の環境のユーザー名に置き換えてください |
| macOS / Linux | ~/. codex/config.toml | ファイルが存在しない場合は、新規に config.toml を作成してください |
カスタムプロバイダーの設定方法
公式アカウントのみをご利用の場合は、まず公式のログイン手順を行ってください。プロバイダー側で Codex / OpenAI 互換の設定が明記されている場合のみ、カスタムプロバイダーを追加してください。
Codex CLI ログインテスト
codex login codex "Please reply only: Configuration successful"config.toml の設定例
model = "MODEL_ID_FROM_PROVIDER_DASHBOARD" model_provider = "mz_proxy" [model_providers.mz_proxy] name = "Example AI Provider" base_url = "https://YOUR_PROVIDER_API_URL" env_key = "MZ_PROXY_API_KEY" wire_api = "responses"| 設定項目 | 入力内容 | 注意事項 |
|---|---|---|
| model | プロバイダー管理画面のモデル一覧に記載されている Model ID / モデル名 | 自身で創作した表示名を入力せず、大文字小文字・ハイフン・ドットも変更しないでください |
| model_provider | 下記で定義するプロバイダー名 | [model_providers.xxx] の xxx 部分と完全に一致させる必要があります |
| base_url | プロバイダー管理画面で提供されている API アドレス | 管理画面の指示例に従い、末尾に /v1 を含めるかどうか確認してください |
| env_key | ローカル環境変数名 | ここには環境変数名を記述し、API Key そのものを直接入力しないでください |
| wire_api | インターフェースプロトコル | Codex 公式ドキュメントおよびプロバイダーの案内に従って選択してください |
API Key の設定とテスト
上記の env_key は変数名にすぎないため、実際の Key はローカルの環境変数に設定する必要があります。まずはテスト用に一時設定し、動作確認が完了してから恒久的な保存を検討してください。
PowerShell での一時テスト
$env:MZ_PROXY_API_KEY = "YOUR_KEY" codex "Please reply only: Configuration successful"ターミナルでの一時テスト
MZ_PROXY_API_KEY="YOUR_KEY" codex "Please reply only: Configuration successful"TOML 内で model と model_provider はファイルの先頭に記述してください。[model_providers.xxx] セクションの下に記述しないでください。
Codex CLI ドキュメント Codex CLI の公式エントリを確認します。
Codex の基本設定 config.toml の配置場所と適用範囲を確認します。
Codex の設定リファレンス model_providers、base_url、env_key などの設定項目を確認します。