首页 › tips-tricks › Zed真身:Agent万能插座,快只是皮

你印象里的 Zed,大概还停留在那个“Rust 写的超快编辑器”——装上试试,快是真快,然后就没有然后了。但过去一年,Zed 悄悄换了个活法:它把自己变成了一个Agent 万能插座。Claude Code、Gemini CLI、Codex、OpenCode 这些终端里的 AI Agent,现在都能通过一个叫 ACP(Agent Client Protocol) 的开放协议,直接跑进 Zed 的图形界面里干活——带 diff 预览、带文件树、带权限弹窗。

我按惯例搜了几轮海外资料,能找到的深度拆解几乎清一色是英文源:官方文档、2026 年 4 月的生态报道、5 月的配置指南、6 月的跨 IDE 实战文,铺了一整年。而中文圈对 Zed 的讨论,大多还停留在“装哪个版本”和“确实挺快”。这篇文章就把这层窗户纸捅破:8 个具体开关,读完就能上手。

一、多数人想错了:Zed 的主线早就不是“快”

先补个背景。Zed 是 Atom 原班人马用 Rust 重写的编辑器,开源,主打性能。2024 年它开始 AI 化,最早是个简单的 Assistant 面板;到 2025-2026 年,重心彻底转向了 Agent Panel——官方文档的原话是“这是 Zed AI 体验的核心,Agent 可以读你的代码、写你的代码、跑你的命令”。

真正的转折点是 ACP。这个协议被海外开发者比作“LSP 的 Agent 版”——当年 LSP 统一了编辑器和语言服务器的通信,ACP 想统一的是编辑器和 AI Agent 的通信。它是 Apache 协议的开源标准,走 stdio 上的 NDJSON 通信。2026 年 4 月,agentmarketcap.ai 专门写了篇报道,标题就叫“那个让你在 IDE 里跑 Claude Code 的编辑器正式发车了”。

对中文用户来说,这意味着一件事:你不用再站队“Cursor 还是 Claude Code”了。终端归终端,GUI 归 GUI,中间用协议连起来,随时可换。

二、暗门一:把 Claude Code「装进」图形界面

这是本轮最大的信息差,先给操作步骤:

  1. 本机装好 Claude Code 或 Gemini CLI(终端里能跑就行);
  2. Zed 里打开命令面板,执行 agent: open settings,直达设置页的 AI 分区;
  3. 找到 External Agents,添加 Agent Server——Zed 会自动发现本机的 CLI;
  4. 回到 Agent Panel,顶部切换到刚加的 Agent,开始对话。

根据 Zed 官方文档,目前官方列出的外接 Agent 包括:Claude Code、Codex、OpenCode、Copilot、Cursor CLI,以及 Pi Coding Agent。其中 Gemini CLI 是协议的参考实现,Claude Code 默认内置适配(官方维护了一个 claude-code-acp 适配器,走 NDJSON over stdio 和 Zed 通信)。

看清楚这个名单里的“Cursor”了吗?没错,连竞争对手的 CLI 都能插进来。Zed 的算盘很明白:编辑器不锁人,Agent 随便换。

更划算的是,ACP 不是 Zed 私有协议。2026 年 6 月 danilchenko.dev 的实战文演示了同一份配置在 JetBrains、Zed、Neovim 三端跑 Claude Code——学会一次,三端复用。

flowchart TD
    U["你:在 Zed 里对话"] --> P["Agent Panel 面板"]
    P -->|ACP 协议| C["Claude Code"]
    P -->|ACP 协议| G["Gemini CLI"]
    P -->|ACP 协议| X["Codex 或 OpenCode"]
    P -->|MCP 协议| M["MCP 服务器"]
    M --> D["数据库 文档 浏览器"]
    C --> R["代码仓库 diff"]
    G --> R
    X --> R

三、暗门二:一个 Claude Code 开两份,互不打架

外接 Agent 不是只能加一个。2026 年 5 月,开发者 Alorse 在 GitHub Gist 上发了一份配置指南:在 Zed 里注册多个同款 Agent Server,每个指向不同的 Claude Code 实例——不同模型、不同权限、不同预算,各自独立。

实际用法很野:一份配便宜模型,专门跑“帮我改注释、补测试”这种杂活;另一份配旗舰模型加全量权限,只在做大重构时调用。在 Agent Panel 顶部一键切换,账单和风险都隔离开。对按 token 计费的用户,这一招直接决定月底账单的形状。

四、暗门三:Profiles——给 Agent 戴上三种镣铐

Zed 自带 Agent 有三个内置档案,官方文档写得很清楚:

面板左下角点击 Write | Ask 按钮就能切换,命令面板里 agent: manage profiles 可以管理自定义档案——你可以在 settings 里建一个自己的只读档案,只勾选你想开放的少数工具。

最实用的场景:接手老项目第一天,切 Ask 档案。让它先把代码库摸一遍、画个架构认知出来,全程零写入风险。等你自己对项目有了判断,再放它动手。

flowchart TD
    S["这次让 Agent 干嘛"] --> Q["只问不改"]
    S --> W["要改代码"]
    S --> N["纯闲聊"]
    Q --> A["Ask 档案 只读"]
    N --> MI["Minimal 档案"]
    W --> B{"改动大不大"}
    B -->|小| Z["Write 档案 自带 Agent"]
    B -->|大| E["外接 Claude Code"]

五、暗门四:家规文件“三吃”,搬家不用重写

每个 Agent 工具都有自己的家规文件:Claude Code 读 CLAUDE.md,新兴工具读 AGENTS.md,Zed 自己用 .rules。好消息是,2026 年的 Zed 三种都认。

官方文档确认:worktree 顶层的 .rules 文件会自动注入你和 Agent Panel 的每一次对话。而第三方 promptshelf.dev 在 2026 年 7 月的拆解进一步确认:Zed 内置 Agent 会按优先级读取 AGENTS.md、CLAUDE.md 和传统 .rules 文件,旧的 Rules Library 机制已经移除。

这对中国用户的实际意义:你从 Cursor 或 Claude Code 搬到 Zed,项目级提示词一行都不用改。家规里写清楚代码风格、commit message 格式、哪些目录不许碰,所有 Agent 通吃。

六、暗门五:Review Changes 是最后一道闸

Agent 干完活,怎么验收?Zed 给了个体面的答案:面板会统计改了几个文件、动了几行,点 Review Changes(快捷键 Ctrl+Shift+R)会打开一个多缓冲 diff 视图,所有改动逐块过目。

但这里有个海外社区正在吐槽的坑,值得你知道:GitHub discussion #47695 里开发者反映,目前外接 Agent(比如 Claude Code 经 ACP)提出编辑时,用户是先批准、后看 diff——审批那一刻看不到具体改动内容。所以实操纪律是:权限给小不给大,敏感目录让 Ask 档案守着,改完第一时间过 Review Changes,别攒着。

七、暗门六:MCP 上下文服务器,给 Agent 接外挂

Zed 对 MCP(Model Context Protocol)的支持走的是 context_servers 配置,写进 settings.json,支持 stdio 和 HTTP 两种传输。官方文档说明目前支持 MCP 的 Tools 和 Prompts 两类能力。

通俗讲:ACP 给 Zed 接“Agent 大脑”,MCP 给 Agent 接“外部器官”——数据库查询、文档检索、浏览器操作,都能变成 Agent 可调用的工具。两套协议在 Zed 里是并存互补关系,这也是它比很多“单协议编辑器”灵活的地方:大脑可以天天换,器官不用重插。

八、暗门七:Zeta 补全,白嫖且不扣你的 API 额度

行间补全(Edit Prediction)这块,Zed 用的是自研的 Zeta 模型。打开设置搜 edit_predictions,provider 显示 Zed AI 就是在用官方托管版——跑在 Zed 服务器上,不消耗你自己配置的任何 API key 额度,登录账号即用。

对国内用户的隐藏价值:代码补全是高频低脑力的活,交给托管 Zeta;你那些按量付费的 Claude/GPT 额度,留给 Agent Panel 里的真刀真枪。补全零成本,Agent 花大钱,层次分明。第三方 provider 也支持更换,想接 Copilot 或 Codestral 做补全的,同一个设置页里能改。

九、暗门八:agent: open settings 一个入口管全部

最后这个最不起眼但最常用。Zed 把模型提供商、External Agents、MCP 服务器全部收进设置编辑器的 AI 分区,一条命令 agent: open settings 直达,不用翻各种菜单。

配合 BYOK(自带 key)玩法:Anthropic、OpenAI、Google 之外,OpenRouter、本地 Ollama 这类方案也都在支持之列。中国用户的经典分层是——补全用 Zeta、日常问答用 DeepSeek 或 OpenRouter 的便宜档、大重构切外接 Claude Code,每一层都在同一个页面管理。

信息差总结

你以为的 实际情况
Zed 就是个快的编辑器 它是 ACP 协议的旗舰宿主,Claude Code/Codex/Cursor CLI 都能插进来
想用 Claude Code 必须忍受终端 Agent Panel 给它配齐 diff 预览、文件树、GUI 审批
换编辑器要重写一遍提示词 CLAUDE.md / AGENTS.md / .rules 三种家规通吃
Agent 权限全开或全关 Write/Ask/Minimal 三档档案 + 自定义细粒度工具开关
补全也在烧你的 API 额度 Zeta 托管补全登录即用,不吃自己的 key
ACP 是 Zed 私有玩意 Apache 开源标准,JetBrains、Neovim 同样能接

行动指南

  1. 今天:装 Zed,登录账号,确认 edit_predictions 里 provider 是 Zed AI,白嫖先跑起来;
  2. 本周:本机装 Gemini CLI(免费额度最大方),在 Zed 里走一遍外接流程,感受 GUI 版终端 Agent;
  3. 顺手做:把现有 CLAUDE.md 复制一份改名 .rules 放项目根目录,验证家规注入;
  4. 建纪律:建一个自定义只读档案,接手新项目先用 Ask 摸底;
  5. 进阶:照 Alorse 的 Gist 配两个同款 Agent Server,杂活和硬仗分开记账。

这个赛道的走向已经很明显:编辑器在变成“Agent 的驾驶舱”,协议层在变成新的护城河。Zed 押注 ACP 押得早也押得狠,而现在中文圈的教程密度还远没跟上——这正是先行者的窗口期。

参考来源

  1. Zed 官方文档 · External Agents:https://zed.dev/docs/ai/external-agents
  2. Zed 官方 · Agent Client Protocol:https://zed.dev/acp
  3. Zed 官方文档 · Agent Profiles / Agent Panel:https://zed.dev/docs/ai/agent-profiles
  4. Zed MCP 集成文档:https://zed.dev/docs/ai/mcp
  5. ACP 跨 IDE 实战(JetBrains/Zed/Neovim,2026-06):https://www.danilchenko.dev/posts/agent-client-protocol/
  6. 多 Claude Code 实例配置 Gist(2026-05):https://gist.github.com/Alorse/7ffbe04d22ed05f27632c331dfeb25f5

本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生(微信ID: gprshome201101)维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。

[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。

51学通信知识星球海报-扫码加入