AI 编码工具报错大全——Claude Code、Cursor、Codex、opencode、Cline、Zed
选择出问题的工具。每个页面都会逐字引用工具打印的报错文本，解释它是如何产生的，并给出恢复正常配置的最短路径。若需要按状态码组织的 API 层面参考，请查看 Claude API 错误码页面。
Claude Code 错误
Claude Code 会打印的每种错误的解决方法：API Error 429 rate_limit_error、401 invalid x-api-key、529 Overloaded 以及用量上限提示。报错原文、原因与修复。
Cursor 错误
使用自定义 Anthropic 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 错误
使用 Anthropic 密钥时 Cline 的错误解决方法：API Request Failed 横幅、401 invalid x-api-key、429 rate_limit_error 重试循环以及上下文超限 400。每个错误都有原因和修复。
Zed 错误
Zed 助手使用 Anthropic 模型时的错误解决方法：401 invalid x-api-key、429 速率限制、529 Overloaded 以及自定义 api_url 配置，包括 /v1/v1 404 陷阱。
Claude API 错误码
API 层面的参考：每个状态码及其逐字响应体，按错误码而非工具组织。