疑难排查
Zed Claude 报错——401、429、529、自定义 api_url
Zed 的助手几乎原样透传 Anthropic 的响应，因此你看到的报错文本就是 API 自己的。Zed 特有的部分只是密钥和自定义 api_url 在 settings.json 中的位置——大多数持续性故障最终都能追溯到这两个字段。
| 错误 | 含义 |
|---|---|
{"type":"error","error":{"type":"authentication_error","message"… | Zed 的助手会原样透传 Anthropic 的 401 invalid x-api-key。密钥和 api_url 在 Zed 设置中的位置，以及为什么它们必须来自同一签发方。 |
{"type":"error","error":{"type":"rate_limit_error","message":"Th… | Zed 助手里的 429 是你密钥背后 API 组织的每分钟上限。为什么长线程和共享密钥会触发它，以及什么能让它消退。 |
{"type":"error","error":{"type":"overloaded_error","message":"Ov… | 当上游容量饱和时，Zed 会原样显示 Anthropic 的 529 Overloaded。为什么你的设置不是原因，以及在它持续期间该做什么。 |
zed custom anthropic api url | 如何用 language_models.anthropic.api_url 把 Zed 的 Anthropic 提供商指向自定义端点，以及为什么追加 /v1 会因路径重复产生 404。 |
Zed Claude 401 invalid x-api-key——Anthropic 设置修复
Zed 的助手会原样透传 Anthropic 的 401 invalid x-api-key。密钥和 api_url 在 Zed 设置中的位置，以及为什么它们必须来自同一签发方。
Zed 助手 429 rate_limit_error 解决方法
Zed 助手里的 429 是你密钥背后 API 组织的每分钟上限。为什么长线程和共享密钥会触发它，以及什么能让它消退。
Zed 收到 Claude 529 Overloaded——该怎么办
当上游容量饱和时，Zed 会原样显示 Anthropic 的 529 Overloaded。为什么你的设置不是原因，以及在它持续期间该做什么。
Zed Anthropic api_url 自定义配置与 /v1/v1 404 陷阱
如何用 language_models.anthropic.api_url 把 Zed 的 Anthropic 提供商指向自定义端点，以及为什么追加 /v1 会因路径重复产生 404。
全部工具 · Claude API 错误码 · 配置指南