CC-Switch Claude Code
這一頁只講一件事：在 CC Switch 裡新增或選擇一個 Provider，然後把它應用到 Claude Code。它不是 Claude Code 直連配置教程；如果你想直接改 Claude Code 配置文件，請看 Claude Code CLI 配置。
官方信息 下載和文檔以官方站點為準
這一頁講什麼
CC Switch 的作用是幫你集中管理 Provider，並把配置同步給目標工具。Claude Code 這一路要重點核對 Claude / Anthropic 協議、Key 和模型名，不要把 OpenAI 兼容地址直接當成 Claude 地址使用，除非服務商明確寫了它支持 Claude Code。
開始前確認
| 要確認的事 | 怎麼看 | 為什麼 |
|---|---|---|
| Claude Code 已能啟動 | 在終端或客戶端裡確認 Claude Code 能正常打開 | CC Switch 只負責切換配置，不負責安裝 Claude Code |
| 服務商支持 Claude Code | 後臺或文檔裡能看到 Claude / Anthropic / Claude Code 相關說明 | 只提供 OpenAI 兼容接口的服務商不一定能給 Claude Code 用 |
| Key 和模型名可用 | 後臺能看到令牌、Key、模型列表或可用模型說明 | 模型名寫錯會直接導致 model not found |
| 先只改一個目標工具 | 第一次只選擇 Claude Code | 排錯時更容易判斷是哪一項出問題 |
字段怎麼填
| 配置項 | 填寫方式 | 新手注意 |
|---|---|---|
| Provider 名稱 | 寫成容易識別的名稱 | 例如“主力中轉 Claude”，不要只寫數字 |
| 目標工具 / Preset | 選擇 Claude Code 或 Claude 相關預設 | 不要選成 Codex、OpenAI 或 Gemini |
| Base URL | 複製服務商後臺給 Claude / Anthropic 使用的 API 鏈接 | 不是所有服務商都和 OpenAI 共用同一個 Base URL |
| API Key | 複製後臺生成的完整 Key | 它也常被叫作令牌、Key、密鑰 |
| 模型名 | 照抄後臺支持的 Claude 模型名 | 不要自己縮寫，也不要把展示名改成模型名 |
如果服務商後臺把不同協議分開寫，Claude Code 就用 Claude / Anthropic 那一組。只有後臺明確說明“Claude Code 使用 OpenAI 兼容地址”時，才按它的說明填寫。
應用到 Claude Code
- 打開 CC Switch，進入 Provider 管理區域。
- 新增 Provider，或者選擇你已經創建好的服務商配置。
- 目標工具選擇 Claude Code 相關預設。
- 依次填寫 Provider 名稱、Base URL、API Key、模型名。
- 保存後執行 Apply / Switch，把當前 Provider 應用到 Claude Code。
- 如果頁面提示需要重啟終端或目標工具，就關閉當前 Claude Code 會話後重新打開。
測試是否生效
測試時先發一個極短問題，不要直接打開真實項目。只要能正常返回，就說明 Key、Base URL、模型名和目標工具同步基本可用。
Claude Code 最小測試
claude "請只回覆：CC-Switch Claude Code 已生效"如果測試失敗，優先按這個順序查：目標工具是否選錯、Base URL 是否對應 Claude / Anthropic、Key 是否複製完整、模型名是否照抄後臺。