Claude Code 問題排查
Claude Code 的排查重點是確認它是否拿到了 Claude / Anthropic 這一套配置。不要把 OpenAI 兼容地址、Codex 模型名或 Gemini Key 混到 Claude Code 裡。
先確認什麼
| 檢查項 | 怎麼看 | 為什麼 |
|---|---|---|
| 目標工具 | 確認你排查的是 Claude Code，而不是 Codex 或 Gemini CLI | 不同工具的配置文件、協議和模型名不一樣 |
| 服務商協議 | 後臺或教程裡明確寫了 Claude、Anthropic、Claude Code | 只提供 OpenAI 兼容接口的服務商不一定支持 Claude Code |
| Key 類型 | 使用 Claude / Anthropic 對應 Key | Key 類型不對會直接 401 或鑑權失敗 |
| 終端狀態 | 切換配置後重新打開終端再測 | 舊終端可能還在使用切換前的環境變量或配置 |
常見報錯
| 現象 | 優先檢查 | 處理方法 |
|---|---|---|
| 命令能打開，但請求失敗 | Claude Code 是否拿到新配置 | 關閉當前終端窗口後重新打開，再發最短測試問題。通過 CC-Switch 切換後，不要同時手動改同一份配置。 |
| 401 / Unauthorized | Key 類型和完整性 | 確認使用的是 Claude / Anthropic 對應 Key，不要把 OpenAI 兼容 Key 填到 Claude Code 裡；重新複製時檢查前後空格。 |
| 404 / model not found | Claude 模型名 | 按服務商後臺 Claude 模型列表原樣填寫，大小寫、短橫線、版本號都不要改。 |
| 連接超時或無響應 | Claude Base URL | 回後臺確認 Claude / Anthropic 接口地址；只給 OpenAI 兼容地址的服務商，不一定支持 Claude Code。 |
| 切換後仍走舊服務商 | 終端會話和配置來源 | 重開終端後再測；如果還不生效，確認 CC-Switch 當前 Provider 已應用到 Claude Code。 |
最小測試
測試時先發一句固定短問題，確認能返回後，再進入真實項目。
Claude Code 最小測試
claude "請只回覆：Claude Code 配置測試成功"反饋模板
給服務商反饋時這樣寫
工具名稱：Claude Code 系統版本： 服務商後臺 Base URL： 模型 ID / 模型名： 報錯原文： 我已經檢查過：Key 沒有空格 / 餘額正常 / 模型名照抄 / Base URL 按後臺填寫 / 已經重開終端