疑难排查

AI 编码工具报错大全——Claude Code、Cursor、Codex、opencode、Cline、Zed

选择出问题的工具。每个页面都会逐字引用工具打印的报错文本,解释它是如何产生的,并给出恢复正常配置的最短路径。若需要按状态码组织的 API 层面参考,请查看 API 错误码页面。

Claude Code 错误

Claude Code 通过 apiToken.sale 运行 GPT 和 Gemini 模型时所打印错误的解决方法:API Error 429 rate_limit_error、401 authentication_error、402 余额不足、529 Overloaded。报错原文、原因与修复。

Cursor 错误

使用自定义 OpenAI base URL 和 API 密钥时 Cursor 的错误解决方法:unable to reach model provider、验证时提示 invalid API key、提供商返回的 401 以及速率限制。每个错误都有原因和修复。

Codex CLI 错误

使用自定义模型提供商时 Codex CLI 的故障解决方法:Missing OPENAI_API_KEY、config.toml 配置错误、auth.json 登录状态以及 stream error: unexpected status 401。

Cline 错误

使用 OpenAI Compatible 提供商时 Cline 的错误解决方法:API Request Failed 横幅、401 invalid API key、429 rate_limit_error 重试循环以及 400 context_length_exceeded。每个错误都有原因和修复。

Zed 错误

Zed 助手通过 OpenAI 提供商使用 GPT 和 Gemini 模型时的错误解决方法:401 invalid API key、429 速率限制以及自定义 api_url 配置,包括缺少 /v1 导致的 404。

API 错误码

API 层面的参考:每个状态码及其逐字响应体,按错误码而非工具组织。

跳过折腾坏掉的配置

apiToken.sale 通过 OpenAI 兼容端点、Messages(Anthropic 格式)端点和原生 Gemini 端点提供 GPT 与 Gemini 模型——标准 SDK、一把密钥、一个预付余额。把你工具的 base URL 指向它,本页的配置即可原样生效。