Codex CLI カスタム API 設定方法

クイック設定

インストールコマンド

npm install -g @openai/codex

設定ファイル

~/.codex/config.toml

model_provider

qionggeme

base_url

https://qionggeme.com/v1

env_key

QIONGGEME_API_KEY

平文のAPI Keyではなく、環境変数名です。

wire_api

responses

現在の公式カスタムproviderではResponsesを使用します。

設定手順

1. 1

   Codex CLIをインストールする

   公式npmパッケージをグローバルインストールします。

   npm install -g @openai/codex

   インストール後は codex で起動できます。

2. 2

   ~/.codex/config.tomlを設定する

   ~/.codex/config.toml を作成または編集し、次の設定を追加します。

   model_provider = "qionggeme"
   model = "gpt-5.3-codex-spark"
   
   [model_providers.qionggeme]
   name = "穷哥么"
   base_url = "https://qionggeme.com/v1"
   env_key = "QIONGGEME_API_KEY"
   wire_api = "responses"

   env_key の値はCodexが読み込む環境変数名であり、API Key本体ではありません。api_key フィールドは追加しないでください。

3. 3

   macOS / LinuxでAPI Keyを設定する

   Codexを起動するターミナルで環境変数を設定します。

   export QIONGGEME_API_KEY="あなたの穷哥么 API Key"

   shell設定ファイルへ追記した場合は再読み込みするか、新しいターミナルを開いてからCodexを起動してください。

4. 4

   Windows PowerShellでAPI Keyを設定する

   PowerShellで次を実行します。

   $env:QIONGGEME_API_KEY="あなたの穷哥么 API Key"

   この設定は現在のPowerShellセッションで有効です。同じウィンドウから codex を起動してください。変数またはTOMLを変更した場合は、古いCodexセッションを終了して再起動します。

5. 5

   Codexセッションを再起動して確認する

   設定ファイルまたは環境変数を変更したら、実行中のCodexを終了し、codex で新しいセッションを開始します。例のモデルが現在のトークンで利用できない場合は、コンソールに表示されるCodex互換モデルへ変更してください。変更するのはTOML先頭の model 値だけです。

設定例

model_provider = "qionggeme"
model = "gpt-5.3-codex-spark"

[model_providers.qionggeme]
name = "穷哥么"
base_url = "https://qionggeme.com/v1"
env_key = "QIONGGEME_API_KEY"
wire_api = "responses"

# macOS / Linux
export QIONGGEME_API_KEY="あなたの穷哥么 API Key"

# Windows PowerShell
$env:QIONGGEME_API_KEY="あなたの穷哥么 API Key"

トラブルシューティング

よくある質問