FAQ

本页汇总 CatAPI 官方 FAQ 中常见问题的处理思路。来源参考：FAQ、Codex FAQ

Claude Code 无法连接

优先检查：

  • ANTHROPIC_AUTH_TOKEN 是否是 CatAPI 令牌。
  • ANTHROPIC_BASE_URL 是否指向 CatAPI。
  • 当前 shell 是否读取到了新环境变量。
  • 模型名是否属于 Claude 或 CC 分组。

Codex CLI 报错

优先检查：

  • OPENAI_API_KEY 是否存在。
  • Codex CLI 当前 profile 是否使用 CatAPI provider。
  • base_url 是否包含客户端要求的 /v1。
  • wire_api 或接口类型是否和当前 Codex CLI 版本匹配。

如何确认请求走了 CatAPI

可以从三个方向确认：

  1. CLI 日志中是否出现 CatAPI 地址。
  2. CatAPI 后台是否产生请求或额度变化。
  3. 断开官方服务配置后，客户端是否仍能调用成功。

常见错误对照

错误常见原因
unauthorized令牌错误、未设置环境变量、复制时多了空格。
model not found模型名不属于当前分组，或客户端改写了模型名。
insufficient balance余额不足或令牌权限受限。
connection timeout网络、代理、DNS 或防火墙问题。
invalid base url客户端要求根地址或 /v1 地址，但填写方式不匹配。