参考
报错速查
按错误信息快速排查协议、密钥、模型和环境问题。
遇到报错先在这里对号入座，绝大多数问题 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 协议不带 |
按表排查后仍未解决？带上报错截图 + 你用的工具名 + 大致时间联络我们，我们按调用日志帮你定位。