通用排查顺序
01
先看请求有没有到达后台
QuickRouter 后台没有请求记录时，优先查 Base URL、网络代理、provider 类型和本地配置是否生效。
02
再看返回码和模型名
后台有请求记录但失败时，重点看 401、429、404、model not found、provider error 这类返回信息。
03
最后处理工具缓存
Claude Code、Cursor、opencode、Codex 都可能读取旧配置，保存后建议重启工具或重新打开终端。
Error Fix Hub
AI 编程工具报错修复
围绕 Claude Code、opencode、Cursor、Codex、Cherry Studio、Trae 六个高频工具，按错误信息定位 API Key、Base URL、模型名和限流问题。
高频报错入口
先覆盖最容易带来搜索流量和转化的报错词：API Key、Base URL、provider、模型名、限流。
Claude Code
API Error 429
429 通常不是本地安装问题，而是请求频率、额度或上游限流触发。先确认当前 Key 有余额，再降低并发或切换到 QuickRouter 的稳定中转端点。
Claude Code
API Error 401
401 优先检查令牌是否复制完整、环境变量是否被当前 shell 读取，以及 Base URL 是否使用 Claude Code 对应的根地址。
Cursor
Unable to reach model provider
这个报错优先看 Base URL。Cursor 的 OpenAI 兼容配置应使用 /v1 结尾，并确认当前网络能访问该地址。
opencode
AI_APICallError
AI_APICallError 是 opencode 的通用外层错误，需要同时看 provider、baseURL、model 和 auth.json 是否一致。
Cherry Studio
fetch models failed
获取模型失败并不代表聊天接口不能用，但通常说明 Base URL、Key 或服务商类型至少有一项不对。
Trae
model request failed
Trae 的 model request failed 通常是 OpenAI 兼容配置没有完全填对，先检查 Base URL、Key 和 Model 三项。
Claude Code
Claude Code 常见 API Key、Base URL、限流和模型名报错修复。
4 个报错修复 →
opencode
opencode 终端调用模型时的 provider、auth.json 和模型配置报错修复。
4 个报错修复 →
Cursor
Cursor 自定义模型、OpenAI 兼容接口和 provider 连接失败报错修复。
4 个报错修复 →
Codex
Codex CLI 的 API Key、config.toml、auth.json 和 provider 报错修复。
4 个报错修复 →
Cherry Studio
Cherry Studio 添加模型、拉取模型列表和 Base URL 配置报错修复。
4 个报错修复 →
Trae
Trae Builder 自定义模型、API Key 和 Base URL 报错修复。
4 个报错修复 →
六个工具的配置差异
- Claude Code 通常使用 https://api.quickrouter.ai，不要直接套 OpenAI 兼容工具的 /v1 配置。
- Cursor、opencode、Codex、Cherry Studio、Trae 多数按 OpenAI Compatible 接入，Base URL 通常是 https://api.quickrouter.ai/v1。
- 遇到 model not found，先统一用 claude-sonnet-4-6 做连通性测试，再切回其他模型。
- 遇到 429 或 overloaded，先停掉 Agent 自动重试，拆小任务后再跑。