<!-- title: Zed白嫖AI的8个暗门没人讲 -->
<!-- domain: tips-tricks -->

你大概率听过 Cursor、Copilot，甚至已经把钱交给了其中一家。但海外开发社区这两年悄悄换了一个答案：Zed——用 Rust 写的开源编辑器，2025 年起把 AI 能力做成了「面板 + 协议」两层架构，最快版本下你可以**把自己已有的 Claude Code、Gemini CLI 订阅直接塞进编辑器里跑**，一分钱不用多花。这件事国内几乎没有像样的中文教程，本文把你不知道的 8 个暗门一次讲透。所有功能入口均以 zed.dev 官方文档为准（截至 2026 年 9 月），版本迭代快，操作路径如有出入请以你本机设置面板为准。

## 背景：为什么值得花十分钟了解 Zed

Zed 由 Atom 编辑器原班团队打造，卖点是协作和性能，GitHub 上长年处于编辑器品类的热度第一梯队。对中文用户真正的价值在于：它没有把 AI 做成封闭订阅，而是做成了**可插拔的接口**——内置 Agent 面板只是默认选项，你完全可以换成自己的 API、本地模型，甚至把整个命令行 Agent「外挂」进来。换句话说，Zed 是目前对「不想被单一厂商绑定」最友好的主流编辑器，而这恰恰是国内教程最不爱讲的部分。

## 暗门一：ACP 协议，把 Claude Code 装进编辑器

这是全文最大的信息差。Zed 推出了 Agent Client Protocol（ACP），允许外部命令行 Agent 以「服务器」身份接入 Agent 面板。**操作步骤**：打开 Agent 面板 → 设置里选择 Add Agent Server → 选 Claude Code 或 Gemini CLI，Zed 会自动探测你本机已安装的 CLI 并拉起进程。**预期效果**：CLI Agent 的能力（执行命令、改文件、跑测试）全部出现在编辑器的图形界面里，diff 可视化、点击确认，但计费走的是你 CLI 自带的订阅额度，**不消耗 Zed 的内置额度**。**适用场景**：已经订了 Claude Pro / Gemini 付费档的人，等于订阅价值直接翻倍——终端里能干的事，编辑器里也能干。协议官网是 agentclientprotocol.com，第三方 Agent 也在陆续接入，这个生态位置类似当年的 LSP，值得早关注。

## 暗门二：Edit Predictions，免费行内补全别浪费

Zed 自研并开源了 Zeta 补全模型，Edit Predictions 提供整段代码的行内建议，**个人用户免费使用**（长期政策以官方定价页为准）。**操作步骤**：设置里搜索 edit_predictions，确认开启；如果你同时装了 GitHub Copilot 插件，建议二选一，两个补全源同时开会在光标处打架。**预期效果**：补全质量对标主流商业产品，且不占任何 API 额度。**适用场景**：预算为零的学生党、以及不想把代码发往第三方 API 的公司内网场景（配合暗门七的本地模型更彻底）。

## 暗门三：@ 引用，上下文喂得比别人准

多数人只会把代码粘进对话框。Zed 的 Agent 面板支持 @ 引用语法：@file 指定文件、@directory 挂整个目录、@selection 引用当前选中片段、@symbol 直接引用代码符号（函数/类名），@fetch 可以把一个 URL 的网页内容抓进上下文。**操作步骤**：在输入框敲 @ 唤出补全列表逐层选择。**预期效果**：Agent 不用全仓扫描，响应更快、token 更省、答得更准。**适用场景**：大仓库里定位问题、以及需要让 Agent 读某篇在线文档再动手改码的组合任务。新版本还在陆续加入诊断信息、终端等更多引用源，敲 @ 看列表即可发现。

## 暗门四：/diagnostics，让 Agent 自己去读报错

斜杠命令是被低估的一层。/diagnostics 会把当前项目的 lint/编译诊断信息直接注入对话上下文；/tab 把你正在打开的标签页集合交给 Agent 参考；/file 快速引用文件。**操作步骤**：输入框敲 / 查看全部可用命令。**预期效果**：最典型的工作流是「改完代码跑一遍构建 → 敲 /diagnostics → 一句“把所有报错修掉”」，Agent 拿到的是结构化的错误清单而不是你的复述，修错成功率明显更高。**适用场景**：接手老项目第一天的批量清错。

## 暗门五：.rules 文件，给 Agent 立规矩

项目根目录放一个 `.rules` 文件，Agent 面板的每次对话都会自动带上它，作用等价于 Cursor 的 .cursorrules：写清「本项目用 pnpm 不用 npm、组件库是 Ant Design、提交信息用中文」这类团队约定，Agent 的输出风格立刻收敛。**操作步骤**：根目录新建 .rules，写完保存即可，无需注册；社区常见的其他规则文件名的兼容情况以官方文档为准。**预期效果**：这是把「AI 产出像路人」变成「AI 产出像同事」成本最低的一步，但据观察超过九成 casually 用 Zed 的人从来没建过这个文件。**适用场景**：任何多人协作仓库，一次编写全队受益。

## 暗门六：Profiles 配置档，一键切换人格

Agent 面板内置了 Write / Ask 等预设档，Write 档允许改文件、Ask 档只读问答；你还可以自建配置档，比如建一个 Review 档：只读权限 + 高思考预算，专门用来做代码审查，防止审查型 Agent 手痒改代码。**操作步骤**：Agent 面板设置 → Profiles → 复制默认档修改允许的工具清单。**预期效果**：不同任务一键切换权限与模型，避免「让它分析却把文件改了」的经典事故。**适用场景**：代码评审、面试题讲解、给新人讲架构等只读场景。

## 暗门七：自定义模型端点，国内直连的正规姿势

Agent 面板的模型列表不是封闭的：设置里可以接入 OpenAI 兼容端点、OpenRouter、Ollama、LM Studio、DeepSeek 等。**操作步骤**：设置 → 搜索 model / context server 相关项 → 填入 base URL 与 key，本机先跑 `ollama serve` 即可发现本地模型。**预期效果**：内网跑本地模型零 API 成本、数据不出机器；外网场景用 DeepSeek/OpenRouter 直连，无需为某个硅谷订阅辗转付款。**适用场景**：这是对国内用户最实际的暗门——Zed 对第三方端点的开放程度远超多数商业编辑器，等于一份编辑器吃遍所有模型供应商。

## 暗门八：协作功能，免费却没人用

Zed 起家本领是多人实时协作：频道（channels）、语音通话、光标跟随、共享缓冲区，个人使用免费，却经常被 AI 用户彻底忽略。Agent 会话本身也能生成分享链接发给同事复现问题。**操作步骤**：左侧栏切到 Collab 面板 → 创建频道 → 拉人进频道共享项目。**预期效果**：结对编程不用再开屏幕共享，延迟低到像操作同一台机器。**适用场景**：远程小队复盘、导师带教、让队友「看着我改」的场景。

## 三条接入路线怎么选

```mermaid
flowchart TD
    S["在Zed里用AI的三条路"] --> A["路线一：内置Agent面板"]
    S --> B["路线二：外挂CLI接入ACP"]
    S --> C["路线三：自定义模型端点"]
    A --> A1["Zed托管的各家模型"]
    A --> A2["按量扣Zed额度"]
    B --> B1["装Claude Code或Gemini CLI"]
    B --> B2["复用CLI自己的订阅"]
    C --> C1["Ollama本机跑本地模型"]
    C --> C2["DeepSeek或OpenRouter直连"]
    A2 --> D["适合轻度尝鲜用户"]
    B2 --> E["已有CLI订阅的性价比之王"]
    C1 --> F["离线隐私零API成本"]
```

一句话版：**有 CLI 订阅走路线二，注重隐私走路线三，都想试再开路线一**。

## 信息差总结

| 大多数人以为 | 实际上 |
|---|---|
| Zed 只是「快」的编辑器 | AI 架构是可插拔的，面板只是默认壳 |
| 用编辑器 AI 必须再买一份订阅 | ACP 外挂 CLI，复用已有订阅额度 |
| 补全都要按月付费 | Edit Predictions 个人免费 |
| 上下文只能靠粘贴 | @ 引用 + /diagnostics 结构化喂料 |
| Agent 输出风格没法管 | 一个 .rules 文件全场收敛 |
| 只能绑硅谷大厂模型 | Ollama/DeepSeek/OpenRouter 随便接 |
| AI 和协作是两回事 | Agent 会话可分享，协作面板免费 |

## 行动指南

1. **今天**：去 zed.dev 下载对应平台版本，设置里确认 edit_predictions 已开启（暗门二，五分钟见效）。
2. **本周**：本机装好 Claude Code 或 Gemini CLI，在 Zed 里通过 Add Agent Server 接入（暗门一），把现有订阅吃满。
3. **本周**：给最活跃的项目根目录建 .rules，写上包管理器、组件库、命名规范三条（暗门五）。
4. **本月**：跑通一条本地模型链路（Ollama + 暗门七），作为订阅断供或内网环境的兜底方案。

## 参考来源

1. Zed 官方 AI 总览与 Agent 面板文档：https://zed.dev/ai
2. Zed 官方文档（设置、规则文件、模型接入）：https://zed.dev/docs
3. Agent Client Protocol 协议站（外挂 CLI 接入规范）：https://agentclientprotocol.com
4. Zed 官方博客（版本发布与 AI 更新公告）：https://zed.dev/blog

---
> 本文由「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学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
