Zed Editor
為什麼選 Zed？
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. 新增 Provider
Agent Panel 新增（推薦）
透過 Agent Panel 視覺化新增，無需編輯 JSON。
- 按
⌘ + Shift + A開啟 Agent Panel - 點選 LLM Providers 區域的 + Add Provider
- 按下圖填寫設定：
| 標註 | 欄位 | 值 |
|---|---|---|
| ① | Provider Name | OfoxAI |
| ② | API URL | https://api.ofox.ai/v1 |
| ③ | API Key | 你的 OfoxAI API Key |
| ④ | Model Name | openai/gpt-5.2 |
| ⑤ | Max Completion Tokens | 512000 |
| ⑥ | Capabilities | 勾選模型支援的能力 |
點選 + Add Model 繼續新增更多模型。
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（⌘ + N） |
| ② | External Agents 區域展示已連線的外部 Agent |
| ③ | 右下角模型選擇器 → OfoxAI 分組 → 選擇模型 |
推薦模型
| 場景 | 模型 | 說明 |
|---|---|---|
| Agent 編碼 | openai/gpt-5.2 | 512K 上下文，綜合最強 |
| 快速問答 | openai/gpt-5-mini | 256K 上下文，高速低成本 |
| 超長輸出 | moonshotai/kimi-k2.5 | 262K 上下文 / 262K 輸出 |
| 中文場景 | bailian/qwen3-max | 256K 上下文，中英雙語 |
完整模型列表見 模型目錄。
新增更多模型
每個模型需要以下參數：
| 欄位 | 必填 | 說明 |
|---|---|---|
name | 是 | 模型 ID，如 openai/gpt-5.2 |
display_name | 否 | UI 顯示名稱 |
max_tokens | 是 | 上下文窗口大小 |
max_output_tokens | 否 | 最大輸出 token 數 |
capabilities.tools | 否 | 是否支援 Function Calling |
capabilities.images | 否 | 是否支援圖片輸入 |
高手實踐
手動填參數太慢？點選本頁右上角 Copy Page 複製全文（或直接傳送本頁 URL），連同 https://api.ofox.ai/v1/models 一起發給 AI，讓它自動生成完整的 settings.json 設定。
進入設定頁面 → 點選右上角 Edit in settings.json 即可貼上：
故障排除
模型列表中看不到 OfoxAI
確認 settings.json 格式正確，保存後重新啟動 Zed。
提示認證錯誤
命令面板 ⌘ + Shift + P → 搜尋 language model: reset credentials → 重新輸入 API Key。
模型不支援工具呼叫
將 capabilities.tools 設為 false。
Last updated on