错误排查中心
先看 HTTP 状态码，再看 Base URL、模型名、Key、客户端 Provider。
1. 快速定位表
| 错误 | 常见原因 | 处理 |
|---|---|---|
| 401 Unauthorized | Key 错、过期、没带 Bearer | 重新复制 key，确认 Header |
| 403 Forbidden | 账号权限或模型权限不足 | 确认账号是否开通该模型 |
| 404 Not Found | Base URL 或 endpoint 错 | GPT 用 /v1，Claude Code 用根地址 |
| model not found | 模型名拼错或未开通 | 使用模型矩阵里的模型 ID |
| 429 Rate limit | 请求过快或额度不足 | 降低并发，检查额度 |
| 500 / 502 / 503 | 上游或网关临时错误 | 重试，记录 request id 联系支持 |
| timeout | 网络、代理、输入太大 | 缩短输入，检查代理和网络 |
| stream interrupted | 流式连接被代理中断 | 关闭中间代理缓冲或改非流式验证 |
2. GPT 检查顺序
export OPENAI_API_KEY="your_synterolink_key"
curl -i https://api.synterolink.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY"如果 /v1/models 不通，不要先改 VS Code；先修 key、网络或 Base URL。
3. Claude Code 检查顺序
export ANTHROPIC_BASE_URL="https://api.synterolink.com"
export ANTHROPIC_AUTH_TOKEN="your_synterolink_key"
claude --model claude-sonnet-4-6 -p "Reply exactly: OK"如果仍然走官方 Anthropic，通常是环境变量没有在当前终端生效。
4. VS Code / Cursor 不生效
- 检查插件 Provider 是否选对。
- 检查 Base URL 是否粘贴完整。
- 检查 Model 是否精确等于模型 ID。
- 重启插件窗口或 VS Code。
- 用终端 curl 证明 API 已通，再排查插件。
5. 如何向支持提供信息
请提供这些信息，不要提供真实 key：
- 工具名称：VS Code / Cursor / Claude Code / CLI
- Provider 类型：OpenAI-compatible 或 Anthropic-compatible
- Base URL
- 模型 ID
- HTTP 状态码
- 错误片段
- 大概时间
6. 安全提醒
排查时不要截图暴露完整 key。如果必须截图，请先遮挡 key 中间部分。