文档
Zed
Zed 在 settings.json 中声明 OpenAI 兼容的提供商,并通过 Agent Panel 单独填写密钥。models 数组并非便捷选项,而是 Zed 所能识别的完整模型列表。
settings.json 中的 language_models.openai_compatible 配置块声明端点及其模型;密钥放在 Agent Panel 界面中,绝不写入文件。
{
"language_models": {
"openai_compatible": {
"kunavo": {
"api_url": "https://api.kunavo.com/v1",
"available_models": [
{
"name": "claude-sonnet-5",
"display_name": "Claude Sonnet 5",
"max_tokens": 200000,
"max_output_tokens": 64000,
"capabilities": { "tools": true, "images": true }
},
{
"name": "claude-haiku-4-5",
"display_name": "Claude Haiku 4.5",
"max_tokens": 200000
}
]
}
}
}
}settings.json会同步并共享;将密钥写入其中,它也会随文件一同共享。available_models就是完整目录 —— OpenAI 兼容的提供商不会进行发现调用,因此未列出的模型不会出现在选择器中。请为打算使用的每个 ID 添加一条配置,并将 max_tokens 设为该模型实际的上下文窗口。sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Zed 设置页面。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 从命令面板运行 zed: open settings,打开
settings.json并添加上面的配置块。 - 打开 Agent Panel 设置,在以你用作键名的名称命名的提供商下找到该提供商(此处为
kunavo),然后粘贴 API 密钥。 - 在 Agent Panel 的模型选择器中选择模型 ——它会显示
display_name,并发送name。 - 只覆盖与 Zed 默认值不同的
capabilities——默认设置为tools: true,其中图像和并行工具调用均处于关闭状态。
已于 2026年9月6日对照 Zed 的 API 访问文档检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。
调试客户端前先验证
一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON,则相同的基础 URL 和密钥可以在 Zed 中使用。
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."字段中应填写哪个模型 ID
每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models,包含价格的目录见模型页面。费率单位为每 1M token 的美元,格式为输入 / 输出。
| 模型 ID | Kunavo 输入 / 输出 | 它在 Zed 中的位置 |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | 智能体默认模型 —— 启用工具和图像 |
claude-opus-5 | $3.50 / $17.50 | 大型重构任务,计划比速度更重要 |
claude-haiku-4-5 | $0.70 / $3.50 | 行内辅助和快速编辑 |
gpt-5-6-terra | $0.70 / $4.20 | 同一提供商条目下的第二个系列 |
常见问题
如何向 Zed 添加 OpenAI 兼容的提供商?
在 settings.json 中添加 language_models.openai_compatible 配置块,以提供商名称作为键名,设置 api_url 指向端点的 /v1 根路径,并通过 available_models 数组列出要使用的每个模型 ID。然后打开 Agent Panel 的提供商设置,并在那里输入 API 密钥。Zed 的文档明确指出,密钥不应放在 settings.json 中。
为什么模型没有出现在 Zed 的模型选择器中?
因为它未列入 available_models。Zed 不会向 OpenAI 兼容端点查询模型目录,因此 settings.json 中的数组就是该提供商提供的完整模型列表。请添加一条配置,将模型 ID 设为 name,为选择器设置 display_name,并将 max_tokens 设为模型实际的上下文窗口。
Zed 将自定义提供商的 API 密钥存在哪里?
存放在 Agent Panel 的提供商设置界面中,或存放在 Zed 根据提供商名称生成的环境变量中 ——不要放在 settings.json 中。Zed 特意将凭据保存在设置文件之外,因为该文件旨在便于移植和共享,而密钥不适合随文件共享。
Zed 能否通过自定义端点使用 Claude 模型?
可以。openai_compatible 提供商会将模型名称直接发送到 api_url,因此 Claude ID 由端点而非 Zed 解析。对于支持工具调用的模型,将 capabilities.tools 设为 true ——这是 Zed 对此类提供商的默认设置 ——这样智能体的工作方式就与使用第一方提供商时相同。