FAQ

为什么 Claude Code 无法连接？

可以先检查以下配置：

完整配置与验证步骤见 Claude Code 接入。

先检查 ~/.codex/auth.json 中是否正确填写了 API Key：

auth.json

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

再确认 ~/.codex/config.toml 中的 base_url 是否为 https://api.aigocode.dev。

如果提交消息时出现以下提示，请根据当前使用的模式处理：

提交消息时出错
Work browser access requires an authenticated account

有用户反馈，客户端更新后出现此提示，将会话详情模式改为 STEPS_COMMANDS 后恢复正常。具体触发原因尚未确认，可按以下步骤尝试。

完全退出客户端，并备份配置文件后，用文本编辑器打开：
- Windows：%USERPROFILE%\.codex\config.toml。也可以按 Win + R，输入 %USERPROFILE%\.codex，再打开 config.toml。
- macOS / Linux：~/.codex/config.toml。
找到 [desktop] 段，将 conversationDetailMode 设置为：

config.toml

[desktop]
conversationDetailMode = "STEPS_COMMANDS"

如果已有 [desktop] 段，在该段内修改或添加这一项，保留其他配置；如果没有该段，将上面两行追加到文件末尾。

配置项应位于 [desktop] 下方、下一个配置段之前，避免归入其他段。请勿重复添加 [desktop] 或同名配置项。

以上方法针对 Codex 模式下的报错，不适用于 ChatGPT Work 模式中的同名报错。

先确认客户端已登录可使用 Work 的 ChatGPT 账户。AIGoCode API Key 用于模型接口调用，不能替代 Work 浏览器所需的账户登录身份。

如果仍需使用 Work 模式，可以尝试关闭浏览器与计算机操作功能。

完全退出客户端，打开同一个 .codex/config.toml，在 [features] 段中添加或修改以下配置：

config.toml

[features]
browser_use = false
browser_use_external = false
computer_use = false

如果已有 [features] 段，只修改或补充这三项，保留其他设置；如果没有该段，将上面四行追加到文件末尾。请勿重复添加配置段或同名选项，也不要将这三项放在 [desktop] 下。

保存后重新启动客户端，在 Work 模式中新建会话，发送一条不涉及浏览器或计算机操作的消息进行验证。

该方法通过关闭相关功能规避报错，不会授予浏览器访问权限。关闭后，依赖这些功能的网页和计算机操作任务将无法使用。

请联系售后，并提供客户端版本、当前模式、完整报错截图，以及脱敏后的 [desktop] 和 [features] 配置片段。请勿发送 API Key 或包含密钥的完整配置文件。

Gemini 原生兼容接口使用 /v1beta 路径前缀。直接发送 HTTP 请求时，在 https://api.aigocode.dev/v1beta 后拼接对应的模型和接口路径。

较长的上下文、大量输出、缓存写入、多工具并发，以及客户端自动重试，都可能增加实际消耗。建议先在控制台核对用量记录，再减少不必要的上下文和重复请求。

这类报错通常与上游模型、工具客户端或上下文格式有关。可以先尝试切换模型或新建会话；如果问题持续出现，请记录工具名称、模型 ID、完整报错和发生时间，再联系售后。

通过主站的售后支持提交问题。建议附上工具名称、模型 ID、错误码、发生时间，以及是否已经产生额度消耗，方便定位。