主题
可复制本页去问 AI。把现象、你填的 Base URL、变量名一起贴出去;不要贴完整 Key。
常见报错
接不上时先看这一页。Cursor 和 Claude Code 的变量名、Base URL 坑见 Cursor 与 Claude Code 坑。
先按状态码定位
| 看到的 | 大致是什么 | 先去哪一节 |
|---|---|---|
| 401 / unauthorized | 没带对 Key | 401 / 未授权 |
| 模型不可用 / 无权限 | 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 已作废、贴错,或复制时带了空格换行
怎么改:
- 回 用户仪表盘密钥页 确认 Key 仍有效,需要的话新建一把。步骤以控制台为准。
- 按 创建 API Key 把 Key 贴到对应客户端,不要混用 Codex / Claude Code / Gemini 的字段名。
- 保存后重启终端;若在 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 - 只改了配置文件,当前进程还在用旧环境变量
怎么改:
- 对照 5 分钟接入 的表格,按客户端核对 Base URL。
- 浏览器能打开 https://aicode.cat 再回头测客户端。
- 改完后重启终端或 IDE,见上一节。
模型不存在 / 无权限
现象: model not found、模型不存在、该模型不可用、没有权限。
常见原因:
- Key 绑定的分组与所选模型不匹配(例如拿 Codex 分组的 Key 调 Claude 模型)
- 创建 Key 时勾选了「可用模型限制」,把当前模型拦在外面
- 填了客户端自带的官方模型名,或 Cursor 等编辑器拦截了官方模型名(见 IDE 坑)
- 模型名抄错、多了空格
怎么改:
- 按 创建 API Key 的 6 步排查顺序核对 Key 分组、额度上限、过期时间和可用模型限制。
- 模型名以控制台/主站为准,不要从第三方截图抄。
- Cursor 里改用短名或自定义模型,细节见 IDE 坑。
429 限速与额度
现象: 429 Too Many Requests、rate limit、quota exceeded。
常见原因:
- 短时间并发太高,触发通道限流
- 当前 Key 设了额度上限且已用完,或账户余额不足
怎么改:
- 稍等几秒重试,降低客户端并发。
- 去 用户仪表盘密钥页 检查这把 Key 的额度上限、过期时间以及账户余额。
504 / 522 超时
现象: 504 Gateway time-out 或 522 Connection timed out。
常见原因:
504多见于单次任务太重、模型思考或生成时间过长导致网关超时522多见于瞬时连接波动(不要急着改配置)
怎么改:
- 等 1~2 分钟后发一句「继续」,先看工作区里有没有已经写了一半的文件,避免重复干活。
- 把超大任务拆成几步(例如「先读结构 → 再改模块 → 最后跑测试」)。
200 但回复是空的
现象: API returned an empty or malformed response (HTTP 200)、0 bytes,发「继续」只回 No response requested。
怎么改:
- 稍等片刻重试一次;如果同一会话连续发「继续」都空回,直接新开一个会话(
/new或重进客户端) 重新发任务。 - 顺手确认 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 集成终端只关了标签,没退出编辑器。
怎么改:
- 关掉当前终端窗口,新开一个。
- 在 VS Code / Cursor 里用客户端时,退出整个 IDE 再打开,不只是重开终端面板。Claude Code、Codex、Gemini CLI 安装页都写了这一条。
- 确认改的是安装页给出的那份文件(例如 Claude Code 的
settings.json,不是别的项目里的.env)。