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。
opencode 错误
使用自定义提供商时 opencode 的故障解决方法:AI_APICallError、模型未出现在提供商列表中、API 密钥未被读取,以及被悄悄丢弃的图片附件。
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 层面的参考:每个状态码及其逐字响应体,按错误码而非工具组织。