コンテンツへスキップ
開発者向けリソース
開発者向けリソース

CC Switch

CC Switch をインストールし、RunAPI の Claude Code プロバイダーを追加して、モデルを選択し、接続を確認します。

概要

CC Switchはコーディングツールプロバイダーを管理するデスクトップアプリケーションです。このガイドでは、シェルプロファイルやプロジェクトファイルを手動で編集することなく、そのClaude Code ProviderをRunAPIに接続します。

始める前に

  • Claude Codeをインストールし、RunAPIアカウントにサインインしてください。
  • 認証ガイドで標準APIキーを作成してください。CC Switchに保管し、ソースコントロールには追加しないでください。
  • この接続で利用可能なRunAPIのモデル識別子を使用してください。CC Switchから選択するか、モデルカタログからコピーできます。

インストール

Windows、macOS、またはLinux向けの公式リリースからCC Switchをダウンロードします。macOSでHomebrewを使用する場合は、以下のコマンドでインストールできます:

SHELL
brew install --cask cc-switch

インストール後にCC Switchを開き、アプリスイッチャーでClaude Codeを選択してください。

RunAPIを設定する

  1. プロバイダーを追加を選択し、カスタムプリセットを選択します。
  2. プロバイダー名を RunAPI とし、設定エディターに API キーとベース URL を入力します:
JSON
{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_BASE_URL": "https://runapi.ai"
  }
}

上記のAPIキーはプレースホルダーです。実際のキーの作成とローテーションは認証ガイドを通じて行ってください。

モデルを選択する

  1. モデルを取得は候補の検出のみに使用します。モデルが一覧にない場合は、モデルカタログから識別子をコピーします。取得操作では Claude Code リクエストロールへのモデルの割り当ては行われません。
  2. 選択した識別子をデフォルトのフォールバックモデルとして設定し、クイック設定を選択します。これにより、すべての実際のリクエストモデル行(Sonnet、Opus、Fable、Haiku、Subagent)に識別子が適用されます。
  3. 保存前に、すべての行に意図した RunAPI 識別子が表示されていることを確認します。CC Switch はこのマッピングを ANTHROPIC_MODELANTHROPIC_DEFAULT_SONNET_MODELANTHROPIC_DEFAULT_OPUS_MODELANTHROPIC_DEFAULT_FABLE_MODELANTHROPIC_DEFAULT_HAIKU_MODEL、 および CLAUDE_CODE_SUBAGENT_MODEL として保存します。
  4. プロバイダーを保存し、プロバイダー一覧で選択してアクティブにします。

検証

プロジェクトディレクトリで新しいターミナルを開き、Claude Codeを起動してください:

SHELL
claude

/statusを実行してアクティブなモデルを確認し、Describe this repository in one sentence.などの短いプロンプトを送信してください。通常のレスポンスが返れば、CC SwitchがアクティブなRunAPI Providerを使用していることが確認されます。

トラブルシューティング

  • 認証に失敗する: アクティブな CC Switch プロバイダーの API キーを確認し、必要であれば認証ガイドから新しいキーを作成してください。
  • 期待するモデルが利用できない: モデルセレクターを更新するか、モデルカタログからサポートされているモデル識別子をコピーし、デフォルトフォールバックモデルとして設定して再度 Quick Set を選択してください。
  • Claude Code が別のプロバイダーを使い続ける: CC Switch で RunAPI プロバイダーを有効化し、新しいターミナルセッションを開いてください。環境の競合については CC Switch のプロバイダードキュメントを確認してください。

次のステップ

プロトコルの選択とリクエストの動作については、LLM API クイックスタートを参照してください。リクエストおよびレスポンスのフィールドについては、Anthropic Messages API リファレンスを参照してください。Claude Code に RunAPI ツールを追加するには、MCP 概要に進んでください。