CC-Switch 完全ガイド：5分で学ぶ Claude Code 複数API設定の管理

Claude Codeでのコーディングは非常に快適ですが、公式APIの料金が気になりませんか？サードパーティのAPIプロキシサービスに切り替えたいけれど、設定ファイルの変更方法がわからない……。CC-Switchは、まさにそんな悩みを解決するために生まれたツールです。この記事では、CC-Switchのインストールと使用方法を5分でマスターできるよう解説します。Claude Code、Codex、OpenCode、Gemini CLIという4つの主要なAIプログラミングアシスタントのAPI管理を、これ一つで簡単に行えるようになります。

コアバリュー: この記事を読み終える頃には、CC-Switchを使用して複数のAPIプロバイダーを視覚的に管理し、ワンクリックで設定を切り替える方法を習得できます。もう面倒なJSONファイルの手動編集に悩まされることはありません。

CC-Switchとは？なぜ必要なのか

CC-Switchは、AIプログラミングアシスタントの設定を一元管理するために開発された、オープンソースのクロスプラットフォーム・デスクトップアプリです。開発者のfarion1231氏によって作成され、GitHub上で公開されています。

CC-Switchの核心的な役割

一言で言えば、CC-SwitchはAIプログラミングツールの「設定管理センター」です。

CC-Switchがサポートする4つの主要AIプログラミングツール

🚀 クイックスタート: CC-Switchは、APIYI (apiyi.com) などのサードパーティ製プロキシサービスへの接続をサポートしています。プロバイダーを設定すれば、Claude Codeなどのツールをより低コストで利用でき、同時にワンクリック切り替えの利便性を享受できます。

CC-Switch 核心機能詳解

CC-Switchは単なる設定切り替えツールではありません。機能が充実した、大規模言語モデル（AI）ツール管理プラットフォームです。

機能1: Provider 管理 (コア機能)

これはCC-Switchで最も頻繁に使われる機能で、以下をサポートしています：

Provider 設定例:

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "models": {
    "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
    "claude-opus-4-20250514": "claude-opus-4-20250514"
  }
}

機能2: MCP サーバー管理

MCP (Model Context Protocol) は、Claude Codeの拡張プロトコルです。CC-Switchは、統合されたMCP管理インターフェースを提供します：

• stdio / http / sse の3つの転送タイプに対応
• アプリ間での共通設定（Claude/Codex/Gemini）
• MCPサーバーの視覚的な追加、編集、削除

機能3: Skills（スキル）管理

CC-Switchは、Claude Skillsを自動的に検出してインストールできます：

• GitHubリポジトリ内のSkillsを自動スキャン
• ワンクリックで ~/.claude/skills/ ディレクトリにインストール
• ネストされたディレクトリの再帰的スキャンに対応

機能4: システムプロンプト管理

さまざまなシーンに合わせてシステムプロンプトのプリセットを作成できます：

• 無制限のプロンプトプリセット
• CLAUDE.md、AGENTS.md、GEMINI.md に対応
• 異なるワークモードへの素早い切り替え

機能5: ローカル API プロキシ (v3.9.0+)

CC-Switchにはローカルプロキシサーバーが内蔵されており、高度な機能を提供します：

💡 テクニカルアドバイス: ローカルプロキシ機能は、APIYI（apiyi.com）と組み合わせて使用するとより効果的です。APIYIは安定したOpenAI互換インターフェースを提供しており、CC-Switchのフェイルオーバー機能により、ネットワークが不安定な際も自動で切り替わり、プログラミング体験を中断させません。

CC-Switch インストールガイド

CC-Switchは、Windows、macOS、Linuxの3つのプラットフォームに対応しており、複数のインストール方法を提供しています。

Windows でのインストール

方法1：MSI インストーラー (推奨)

GitHubのReleasesから .msi ファイルをダウンロードし、ダブルクリックしてインストールします。

方法2：ポータブル版

.zip ポータブル版をダウンロードし、解凍後に直接実行します。インストールは不要です。

macOS でのインストール

方法1：Homebrew (推奨)

brew install --cask cc-switch

方法2：手動インストール

.dmg または .zip ファイルをダウンロードし、アプリケーション（Applications）フォルダにドラッグします。

注意: 初回起動時にGatekeeperの警告が表示される場合があります。「システム設定（またはシステム環境設定） → プライバシーとセキュリティ」で実行を許可してください。

Linux でのインストール

CC-Switchは、Linux向けに複数のパッケージ形式を提供しています：

インストールの確認

インストール完了後、CC-Switchを起動してください。メイン画面に検出されたCLIツールのステータスが表示されれば成功です。

CC-Switch クイックスタート設定

第1ステップ: APIYI プロバイダーの追加

1. メイン画面の 「Add Provider」 ボタンをクリックします。
2. 「Custom」（カスタム設定）を選択します。
3. 以下の情報を入力します：

名称: APIYI
Base URL: https://api.apiyi.com
API Key: sk-your-apiyi-key  # 从 apiyi.com 获取

4. モデルマッピングを設定します（任意）：

{
  "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
  "claude-opus-4-20250514": "claude-opus-4-20250514",
  "gpt-4o": "gpt-4o"
}

5. 「Save」 をクリックして設定を保存します。

API Key の取得: APIYI (apiyi.com) にアクセスしてアカウントを登録すると、API Key を取得できます。プラットフォームでは無料のテストクレジットが提供されており、Claude、GPT、Gemini などの主要なモデルをサポートしています。

第2ステップ: プロバイダーの切り替え

設定保存後、メイン画面のプロバイダーリストにて：

1. 先ほど追加した「APIYI」プロバイダーを探します。
2. 「Switch」 をクリックするか、そのプロバイダーを直接クリックします。
3. CC-Switch が対応するツールの設定ファイルを自動的に書き換えます。
4. Claude Code などの CLI ツールを再起動して設定を反映させます。

第3ステップ: 接続テスト

CC-Switch の速度テスト機能を使用して設定を確認します：

1. プロバイダーの横にある 「Test」 ボタンをクリックします。
2. 遅延テストが完了するまで待ちます。
3. 応答時間とステータス表示を確認します。

テストに合格したら、ターミナルを開いて Claude Code を実行します：

claude

正常に対話ができれば、設定は成功です。

最小構成の例

{
  "id": "apiyi-provider",
  "name": "APIYI (推荐)",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "enabled": true,
  "models": {
    "claude-sonnet-4-20250514": {
      "id": "claude-sonnet-4-20250514",
      "name": "Claude Sonnet 4",
      "maxTokens": 64000
    },
    "claude-opus-4-20250514": {
      "id": "claude-opus-4-20250514",
      "name": "Claude Opus 4",
      "maxTokens": 32000
    },
    "gpt-4o": {
      "id": "gpt-4o",
      "name": "GPT-4o",
      "maxTokens": 16384
    },
    "gpt-4o-mini": {
      "id": "gpt-4o-mini",
      "name": "GPT-4o Mini",
      "maxTokens": 16384
    }
  },
  "healthCheck": {
    "enabled": true,
    "interval": 60
  }
}

CC-Switch 応用機能

マルチプロバイダー管理戦略

CC-Switch は複数のプロバイダー設定に対応しており、柔軟な運用戦略を実現できます：

┌─────────────────────────────────────────────────┐
│              CC-Switch Provider 列表              │
├─────────────────────────────────────────────────┤
│  ⭐ APIYI (主用)        延迟: 120ms   ✓ 健康    │
│  📦 OpenRouter (备用)   延迟: 280ms   ✓ 健康    │
│  🏢 官方 Claude (保底)  延迟: 350ms   ✓ 健康    │
└─────────────────────────────────────────────────┘

推奨設定:

• メイン: APIYI – 低価格で、日本国内（アジア圏）からのアクセスが高速
• バックアップ: OpenRouter – モデルが豊富で、海外サーバー経由で安定
• フォールバック: 公式ログイン – 常に利用可能な状態を確保

クラウド同期設定

CC-Switch は設定をクラウドストレージに同期できます：

1. Settings → Storage を開きます。
2. クラウド同期フォルダ（Dropbox、OneDrive、iCloud Drive など）を選択します。
3. CC-Switch がプロバイダー設定を自動的に同期します。

これにより、複数のデバイス間で同じ API 設定を共有できます。

ローカルプロキシの高度な設定

ローカルプロキシを有効にすると、CC-Switch は以下の動作を行います：

1. ローカルでプロキシサーバーを起動します。
2. CLI 設定を自動的に書き換え、ローカルプロキシを指すようにします。
3. プロキシサーバーがリクエストを実際のプロバイダーに転送します。

メリット:

• すべてのリクエストが統一された入り口を通過するため、モニタリングが容易。
• 自動フェイルオーバー機能により、プロバイダーがダウンしても自動で切り替え。
• リクエストログの記録により、問題の特定がスムーズ。

# プロキシモードのリクエストフロー
Claude Code → localhost:8080 → CC-Switch 代理 → APIYI → Claude API

Claude Rectifier 機能

v3.10.0 で追加された Claude Rectifier 機能は、サードパーティ API の互換性問題を修正するために使用されます：

• thinking signature（思考プロセス）のフォーマットを自動修正。
• 非公式 API との互換性を向上。
• 「フォーマットエラー」系のエラーを削減。

CC-Switch よくある質問

# 方法1: 現在のターミナルを閉じ、再度開く
# 方法2: Claude Code で /exit と入力して終了した後、再起動する
claude  # 再起動

# カスタム設定を削除し、公式設定を復元する
rm ~/.claude/settings.json
claude  # 公式アカウントに再ログインする

CC-Switch vs 手動設定の比較

🎯 選択のアドバイス: 複数の API プロバイダーを頻繁に切り替える必要がある場合や、複数の AI プログラミングツールを併用している場合、CC-Switch は効率を大幅に向上させます。APIYI (apiyi.com) と組み合わせて使用することで、低コストかつ利便性の高い最高の体験を得ることができます。

CC-Switch 関連ツールの比較

CC-Switch 以外にも、以下のような類似ツールがあります：

推奨の組み合わせ：CC-Switch（設定管理）+ APIYI（API プロキシ）= 最高のコストパフォーマンスを実現する構成

参考資料

まとめ

CC-Switchは、AIプログラミングアシスタントの設定を管理するための強力なツールであり、以下の課題を解決します。

1. 煩雑な設定: JSONの手動編集に代わり、ビジュアルなインターフェースを提供
2. 切り替えの手間: ワンクリックで複数のプロバイダーを切り替え可能
3. ツールの分散: Claude Code、Codex、OpenCode、Gemini CLIを統合管理
4. 速度測定の欠如: 遅延テスト機能を内蔵し、最速のプロバイダーを選択可能
5. 設定の紛失: 自動バックアップとクラウド同期により、設定を永久に保存

AIプログラミングツールを頻繁に使用する開発者にとって、CC-Switch + APIYI はおすすめの組み合わせです。

• CC-Switch: 便利な設定管理を提供
• APIYI (apiyi.com): 安定かつ低価格なAPIサービスを提供

APIYI (apiyi.com) にアクセスしてアカウントを登録し、APIキーを取得しましょう。その後、CC-Switchにプロバイダーを追加するだけで、スムーズなAIプログラミング体験を始めることができます。

📝 著者: APIYI 技術チーム | APIYI (apiyi.com) – AI APIの呼び出しをもっと簡単に