疑难排查 · Zed

Zed Anthropic api_url 自定义配置与 /v1/v1 404 陷阱

如何用 language_models.anthropic.api_url 把 Zed 的 Anthropic 提供商指向自定义端点,以及为什么追加 /v1 会因路径重复产生 404。

你看到的报错

zed custom anthropic api url

为什么会发生

  • api_url 设置时包含了 /v1,而 Zed 会自己追加 API 路径——请求发往 /v1/v1/messages,这个路径不存在。
  • api_url 被加在错误的设置键下或有拼写错误,Zed 悄悄继续使用默认端点。
  • 端点没错,但所选模型 id 是它不提供的——这是 404 的另一个来源。

如何解决

  • api_url 只设置为源站,让 Zed 自己构建路径。
  • 把设置准确放在 settings.json 的 language_models.anthropic.api_url——放错位置的键不会报错,只是毫无作用。
  • 如果 404 响应体点名了某个模型,说明路径没问题,问题在模型 id:列出端点的模型并选一个它提供的 id。

正确的 settings.json

{
  "language_models": {
    "anthropic": {
      "api_url": "https://api.apitoken.sale"
    }
  }
}
// wrong: "api_url": "https://api.apitoken.sale/v1"  → /v1/v1/messages → 404

相关搜索

  • zed api_url not working
  • {"type":"error","error":{"type":"not_found_error","message":"Not found"}}

常见问题

Zed 的 api_url 应该带 /v1 吗?+
不带。Zed 会自己追加 /v1/messages。以 /v1 结尾的 api_url 会产生重复的 /v1/v1 路径和 404。
怎么确认我的自定义 api_url 真的生效了?+
故意把它改错测一次请求(填一个乱写的主机)——如果什么都没变,说明 Zed 没在读你编辑的那个键;修正设置路径。
路径没错但仍然 404——为什么?+
404 响应体通常会点名缺失的东西。如果它点名一个模型,就选一个端点提供的 id;用 GET /v1/models 列出它们。

跳过折腾坏掉的配置

apiToken.sale 提供标准的 Anthropic API——同样的模型、同样的 SDK、一个预付余额。把你工具的 base URL 指向它,本页的配置即可原样生效。