AiCodeCat Docs

主题

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

常见报错 ​

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

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 没有这个模型
  • Cursor 等编辑器可能拦截官方模型名（见 IDE 坑）
  • 模型名抄错、多了空格

怎么改：

  1. 模型名以控制台/主站为准，不要从第三方截图抄。
  2. Cursor 里改用短名或自定义模型，细节见 IDE 坑。
  3. 仍失败就把报错原文（去掉 Key）留着，对照该客户端安装页再核一次。

改了配置没生效 ​

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

常见原因： 终端没重启；IDE 集成终端只关了标签，没退出编辑器。

怎么改：

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

已解决？ ​