Skip to content

可复制本页去问 AI。把现象、你填的 Base URL、变量名一起贴出去;不要贴完整 Key。

常见报错 ​

接不上时先看这一页。Cursor 和 Claude Code 的变量名、Base URL 坑见 Cursor 与 Claude Code 坑。

先按状态码定位 ​

看到的大致是什么先去哪一节
401 / unauthorized没带对 Key401 / 未授权
模型不可用 / 无权限Key 的分组与模型不匹配模型不存在 / 无权限
429请求太快或额度受限429 限速与额度
504 / 522上游或网关连接超时504 / 522 超时
200 但没有内容上游返回空或被中断200 但回复是空的
账单里出现 Haiku 等小模型客户端内部发的辅助短请求账单里为什么出现小模型

401 / 未授权 ​

现象: 客户端提示 401、unauthorized、invalid api key,或要求重新登录。

常见原因:

  • 还是占位符 你的API密钥,没有换成仪表盘里的真 Key
  • 变量名写错。Claude Code 要用 ANTHROPIC_AUTH_TOKEN,不是 ANTHROPIC_API_KEY
  • Key 已作废、贴错,或复制时带了空格换行

怎么改:

  1. 回 用户仪表盘密钥页 确认 Key 仍有效,需要的话新建一把。步骤以控制台为准。
  2. 按 创建 API Key 把 Key 贴到对应客户端,不要混用 Codex / Claude Code / Gemini 的字段名。
  3. 保存后重启终端;若在 VS Code / Cursor 的集成终端里用,必须彻底重启整个 IDE。

连不上 ​

现象: 超时、connection refused、无法解析主机,或一直转圈。

常见原因:

  • Base URL 填错。按协议:Claude 用 https://aicode.cat(不要加 /v1);GPT 用 https://aicode.cat/v1;Gemini 用 https://aicode.cat/v1beta。Cherry Studio / OpenCode 要按模型分别填,不能三个服务共用一个地址
  • 本机代理、公司网络拦了 aicode.cat
  • 只改了配置文件,当前进程还在用旧环境变量

怎么改:

  1. 对照 5 分钟接入 的表格,按客户端核对 Base URL。
  2. 浏览器能打开 https://aicode.cat 再回头测客户端。
  3. 改完后重启终端或 IDE,见上一节。

模型不存在 / 无权限 ​

现象: model not found、模型不存在、该模型不可用、没有权限。

常见原因:

  • Key 绑定的分组与所选模型不匹配(例如拿 Codex 分组的 Key 调 Claude 模型)
  • 创建 Key 时勾选了「可用模型限制」,把当前模型拦在外面
  • 填了客户端自带的官方模型名,或 Cursor 等编辑器拦截了官方模型名(见 IDE 坑)
  • 模型名抄错、多了空格

怎么改:

  1. 按 创建 API Key 的 6 步排查顺序核对 Key 分组、额度上限、过期时间和可用模型限制。
  2. 模型名以控制台/主站为准,不要从第三方截图抄。
  3. Cursor 里改用短名或自定义模型,细节见 IDE 坑。

429 限速与额度 ​

现象: 429 Too Many Requests、rate limit、quota exceeded。

常见原因:

  • 短时间并发太高,触发通道限流
  • 当前 Key 设了额度上限且已用完,或账户余额不足

怎么改:

  1. 稍等几秒重试,降低客户端并发。
  2. 去 用户仪表盘密钥页 检查这把 Key 的额度上限、过期时间以及账户余额。

504 / 522 超时 ​

现象: 504 Gateway time-out 或 522 Connection timed out。

常见原因:

  • 504 多见于单次任务太重、模型思考或生成时间过长导致网关超时
  • 522 多见于瞬时连接波动(不要急着改配置)

怎么改:

  1. 等 1~2 分钟后发一句「继续」,先看工作区里有没有已经写了一半的文件,避免重复干活。
  2. 把超大任务拆成几步(例如「先读结构 → 再改模块 → 最后跑测试」)。

200 但回复是空的 ​

现象: API returned an empty or malformed response (HTTP 200)、0 bytes,发「继续」只回 No response requested。

怎么改:

  1. 稍等片刻重试一次;如果同一会话连续发「继续」都空回,直接新开一个会话(/new 或重进客户端) 重新发任务。
  2. 顺手确认 Base URL 后缀没填串(Claude 用 https://aicode.cat 不加 /v1,GPT/Grok 用 https://aicode.cat/v1,Gemini 原生用 https://aicode.cat/v1beta)。

账单里为什么出现小模型 ​

现象: 明明选的是 Opus 或 GPT 主力模型,账单/日志里却有 Haiku、codex-auto-review 等其他模型记录。

原因: 这是客户端的正常机制,不是串号:

  • Claude Code / Claude 桌面版 会自动用便宜快速的小模型(如 Haiku)生成会话标题、压缩长上下文,内置 Explore 等子代理也会按各自设定调模型。
  • Codex 会在后台调辅助模型生成标题(/resume)、压缩上下文(/compact)、做代码审查(/review)和整理搜索结果。

改了配置没生效 ​

现象: 文件已经改了,工具还是旧报错,或仍走官方登录。

常见原因: 终端没重启;IDE 集成终端只关了标签,没退出编辑器。

怎么改:

  1. 关掉当前终端窗口,新开一个。
  2. 在 VS Code / Cursor 里用客户端时,退出整个 IDE 再打开,不只是重开终端面板。Claude Code、Codex、Gemini CLI 安装页都写了这一条。
  3. 确认改的是安装页给出的那份文件(例如 Claude Code 的 settings.json,不是别的项目里的 .env)。

已解决? ​