Zed Editor 使用指南

Zed 是一款高性能的现代代码编辑器，内置 AI 助手功能，支持多种大语言模型。本指南介绍如何将 Zed Editor 接入 OPE.AI，使用各类前沿模型辅助编程。

快速开始

1. 获取 API Key

请访问 OPE.AI 控制台 并创建您的专属 API Key。

2. 添加 Provider（服务商）

您可以选择以下两种方式配置 OPE.AI：

可视化配置（推荐）

通过 Agent Panel 可视化界面添加，无需手动编辑 JSON 文件。

操作步骤

1. 按下快捷键 Cmd + Shift + A（Windows/Linux: Ctrl + Shift + A）打开 Agent Panel。
2. 在 LLM Providers 区域点击 + Add Provider。
3. 按照下方表格输入配置信息：

序号	字段名	配置值
①	Provider Name	OPE.AI
②	API URL	https://api.ope.ai/v1
③	API Key	您的 OPE.AI API Key
④	Model Name	Claude-4.6-Sonnet
⑤	Max Completion Tokens	200000
⑥	Capabilities	勾选 Tools 和 Images（视模型而定）

4. 点击 + Add Model 继续添加其他模型（如 claude-opus-4.6、gpt-5.4-pro 等）。

编辑 settings.json

适合批量添加多个模型，编辑配置文件更高效。

操作步骤

1. 按下 Cmd + ,（Windows/Linux: Ctrl + ,）打开设置。
2. 点击右上角的 Edit in settings.json。
3. 在配置文件中添加以下内容：

~/.config/zed/settings.json

{
  "language_models": {
    "openai_compatible": {
      "OPE.AI": {
        "api_url": "https://api.ope.ai/v1",
        "available_models": [
          {
            "name": "Claude-4.6-Sonnet",
            "display_name": "Claude Sonnet 4.6",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "Claude-4.6-Opus",
            "display_name": "Claude Opus 4.6",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "Claude-4.5-Haiku",
            "display_name": "Claude Haiku 4.5",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "GPT-5.4-Pro",
            "display_name": "GPT-5.4 Pro",
            "max_tokens": 1050000,
            "max_output_tokens": 128000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          },
          {
            "name": "GPT-5.4",
            "display_name": "GPT-5.4",
            "max_tokens": 1050000,
            "max_output_tokens": 128000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          },
          {
            "name": "DeepSeek-V3.2",
            "display_name": "DeepSeek V3.2",
            "max_tokens": 128000,
            "max_output_tokens": 8000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          },
          {
            "name": "Gemini-3-Pro",
            "display_name": "Gemini 3 Pro",
            "max_tokens": 1000000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": true
            }
          }
        ]
      }
    }
  }
}

4. 保存文件后，Zed 会自动弹出 API Key 输入对话框，输入您的 OPE.AI API Key 即可。

提示

settings.json 方式适合批量管理模型，只需编辑 available_models 数组即可添加/删除模型。

安全提示：API Key 会被安全地存储在系统密钥链（macOS Keychain / Linux Secret Service）中，不会以明文写入配置文件。

---

开始使用

Zed Agent Panel 提供两种工作模式：

模式	说明
Zed Agent	内置 AI 助手，使用您配置的 LLM Provider（如 OPE.AI）。
External Agents	外部集成插件（如 Claude Code、Gemini CLI 等），独立运行。

启动 Zed Agent 对话：

步骤	操作
①	点击编辑器左侧面板的 + 号 → 选择 Zed Agent（快捷键 Cmd/Ctrl + N）。
②	若已安装外部插件，它们会显示在 External Agents 区域。
③	在右下角的模型选择器中，切换至 OPE.AI 分组并选择具体模型。

---

推荐模型对照表

应用场景	推荐模型	参数/特性说明
核心编程	Claude-4.6-Sonnet	200K 上下文，综合能力强，响应快。
顶级推理	Claude-4.6-Opus	200K 上下文，最强推理，适合架构设计。
快速问答	Claude-4.5-Haiku	200K 上下文，极速响应，低成本。
超长上下文	GPT-5.4-Pro	1M 上下文，OpenAI 旗舰模型。
高性价比	DeepSeek-V3.2	128K 上下文，极低成本，高频调用首选。

完整模型列表请查看 模型价格说明。

---

模型配置参考

每个模型需要以下参数：

字段	必填	说明
name	是	模型 ID（如 Claude-4.6-Opus、GPT-5.4）
display_name	否	UI 显示名称
max_tokens	是	上下文窗口大小（如 200000）
max_output_tokens	否	最大输出 Token 数（如 64000）
capabilities.tools	否	是否支持 Function Calling
capabilities.images	否	是否支持图像输入

常用模型配置速查表

模型 ID	Max Tokens	Max Output	Tools	Images
Claude-4.6-Opus	200000	64000	是	是
Claude-4.6-Sonnet	200000	64000	是	是
Claude-4.5-Haiku	200000	64000	是	是
GPT-5.4-Pro	1050000	128000	是	否
GPT-5.4	1050000	128000	是	否
DeepSeek-V3.2	128000	8000	是	否
Gemini-3-Pro	1000000	64000	是	是

---

排查与修复（Troubleshooting）

模型列表未显示 OPE.AI Provider

• 确认已在 Agent Panel 或 settings.json 中正确添加 Provider。
• 尝试重启 Zed Editor。
• 检查 API URL 是否正确：https://api.ope.ai/v1

认证失败错误

• 确认 API Key 格式正确（以 sk- 开头）。
• 打开命令面板 Cmd/Ctrl + Shift + P → 搜索 language model: reset credentials → 重新输入 Key。
• 登录 OPE.AI 控制台 确认 Key 有效。

工具调用（Tool Use）无响应

• 确认在配置中设置了 "capabilities": { "tools": true }。
• 部分模型不支持工具调用，请参考上方速查表。

模型返回错误或超时

• 检查网络连接，确认能访问 https://api.ope.ai。
• 尝试切换到其他模型（如 Claude-4.5-Haiku）测试。
• 查看 Zed 日志：Help > View Logs。

相关链接

• Zed 官方文档
• OPE.AI 控制台
• OPE.AI API 文档
• 模型价格说明