Zed 编辑器 AI 配置完整教程：接入 OfoxAI 自定义 LLM Provider（2026）

摘要

Zed 是一款用 Rust 编写的高性能代码编辑器，内置了 Agent 功能和对外部 AI 工具的原生支持。通过 OpenAI 兼容协议，你可以将 OfoxAI 作为自定义 LLM Provider 接入 Zed，在编辑器内使用 GPT-5.4-mini、GPT-5.3 Codex、Kimi K2.5、Qwen3-Max 等模型。本文介绍两种配置方式（Agent Panel GUI 和 settings.json），以及 Zed Agent 的使用方法。

为什么在 Zed 里用 AI

Zed 和 VS Code 的 AI 集成思路不同。VS Code 需要安装各种第三方扩展，Zed 把 AI 作为编辑器一等功能直接内置：

• 原生 Agent 支持：内置 Claude Code、Codex CLI、Gemini CLI 作为外部代理
• 自定义 LLM Provider：通过 OpenAI 兼容协议接入任意模型
• 高性能：Rust 编写，启动快、占用低

搭配 OfoxAI，一个 API Key 即可在 Zed 中使用 100+ 主流大模型。

前置准备

1. 获取 API Key：前往 OfoxAI 控制台 创建 API Key
2. 安装 Zed：从 zed.dev 下载最新版本

方式一：通过 Agent Panel GUI 添加（推荐）

无需编辑 JSON，全程图形界面操作：

1. 按 ⌘ + Shift + A 打开 Agent Panel
2. 点击 LLM Providers 区域的 + Add Provider
3. 填写以下信息：

4. 点击 + Add Model 继续添加更多模型

方式二：通过 settings.json 手动配置

适合批量配置所有模型。按 ⌘ + , 打开设置，点击右上角 Edit in settings.json：

添加以下配置：

{
  "language_models": {
    "openai_compatible": {
      "OfoxAI": {
        "api_url": "https://api.ofox.ai/v1",
        "available_models": [
          {
            "name": "openai/gpt-5.3-codex",
            "display_name": "GPT-5.3 Codex",
            "max_tokens": 512000,
            "max_output_tokens": 65536,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "openai/gpt-5-mini",
            "display_name": "GPT-5 Mini",
            "max_tokens": 256000,
            "max_output_tokens": 32768,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "moonshotai/kimi-k2.5",
            "display_name": "Kimi K2.5",
            "max_tokens": 262144,
            "max_output_tokens": 262144,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "bailian/qwen3-max",
            "display_name": "Qwen3 Max",
            "max_tokens": 256000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          }
        ]
      }
    }
  }
}

保存后，Zed 会弹出输入框要求输入 API Key。输入一次后保存到系统钥匙串，后续不需要重复输入。

settings.json 适合批量添加模型，后续增删直接编辑 available_models 数组即可。

配置字段说明

每个模型需要以下参数：

API Key 安全存储

API Key 安全存储在系统钥匙串中（macOS Keychain / Linux Secret Service），不会明文写入配置文件。即使你把 dotfiles 推送到 GitHub，也不会泄露 API Key。

使用 Zed Agent

Zed Agent Panel 有两种模式：

使用 Zed Agent 开始对话：

1. 点击 + → 选择 Zed Agent（⌘ + N）
2. 右下角模型选择器 → OfoxAI 分组 → 选择模型
3. 开始对话

Zed Agent 可以读取项目上下文、调用工具、直接修改文件（修改前显示 diff 供确认）。

推荐模型

完整模型列表见 OfoxAI 模型目录。

高手实践：让 AI 帮你生成配置

手动填参数太慢？把本文的配置格式连同 https://api.ofox.ai/v1/models 一起发给 AI，让它自动生成完整的 settings.json 配置。进入设置页面 → 点击右上角 Edit in settings.json 即可粘贴。

常见问题排查

模型列表中看不到 OfoxAI

确认 settings.json 格式正确（合法 JSON，无多余逗号、括号配对），保存后重启 Zed。

提示认证错误

命令面板 ⌘ + Shift + P → 搜索 language model: reset credentials → 重新输入 API Key。

模型不支持工具调用

将 capabilities.tools 设为 false。不声明不影响基础对话功能。

模型无响应

确保 API URL 是 https://api.ofox.ai/v1，必须包含 /v1。不要写成 https://api.ofox.ai/v1/chat/completions，Zed 会自动拼接后面的路径。模型 name 必须和 API 平台的 Model ID 完全一致（带 provider/ 前缀）。

总结

Zed 的 AI 集成是原生内置路线，不需要安装扩展，配置简单直接。两种配置方式各有适用场景：快速试用选 Agent Panel GUI，批量管理选 settings.json。配置完成后，API Key 安全存储在系统钥匙串中，日常使用无需操心 Key 管理。

完整配置文档和模型列表参考 OfoxAI Zed 集成文档。