# Zed Editor 接入 OfoxAI 配置指南

Source: https://ofox.io/zh/docs/integrations/zed

![Zed Editor 中配置 OfoxAI](https://ofox.io/images/integrations/zed.png)

## 为什么选 Zed？

[Zed](https://zed.dev) 是目前 AI 编码体验最完整的编辑器：

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

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

## 快速开始

### 1. 获取 API Key

前往 [OfoxAI 控制台](https://app.ofox.io) 创建 API Key。

### 2. 添加 Provider

**Agent Panel 添加（推荐）**

通过 Agent Panel 可视化添加，无需编辑 JSON。

1. 按 `⌘ + Shift + P` 打开命令面板，选择 `agent: open settings`
2. 点击 LLM Providers 区域的 **+ Add Provider**
3. 按下图填写配置：

![Zed 添加 OfoxAI Provider](https://ofox.io/images/integrations/zed03.png)

| 标注 | 字段 | 值 |
|-----|------|---|
| ① | Provider Name | `OfoxAI` |
| ② | API URL | `https://api.ofox.io/v1` |
| ③ | API Key | 你的 OfoxAI API Key |
| ④ | Model Name | `openai/gpt-6.1-sol` |
| ⑤ | Max Completion Tokens | `512000` |
| ⑥ | Capabilities | 勾选模型支持的能力 |

点击 **+ Add Model** 继续添加更多模型。

**settings.json 配置**

通过 `settings.json` 批量配置所有模型。

1. 按 `⌘ + ,` 打开设置，点击右上角 **Edit in settings.json**
2. 添加以下配置：

```json filename="~/.config/zed/settings.json"
{
  "language_models": {
    "openai_compatible": {
      "OfoxAI": {
        "api_url": "https://api.ofox.io/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-6-luna",
            "display_name": "GPT-6 Luna",
            "max_tokens": 256000,
            "max_output_tokens": 32768,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "moonshotai/kimi-k2.6",
            "display_name": "Kimi K2.6",
            "max_tokens": 262144,
            "max_output_tokens": 262144,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "qwen/qwen3.7-max",
            "display_name": "Qwen3.7 Max",
            "max_tokens": 256000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          }
        ]
      }
    }
  }
}
```

3. 保存后，Zed 会弹出输入框要求输入 API Key

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

API Key 安全存储在系统钥匙串（macOS Keychain / Linux Secret Service）中，不会明文写入配置文件。

## 开始使用

Zed Agent Panel 有两种模式：

| 模式 | 说明 |
|-----|------|
| **Zed Agent** | 内置 AI 助手，使用你配置的 LLM Provider（如 OfoxAI） |
| **External Agents** | 外部 Agent（Claude Code、Codex CLI、Gemini CLI），独立运行 |

使用 **Zed Agent** 开始对话：

![Zed Agent Panel 模型选择](https://ofox.io/images/integrations/zed04.png)

| 步骤 | 操作 |
|-----|------|
| ① | 点击 **+** → 选择 **Zed Agent**（`⌘ + N`） |
| ② | External Agents 区域展示已连接的外部 Agent |
| ③ | 右下角模型选择器 → **OfoxAI** 分组 → 选择模型 |

![Zed Agent 对话演示](https://ofox.io/images/integrations/zed05.png)

## 推荐模型

推荐模型请参考 [模型广场](https://ofox.io/zh/models)。

## 添加更多模型

每个模型需要以下参数：

| 字段 | 必填 | 说明 |
|-----|------|------|
| `name` | 是 | 模型 ID，如 `openai/gpt-6.1-sol` |
| `display_name` | 否 | UI 显示名称 |
| `max_tokens` | 是 | 上下文窗口大小 |
| `max_output_tokens` | 否 | 最大输出 token 数 |
| `capabilities.tools` | 否 | 是否支持 Function Calling |
| `capabilities.images` | 否 | 是否支持图片输入 |

### 高手实践

手动填参数太慢？点击本页右上角 **Copy Page** 复制全文（或直接发送本页 URL），连同 `https://api.ofox.io/v1/models` 一起发给 AI，让它自动生成完整的 `settings.json` 配置。

进入设置页面 → 点击右上角 **Edit in settings.json** 即可粘贴：

![Edit in settings.json](https://ofox.io/images/integrations/zed02.png)

## 故障排除

**模型列表中看不到 OfoxAI**

确认 `settings.json` 格式正确，保存后重启 Zed。

**提示认证错误**

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

**模型不支持工具调用**

将 `capabilities.tools` 设为 `false`。