Codex CLI の設定

Codex は既定で OpenAI に接続します。StoryClaw に切り替えるには 2 つが必要です。プロバイダー設定と、環境変数に入れたキーです。

Codex がまだ入っていない場合は、先に Codex CLI のインストールを参照してください。キーはコンソールの「API キー」ページで作成します（API キーを参照）。以下の 2 つの方法はどちらを選んでも結果は同じです。

方法 A：手動設定

次の内容を ~/.codex/config.toml に書き込みます（ファイルがなければ新規作成します）。

model_provider = "storyclaw"
model = "gpt-5.6-sol"

[model_providers.storyclaw]
name = "StoryClaw"
base_url = "https://llm.storyclaw.com/v1"
env_key = "STORYCLAW_API_KEY"
wire_api = "responses"
disable_response_storage = true

この設定で間違えやすい点がいくつかあります。

• storyclaw は自分で決める名前ですが、model_provider = "storyclaw" と [model_providers.storyclaw] の 2 か所は同じ語にする必要があります。変更するときは両方まとめて変えてください。openai、ollama、lmstudio は Codex の予約名なので使えません。
• env_key に書くのは環境変数の名前であり、キーそのものではありません——キーは次のステップで別途設定し、このファイルには現れません。
• base_url には /v1 が必要です。Codex がその後ろに /responses を付加します。
• disable_response_storage = true は必須です。StoryClaw はレスポンスを保存しないため、これを付けないと Codex が previous_response_id で会話を継続しようとして失敗します。
• model に指定できるのは 1 つだけで、これが既定のモデルです。利用できる ID は利用できるモデルを参照してください。一時的に変えるときは起動時に --model を付けます。

macOS / Linux ならコマンド 1 つで書き込めます。

mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "storyclaw"
model = "gpt-5.6-sol"

[model_providers.storyclaw]
name = "StoryClaw"
base_url = "https://llm.storyclaw.com/v1"
env_key = "STORYCLAW_API_KEY"
wire_api = "responses"
disable_response_storage = true
EOF

続いてキーを環境変数に設定します。

# macOS / Linux——~/.zshrc または ~/.bashrc に書くと永続化されます
export STORYCLAW_API_KEY="あなたの StoryClaw キー"

# Windows (PowerShell)——設定後にターミナルを開き直してください
setx STORYCLAW_API_KEY "あなたの StoryClaw キー"

方法 B：CC Switch の GUI

CC Switch はオープンソースのプロバイダー管理ツールで、TOML を手で書かずに GUI で設定できます。設定は ~/.codex/config.toml に書き込まれるため、結果は方法 A と同じです。macOS では brew install --cask cc-switch だけで導入できます。他のプラットフォームは CC Switch を参照してください。

プロバイダーを追加する

CC Switch を起動し、上部の Codex タブに切り替えて、右上の + ボタンをクリックします。

設定を入力する

「新しいプロバイダーを追加」ダイアログで「カスタム設定」をクリックし、まず次の表のとおり基本情報を入力します。

続いてフォーム下部の「詳細オプション」を展開します。

モデルマッピングは詳細オプションの下にあり、Codex の /model コマンドとデスクトップ版のモデル一覧に表示されるモデルを決めます。次の 3 ステップで設定します。

1. モデル一覧を取得をクリックし、入力した URL とキーで利用できるモデルを取得します。
2. モデルを追加をクリックすると、表に 1 行追加されます。
3. その行の三角マークをクリックし、取得した一覧からモデルを選びます。手入力もできますが、実際のリクエストモデル列は利用できるモデルと一致させてください。

必要なモデルの数だけ手順 2、3 を繰り返します。変更後は Codex を再起動すると一覧が更新されます。

最後に config.toml（TOML） のブロックまでスクロールしてください——CC Switch が実際に書き込む内容を確認できます。右上の共通設定を適用にチェックを入れると、グローバルの ~/.codex/config.toml に書き込まれ、すべてのプロジェクトで有効になります。そのうえで右下の追加をクリックして完了します。

CC Switch がキーを含む設定を ~/.codex/config.toml に書き込むため、ファイルを手で編集する必要はなく、方法 A の環境変数の設定も不要です。

プロバイダーを有効化する

追加が終わったら一覧に戻り、StoryClaw-Codex の行にマウスを重ねて右側に現れる有効化ボタンをクリックします。行がハイライトされれば有効です。

設定を確認する

まずターミナルを再起動してください——Codex は起動時に環境変数を読み込みます。その後、任意のプロジェクトディレクトリで実行します。

codex

起動画面の上部に使用中のモデルが表示されます。任意のメッセージ（「こんにちは」など）を送って正常に返信が届けば、接続は成功です。

Codex デスクトップ版を使う場合、同じ設定がそのまま有効です。Codex デスクトップ版を参照してください。

利用できるモデル

Codex は OpenAI Responses プロトコルを使います（2026 年 2 月に Chat Completions のサポートを廃止しました）。StoryClaw が現在 Responses で公開しているのは GPT 系の 3 モデルです。

最新の一覧はいつでも確認できます。

curl https://llm.storyclaw.com/v1/models \
  -H "Authorization: Bearer あなたのキー"

レスポンスに responses_api_url フィールドが含まれるモデルが、Codex から直接利用できるモデルです。

モデルを指定する

セッション中は /model で切り替えられます。起動時に指定することもできます。

codex --model gpt-5.6-luna

よく使う調整

トラブルシューティング

インストールできない場合や codex コマンドが見つからない場合は、Codex CLI のインストールを参照してください。