Zed 編輯器完整教學 2026：9.1 萬星 Rust 極速開源編輯器，Agent Panel、ACP 外部代理（Claude Code／Codex）、MCP 與自架 Ollama（安裝、設定、實戰一次學會）

Zed 是由 Atom 與 Tree-sitter 作者打造、以 Rust 撰寫並用 GPU 渲染的開源程式編輯器，GitHub 約 9.1 萬顆星（zed-industries/zed），主打極低延遲與原生協作。它有免費永久方案，AI 部分支援自備 API key，也能用 Ollama 或 LM Studio 跑本機模型，並可透過 ACP（Agent Client Protocol）直接掛上 Claude Code、Codex 等外部代理。

如果你已經在觀望「換掉 VS Code 但不想被鎖進某一家 AI 訂閱」，Zed 的架構正好切中這個需求：編輯器與 AI 供應商解耦。

為什麼 2026 年值得學 Zed

三個理由：

1. 效能不是行銷詞，是架構差異。Zed 用 Rust 寫成，UI 走 GPU 渲染；這是 Electron 系編輯器（VS Code、Cursor 都是）在大量檔案與長檔案上最難追平的地方。
2. AI 供應商可換、可自架。Zed 官方明列支援 Amazon Bedrock、Anthropic、GitHub Copilot、DeepSeek、Google AI、LM Studio、Mistral、Ollama、OpenAI、OpenRouter、Vercel 等；你可以一條 key 都不用買，全部走本機 Ollama。
3. ACP 讓「外部代理」變成外掛。Claude Code、Codex、Gemini CLI、Cursor、OpenCode 都能以 ACP 整合的方式裝進 Zed，用 Zed 的 Agent Panel 操作——帳號與計費仍歸各家代理自己。

專案本身約每週發布新版本，且維持高度活躍（GitHub 上最後一次 push 就在 2026 年 10 月 3 日）。

安裝：三平台指令一次給

Linux 想指定版本或搶先試預覽版：

# 指定版本
curl -f https://zed.dev/install.sh | ZED_VERSION=0.216.0 sh

# 預覽版（比穩定版早約一週拿到更新）
curl -f https://zed.dev/install.sh | ZED_CHANNEL=preview sh

用安裝腳本裝的 Zed 可以完整移除：執行 zed --uninstall，它會問你要不要保留設定。

系統需求重點：

• Linux：需要 Vulkan 1.3 驅動，以及 org.freedesktop.portal.FileChooser、OpenURI、Secret（或 Secrets）三個 desktop portal。這是最容易卡關的一項，尤其在無桌面環境或老舊顯卡上。
• macOS：macOS 12（Monterey）以上完整支援；Big Sur 與 Catalina 為「部分支援」（螢幕分享功能不可用）。
• Windows：需要支援 DirectX 11 的 GPU 與各家原廠驅動程式，不能用 Microsoft Basic Display Adapter。

提醒：Zed 的官網網域比較容易被企業網路的安全設備或掃描規則擋下。若 curl … zed.dev/install.sh 被阻斷，改用 Homebrew／winget 或直接到官方下載頁拿安裝檔最穩。

搞懂 Zed 的 AI 三條路，才不會走錯

這是初學者最常混淆的地方。Zed 的 AI 不是「一個功能」，而是三個入口：

關鍵細節：External Agent 用自己的程序、自己的登入與計費。你在 Zed 裡設好的 Anthropic API key，不會自動設定 Claude Agent；反之亦然。

Agent Panel 實戰：從開啟到多執行緒並行

打開 Agent Panel：在 Command Palette 執行 agent: new thread，或點狀態列的 ✨ 圖示。

必背快捷鍵（macOS 為 cmd，其他平台為 ctrl）：

幾個真正會改變工作流的設計：

• 多執行緒並行：每個執行緒有自己的代理、上下文與歷史，互不干擾。若兩個執行緒可能改到同一批檔案，可以用 worktree 隔離（在標題列切換 worktree），避免互相覆蓋。
• Checkpoint 還原：模型每次動你的檔案，訊息上方都會出現「Restore Checkpoint」，可以一鍵把 codebase 還原成該則訊息之前的狀態。中途中斷也保留——這正是你判斷「方向不對」的時刻。
• @-mention 餵 context：在訊息編輯器打 @，可提及檔案、目錄、符號、先前的執行緒、Skills、診斷訊息（diagnostics）、分支 diff，甚至 URL（讓它去抓）。從 buffer 貼上多行程式碼會自動轉成 @-mention；不想被自動格式化的話用 ctrl-shift-v 貼純文字。
• 圖片輸入：支援視覺的模型（GPT-4o 之後、Claude 3 之後、Gemini 1.5／2.0、Bedrock 視覺模型）可以直接拖圖片進 Agent Panel 或複製貼上。
• Token 用量可見：面板上會顯示當前執行緒的 token 消耗；接近上限時 Zed 會自動壓縮長對話，並在執行緒裡留一則可展開的「Context Compacted」摘要。
• 跟隨代理：點面板左下角的準星，編輯器會跟著代理讀寫的檔案跳動；送出訊息時按住 cmd／ctrl 也能自動跟隨。

⚠️ 隱私注意：替代理回應評分（thumbs up/down）會把整段執行緒（你的訊息、AI 回覆、中繼資料）送到 Zed。官方文件寫得很直白：不想讓資料存在 Zed 伺服器上，就不要評分。

用 ACP Registry 把 Claude Code／Codex 掛進 Zed

這是 Zed 目前最有價值的功能。流程比想像中簡單：

1. 開啟 ACP Registry：用 Command Palette 執行 zed: acp registry。
2. 或走 Agent Settings：agent: open settings → External Agents 頁 → Add Agent → Install from Registry。
3. 裝好後，該代理就會出現在 Agent Panel 與 Threads 側邊欄的「新執行緒」選單裡。

官方文件列出的常見外部代理：Claude、Codex、OpenCode、Copilot、Cursor、Pi Coding Agent（另支援 Gemini CLI、Poolside）。這份清單是精選而非窮盡，直接開 Registry 看最新狀態最準。

登入與計費怎麼走：

• Claude Agent：裝好後開一個 Claude Agent 執行緒，執行 /login，用 API key 或 Claude Code 帳號登入。它會直接讀 CLAUDE.md 等 Claude 原生檔案。
• Codex：支援 ChatGPT 登入、Codex API key、OpenAI API key 或原生設定，看你的版本與環境。
• Gemini CLI：若環境變數有 GEMINI_API_KEY 或 GOOGLE_AI_API_KEY 就直接用；否則如果你在 Zed 設過 Google AI key，Zed 會把它當 GEMINI_API_KEY 傳給 Gemini CLI。

要自製代理（或跑還沒進 Registry 的 ACP 實作），在 Agent Settings 選 Add Custom Agent，之後在 settings.json 補上：

{
  "agent_servers": {
    "my-agent": {
      "type": "custom",
      "command": "node",
      "args": ["~/projects/agent/index.js", "--acp"],
      "env": {}
    }
  }
}

除錯用：Command Palette 執行 dev: open acp logs，可以看到 Zed 與外部代理之間的 ACP 訊息——報 issue 時請一併附上。

補充：舊的「extension 形式代理」已棄用，安裝一律改走 ACP Registry，舊的會自動遷移。

模型怎麼接：五種來源與自架管道

Zed 官方把「模型存取路徑」分成五類，選一條就好：

想要「零 AI 支出」的做法很簡單：安裝 Ollama 或 LM Studio 拉起一個模型，在 Zed 的 LLM Providers 裡選本機來源即可；或者乾脆所有 AI 工作都交給 ACP 外部代理，用你已經付費的 Claude／ChatGPT 訂閱。官方也明確表示 Zed 可以完全關閉 AI 功能，純當一個極速編輯器用。

價格：$0、$10、$30 三種方案

Pro 有 14 天免費試用，內含 $5 的 GPT-5.6 Luna 用量，不用填信用卡；試用額度在 Zed 與 Delta 之間共用。Business 目前沒有試用，但可月付、隨時取消（SSO／SAML／SCIM 官方標示為「規劃中」）。

Zed vs VS Code vs Cursor

結論：要生態系與相容性，VS Code 仍難取代；要「AI 一條龍、不想設定」，Cursor 最省事；要極速 + 模型自主權 + 不綁訂閱，Zed 是 2026 年最合理的選擇。而且三者不衝突——Zed 可以只當你處理大型專案與長檔案時的主力。

兩個實用 settings.json 設定

設定檔位置：macOS 與 Linux（未自訂 XDG_CONFIG_HOME）為 ~/.config/zed/settings.json。

{
  "agent": {
    "single_file_review": true,
    "prevent_idle_sleep": true,
    "notify_when_agent_waiting": true,
    "play_sound_when_agent_done": false
  }
}

• single_file_review：讓 diff 的「保留／拒絕」控制項直接出現在個別檔案內，而不是只在多檔案檢視頁。
• prevent_idle_sleep：代理執行期間請作業系統不要進入睡眠（螢幕仍可關、仍可鎖定），適合長回合任務。
• 後兩項控制「代理跑完要不要通知你」——桌面通知與音效可各自開關。

其他常用 key：agent.favorite_models（我的最愛模型清單）、agent.notify_when_agent_waiting、agent.play_sound_when_agent_done。

常見疑問

Q：Zed 在 Linux 上跑不起來，最可能卡在哪？ A：九成是 Vulkan 1.3 或 desktop portal。先確認顯卡驅動支援 Vulkan 1.3，再裝 xdg-desktop-portal 相關套件（FileChooser、OpenURI、Secret）。這是官方明列的硬需求。

Q：用 Zed 一定要付錢嗎？ A：不必。Personal 方案 $0 永久，限制只有「2,000 次 edit prediction」；只要你的 AI 走自備 API key、本機 Ollama 或 ACP 外部代理，就沒有其他付費牆。

Q：外部代理的費用算誰的？ A：算代理自己的。用 Claude Agent 就是你的 Anthropic 帳單，Zed 不對 External Agent 收費。

Q：Zed 會拿我的程式碼去訓練嗎？ A：官方區分得很清楚：Zed 代管 AI 有獨立隱私說明，而主動評分 AI 回覆等同把整段對話送往 Zed。不評分就不會為了改善代理體驗而收集你的資料。

延伸閱讀

• Void：整合 AI 的開源 IDE（另一款 Zed 之外的開源選擇）
• VS Code AI 插件比較：Roo Code、Cline、Kilo Code 怎麼選？
• Cursor：以 AI 為優先的程式碼編輯器，實現更快的開發
• Agent Skills 完整教學：讓 Claude Code、Cursor 自動遵循工程紀律
• Claude Code 2026 完整使用指南：從入門到多代理架構
• Open Code Review 完整教學 2026：阿里巴巴開源的 AI 程式碼審查 CLI

來源：Zed 官方 GitHub（zed-industries/zed）、Zed 文件：Installation、Zed 文件：Agent Panel、Zed 文件：External Agents（ACP）、Zed 文件：LLM Providers、Zed 定價頁、Agent Client Protocol 官網；GitHub 星數與 repo metadata 取自 GitHub API（2026-10-03）。