跳到主要內容
開發者資源
開發者資源

CC Switch

安裝 CC Switch，新增 RunAPI Claude Code Provider，選擇模型，並驗證連線。

檢視 Markdown

概覽

CC Switch 是一款用於管理程式碼工具供應商的桌面應用程式。本指南將其 Claude Code 供應商連接至 RunAPI，無需手動編輯您的 shell 設定檔或專案檔案。

開始之前

  • 安裝 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. 選取 Add Provider，然後選擇 Custom 預設值。
  2. 將提供者命名為 RunAPI，並在其設定編輯器中輸入您的 API 金鑰與 Base URL：
JSON 
{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_BASE_URL": "https://runapi.ai"
  }
}

上方的 API 金鑰僅為占位符。請透過身分驗證指南建立並輪換您的實際金鑰。

選擇模型

  1. 僅使用 Fetch Models 探索候選模型。若模型未列出，請從模型目錄複製其識別碼。擷取模型並不會將模型指派給 Claude Code 的請求角色。
  2. 將選定的識別碼設為 Default fallback model，然後選取 Quick Set。這會將該識別碼套用至每個 Actual Request Model 列：Sonnet、Opus、Fable、Haiku 與 Subagent。
  3. 儲存前，請確認每一列均顯示預期的 RunAPI 識別碼。CC Switch 會將此對應關係以 ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 及 CLAUDE_CODE_SUBAGENT_MODEL 的形式持久儲存。
  4. 儲存提供者，在提供者清單中選取它，然後將其啟用。

驗證

在專案目錄中開啟新的終端機並啟動 Claude Code：

SHELL 
claude

執行 /status 以檢視目前使用的模型，然後傳送一段簡短提示，例如 Describe this repository in one sentence.。收到正常回應即確認 CC Switch 正在使用有效的 RunAPI 提供者。

疑難排解

  • 身分驗證失敗： 請確認 CC Switch Provider 中的 API 金鑰是否正確，若有需要，請從身分驗證指南建立新的金鑰。
  • 預期的模型無法使用： 重新整理模型選擇器，或從模型目錄複製受支援的模型識別碼，將其設為預設備援模型，然後再次選擇 Quick Set。
  • Claude Code 仍然使用其他 Provider： 請在 CC Switch 中啟用 RunAPI Provider，然後開啟新的終端機工作階段。請查閱 CC Switch 的 provider 說明文件，以排查環境衝突問題。

後續步驟

如需協定選擇與請求行為，請參閱 LLM API 快速入門。如需請求與回應欄位，請參閱 Anthropic Messages API 參考。若要將 RunAPI 工具加入 Claude Code，請繼續閱讀 MCP 概覽。