常见报错与接入排查
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。