Skip to content

创建 API Key ​

文档站不内嵌控制台。Key 在主站创建,再粘贴到客户端配置里。

打开密钥页 ​

  1. 打开主站 https://aicode.cat 并登录。
  2. 进入 用户仪表盘密钥页。
  3. 在页面上创建一把新 Key,然后点 Key 旁边的复制图标再粘贴到客户端。

创建按钮、名称、权限等字段以控制台为准。

为什么要点复制图标,不要手动框选

用鼠标拖选文本很容易漏掉末尾字符,或把换行、空格一起复制进去,粘进客户端就成了 401。复制图标写进剪贴板的是完整 Key,粘贴后不要再补空格、不要加引号。

复制后放哪 ​

按你正在用的客户端,把 Key 填进对应位置(完整步骤在安装页):

客户端常见位置
Claude Code~/.claude/settings.json 的 ANTHROPIC_AUTH_TOKEN,见 Claude Code
Claude 桌面版Developer → Third-Party Inference 里的 Gateway API key,见 Claude 桌面版
Codex(终端 / 桌面版)~/.codex/auth.json 的 OPENAI_API_KEY,见 Codex
Gemini CLI~/.gemini/.env 的 GEMINI_API_KEY,见 Gemini CLI
Grok CLI~/.grok/config.toml 的 api_key,见 Grok
Hermes~/.hermes/config.yaml 的 api_key,见 Hermes
OpenCodeopencode.json 的 apiKey,见 OpenCode
OpenClaw~/.openclaw/openclaw.json 的 apiKey,见 OpenClaw
Cherry Studio设置 → 模型服务里的 API Key,见 Cherry Studio
Trae自定义模型里的 API 密钥,见 Trae
WorkBuddy AI设置 → 模型 → 添加模型里的 API Key,见 WorkBuddy
Droid CLI~/.factory/settings.json 的 customModels,见 Droid CLI
DeepSeek Harness设置 → 模型 → 添加自定义提供方里的 API 密钥,见 DeepSeek Harness

Key 前缀以控制台实际显示为准,不要把 Factory 账号的 TR_ Key 填进 AiCodeCat。

Key 绑在哪一组,就只调哪一组的模型 ​

创建 Key 时要选分组(Claude / GPT / Gemini / DeepSeek 等)。分组决定这把 Key 能用哪些模型,不是拿到 Key 就全家桶通用:

  • 用 Claude 分组的 Key 去打 GPT 模型,会提示模型不可用或无权限。
  • 额度、限速、可用模型清单都跟着分组走,换分组等于换了一档。
  • 分组选错不用重建 Key:在控制台把它换到正确分组,或按需再建一把。多个客户端各用各的 Key,排查时更清楚。

所以接入报错时先回密钥页确认两件事:这把 Key 属于哪个分组、你要用的模型 ID 在不在这组里。

模型不可用 / 无权限 / 429:按 6 步排查 ​

出现「模型不可用」「无权限」「无此模型」或 429 时,从上往下逐条排除,不要一上来就新建 Key:

  1. Key 是不是复制完整:回密钥页重新点复制图标,替换客户端里的旧 Key,检查有没有多余空格、引号、换行。
  2. Key 属于哪个分组:这把 Key 的分组里,有没有你要调的那个模型。
  3. 模型 ID 对不对:从控制台复制模型 ID,不要手打,也不要用客户端自带的官方模型名。
  4. 地址和协议对不对:Claude 用 https://aicode.cat(不加 /v1),GPT 用 https://aicode.cat/v1,Gemini 用 https://aicode.cat/v1beta。地址填错有时也表现成「无权限」。
  5. 是不是限速:429 多半是请求太快或并发达到了本组上限,等几秒重试;仍频繁出现就把并发调小。
  6. 额度和 Key 状态:回密钥页 / 用量页看额度是否用完、Key 是否被禁用或作废。作废了就新建一把。

逐条查完还是不通,把现象和你填的 Base URL、变量名(不要带 Key)抄到 常见报错 对照。

不要把 Key 贴到群里 ​

  • Key 能调用你的额度,发给别人等于把账号借出去。
  • 不要发到微信群、QQ 群、GitHub Issue、截图或录屏。
  • 怀疑泄露了,回密钥页作废旧 Key、再创建一把。作废入口以控制台为准。

接下来 ​