cc-switch/docs/user-manual/ja/2-providers/2.1-add.md

2.1 プロバイダーの追加

追加パネルを開く

メイン画面右上の + ボタンをクリックして、プロバイダー追加パネルを開きます。

パネルは 2 つのタブに分かれています：

• アプリ専用プロバイダー：現在選択中のアプリ（Claude/Codex/Gemini/OpenCode/OpenClaw）専用
• 統一プロバイダー：アプリ間で共有する設定

プリセットで追加

プリセットは事前に設定されたプロバイダーテンプレートで、API Key を入力するだけで使用できます。

操作手順

1. 「プリセット」ドロップダウンからプロバイダーを選択
2. 名前とエンドポイントが自動入力される
3. API Key を入力
4. （任意）メモを入力
5. 「追加」をクリック

主なプリセット

Claude プリセット

プリセット名	説明
Claude 公式	Anthropic 公式アカウントでログイン
DeepSeek	DeepSeek モデル
智谱 GLM	智谱 AI の GLM モデル
智谱 GLM en	智谱 AI（英語版）
百炼	アリクラウド百炼（通义千問）
Kimi	Moonshot Kimi モデル
Kimi For Coding	Kimi プログラミング専用モデル
StepFun	StepFun モデル
ModelScope	魔搭コミュニティ
KAT-Coder	KAT-Coder モデル
Longcat	Longcat AI
MiniMax	MiniMax モデル
MiniMax en	MiniMax（英語版）
DouBaoSeed	豆包 Seed モデル
BaiLing	百灵 AI
AiHubMix	AiHubMix 統合サービス
SiliconFlow	SiliconFlow
SiliconFlow en	SiliconFlow（英語版）
DMXAPI	DMXAPI 中継サービス
PackyCode	PackyCode 中継サービス ⭐
Cubence	Cubence サービス
AIGoCode	AIGoCode サービス
RightCode	RightCode サービス
AICodeMirror	AICodeMirror サービス
OpenRouter	統合ルーティングサービス
Nvidia	Nvidia AI サービス
Xiaomi MiMo	Xiaomi MiMo モデル

⭐ は公式パートナーを示します。プリセットリストはバージョンの更新に伴い変更される場合があります。アプリ内の実際の表示を基準にしてください。

Codex プリセット

プリセット名	説明
OpenAI 公式	OpenAI 公式アカウントでログイン
Azure OpenAI	Azure OpenAI サービス
AiHubMix	AiHubMix 統合サービス
DMXAPI	DMXAPI 中継サービス
PackyCode	PackyCode 中継サービス
Cubence	Cubence サービス
AIGoCode	AIGoCode サービス
RightCode	RightCode サービス
AICodeMirror	AICodeMirror サービス
OpenRouter	統合ルーティングサービス

Gemini プリセット

プリセット名	説明
Google 公式	Google OAuth でログイン
PackyCode	PackyCode 中継サービス
Cubence	Cubence サービス
AIGoCode	AIGoCode サービス
AICodeMirror	AICodeMirror サービス
OpenRouter	統合ルーティングサービス
カスタム	すべてのパラメータを手動設定

OpenCode プリセット

プリセット名	説明
DeepSeek	DeepSeek モデル
智谱 GLM	智谱 AI の GLM モデル
智谱 GLM en	智谱 AI（英語版）
百炼	アリクラウド百炼
Kimi k2.5	Moonshot Kimi-k2.5 モデル
Kimi For Coding	Kimi プログラミング専用モデル
StepFun	StepFun モデル
ModelScope	魔搭コミュニティ
KAT-Coder	KAT-Coder モデル
Longcat	Longcat AI
MiniMax	MiniMax モデル
MiniMax en	MiniMax（英語版）
DouBaoSeed	豆包 Seed モデル
BaiLing	百灵 AI
Xiaomi MiMo	Xiaomi MiMo モデル
AiHubMix	AiHubMix 統合サービス
DMXAPI	DMXAPI 中継サービス
OpenRouter	統合ルーティングサービス
Nvidia	Nvidia AI サービス
PackyCode	PackyCode 中継サービス
Cubence	Cubence サービス
AIGoCode	AIGoCode サービス
RightCode	RightCode サービス
AICodeMirror	AICodeMirror サービス
OpenAI Compatible	OpenAI 互換インターフェース
Oh My OpenCode	Oh My OpenCode サービス

プリセットリストは継続的に更新されています。アプリ内の実際の表示を基準にしてください。

OpenClaw プリセット

プリセット名	説明
DeepSeek	DeepSeek モデル
智谱 GLM	智谱 AI の GLM モデル
智谱 GLM en	智谱 AI（英語版）
Qwen Coder	通义千問コーディングモデル
Kimi k2.5	Moonshot Kimi-k2.5 モデル
Kimi For Coding	Kimi プログラミング専用モデル
StepFun	StepFun モデル
MiniMax	MiniMax モデル
MiniMax en	MiniMax（英語版）
KAT-Coder	KAT-Coder モデル
Longcat	Longcat AI
DouBaoSeed	豆包 Seed モデル
BaiLing	百灵 AI
Xiaomi MiMo	Xiaomi MiMo モデル
AiHubMix	AiHubMix 統合サービス
DMXAPI	DMXAPI 中継サービス
OpenRouter	統合ルーティングサービス
ModelScope	魔搭コミュニティ
SiliconFlow	SiliconFlow
SiliconFlow en	SiliconFlow（英語版）
Nvidia	Nvidia AI サービス
PackyCode	PackyCode 中継サービス
Cubence	Cubence サービス
AIGoCode	AIGoCode サービス
RightCode	RightCode サービス
AICodeMirror	AICodeMirror サービス
AICoding	AICoding サービス
CrazyRouter	CrazyRouter サービス
SSSAiCode	SSSAiCode サービス
AWS Bedrock	AWS Bedrock サービス
OpenAI Compatible	OpenAI 互換インターフェース

モデル自動取得

プロバイダーの追加や編集時に、プロバイダーのエンドポイントから利用可能なモデルを自動検出でき、モデル ID の手動コピー＆ペーストの手間を省けます。

1. API Key と エンドポイントアドレス が入力されていることを確認
2. モデル入力フィールドの横にある モデル取得 ボタン（ダウンロードアイコン）をクリック
3. CC Switch が設定された API Key で OpenAI 互換の /v1/models エンドポイントを呼び出し
4. カテゴリ別にグループ化されたドロップダウンからモデルを選択

この機能は 5 つのアプリ全対応 —— Claude / Codex / Gemini / OpenCode / OpenClaw のプロバイダーで利用可能で、/v1/models エンドポイントをサポートするすべてのプロバイダーに対応します。

よくあるエラー：

• 認証失敗（401/403）：API Key が正しいか確認してください
• エンドポイント未対応（404/405）：プロバイダーが /v1/models エンドポイントを公開していません。手動でモデル ID を入力してください
• 解析失敗：レスポンスが OpenAI 互換フォーマットに準拠していません
• タイムアウト：エンドポイントの応答が遅いです。後ほど再試行するかネットワークを確認してください

カスタム設定

「カスタム」プリセットを選択した場合、JSON 設定を手動で編集する必要があります。

Claude 設定形式

{
  "env": {
    "ANTHROPIC_API_KEY": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.example.com"
  }
}

フィールド	必須	説明
ANTHROPIC_API_KEY	はい	API キー
ANTHROPIC_BASE_URL	いいえ	カスタムエンドポイントアドレス
ANTHROPIC_AUTH_TOKEN	いいえ	API_KEY の代替認証方式

Codex 設定形式

Codex は 2 つの設定ファイルを使用します：

1. auth.json（~/.codex/auth.json）- API キーを保存：

{
  "OPENAI_API_KEY": "your-api-key"
}

2. config.toml（~/.codex/config.toml）- モデルとエンドポイントの設定を保存：

# 基本設定
model_provider = "custom"
model = "gpt-5.2"
model_reasoning_effort = "high"
disable_response_storage = true

# カスタムプロバイダー設定
[model_providers.custom]
name = "custom"
base_url = "https://api.example.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json フィールド説明：

フィールド	必須	説明
OPENAI_API_KEY	はい	API キー

config.toml フィールド説明：

フィールド	必須	説明
model_provider	はい	モデルプロバイダー名（[model_providers.xxx] と一致する必要あり）
model	はい	使用するモデル（例：gpt-5.2、gpt-4o）
model_reasoning_effort	いいえ	推論強度：low / medium / high
disable_response_storage	いいえ	レスポンス保存を無効にするかどうか
base_url	はい	API エンドポイントアドレス
wire_api	いいえ	API プロトコルタイプ（通常 responses）
requires_openai_auth	いいえ	OpenAI 認証方式を使用するかどうか

Gemini 設定形式

{
  "env": {
    "GEMINI_API_KEY": "your-api-key",
    "GOOGLE_GEMINI_BASE_URL": "https://api.example.com"
  }
}

フィールド	必須	説明
GEMINI_API_KEY	はい	API キー
GOOGLE_GEMINI_BASE_URL	いいえ	カスタムエンドポイントアドレス
GEMINI_MODEL	いいえ	モデルの指定

認証タイプは CC Switch が自動的に検出します（PackyCode API プロキシ / Google OAuth / 汎用 API Key）。手動設定は不要です。

統一プロバイダー

統一プロバイダーは Claude/Codex/Gemini/OpenCode/OpenClaw 間で設定を共有でき、複数の API 形式をサポートする中継サービスに適しています。

統一プロバイダーの作成

1. 「統一プロバイダー」タブに切り替え
2. 「統一プロバイダーを追加」をクリック
3. 共通設定を入力：
   • 名前
   • API Key
   • エンドポイントアドレス
4. 同期するアプリにチェック（Claude/Codex/Gemini/OpenCode/OpenClaw）
5. 保存

同期の仕組み

統一プロバイダーはチェックしたアプリに自動的に同期されます：

• 統一プロバイダーを変更すると、関連するすべてのアプリの設定が同期更新される
• 統一プロバイダーを削除すると、関連するアプリの設定も削除される

保存して同期

統一プロバイダーの編集時に選択できます：

操作	説明
保存	設定のみ保存、すぐに同期しない
保存して同期	設定を保存し、有効なすべてのアプリに即座に同期

手動同期

手動で同期をトリガーする場合：

1. 統一プロバイダーカードの「同期」ボタンをクリック
2. 同期操作を確認
3. 各アプリの関連プロバイダーの設定が上書きされる

プロバイダーのインポート

CC Switch は 2 つの方法でプロバイダー設定をインポートできます：

方法 1：ディープリンクでインポート

ccswitch:// プロトコルリンクでワンクリックインポート：

1. ディープリンクをクリックまたはアクセス
2. CC Switch が自動的に開き、インポート確認を表示
3. 設定情報をプレビュー
4. 「インポートを確認」をクリック

ディープリンクの取得方法：

• 他の人からの共有で取得
• オンライン生成ツール で作成

方法 2：データベースバックアップからインポート

SQL バックアップファイルから一括インポート：

1. 「設定 → 詳細 → データ管理」を開く
2. 「ファイルを選択」をクリック
3. 以前にエクスポートした .sql バックアップファイルを選択
4. 「インポート」をクリック
5. 既存の設定の上書きを確認

インポート内容：

• すべてのプロバイダー設定
• MCP サーバー設定
• Prompts プリセット
• 使用量ログ

注意：インポートは既存のデータベースを上書きするため、事前に現在の設定をエクスポートしてバックアップすることをお勧めします。エクスポートファイル名の形式は cc-switch-export-{タイムスタンプ}.sql です。

Codex OAuth リバースプロキシ（Claude プロバイダー）

v3.13.0 より、CC Switch は Codex OAuth リバースプロキシ 経路を追加しました。ChatGPT アカウント を使って Claude Code 内から Codex サービスを再利用できます。

位置ヒント：この機能は 新しい Claude プロバイダーカードタイプ として表示され、Codex 側のプリセットではありません。追加後は通常の API Key プロバイダーと並んで Claude のプロバイダーリストに表示されます。

前提条件

• ログイン可能な ChatGPT アカウント
• auth.openai.com および chatgpt.com にアクセスできる
• 利用前に必ず本節末尾の ⚠️ リスク通知 をお読みください

2 つの入口

以下のどちらの入口からでも開始できます：

入口 A：プロバイダー追加パネルから（新規ユーザー推奨）

1. Claude アプリに切り替える
2. 右上の + ボタンをクリックしてプロバイダー追加パネルを開く
3. プリセットリストの第三者カテゴリから Codex (ChatGPT Plus/Pro) プリセットを選択（UI に表示される名称を優先）
4. まだ ChatGPT アカウントにログインしていない場合、パネルが 自動的に ログインフローへ誘導します（下記「ログインフロー」を参照）
5. ログイン成功後、プロバイダーフォームにログイン済みアカウントが表示されるので「保存」をクリックして完了

入口 B：OAuth 認証センターから（マルチアカウント管理に適する）

1. 設定 → OAuth 認証センター を開く（タブに Beta マーク）
2. ChatGPT (Codex OAuth) セクションで ChatGPT でログイン ボタンをクリック
3. ログインフローを完了（下記参照）
4. ログイン完了後、Claude アプリに戻る → プロバイダーの追加 → 同じ Codex (ChatGPT Plus/Pro) プリセットを選択
5. フォーム内の「アカウント選択」ドロップダウンから、先ほどログインしたアカウントを選択して保存

ログインフロー（Device Code）

どちらの入口から入っても、ログインフローは同一です：

1. 認証コードを取得：CC Switch が OpenAI Device Code フローを呼び出し、以下を表示：
   • 認証コード（約 8 文字、例：ABCD-1234）
   • 認証コード右側の コピー ボタン
   • その下の認証 URL https://auth.openai.com/codex/device
   • 「認証を待っています...」のアニメーション表示
2. ブラウザ認証：リンクをクリック（または URL を手動で訪問）し、ブラウザで：
   • ChatGPT アカウントにログイン
   • 先ほどコピーした認証コードを入力
   • 認証を確認
3. 自動ポーリング完了：CC Switch はバックグラウンドで OpenAI サーバーをポーリングし、認証成功を検知すると待機画面を自動的に閉じます
4. ログイン済みアカウントを表示：ログインした ChatGPT アカウント（ログインメール）が OAuth 認証センター → ログイン済みアカウント リストに表示されます

⏱️ 認証コードの有効期限は約 15 分 です。タイムアウトすると「Device Code の有効期限切れ」が表示されるので、再試行 をクリックして新しい認証コードを取得してください。

有効化と使用

Codex OAuth プロバイダーを追加・保存した後：

1. Claude のプロバイダーリストから探す
2. カードの 有効化 ボタンをクリック —— 通常のプロバイダーと同じ
3. Claude Code CLI がリバースプロキシ経由で Codex サービスを使用します
4. トレイメニューの Claude サブメニューにもこのプロバイダーが表示され、素早く切り替え可能

内部動作：CC Switch はリクエストを https://chatgpt.com/backend-api/codex にルーティングし、base URL が強制的に書き換えられます —— フォームにエンドポイントを手動入力する 必要はありません。API フォーマットは openai_responses に固定されます。

デフォルトモデル

Codex OAuth プリセットのデフォルトモデルマッピング：

役割	デフォルトモデル
メインモデル	gpt-5.4
Sonnet 役割	gpt-5.4
Opus 役割	gpt-5.4
Haiku 役割	gpt-5.4-mini

プロバイダーの JSON エディタで ANTHROPIC_MODEL などの環境変数を上書きしてカスタマイズできます。

マルチアカウント管理（OAuth 認証センター）

OAuth 認証センター は複数の ChatGPT アカウントの同時管理をサポートします：

操作	説明
別のアカウントを追加	「別のアカウントを追加」をクリックしてログインフローを繰り返す
デフォルトに設定	アカウント行の「デフォルトに設定」をクリック —— 新規プロバイダーに適用
プロバイダー用に選択	プロバイダーフォームの「アカウント選択」ドロップダウンで特定アカウントを指定
アカウントを削除	アカウント右側の赤い × をクリックして削除（Token がクリアされる）
すべてのアカウントをログアウト	下部の「すべてのアカウントをログアウト」ボタンで一括クリア

使用シーン：チームで開発マシンを共有する場合、各メンバーの ChatGPT アカウントごとに 1 つのプロバイダーを作成し、トレイメニューから素早く切り替えできます。

Token 自動更新

• Token は 有効期限の 60 秒前 に自動更新され、すべてバックグラウンドで処理されるため手動介入は不要です
• Refresh Token はローカルデータディレクトリに保存され、どこにもアップロードされません
• Token のエクスポートは サポートされていません（漏洩防止）

クォータ表示

ログインしてプロバイダーを有効化すると、プロバイダーカード下部 に自動的にアカウントクォータが表示されます：

表示要素	例	カラールール
使用率	45%	< 70% 緑、70–89% オレンジ、≥ 90% 赤
リセットまでの時間	7d12h 後にリセット	ChatGPT アカウントのスライディングウィンドウまたは日次制限
更新ボタン	円形の矢印	手動でクォータを再取得

⚠️ セッション期限切れ：Token が完全に無効になった（自動更新できない）場合、カード下部に黄色い警告枠「セッション期限切れ」が表示されます。OAuth 認証センター からこのアカウントを削除し、再ログインしてください。

よくある失敗

シナリオ	表示	解決方法
認証コードタイムアウト	「Device Code の有効期限切れ」	「再試行」をクリックして新しい認証コードを取得
ブラウザで認証拒否	「ユーザーが認証を拒否」	再ログインしブラウザで「認証」をクリック
ネットワークエラー	具体的なエラー情報を表示	ネットワーク接続を確認、OpenAI ドメインへのアクセス可否を確認
ログイン前にプロバイダー作成	「ChatGPT アカウントにログインしてください」	先に OAuth 認証センターでログインを完了
Token 更新失敗	クォータ欄に「セッション期限切れ」	アカウントを削除して再ログイン
クォータ取得失敗	クォータ欄に「取得失敗」	「更新」ボタンをクリックして再試行

⚠️ リスク通知（重要）

Codex OAuth リバースプロキシは リバースエンジニアリングされた OAuth フロー で ChatGPT アカウントの Codex サービスにアクセスします。有効化前に必ず以下のリスクをご理解ください：

1. 利用規約違反：OpenAI の利用規約に違反する可能性があります。同規約は未承認の自動化アクセス、サービスの複製、および既定のアクセス経路の迂回を禁止しています
2. アカウントリスク：OpenAI は異常な使用パターンを疑わしい自動化として検知し、ChatGPT アカウントに一時的または永続的な制限を課す可能性があります
3. 長期的な可用性は保証されません：OpenAI は認証および検出メカニズムをいつでも更新する可能性があり、現在利用可能な方法が将来ブロックされる可能性があります

この機能を有効化することは、すべてのリスクを自己責任で負うことを意味します。CC Switch は本機能の使用による一切のアカウント制限、警告、サービス停止について責任を負いません。

📖 完全な免責事項と背景は v3.13.0 Release Notes をご覧ください。

高度なオプション

API フォーマット（Claude のみ）

サードパーティ API を使用する Claude プロバイダーを追加する際、高度なオプションセクションで正しい API フォーマット を選択する必要がある場合があります：

フォーマット	説明	使用場面
Anthropic Messages	ネイティブ Anthropic API フォーマット（デフォルト）	Anthropic API に直接接続、または互換プロキシ
OpenAI Chat Completions	OpenAI Chat API フォーマット、プロキシが自動変換	プロバイダーが OpenAI Chat フォーマットのみ対応
OpenAI Responses API	OpenAI Responses API フォーマット、プロキシが自動変換	プロバイダーが OpenAI Responses フォーマットのみ対応

注意：API フォーマットの変換はプロキシサービスが担当します。Anthropic 以外のフォーマットを使用する場合、リクエスト/レスポンスの正しい変換のためにプロキシが接管有効の状態で稼働している必要があります。詳しくは 4.1 プロキシサービス をご覧ください。

デフォルト以外の API フォーマットが設定されている場合、高度なオプションセクションが自動展開されます。

完全URLエンドポイントモード

v3.13.0 で追加された高度なオプション。デフォルトでは、CC Switch は設定された base_url を プレフィックス として扱い、/v1/chat/completions などの固定パスを後ろに連結します。一部のベンダー（非標準の URL レイアウトを必要とする第三者サービスなど）では、この連結方式ではリクエストが失敗します。

有効化方法：

1. プロバイダーを編集し、「高度なオプション」を展開
2. 完全 URL モード チェックボックスにチェックを入れる
3. 完全なアップストリームエンドポイント（プレフィックスではなく）を base_url に入力

例の比較：

モード	base_url の記入例	実際のリクエスト先
デフォルト（プレフィックス連結）	https://api.example.com	https://api.example.com/v1/chat/completions
完全 URL モード	https://api.example.com/custom/path/messages	https://api.example.com/custom/path/messages

使用シーン：

• ベンダーが非標準パスを要求する場合（/v1/chat/completions 以外）
• ベンダーに多階層のパス構造がある場合
• ベンダー専用の API ゲートウェイパス

ヒント：プロキシ転送および Stream Check のいずれも「完全 URL モード」の設定に従うため、有効化後に追加調整は不要です。このオプションを無効化すると、パス連結はデフォルトの動作に戻ります。

Claude 共通設定クイックトグル

Claude プロバイダーの編集時、JSON エディタの上部に クイックトグル が利用できます：

トグル	効果	設定変更
帰属情報を非表示	コミット/PR の帰属メタデータをクリア	attribution: {commit: "", pr: ""} を設定
チームメイトを有効化	エージェントチーム機能を有効化	env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1" を設定
ツール検索を有効化	ツール検索機能を有効化	env.ENABLE_TOOL_SEARCH = "true" を設定
高強度	エフォートレベルを高に設定	effortLevel = "high" を設定
自動アップグレードを無効化	Claude Code の自動更新を防止	env.DISABLE_AUTOUPDATER = "1" を設定

トグルのチェックを外すと、対応する設定エントリが完全に削除されます。変更は JSON エディタにリアルタイムで反映されます。

また、共通設定を書き込み チェックボックスを有効にすると、グローバル設定スニペットをプロバイダーにマージできます。共通設定を編集 をクリックして共有スニペットをカスタマイズできます。

Codex 1M コンテキストウィンドウ

Codex プロバイダーの追加時、1M コンテキストウィンドウを有効化 トグルが利用できます：

• 有効時：config.toml に model_context_window = 1000000 を設定し、model_auto_compact_token_limit = 900000 を自動入力
• 無効時：両方のフィールドを削除

トグルがオンの場合に表示されるテキストフィールドで、自動コンパクト制限をカスタマイズできます。

カスタムアイコン

名前の左側にあるアイコンエリアをクリックすると：

• プリセットアイコンを選択
• アイコンの色をカスタマイズ

Web サイトリンク

プロバイダーの公式サイトやコンソールのアドレスを入力して、素早くアクセスできます：

• プロバイダーカードのリンクアイコンをクリックすると直接開く
• 残額の確認や API Key の取得などに使用

メモ

以下のようなメモ情報を追加できます：

• アカウントの用途（個人/仕事）
• プランの情報
• 有効期限

メモはプロバイダーカードに表示され、検索にも対応しています。

エンドポイント速度テスト

プロバイダーを追加した後、API エンドポイントの速度テストができます：

1. プロバイダーカードの「テスト」ボタンをクリック
2. テストパネルで複数のエンドポイント URL を追加
3. 「テスト」をクリックして実行
4. レイテンシが最も低いエンドポイントを選択

テスト結果：

• 緑：レイテンシ < 500ms（優秀）
• 黄：レイテンシ 500-1000ms（普通）
• 赤：レイテンシ > 1000ms（遅い）