适用边界
Zed 的 OpenAI-compatible provider 用于 Zed Agent、Inline Assistant、Git commit generation、thread summaries 等 Zed 自有 AI 功能。External Agents 和 Terminal Threads 通常有自己的模型、认证和配置,不会自动复用这里的 provider。
CC Switch 说明
CC Switch 当前公开支持的 app-specific provider 不包含 Zed Editor。Zed 的内置 AI provider 请在 Zed Agent Settings 或 settings.json 中配置;如果你在 Zed 中运行 Claude Code、Codex CLI 等 External Agent,那些外部工具按各自页面的 CC Switch 方法配置。
准备
- 安装 Zed,并确认当前版本支持 Agent Settings 中的 LLM Providers。
- 在 Ling.AI 控制台创建 API Key,确认余额、套餐和模型授权可用。
- 请求
GET https://api.lingyuncx.com/v1/models,复制要添加到 Zed 的模型 ID。 - 确认模型是否支持 tools、images、chat completions 或 responses,再决定 Zed 里勾选哪些能力。
Agent Settings 配置
- 打开 Agent Settings。 使用命令面板执行
agent: open settings,或从 Zed Agent 面板进入设置。 - 找到 LLM Providers。 在 LLM Providers 区域点击 Add Provider。
- 填写 Provider Name。 建议填
Ling.AI。 - 填写 API URL。 输入
https://api.lingyuncx.com/v1。 - 填写 API Key。 粘贴 Ling.AI API Key。Zed 会按自身机制保存密钥,不要把真实 Key 写入
settings.json。 - 添加模型。 点击 Add Model,Model Name 填
/v1/models返回的真实 ID。 - 填写 token 限制。 Max Tokens / Max Output Tokens 按模型能力填写,不要照抄截图中的其它供应商数值。
- 勾选能力。 按模型真实能力勾选 Supports tools、Supports images、Supports /chat/completions 等选项。
settings.json 配置
如果要批量管理多个模型,可以编辑 Zed settings.json。API Key 不写入 JSON,保存后按 Zed 提示录入。
json
{
"language_models": {
"openai_compatible": {
"Ling.AI": {
"api_url": "https://api.lingyuncx.com/v1",
"available_models": [
{
"name": "your-model-id-from-v1-models",
"display_name": "Ling.AI Model",
"max_tokens": 128000,
"max_output_tokens": 16384,
"capabilities": {
"tools": true,
"images": false
}
}
]
}
}
}
}
验证
- 保存 provider 后重启 Zed 或重新打开 Agent Panel。
- 打开 Zed Agent,选择 Ling.AI provider 下的模型。
- 发送短 prompt,例如“解释当前文件”。
- 确认 Zed 收到回复。
- 回到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。
排障
| 问题 | 先检查 | 处理方式 |
|---|---|---|
| 模型不显示 | settings.json 结构和 provider 名称 |
检查 JSON 逗号、括号和 openai_compatible 层级,保存后重启 Zed。 |
| 认证失败 | Zed 保存的 API Key | 在命令面板搜索重置 language model credentials,重新输入 Ling.AI API Key。 |
| 工具调用失败 | 是否误勾选 tools | 只有模型真实支持 function/tool calling 时才把 capabilities.tools 设为 true。 |
| Responses 模型不可用 | 模型是否只支持 Responses API | 按 Zed 当前文档设置对应能力;不确定时先选支持 Chat Completions 的模型。 |