跳到主要内容

附录 B：常见坑位清单

本页中的 {baseUrl} 是平台 API 根地址（不含末尾 / 或 /v1），使用前请替换为实际地址。模型、价格和界面以当前控制台及客户端版本为准。

配置出错时，按这个清单逐条排查，能覆盖绝大多数情况：

  1. /v1 该不该带——工具要求"Base URL"就带，工具会自动补就不带，Claude Code 一定不带
  2. Bearer 后面有空格——Authorization: Bearer sk-xxx，中间一个空格
  3. 两种令牌不通用——sk- 调模型，access_token 调 /api/
  4. 分组与模型不匹配——用不到的模型往往是因为令牌分组不对
  5. 模型名区分大小写——GLM-5.3 和 glm-5.3 是平台里两个不同的条目
  6. 环境变量改完没重开终端——Windows 尤其容易踩
  7. ANTHROPIC_AUTH_TOKEN 写成了 ANTHROPIC_API_KEY——Claude Code 认前者
  8. 把密钥提交进了 Git——在 控制台吊销并重建
  9. 客户端缓存了旧配置——改完配置重启客户端，而不是只关窗口
  10. 异步任务用不同密钥查询——task_id 与 API Key 绑定