Claude Codeのプロバイダー切り替え：5分でわかるCC Switchチュートリアル

このチュートリアルはCC Switch v4.0.26（2026年11月）に基づいています。ボタンのラベルは今後のリリースで変わる場合がありますが、設定モデルは変わりません。

Claude Codeでプロバイダーを切り替えるには、通常~/.claude/settings.jsonを編集し、ベースURL、APIキー、場合によってはモデルを変更します。プロバイダーが1つなら管理できます。2つか3つになると、ちょっとした保守作業になります。しかも、シェルに残った古いANTHROPIC_*の環境変数が編集したばかりのファイルを上書きすることがあり、問題に気づきにくいのが厄介です。

CC Switchを使えば、カードをクリックするだけで切り替えられます。組み込みのAiHubMixプリセットがエンドポイントを入力してくれるので、APIキーを貼り付けるだけです。通常、Claude Codeは再起動しなくても変更を再読み込みします。このチュートリアルでは、設定手順をすべて説明したうえで、CC Switchが書き込む内容、環境変数の落とし穴、そしてDirectモードで十分なケースについて解説します。

手順だけを知りたい方は、CC Switchをインストールし、AIHubMixのキーを作成して、Claude Codeの下にあるAiHubMixプリセットを選び、キーを貼り付け、プロバイダーにANTHROPIC_MODEL=claude-sonnet-5-5を追加して、Switchをクリックし、claude -p "1+1, output only the answer" --model claude-sonnet-5-5を実行してください。以下では、各手順の詳細を説明します。

CC Switchとは

CC Switchは、Claude Code、Codex、Gemini CLI、OpenCodeなどのコーディングツールのプロバイダー設定を管理するオープンソースのデスクトップアプリです（MITライセンス、Tauri + Rust + React）。90種類以上のプロバイダープリセットが用意されており、カスタムプロバイダーにも対応しています。

単なるキー切り替えツールではありません。

• Directモードでは、クライアントの設定ファイルにあるキー関連の項目を書き換え、クライアントがプロバイダーと直接通信します。
• Routingモードでは、127.0.0.1:15721でローカルゲートウェイを起動し、API形式の変換、フェイルオーバー、ヘルスチェック、リクエストログに対応します。
• Aggregationモードでは、複数のプロバイダーのモデルを1つの/modelリストにまとめます。

リポジトリとユーザーマニュアルはgithub.com/farion1231/cc-switchにあります。公式ダウンロード元はccswitch.ioとGitHub Releasesページのみです。支払いやアカウント認証情報を求めるサイトは公式ではありません。

始める前に

必要なものは3つです。

• Claude Codeがインストールされており、ターミナルから実行できること。claude --versionで確認できます。インストールされていない場合は、公式インストーラーcurl -fsSL https://claude.ai/install.sh | bashを使うか、Node.js 22以降でnpm i -g @anthropic-ai/claude-codeを実行してください。
• AIHubMixアカウントとAPIキー。AIHubMixコンソールで作成します。キーは通常sk-で始まります。
• CC Switchのインストーラー。ccswitch.ioまたはGitHub Releasesからダウンロードしてください。

ステップ1：CC Switchをインストールする

初回起動時、CC Switchは既存のClaude Code設定をdefaultという名前のプロバイダーとしてインポートし、公式プロバイダーも追加します。元の設定は失われず、いつでも元に戻せます。

Claude Codeがまだインストールされていない場合は、CC SwitchのAppsページからインストールまたはアップグレードできます。

ステップ2：AIHubMix APIキーを作成する

AIHubMixのAPIキーのページを開き、キーを作成してコピーします。

ドキュメント内のプレースホルダーAIHUBMIX_API_KEYは実際のキーではありません。そのまま貼り付けると、リクエストは401 invalid key: AIHUBMIX_API_KEYで失敗します。

ステップ3：Claude CodeにAIHubMixを追加する

1. 左側のサイドバーでClaude Codeを選択します。
2. 右上の+ボタンをクリックします。
3. AiHubMixを検索するか、サードパーティプラットフォームのカテゴリから見つけます。
4. 名前とエンドポイントは自動入力されます。エンドポイントはhttps://aihubmix.comです。API Keyにキーを貼り付けます。
5. Addをクリックします。

このプリセットには、2つの環境変数が設定されています。

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

プリセットではモデルは設定されません。AIHubMixのガイドではANTHROPIC_MODELを必須の変数として扱っているため、切り替える前に同じenvブロックに追加してください。

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

モデルを指定しないと、Claude Codeは独自のデフォルトモデル IDを送信します。このIDは、AIHubMixで提供されていない場合があります。

知っておくべき点が2つあります。

ベースURLの末尾に/v1を追加しないでください。Claude CodeはAnthropic Messagesプロトコルを使用し、リクエストパスを自分で組み立てます。正しいURLはhttps://aihubmix.comです。https://aihubmix.com/v1は他のクライアント向けのOpenAI互換ベースURLで、これを使うとClaude Codeが独自の/v1/messagesを末尾に追加してしまいます。

プリセットではANTHROPIC_API_KEYを使いますが、AIHubMixのClaude CodeガイドではANTHROPIC_AUTH_TOKENを使っています。AIHubMixはどちらにも対応しています。ANTHROPIC_AUTH_TOKENはBearerヘッダーを送信し、ANTHROPIC_API_KEYはx-api-keyを送信します。どちらか一方を選んでください。異なる値を両方に設定しないでください。AIHubMixのセットアップ情報、モデル ID、エラーのリファレンスについては、AIHubMix Claude Codeドキュメントをご覧ください。

プリセットが見つからない場合（古いリリースを使っている場合や、カードを削除した場合など）は、Custom Configurationを選択して、上記のJSONを貼り付けてください。プロバイダーカードのエンドポイントマネージャーでレイテンシをテストできます。また、aihubmix.comが名前解決できない場合に備え、プリセットには代替エンドポイントとしてhttps://api.aihubmix.comも含まれています。

ステップ4：切り替えて確認する

Directタブで、AiHubMixカードのSwitchをクリックします。設定が書き込まれると、ボタンがIn useに変わります。

Claude Codeは設定を自動的に再読み込みするため、通常は再起動する必要はありません。現在のセッションが古いプロバイダーを使い続ける場合は、終了して起動し直してください。

最初から最後までの接続を確認しましょう。

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

2と返ってくれば、リクエストはAIHubMixに到達しています。対話セッションでは、/statusのAnthropic base URLの行にhttps://aihubmix.comと表示されるはずです。

素早く切り替えるには、システムトレイを使います。CC Switchのアイコンを右クリックし、Claude Codeのサブメニューを開いて、プロバイダーをクリックしてください。サブメニューのタイトルには、現在有効なプロバイダーとクォータの概要が表示されます。

公式プロバイダーに戻すには、Claude Officialに切り替えてClaude Codeを再起動し、ログイン手続きを完了してください。

切り替えで実際に変更される内容

Directモードでは、CC Switchは~/.claude/settings.jsonの接続・互換性に関する項目のみを置き換えます。対象はANTHROPIC_*、AWS_*、CLAUDE_CODE_USE_BEDROCKなどのプロトコル選択項目、model、apiKeyHelper、およびCLAUDE_CODE_DISABLE_ARTIFACTやコンテキストウィンドウなど、プロバイダーごとの互換性オプションの一部です。

permissions、hooks、enabledPlugins、statusLine、MCP設定、コメントなど、その他に追加した内容はそのまま残ります。対象項目の正確な一覧は、設定ファイルのリファレンスをご覧ください。

CC Switchは、ツールの設定を書き換える前に、元のファイルを~/.cc-switch/backups/live-first-write/にバックアップします。JSONの形式が正しくない場合は書き込みを中止し、行と列を報告して、ファイルを変更せずに残します。

落とし穴：古いANTHROPIC_*環境変数

これは、CC Switchが動作しなかったように見える原因となる問題です。

以前、手動セットアップのガイドに従ってexport ANTHROPIC_BASE_URL=...やexport ANTHROPIC_AUTH_TOKEN=...を~/.zshrcまたは~/.bash_profileに追加していると、その環境変数がCC Switchの書き込んだ値を上書きする場合があります。カードをAIHubMixに切り替えても、リクエストは古いエンドポイントに送られ続けます。

CC Switchはこの競合を検出します。ウィンドウ上部に、環境変数が設定を上書きしている可能性があるという黄色いバナーが表示され、詳細には変数名、値、参照元が示されます。Delete Selectedをクリックすると、削除前に~/.cc-switch/backups/env-backup-<timestamp>.jsonへバックアップを作成してから、該当する変数を削除します。

手動で確認するには、次のようにします。

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

古いexport文をコメントアウトし、source ~/.zshrcを実行するか、新しいターミナルを開きます。AIHubMixのドキュメントでは、CC Switchで設定を管理する場合、グローバルなANTHROPIC_*環境変数を削除することを推奨しています。競合の解消手順については、環境変数のリファレンスをご覧ください。

モデルのエイリアスと切り替え

ANTHROPIC_MODELを設定すると、Claude CodeのデフォルトはSonnet 5.5になります。/modelのエイリアス（opus、sonnet、haiku、fable）をAIHubMixのモデル IDに解決させたい場合は、マッピングも必要です。次のキーをenv内に追加してください。

プロバイダーの設定全体は、次のようになります。

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

モデル選択の優先順位（上ほど優先度が高い）：/model <name> → claude --model <name> → ANTHROPIC_MODEL → settings.jsonのmodelフィールド。モデル IDはAIHubMixのモデル一覧からコピーしてください。大文字と小文字は区別されます。

RoutingやAggregationを使う場面

AIHubMixでは、Directモードが基本の選択肢です。エンドポイントはすでにAnthropic Messagesに対応しているため、プロトコル変換は必要ありません。

フェイルオーバーキューを使いたい場合や、OpenAI形式のプロバイダーをClaude Codeの背後に接続する必要がある場合は、Routingを使います。RoutingではClaude Codeの接続先をhttp://127.0.0.1:15721にし、設定内のキーをPROXY_MANAGEDに置き換えて、CC Switchから実際のキーを挿入します。アプリは起動したままにする必要があります。CC Switchを終了すると、Direct設定に戻ります。公式ClaudeのサブスクリプションはRouting経由では利用できないため、その場合はDirectモードを使ってください。

集約は、複数のプロバイダーのモデルを1つの/modelリストにまとめたい場合に使います。デフォルトのプロバイダーはプレフィックスなしのリクエストを処理し、ほかのプロバイダーのモデルにはccs-プレフィックスが付きます。集約ではフェイルオーバーは行われません。利用できるのはClaude CodeとCodexのみで、Claude公式サブスクリプションは集約に対応していません。ccs-のモデルリストを使うには、Claude Code 2.1.243以降が必要です。Claude Codeではモデルリストの変更が即座に反映されますが、Codexでは完全な再起動が必要です。

CC Switchで管理できるその他の項目

• 使用状況：ダッシュボードでは、ルーティングされたリクエストのログとローカルセッションのログをまとめて確認できます。ルーティングを使わずにセッションをスキャンすることもでき、料金はログに記録されたモデルに基づいて計算されます。ルーティングされたリクエストは別途ログに記録されます。
• MCP：MCPサーバーを一元管理でき、選択したアプリに同期されます。
• スキル：スキルを1か所で検索、インストール、削除できます。
• セッション：ローカルセッションを検索、表示、エクスポートし、再開できます。
• プロジェクト：プロジェクトのプロバイダー、MCPサーバー、スキル、メモリファイルをスナップショットとして保存し、プロジェクトごとに一式を切り替えられます。

データは~/.cc-switch/に保存され、SQLiteデータベースがその中心となります。自動バックアップでは、デフォルトで最新の10件が保持されます。また、WebDAVまたはS3互換の同期も利用できます。データベースとエクスポートしたバックアップには、キーを含むプロバイダー設定が含まれるため、秘密情報として取り扱ってください。

トラブルシューティング

以下のエラーメッセージは、AIHubMixのClaude Codeドキュメントから引用しています。

エラー以外の症状について：

• ログイン画面が表示される、またはNot logged inと表示される：/statusを確認してください。Settings → App config → Claude CodeでSkip Claude Code first-run confirmationを有効にし、再起動して、キーが入力されていることを確認してください。
• 切り替えても反映されない：シェル変数が古いままか、セッションがキャッシュされています。新しいターミナルを開くか、Claude Codeを再起動してください。
• カードの接続テストは成功するのにリクエストが失敗する：テストで確認するのは接続性であり、キーやモデルではありません。エンドツーエンドでclaude -pコマンドを実行してください。
• 公式プロバイダーに戻したい：Claude Officialに切り替え、Claude Codeを再起動して、もう一度ログインしてください。

macOSでclaudeコマンドが見つからない場合、公式インストーラーによって通常~/.local/bin/claudeに配置されています。シェルのプロファイルにexport PATH="$HOME/.local/bin:$PATH"を追加し、新しいターミナルを開いてください。

チェックリスト

• [ ] ccswitch.ioまたはGitHub ReleasesからCC Switchをインストールする。
• [ ] AIHubMixコンソールでAPIキーを作成する。
• [ ] Claude Code → + → AiHubMix → キーを貼り付け → 追加。
• [ ] プロバイダーのJSONにANTHROPIC_MODEL=claude-sonnet-5-5を追加する。
• [ ] 切り替えをクリックし、カードに使用中と表示されることを確認する。
• [ ] シェルのプロファイルから古いANTHROPIC_*のエクスポート設定を削除する。
• [ ] claude -p "1+1, output only the answer" --model claude-sonnet-5-5を実行し、2が返ることを確認する。

最後のコマンドが2を返せば、プロバイダーの切り替えは完了です。あとは、使いたいモデルのエイリアスを追加し、ルーティングや集約が必要かどうかを決めるだけです。ほとんどのAIHubMixユーザーには、ダイレクトモードで十分です。

よくある質問

CC Switchは無料ですか？
はい。MITライセンスのオープンソースソフトウェアです。料金が発生するのは、利用するプロバイダーのAPIだけです。

切り替えると、フック、MCPサーバー、プラグインは削除されますか？
いいえ。ダイレクト切り替えで置き換わるのは、エンドポイント、キー、モデル、およびプロバイダー固有の一部のオプションです。フック、権限、MCPサーバー、プラグイン、ステータスラインの設定はファイルに残ります。

CC SwitchはAPIキーをアップロードしますか？
プロバイダー設定はローカルの~/.cc-switch/cc-switch.dbに保存されます。WebDAVまたはS3同期を有効にした場合は、自分で管理するストレージに同期されます。データベースとバックアップにはキーが含まれるため、秘密情報として取り扱ってください。

CC Switchを起動したままにしておく必要がありますか？
ダイレクトモードでは必要ありません。ルーティングと集約にはアプリの起動が必要です。CC Switchを終了すると、クライアントはダイレクトモードに戻ります。

Claude OfficialとAIHubMixを同時に使えますか？
ダイレクトモードでは、一度に有効にできるプロバイダーは1つです。集約では複数のプロバイダーのモデルを1つのリストにまとめられますが、Claude公式サブスクリプションには対応していません。利用するにはダイレクトモードに戻してください。

Windowsで使えますか？
はい。CC SwitchはWindows 10以降に対応しており、.msiインストーラーまたはポータブル版を利用できます。Linuxではglibc 2.35以降とWebKitGTK 4.1が必要です。

プロバイダーカードには接続正常と表示されるのに、Claude Codeが失敗するのはなぜですか？
カードの接続確認では、エンドポイントに到達できるかどうかをテストします。APIキーやモデルの有効性は検証しません。エンドツーエンドでclaude -pコマンドを実行し、全体の経路をテストしてください。

出典

• CC Switchリポジトリ
• CC Switchユーザーマニュアル：プロバイダーの追加
• CC Switchユーザーマニュアル：プロバイダーの切り替え
• CC Switchユーザーマニュアル：設定ファイル
• AIHubMixドキュメント：Claude Code