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 互換インターフェース

モデル自動取得

プロバイダーの追加や編集時に、プロバイダーのエンドポイントから利用可能なモデルを自動取得できます：

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

この機能は、OpenAI 互換の /v1/models API をサポートするすべてのプロバイダーで動作します。Claude、Codex、Gemini、OpenCode、OpenClaw のプロバイダーで利用可能です。

よくあるエラー：

• 認証失敗（401/403）：API Key を確認してください
• エンドポイント未対応（404/405）：プロバイダーが /v1/models エンドポイントを公開していません
• タイムアウト：エンドポイントの応答が遅いです。後ほど再試行してください

カスタム設定

「カスタム」プリセットを選択した場合、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 です。

高度なオプション

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 フォーマットが設定されている場合、高度なオプションセクションが自動展開されます。

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（遅い）