API 密钥管理

GoodCode2026/7/8大约 3 分钟

如何创建 API 密钥？

进入后台页面，点击左侧菜单的 API 密钥 一栏
点击右上角 创建密钥 按钮
填写密钥信息：
- 名称：随意，方便自己区分即可
- 分组：必选，最重要的一项。分组决定这个 Key 走哪个平台（Claude / OpenAI / Gemini / Antigravity）以及计费倍率
- 其余选项（额度限制、速率限制、IP 限制、有效期等）按需设置，默认即可

分组必须选对（很重要）

GoodCode 的所有平台共用同一个网关地址，请求走哪个上游完全由 Key 的分组决定：

未分配分组的 Key 无法调用接口，会返回「请先分配分组」类错误。已创建的 Key 也可以在列表中点击分组列随时更换分组。

创建好密钥后，在密钥列表中点击该 Key 的 使用密钥 按钮，后台会根据 Key 所属分组自动生成对应客户端的配置（Claude Code / Codex CLI / Gemini CLI / OpenCode），直接复制即可，不用手写。

一键导入 CC-Switch

密钥列表还提供 导入到 CCS 按钮，可将该 Key 一键导入本地的 CC-Switch 工具，省去手动填写。需要先安装 CC-Switch。

选项	说明
`自定义密钥`	可指定自己的 Key 内容（至少 16 位，仅字母、数字、下划线、连字符）
`额度限制`	该 Key 可消费的最大金额（USD），0 = 无限制；已用额度可随时重置
`速率限制`	按时间窗口限制消费额：5 小时限额 / 日限额 / 7 天限额（USD），0 = 无限制
`IP 白名单`	每行一个 IP 或 CIDR，设置后仅允许这些 IP 使用此密钥
`IP 黑名单`	每行一个 IP 或 CIDR，这些 IP 将被禁止使用此密钥
`密钥有效期`	到期后密钥自动失效
`状态`	可随时启用 / 禁用密钥

常见问题提醒

如果调用时看到「没有权限」「请求被拒绝」「429」这类提示，先不要急着换模型，按下面顺序排查当前 Key 的配置：