CC Switch 設定

CC Switch は AI CLI 向けのクロスプラットフォーム設定マネージャーです。公式 Codex 設定と複数の API プロバイダーを視覚的に切り替えられます。本ガイドは CC Switch 3.20 以降 を対象とします。

設定の概要

CC Switch は ~/.codex/auth.json と ~/.codex/config.toml を管理します。

4AICode は Responses API を直接サポートします。Full URL モードとローカルルーティングは無効のままにしてください。

1. トークンとクライアントの準備

1. ダッシュボード → トークン管理 から sk-4ai-... トークンを作成します。
2. CC Switch サイト または GitHub Releases から最新版をインストールします。
3. Codex CLI をインストールします。

本ガイドの sk-4ai-xxxxxxxxxxxxxxxx はプレースホルダーです。プロバイダー入力時はダッシュボードで作成したトークンに置き換えてください。本物のトークンをバージョン管理や私的メッセージに含めないでください。

初回起動時、CC Switch は既存の Codex 設定をインポートできます。プロバイダー切り替えのたびに Codex 設定ファイルを更新します。

2. 4AICode プロバイダーを追加

1. CC Switch 上部で Codex を選択します。
2. 右上の + をクリックします。
3. App-specific provider のまま Custom プリセットを選択します。
4. 次の値を入力します。

推奨エンドポイントは地域によります。国際ネットワークでは .com、中国本土では https://relay.4aicode.net/v1 を使用します。英語版の例は .com を使用しています。

3. 詳細オプションの確認

Advanced options を展開し、次を確認します。

https://relay.4aicode.com/v1 は API プレフィックスです。Full URL モードが無効のとき、Codex が /responses パスを付加します。

フォーム下部付近の config.toml (TOML) エディタで model_reasoning_effort を xhigh に設定します。本ガイドの推奨値であり、CC Switch が Codex 設定に書き込みます。

Add をクリックしてプロバイダーを保存します。

4. 有効化と確認

1. 4AICode プロバイダーカードで Enable をクリックします。
2. 実行中の Codex CLI または Codex App インスタンスをすべて終了します。
3. 新しいターミナルを開き、実行します。

codex

「このディレクトリを一覧し、プロジェクト構造を説明して」などの簡単なタスクを入力します。正常な応答で設定完了です。

CC Switch がプロバイダーを変更した後は Codex の再起動が必要です。今後の切り替えはメインウィンドウまたはシステムトレイから行えます。

モデルの変更

4AICode プロバイダーを編集し、Default model にモデルを入力します。現在 4AICode が公開しているモデルは以下です。ダッシュボードのモデル一覧とアカウントプールの状態が正とします。

gpt-5.6-sol は max 推論 effort をサポートします。他モデルでは xhigh が推奨設定です。max は推論計算量が増え、応答が遅く、コストも高くなります。保存し、プロバイダーを再度有効化して Codex を再起動してください。

設定リファレンス

CC Switch はサードパーティ APIキープロバイダー用に auth.json にトークンを保存します。意味は以下の例と同じです。公式 ChatGPT ログインモードは tokens と last_refresh を含む別の認証構造を使い、CC Switch はプロバイダー種別に応じて各構造を管理します。CC Switch は異なるプロバイダー ID とセクション名を生成する場合があります。

auth.json：

{
  "OPENAI_API_KEY": "sk-4ai-xxxxxxxxxxxxxxxx"
}

config.toml：

model_provider = "custom"
model = "gpt-5.6-terra"
model_reasoning_effort = "xhigh"

[model_providers.custom]
name = "4AICode"
base_url = "https://relay.4aicode.com/v1"
wire_api = "responses"
requires_openai_auth = true

requires_openai_auth = true は、このプロバイダーが auth.json から APIキーを読むことを示します。

トラブルシューティング

セットアップスクリプト、Codex App モバイルサポート、SDK 例については ChatGPT / Codex 設定 を参照してください。