这篇 FAQ 按「先自查、再联系售后」的顺序整理，共 21 个问题，分为接入、报错、额度三类。每个问题都给出可以马上执行的检查步骤。
如果你还没有完成第一次接入，建议先读使用指南；想了解产品本身，看AIGoCode 是什么。官方原文见FAQ和错误码说明。
先做这五项自查
大多数问题都能靠下面五项定位。五项都核对过仍然失败，再往下看具体问题。
- API Key：是否完整、没有多余空格、没有被删除，也没有提交到公开仓库；
- Base URL：是否按协议或工具教程填写，根地址是
https://api.aigocode.dev； - 模型 ID：是否存在于模型名称列表，并且与 Key 所属分组匹配；
- 额度：控制台余额或套餐额度是否足够，是否触发周限额；
- 并发：是否同时开了多个工具或会话。
图 1：文档站「错误码说明」页。页面按状态码分节，可见 401 API Key 错误、403 余额不足两张表，列出错误现象、可能原因、解决方法、是否扣费、是否联系客服；红框标出右侧目录，包含 401、403、413、429、5xx 和快速自查清单。
接入类问题
1. 为什么 Claude Code 连不上？
按顺序检查四项：
ANTHROPIC_BASE_URL是否为https://api.aigocode.dev；ANTHROPIC_AUTH_TOKEN是否为完整的 API Key；- 创建 Key 时是否选择了支持第三方调用的分组，Claude Code 场景使用「Claude Code（企业）」；
- 当前套餐是否还有额度。
如果你用的是 CC Switch，一键导入完成后，要回到 CC Switch 的 Claude Code 页面，在 AIGoCode 供应商上点击「启用」。完整步骤见Claude Code 接入。
2. 为什么 Codex 提示认证失败？
检查两处：
~/.codex/auth.json里是否包含完整的OPENAI_API_KEY；~/.codex/config.toml里的base_url是否指向 AIGoCode。base_url的具体写法，请以Codex CLI 教程页面给出的配置为准。
Codex 使用「Codex Pro」分组创建 Key。
3. 创建 Key 时分组选错了会怎样？
在 Claude Code、Codex、Cherry Studio、OpenCode、OpenClaw 或 Hermes 里使用 AIGoCode，要在创建 Key 时选择支持第三方调用的分组，否则可能出现工具鉴权通过、但模型请求失败的情况。
遇到这种情况，请对照对应工具教程里写明的分组重新创建 Key，并在工具里换上新 Key。各工具对应的分组见使用指南中的分组对照表。
图 2：文档站「获取 API Key」页。页面展示创建步骤、使用建议和示例环境变量文件，红框标出「第三方工具分组」一节，说明在 Claude Code、Codex 等工具里使用要选支持第三方调用的分组。
4. Base URL 到底填根地址，还是带 /v1？
- 统一服务根地址：
https://api.aigocode.dev； - 直接按协议调用 API：OpenAI 与 Anthropic 兼容使用
https://api.aigocode.dev/v1，Gemini 兼容使用https://api.aigocode.dev/v1beta； - 会自己拼接路径的 CLI 或桌面客户端：通常只填根地址。
各工具教程里都会明确写该填根地址还是协议地址，请以对应教程为准。例如 Trae 的 OpenAI 接入要保留 /v1，Claude 接入只填根地址。
图 3：文档站「Base URL」页。红框分别标出统一服务根地址和「协议地址」表，表中列出 OpenAI Compatible、Anthropic Compatible 的 /v1 地址与 Gemini Compatible 的 /v1beta 地址。
5. 为什么 Gemini 要用不同的路径？
Gemini 兼容协议使用 /v1beta。直接发送 HTTP 请求时，使用 https://api.aigocode.dev/v1beta。如果 Gemini 请求失败，先检查路径是否多了或少了这一段。
6. 工具提示 Key 无效，但我确定 Key 是对的？
先检查 Key 填到了哪个字段。不同工具使用不同的字段名，例如 ANTHROPIC_AUTH_TOKEN、OPENAI_API_KEY、GEMINI_API_KEY，填错字段，工具就会提示 Key 无效。另外检查 Key 前后有没有多余空格，以及分组是否支持第三方调用。
7. 本地能用，部署之后不能用？
检查部署平台是否配置了环境变量，变量名是否与代码里一致。另外，不要把 API Key 放到前端公开代码里。
8. Trae 提示 error sending request 怎么办？
先检查网络或代理设置，确保 Trae 能访问 API 地址。另外核对自定义模型里的请求地址：OpenAI 接入保留 /v1，Claude 接入只填根地址，两种方式的「完整 URL」都保持关闭。详见Trae 教程。
9. 提交消息时提示 Work browser access requires an authenticated account 怎么办？
出现「提交消息时出错 / Work browser access requires an authenticated account」时，按当前使用的模式处理：
Codex 模式（推荐）：已有用户反馈，更新客户端后出现此提示，将会话详情设置改为 STEPS_COMMANDS 后恢复使用，具体触发原因尚未确认。
- 先完全退出客户端，再用文本编辑器打开配置文件（修改前建议复制一份备份）：Windows 是
%USERPROFILE%\.codex\config.toml，macOS / Linux 是~/.codex/config.toml； - 找到
[desktop]段，将conversationDetailMode修改为：
[desktop]
conversationDetailMode = "STEPS_COMMANDS"
- 已有
[desktop]时，只在该段内添加或修改这一项，保留其他设置；没有时，可以把上面两行追加到文件末尾；不要重复添加[desktop]或同名配置项，也不要只把conversationDetailMode单独追加到文件最后； - 保存后重新启动客户端，切换到 Codex 模式，新建会话并发送一条普通消息，确认可以正常回复。
这个方法只处理 Codex 模式下的上述报错，不能解决 ChatGPT Work 模式中的同名报错。
继续使用 Work 模式：先确认客户端已登录可使用 Work 的 ChatGPT 账户。AIGoCode API Key 用于模型接口调用，不能替代 Work 浏览器要求的账户登录身份。如果仍需使用 Work 模式，可以尝试关闭浏览器和计算机操作功能：完全退出客户端，打开同一个 config.toml，在 [features] 段添加或修改下面三项：
[features]
browser_use = false
browser_use_external = false
computer_use = false
已有 [features] 时在该段内修改，没有时把上面四行追加到文件末尾；不要重复添加，也不要把这三项写到 [desktop] 下。保存后重启客户端，在 Work 模式中新建会话，发送一条不涉及浏览器或计算机操作的消息验证。这个方法只是关闭相关功能来规避报错，不会授予浏览器访问权限，关闭后依赖这些功能的网页操作和计算机操作任务将无法使用。
修改后仍然报错：联系售后，并提供客户端版本、当前使用的模式、完整报错截图，以及脱敏后的 [desktop] 和 [features] 配置片段。请勿发送 API Key 或包含密钥的完整配置文件。
图 4：文档站 FAQ 页。红框内是右侧目录，列出「为什么 Claude Code 连不上」「为什么 Codex 提示认证失败」「提交消息时提示 Work browser access requires an authenticated account 怎么办」（含 Codex 模式、继续使用 Work 模式、修改后仍然报错三项）以及「为什么 Gemini 要用不同路径」「为什么余额扣得多」「为什么会出现 thinking signature 相关错误」「如何联系售后」；正文可见 Claude Code 排查四项和 Codex 的 auth.json 示例。
报错类问题
10. 401 是什么原因？
401 Unauthorized 表示认证没通过。可能原因：Key 复制不完整、Key 已删除、请求头没有带 Bearer、工具填错字段。处理办法：重新复制 Key，检查请求头形如 Authorization: Bearer sk-...，必要时重新创建 Key。401 通常不扣费；重建 Key 后仍然失败，再联系客服。
11. 403 是不是余额不足？
错误码页把 403 归在「余额不足」下：返回 403，或出现余额、额度、订阅不足相关提示。可能原因包括当前余额不足、套餐额度未恢复、周限额已触发。先到控制台查看余额和用量记录，再决定是等待恢复还是升级套餐。请求未成功生成时，通常不继续扣费；如果余额显示异常，联系客服。
12. 404 Not Found 怎么排查？
404 Not Found 的常见原因是 Base URL 多填或少填了 /v1、/v1beta。对照第 4 问，核对你的工具到底该填根地址还是协议地址。
13. 413 Payload Too Large 是什么意思？
表示一次请求的内容太大：输入内容、文件、上下文或历史消息过大。解决办法是缩短上下文、删除无关文件、降低一次请求的输入规模。该错误通常不扣费，一般不需要联系客服。
14. 429 怎么办？
429 Too Many Requests 通常是并发过高：同时发起的请求过多、工具自动并发、或者短时间内重试过快。处理办法是降低并发、关闭多余的客户端、等待片刻后再试。未完成的失败请求通常不扣费。长时间持续出现，再联系客服。
15. 500、502、503、504 是我的问题吗？
这类错误通常来自上游模型波动、网络问题或服务临时异常。可以稍后重试，或切换模型。是否扣费以最终生成和用量记录为准，持续影响使用时联系客服。
16. 出现 thinking signature 相关错误怎么办？
这类问题通常和上游模型、工具客户端或上下文格式有关。先切换模型，或者重新开一个会话；如果持续出现，保留工具名称、模型 ID、报错文本和发生时间，再联系支持。
下表把错误码页列出的几类错误放在一起，方便对照：
| 状态码 | 常见原因 | 先做什么 | 是否扣费 |
|---|---|---|---|
| 401 | Key 不完整或已删、未带 Bearer、字段填错 | 重新复制或重建 Key | 通常不扣费 |
| 403 | 余额不足、套餐额度未恢复、周限额 | 看控制台余额与用量 | 未成功生成时通常不继续扣费 |
| 413 | 上下文、文件或历史消息过大 | 缩短上下文 | 通常不扣费 |
| 429 | 并发过高、重试过快 | 降低并发后重试 | 未完成的失败请求通常不扣费 |
| 5xx | 上游波动、网络或服务异常 | 稍后重试或换模型 | 以最终生成和用量记录为准 |
额度与账户类问题
17. 为什么余额扣得比预期多？
原因包括：长上下文、大输出、缓存写入、多工具并发、客户端自动重试，都可能增加消耗；不同模型的输入、输出、缓存读写成本也不同。建议在控制台的用量记录里逐条核对，并减少不必要的上下文。更完整的核对方法见AIGoCode 额度怎么用。
18. 为什么订阅额度没有恢复？
可能仍在恢复周期内，或者已经触发周限额，详见额度与限制。订阅套餐每 4 周续费，套餐额度每 7 天刷新；实际权益以控制台展示和服务端配置为准。
图 5：官网「方案与定价」区。页面可见按量付费、Pro（¥399/4周）、Max（¥899/4周）卡片，以及「订阅套餐每 4 周续费，套餐额度每 7 天刷新」的说明（红框）；订阅卡片上有「套餐额度用尽后，可使用账户余额继续按量调用」的提示。数字以官网当前显示为准。
19.「额度永久有效」是不是意味着用不完也不扣？
不是。官网对按量付费的描述是：按实际用量计费，预充额度、随用随扣，额度永久有效。也就是说，额度是预充后按实际用量扣除的。同一笔额度可以在所有 Agent 间共享，每次调用消耗多少，取决于模型的输入、输出、缓存读写成本等。
20. 套餐额度用完后会怎样？订阅和按量能同时用吗？
套餐额度用尽后，可使用账户余额继续按量调用。另外，按量的灵活用户按正价消耗额度，通常不因套餐折扣限制模型；套餐用户因享受折扣，部分高成本模型可能会按套餐规则限制。具体生效情况以控制台展示和服务端配置为准。
21. 一个 Key 能调用所有模型吗？怎么确认能用哪些？
官网权益里有「一个 API Key 调用多个模型」，可用范围取决于 Key 所属分组，实际以当前权限和请求结果为准。确认方法：用 Bearer 认证请求 https://api.aigocode.dev/v1/models，认证成功后会返回当前 Key 可用的模型列表，不同 Key 返回的模型可能不同。模型 ID 必须完整匹配，参考模型名称列表。
图 6：文档站「Agent工具接入」页。表格列出 Claude Code、Codex CLI、Gemini CLI、Antigravity CLI、Claude Desktop、Codex 桌面端、Cherry Studio、Trae、OpenCode、OpenClaw、Hermes、Pi、WorkBuddy、DeepSeek Harness 及适合场景（红框）；底部提示鉴权失败或 endpoint 错误时先查 Base URL 和错误码。
联系售后之前，请准备这些信息
自查之后仍无法解决，可以通过主站的「售后支持」提交问题。为了更快定位，请附上：
- 工具名称：例如 Claude Code、Codex、Trae；
- 模型 ID：完整的模型 ID；
- 错误码：以及报错文本；
- 发生时间：方便对照用量记录；
- 是否已消耗额度：用量记录中是否出现了这次请求。
遇到 Work browser access 报错时，另外附上客户端版本、当前使用的模式、完整报错截图，以及脱敏后的相关配置片段。请勿发送 API Key 或包含密钥的完整配置文件。