主题
创建 API Key
文档站不内嵌控制台。Key 在主站创建,再粘贴到客户端配置里。
打开密钥页
- 打开主站 https://aicode.cat 并登录。
- 进入 用户仪表盘密钥页。
- 在页面上创建一把新 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 |
| OpenCode | opencode.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:
- Key 是不是复制完整:回密钥页重新点复制图标,替换客户端里的旧 Key,检查有没有多余空格、引号、换行。
- Key 属于哪个分组:这把 Key 的分组里,有没有你要调的那个模型。
- 模型 ID 对不对:从控制台复制模型 ID,不要手打,也不要用客户端自带的官方模型名。
- 地址和协议对不对:Claude 用
https://aicode.cat(不加/v1),GPT 用https://aicode.cat/v1,Gemini 用https://aicode.cat/v1beta。地址填错有时也表现成「无权限」。 - 是不是限速:429 多半是请求太快或并发达到了本组上限,等几秒重试;仍频繁出现就把并发调小。
- 额度和 Key 状态:回密钥页 / 用量页看额度是否用完、Key 是否被禁用或作废。作废了就新建一把。
逐条查完还是不通,把现象和你填的 Base URL、变量名(不要带 Key)抄到 常见报错 对照。
不要把 Key 贴到群里
- Key 能调用你的额度,发给别人等于把账号借出去。
- 不要发到微信群、QQ 群、GitHub Issue、截图或录屏。
- 怀疑泄露了,回密钥页作废旧 Key、再创建一把。作废入口以控制台为准。