2026/7/8大约 3 分钟
调用报错类
提示「请先分配分组」/ Key 无法调用
新建的 Key 如果没有绑定分组，是无法调用任何接口的。到后台 API 密钥 列表中点击该 Key 的分组列，选择一个分组即可。
返回 429（Too Many Requests）
429 有几种可能，按顺序排查：
- 并发达到上限 —— 账户或分组的并发数有限制，等待正在进行的请求结束，或通过兑换码/联系客服提升并发
- 余额不足 / 订阅额度用尽 —— 到后台查看余额与
我的订阅的额度进度 - 触发 Key 的速率限制 —— 检查该 Key 是否设置了 5 小时 / 日 / 7 天限额，可在密钥编辑中调整或重置
提示模型不可用 / not_found
- 先确认 Key 的分组平台与模型匹配：Claude 分组调
claude-*，OpenAI 分组调gpt-*，Gemini 分组调gemini-* - 用 模型列表接口 查询该 Key 实际可用的模型
- 某些接口只对特定平台开放：如
/v1/embeddings、/v1/images/*仅 OpenAI 分组可用
提示 401 / 鉴权失败
- 检查 Key 是否复制完整（含
sk-前缀） - 检查 Key 是否被禁用或已过期
- 不要把 Key 放到 URL query 参数里（
?key=xxx），请使用请求头，见 接口总览
提示 403 / IP 被拒绝
检查该 Key 是否配置了 IP 白名单 / 黑名单，且你当前的出口 IP 不满足规则。
客户端配置类
Codex 修改配置后不生效
每次修改 config.toml 或 auth.json 后，都需要重启 codex：先 Ctrl + C 退出，再重新运行。
Codex 会话经常「换号」/ 上下文缓存命中低
Codex 通过 session_id 请求头维持粘性会话。如果你在 GoodCode 前面自行套了 Nginx 反代，需要在 Nginx 的 http 块中添加：
underscores_in_headers on;否则 Nginx 默认会丢弃带下划线的请求头，导致粘性会话失效。直连 goodcode.store 无此问题。
Claude Code 启动提示缺少 Git
访问 Git 下载页 安装 Git 后重试。
Antigravity 和官渠 Claude 能混用吗？
不能在同一上下文中混用。 Anthropic Claude 与 Antigravity Claude 的会话上下文不兼容，切换渠道请新开会话，并使用各自的端点与分组 Key，见 Antigravity 渠道。
/v1/chat/completions 在某些软件里表现异常
OpenAI 分组下 /v1/chat/completions 的响应由 Responses API 转换而来，个别第三方软件可能存在兼容性问题；优先使用 /v1/responses 或改用支持 Responses 协议的客户端。
账户安全类
API Key 泄露了怎么办？
立即到后台 API 密钥 页面删除或禁用该 Key，再新建一个。也可以为新 Key 配置 IP 白名单、额度限制降低风险。
如何保护账户？
后台 个人资料 中可以开启 TOTP 两步验证（2FA），强烈建议开启。
其他
用量和扣费在哪里核对？
使用记录：每一次请求的模型、输入/输出/缓存 tokens、费用、耗时仪表盘：整体用量趋势、模型分布统计- 密钥列表：单个 Key 的今日 / 近 30 天用量
找不到答案？
请通过以下方式联系我们（详见 GoodCode 简介 - 联系我们）：
- 微信：
Sharpenumind - QQ：
3280792399