參考
報錯速查
按錯誤信息快速排查協議、密鑰、模型和環境問題。
遇到報錯先在這裡對號入座，絕大多數問題 1 分鐘能自己解決：
| 你看到的報錯 | 原因 | 怎麼解決 |
|---|---|---|
| 404「當前平臺不支持該 API 路徑」 | Claude 套餐密鑰走了 OpenAI 協議（供應商類型選了 OpenAI Compatible，或把 Claude 密鑰填進了 Codex） | Claude 模型改選「Anthropic」類型供應商，地址用不帶 /v1 的 https://api.hop-base.com |
| 401 / invalid api key / 無效密鑰 | 密鑰複製不完整、被刪除，或帶進了多餘空格 | 回控制檯「密鑰管理」重新完整複製；必要時新建一把 |
| 「Model … is not supported / model_not_found」 | 模型不在你這把密鑰的套餐分組裡 | 對照上方「可用模型」或用該密鑰調 GET /v1/models，換模型 ID 或換對應套餐密鑰 |
| 「餘額不足 / insufficient balance」 | USD 餘額扣完了 | 控制檯充值後立即恢復，無需重新配置 |
| 「服務繁忙，請稍後再試」/ 502 | 該模型服務短暫波動 | 稍等重試；持續超過 10 分鐘聯絡我們 |
| 「node / npm 不是內部或外部命令」 | Node.js 沒裝好或沒進 PATH | 到 nodejs.org 重裝（Windows 安裝時保持默認勾選），裝完關掉終端重新開啟 |
| PowerShell 提示「禁止執行腳本」 | Windows 腳本執行策略限制 | 優先用控制檯「一鍵接入」的命令（不受影響）；或以系統管理員執行 Set-ExecutionPolicy RemoteSigned |
| 配置都對，但一直連不上 | 地址多打或少打了 /v1，或末尾多了空格、斜線 | 對照「快速開始」的核心參數表逐字核對：OpenAI 協議帶 /v1，Anthropic 協議不帶 |
按表排查後仍未解決？帶上報錯截圖 + 你用的工具名 + 大致時間聯絡我們，我們按調用日誌幫你定位。