ai2saveai2save

常见报错与接入排查

401 / invalid_api_key

确认请求发往本站 Base URL,并且 Authorization 使用 Bearer sk-...。检查 Key 是否完整、是否被撤销、所属分组是否正确。

404 / model not found

依次检查模型 ID、协议地址和 Key 分组。OpenAI Compatible 通常使用带 /v1 的地址;Claude Code 通常使用不带 /v1 的根地址。

403 或风控拦截

给脚本设置明确的 User-Agent,降低空 User-Agent 被网关拦截的概率。不要通过不断重试绕过限制。

请求很慢

先用短问题测试。如果短问题很快而复杂任务很慢,通常是上下文或模型推理耗时;如果短问题也慢,再检查本地网络、线路和服务状态。

连接成功但客户端没有变化

完全退出客户端后重新打开。检查是否存在多个配置文件、旧环境变量覆盖新配置,或 CC Switch 没有真正启用目标供应商。

上线前检查清单

  • 用最小请求验证 Key、Base URL、模型三项。
  • 设置超时、重试、并发和预算上限。
  • 准备备用线路或备用模型。
  • 日志脱敏,不记录完整 Key。