← 博客
Zed接入教程编程 Agent

Zed 配置 Claude 和 GPT：自定义 API 密钥教程

（文中价格随实时价格表更新）

简短回答

在 Zed 中使用 APIVAI：打开 Agent Settings（命令 agent: open settings），在 LLM Providers 中点击 Add Provider，添加一个 OpenAI 兼容提供方，API URL 填 https://api.apivai.com/v1，填入你的 APIVAI 密钥和模型 ID，例如 claude-sonnet-4-6 或 gpt-5.5；在 settings.json 里它对应 language_models.openai_compatible 下的一项。如果想以原生格式使用 Claude，也可以添加一个 Anthropic 兼容提供方，地址填不带 /v1 的 https://api.apivai.com，因为 Zed 会自己加上 /v1/messages。截至 2026-10-10，通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.15 / $5.74，官方价为 $3.00 / $15.00。费用按 token 从预付余额扣除，无需订阅。

Zed 的 Agent Panel 是什么？为什么要接入自己的 API？

Zed 是一款快速的开源代码编辑器，内置 AI Agent。Zed Agent 在 Agent Panel 中工作：读取项目、修改文件、调用工具，并展示每一处改动，方便你审阅或回退。同一套模型设置还用于 Inline Assistant、Git 提交信息生成和对话摘要。

Zed 可以使用它自己托管的模型，也接受任何带 API 密钥的提供方。APIVAI 正好适用：一个密钥即可调用 Claude 和 GPT 模型，按 token 计费，大多数模型低于官方标价，从你按需充值的余额中扣除。这个密钥同时支持 OpenAI 格式和 Anthropic 格式，所以 Zed 的两种自定义提供方都能用。

在 Zed 中应该选哪种提供方类型？

Zed 有两种可以配合 APIVAI 使用的自定义端点：

OpenAI-compatibleAnthropic-compatible
设置中的键openai_compatibleanthropic_compatible
API URLhttps://api.apivai.com/v1https://api.apivai.com（不带 /v1）
模型Claude 和 GPT仅 Claude
Zed 调用的路径/chat/completions/v1/messages
适合一个提供方覆盖所有模型以原生 Messages 格式使用 Claude、提示缓存

先配置 OpenAI-compatible：一个提供方覆盖 Claude 和 GPT，在 Agent Panel 里点一下就能切换模型。如果你主要用 Claude，并希望 Zed 以 Claude 原生格式发送请求（包括提示缓存），再加一个 Anthropic-compatible。两者可以同时配置，使用同一个密钥。

如何一步步把 Zed 接入 APIVAI？

第 1 步：创建 APIVAI 密钥

  1. 在 apivai.com 用邮箱注册。
  2. 充值 $10 起，支持银行卡、加密货币、支付宝和微信支付。没有免费试用，用多少付多少。
  3. 打开控制台，创建密钥并复制。可以给密钥单独设置预算上限，这样 Agent 的花费不会超出计划。

第 2 步：添加 OpenAI 兼容提供方

最快的方式是通过设置界面：

  1. 在命令面板中运行 agent: open settings（或打开 Settings → AI → LLM Providers）。
  2. 点击 Add Provider，按下表填写提供方名称、API URL、模型 ID 和上下文窗口。
  3. 把 APIVAI 密钥粘贴到该提供方的密钥字段。Zed 会把它保存在系统钥匙串中，而不是 settings.json 里。
字段值
提供方名称apivai
API URLhttps://api.apivai.com/v1
API 密钥你的 APIVAI 密钥
模型 IDclaude-sonnet-4-6（或 GET /v1/models 返回的任意 ID）
上下文窗口200000

如果你更习惯直接编辑 settings.json，带两个模型的同一个提供方写法如下：

{
  "language_models": {
    "openai_compatible": {
      "apivai": {
        "api_url": "https://api.apivai.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-4-6",
            "display_name": "Claude Sonnet 4.6 (APIVAI)",
            "max_tokens": 200000,
            "max_output_tokens": 16384
          },
          {
            "name": "gpt-5.5",
            "display_name": "GPT-5.5 (APIVAI)",
            "max_tokens": 128000,
            "max_output_tokens": 16384
          }
        ]
      }
    }
  }
}

有三点要注意。在 Zed 中，max_tokens 是上下文窗口，不是回复长度；回复上限由 max_output_tokens 控制。api_url 必须以 /v1 结尾且只出现一次，因为 Zed 会在后面加上 /chat/completions。密钥不要写进 settings.json：在界面中填写，或者设置 Zed 根据提供方 ID 推导出的环境变量（转大写再加 _API_KEY，即 apivai 对应 APIVAI_API_KEY），然后重启 Zed。

查看你的密钥可用哪些模型 ID：

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

模型列表会随时间变化，请从这个接口的返回或价格页复制 ID，不要照抄旧教程里的名称。

第 3 步（可选）：为 Claude 添加 Anthropic 兼容提供方

在 Add Provider 中选择 Anthropic，API URL 填 https://api.apivai.com；或者在上面的配置块旁边加上：

"anthropic_compatible": {
  "apivai-claude": {
    "api_url": "https://api.apivai.com",
    "available_models": [
      {
        "name": "claude-sonnet-4-6",
        "display_name": "Claude Sonnet 4.6 (APIVAI native)",
        "max_tokens": 200000,
        "max_output_tokens": 16384,
        "capabilities": {
          "tools": true,
          "images": false,
          "prompt_caching": true
        }
      }
    ]
  }
}

这里不要加 /v1。Zed 的 Anthropic 客户端会自己在 API URL 后加上 /v1/messages，填 https://api.apivai.com/v1 会变成 /v1/v1/messages，返回 404。开启 prompt_caching 后，Zed 会发送缓存断点，重复的上下文按缓存读取价计费（Claude Sonnet 4.6 为每百万 $0.12）。密钥在该提供方的设置界面中填写。这种格式的更多说明见 Claude API 代理页面。

第 4 步：在 Agent Panel 中选择模型

打开 Agent Panel，点击消息编辑器中的模型选择器。APIVAI 的模型会显示在你设置的提供方名称下；注意选中 APIVAI 这一项，而不是其他提供方的同名模型。如需设为默认模型，在 settings.json 中用提供方名称和模型 ID 设置 agent.default_model。

在 Zed 中该选哪个模型？

Agent 每一步都会发出请求，所以单价很重要。以下为每百万输入 / 输出 token 价格，截至 2026-10-10：

模型 ID价格（输入 / 输出）用途
claude-sonnet-4-6$1.15 / $5.74日常编程的默认选择
claude-sonnet-5-5$0.77 / $3.82日常编程，更新的 Sonnet
claude-opus-5-5$1.54 / $7.65疑难 bug、大型重构
claude-haiku-4-5$0.38 / $1.92Inline Assistant、提交信息、小改动
gpt-5.5$0.77 / $4.56GPT 方案，第二意见
gpt-6-luna$0.0144 / $0.0768非常便宜的简单任务

实用搭配：Agent 用 Claude Sonnet 4.6 或 Claude Sonnet 5.5；任务反复失败时换成 Claude Opus 5.5；快速的行内修改用 Claude Haiku 4.5。GPT 模型只能通过 OpenAI 兼容提供方使用。

Zed 配合 APIVAI 要花多少钱？

Agent 的每一步都会重新发送对话和已读取的文件，所以费用主要来自输入 token。以下是 Claude Sonnet 4.6 的两个实际例子：

  • 一个中等任务，例如修复一个涉及几个文件的 bug：约 15 次请求，每次约 25,000 输入和 1,500 输出 token。费用：APIVAI $0.56，官方价 $1.46。
  • 一个工作月，每天两个这样的任务，共 22 天（660 次请求）：APIVAI $24.66，官方价 $64.35。

同样一个月换成 Claude Haiku 4.5，费用为 $8.17。以上估算未计入提示缓存，并把思考 token 计入输出数（思考 token 按输出计费）。控制台会列出每次请求的 token 和费用，用上一天就能用自己的真实数据替换这些假设。更全面的对比见 2026 年 Claude API 价格对比。

Zed 常见报错怎么解决？

  • 401 Unauthorized： 密钥未填写、没复制完整、已被删除或已用完预算。请在提供方设置中重新填写。非空的环境变量优先于钥匙串中的值，所以也要检查 APIVAI_API_KEY。
  • 404 Not Found： 几乎都是 /v1 的问题。OpenAI-compatible 需要 https://api.apivai.com/v1（末尾不要加 /chat/completions）；Anthropic-compatible 需要不带 /v1 的 https://api.apivai.com。
  • 找不到模型： name 必须是准确的 ID，例如 claude-sonnet-4-6，而不是显示名称。请用 GET /v1/models 核对。
  • 回复为空或被截断： 思考默认开启并消耗输出 token。把 max_output_tokens 调到 8192 或更高（至少 4096）。
  • 429 Too Many Requests： 每个密钥默认每分钟 60 次请求。长时间的 Agent 任务可能触发限制，稍等片刻或联系客服提高限额。

通用的格式规则见 OpenAI 兼容 API 页面和文档。

常见问题

在 Zed 中能用一个密钥同时使用 Claude 和 GPT 吗？

可以。添加一个 OpenAI 兼容提供方，在 available_models 中写入两个模型 ID，然后在模型选择器里切换即可。

在 Zed 中 API URL 应该填什么？

OpenAI 兼容提供方填 https://api.apivai.com/v1，Anthropic 兼容提供方填 https://api.apivai.com，因为 Zed 会自己加上 /v1/messages。

这对 Zed 的 Edit Prediction 也有效吗？

不会。Edit Prediction 有单独的提供方设置；本文中的提供方用于 Zed Agent、Inline Assistant、提交信息和对话摘要。

APIVAI 会保存我的代码吗？

不会。请求和响应的内容不会被记录，只保留模型、token 数和费用等用于计费的使用数据。

同一个密钥能用在其他编辑器里吗？

可以。同一个密钥也适用于 Cline、Continue 以及 OpenCode 这样的终端 Agent。每个工具单独建一个密钥，控制台里的用量会更清楚。

注册账号，充值 $10 起，把密钥粘贴到 Zed 即可。

准备好了吗？

30 秒获取 API 密钥，按量付费使用 Claude 和 GPT

开始使用