Teapot Router / 使用文档
Claude Code 排错速查：连不上、401、额度
按报错类型对号入座：网络与代理、Key 与地址、余额与额度，三类问题三种排查法。
打开工作台连不上/超时：先查网络链路
- CLI 不走系统代理：终端里 `echo $https_proxy` 看一眼，为空说明代理没传给 CLI，export 之后再试。
- VSCode 插件有独立网络栈，系统代理和环境变量都不一定继承——在插件设置里单独配置代理。
- 用了自定义端点的，核对 ANTHROPIC_BASE_URL 是否多打/少打字符或斜杠；直连官网与直连网关的地址不要混用。
换个网络（如手机热点）能通、原网络不通，就是纯网络问题，与 Key 无关。
401/403：查 Key 与地址
- 401 优先查 Key：是否复制完整（首尾空格）、是否已撤销或过期、是否填的是别家的 Key。
- 自定义端点场景：Key 与地址必须配套——A 家的 Key 配 B 家的地址必然 401。
- settings.json 的 env 段写错字段名时，客户端可能静默回退默认端点，表现为「看起来配置了但仍连官方」。
撤销过的 Key 不会自动恢复；换新 Key 后重启客户端。
429、额度与模型不可用
- 429 是限频：等窗口重置或降低并发；持续 429 说明该模型有速率限制。
- 「额度不足」分两层查：账户余额、这把 Key 的独立额度——独立额度是这把 Key 的使用上限，不是额外充值。
- 「模型不存在」：核对客户端里填的模型 ID 与「模型」目录显示的可用 ID 完全一致（大小写与版本号）。
每次请求的模型/Token/费用在「用量记录」逐笔可查——报错排查完顺手对一笔账，确认没有静默重试的重复扣费。