Reference

路径、变量与排错速查

这一页不负责教学，只负责让你在出错时快速比对当前配置和最小排查路径。

常见配置路径

Claude Code ~/.claude/settings.json 或 Windows 下的 %USERPROFILE%/.claude/settings.json
Claude Code 首次引导 ~/.claude.json
Codex auth.json 与 config.toml
统一入口 https://convertmodel.net

最小排查顺序

  1. 先看客户端发出的模型名和协议类型。
  2. 再看 key 类型与分组是否和这条链路匹配。
  3. 再确认当前站点的网关路由或 alias 映射是否已经调整。
  4. 最后才去查账号容量、过滤条件和错误日志。

最常见错误

503 No available accounts 优先查模型名、key 分组、账号容量和过滤条件。这类错误大多不是客户端安装问题。
无使用记录 请求可能在调度前失败，因此没有生成完整使用流水。
模型行为异常 先确认 alias 和 provider，再核对当前站点是否调整了映射目标。
客户端启动但无法调用 先比对 Base URL、认证字段名和文件路径是否正确，再查日志。