# 别把Zed当快编辑器：八个AI暗格 提起 Zed，大多数人的印象还停留在“那个用 Rust 写的、快得离谱的代码编辑器”。但如果你去翻它官网的文档目录会发现，AI 相关章节的篇幅已经远超编辑器本体——Agent Panel、Edit Prediction、Inline Assistant、Skills、MCP、Worktree Trust……海外开发者早就把它当 AI IDE 在用了，而中文圈连一篇像样的教程都搜不到。更关键的是：它免费版就能白嫖官方自研补全模型，你已有的 Claude/ChatGPT 订阅还能直接登录复用，一分钱 API 费不用花。这篇文章把 Zed 官方文档里埋着的八个“暗格”一次挖开，每个都有具体按键和设置项，读完就能上手。 ## 暗格一：免费白嫖 Zeta 补全，还能换成国产模型引擎 Zed 的代码补全叫 Edit Prediction，默认引擎是 **Zeta**——Zed 自研并开源的补全模型。关键信息是价格：**免费计划每月含 2,000 次 Zeta 补全**，登录账号即用，Pro 计划才解除上限。对个人开发者来说，这个免费额度日常写码基本够用。 真正的暗格在引擎可换。在 `settings.json` 的 `edit_predictions` 里，`provider` 可以切换为 GitHub Copilot（支持企业版自定义 endpoint）、Mistral 的 Codestral、Inception Labs 的 Mercury Coder，甚至 **Ollama 本地模型或任意 OpenAI 兼容接口**。官方文档给的示例直接就是 `qwen2.5-coder:7b-base` 和 `deepseek-coder-6.7b-base`——也就是说，你在 Zed 里可以用通义千问、DeepSeek 的开源模型跑本地补全，断网也能用，代码一行不出本机。 更冷门的一点：它的 `prompt_format` 配置项内置了各家模型的提示词模板，列表里赫然包括 `deepseek_coder`、`qwen`，甚至还有 `glm`（GLM-4 格式）。官方连中国模型的“方言”都适配好了，只是从没宣传过。 操作步骤：设置里搜 `edit_predictions` → 确认 `provider` 为 `zed` → 登录账号；想换本地引擎就填 Ollama 的 `api_url`（默认 `http://localhost:11434`）加模型名。适用场景：公司代码不能出内网的合规党、不想再为补全付月费的独立开发者。 ## 暗格二：多线程并行开 Agent，怕打架就开 Git worktree 隔离 大部分人用 AI 编码是“一个聊天框聊到底”。Zed 的 Agent Panel 支持同时跑**多个 agent 线程**，每个线程有独立的上下文窗口和历史记录。按 `ctrl-alt-j` 打开线程侧边栏（按项目分组），`ctrl-tab` 在最近线程间快速切换，不用的线程悬停点归档（`shift-backspace`）。 真正的深水功能是 **Worktree Isolation**：如果两个线程可能改同一批文件，你可以把其中一个线程隔离进一个新建的 Git worktree 里跑——相当于给每个 Agent 发了一间独立办公室，改完了再合并。标题栏的 worktree 选择器一键创建。一个线程在重构核心模块、另一个线程在写新功能，互不踩脚，这是目前多数 AI IDE 都没有的能力。 适用场景：你有一个以上的并行任务，或者想让 AI 先在一个“沙盒副本”里试错。 ## 暗格三：Steer 插话——不等 Agent 跑完就纠偏 Agent 跑偏了怎么办？多数人的做法是点停止、重新描述。Zed 的做法更细：Agent 生成期间你发的消息**默认进入队列**，等它跑完这一轮再发送；但每条排队消息上有个 **Steer 开关**，打开后消息会在下一个步骤间隙（通常是两次工具调用之间）插进去，让 Agent 立刻转向，不用等整轮结束。想强行立即打断，点排队消息上的 "Send Now" 即可。 另外所有发过的消息都可以**点击卡片直接改写重发**——改个提示词重跑，比新开线程省得多。这套“排队 + 插话 + 改写”的组合拳，是跟 AI 协作时控制成本和方向的核心技巧。 ## 暗格四：Checkpoint 回滚 + 逐块验收，AI 改砸了不用 git checkout Zed 里模型每次动手改代码，你发的消息上方都会出现一个 **Restore Checkpoint** 按钮，一键把代码库回到这条消息之前的状态——哪怕你中途打断它，这个按钮也在。相当于系统自动帮你打了快照，试错成本趋近于零。 验收环节也有暗格：按 `ctrl-shift-r` 打开 **Review Changes**，所有改动汇成一个 multi-buffer，可以**按 hunk 逐块接受或拒绝**，不必整体全收。再进一步，把 `agent.single_file_review` 设为 `true`，diff 会以“当前文件内联”的形式出现，边看边点 keep/reject。国内用惯了“AI 生成 → 全部接受 → 出事再回滚”的同学，这套流程值得直接抄。 ## 暗格五：@ 引用的六个冷门对象，粘贴的代码自动带上出处 在输入框敲 `@`，能引用的不止文件和目录，官方列表里还有：**符号（symbol）、诊断信息（diagnostics）、分支 diff、过去的线程、Skills、以及 URL**——直接 @ 一个网址让 Agent 抓网页内容。几个顺手的细节： - 从编辑器里复制多行代码粘贴到输入框，Zed **自动把它格式化成带文件路径的 @ 引用**，Agent 能自己定位上下文；想粘贴纯文本用 `ctrl-shift-v`。 - 在编辑器或终端里选中一段文字，按 `ctrl->` 直接把选中内容塞进当前线程（`agent: add selection to thread`）。 - 报错截图、设计稿直接**拖或粘贴图片**进输入框（需模型支持视觉）。 把“终端里刚报的错”用 `ctrl->` 丢进线程、再 @ 一下相关文件，一分钟内完成一次精准排障——这套手法比“复制报错 + 贴日志”优雅得多。 ## 暗格六：长对话续命三件套：自动压缩、/compact、New From Summary 上下文快满时，Zed 会**自动压缩**长线程：把早期对话总结成摘要替换原文，线程里会出现一条可展开的 "Context Compacted" 记录。想手动控制，输入 `/compact`。如果选的模型上下文太小（低于 80,000 token 不支持自动压缩），输入框上方会出现横幅提醒。 最实用的是 **New From Summary**：在 `+` 菜单里选它，会开一个以当前对话摘要为种子**的新线程**——长任务跨线程续命，不丢前情。你还可以在新线程里 **@ 一条历史线程**，把旧上下文“继承”过来。跑大重构、跨天的任务，这套机制能让一个项目连跑数周不“失忆”。 ## 暗格七：.rules 文件直接兼容 CLAUDE.md、AGENTS.md，v1.4 起进化成 Skills Zed 支持在项目根目录放 `.rules` 文件作为全局项目指令，每次 Agent 对话自动注入。妙在它的**兼容列表**：`.cursorrules`、`.windsurfrules`、`.clinerules`、`.github/copilot-instructions.md`、`AGENT.md`、`AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 都认——按列表顺序取第一个命中的。也就是说，你项目里给 Claude Code 写的 `CLAUDE.md`、给 Cursor 写的 `.cursorrules`，**一个字都不用改，Zed 直接认**。跨工具迁移的成本被压到了零。 注意版本节点：从 **v1.4.0 起**，Rules 库已被 **Skills** 取代——旧的非默认规则自动迁移为 `~/.agents/skills/` 下的全局技能（带 `disable-model-invocation: true`，只能你手动用 `/技能名` 或 @ 调用），默认规则则并入 `~/.config/zed/AGENTS.md`。想封装“生成提交信息”“按团队规范重构”这类可复用提示词，现在用 Skills 打包，还能被 @ 引用进任意线程。 ## 暗格八：模型接入五条路 + 那些没人告诉你的小开关 LLM Providers 官方页把接入方式归纳为五条路：**Zed 托管模型、API 直连、已有订阅、网关（OpenRouter/Bedrock/Vercel）、本地模型**。第三条是被低估的：如果你已经付了 **ChatGPT、Claude 或 Copilot 的订阅**，直接在 Zed 里登录对应账号即可让这些模型驱动 Agent、内联助手、Git 提交信息生成和线程摘要——不用再买 API。已经给 Cursor/Claude 交过月费的人，等于订阅白捡一个新宿主。 杂项开关一箩筐：`ctrl-alt-/` 快速切模型，给常用模型点星标后 `alt-l` 一键循环；`agent.prevent_idle_sleep` 让长任务期间系统不休眠；挂后台时可用 `agent.notify_when_agent_waiting` 和 `agent.play_sound_when_agent_done` 配置桌面通知和提示音，Agent 干完活喊你回来验收；右键任意回复可把整个线程**导出为 Markdown** 存档。 最后一个隐私暗格：给回复**点赞/点踩会把整段对话上传到 Zed 服务器**用于改进产品，官方文档用警告框专门标注了这一点。介意数据外流的话，管住手别点那个大拇指。 ## 选型一图流 ```mermaid flowchart TD A["打开Zed想用AI"] --> B["想要哪种介入方式"] B -->|边写边补全| C["Edit Prediction"] B -->|选中改一段| D["Inline Assistant"] B -->|整任务托管| E["Agent Panel"] C --> F["默认Zeta免费两千次"] C --> G["可换Copilot或本地"] E --> H["订阅在手吗"] H -->|有Claude或GPT订阅| I["登录直接复用"] H -->|只有API Key| J["API直连或网关"] H -->|一分钱不想花| K["Ollama本地跑"] E --> L["长对话快满了"] L --> M["手动压缩或摘要续线程"] ``` ## 信息差总结 | 你以为的 Zed | 实际上的 Zed | |---|---| | 只是个“快”的编辑器 | AI 是一等公民：Agent 面板、补全、内联助手、Skills 全内置，不用装插件 | | 补全得买订阅 | 免费版每月 2,000 次官方 Zeta 补全，登录即用 | | 用 AI 必须再买 API | 已有的 Claude/ChatGPT/Copilot 订阅可直接登录复用 | | 换工具要重写规则文件 | `.cursorrules`、`CLAUDE.md`、`AGENTS.md` 原样识别，零成本迁移 | | 补全只能用官方引擎 | Copilot、Codestral、Ollama 本地 qwen/deepseek 模型都能接，还内置 GLM 提示词格式 | | Agent 改砸只能手动回滚 | 每条消息带 Checkpoint，`ctrl-shift-r` 按 hunk 逐块验收 | | 一个聊天框串行干活 | 多线程并行 + Git worktree 隔离，Agent 互不打架 | ## 行动指南 1. 去 **zed.dev** 下载安装（macOS/Linux/Windows 全平台），打开设置确认 `edit_predictions.provider` 为 `zed`，登录账号激活免费 Zeta 补全。 2. 把你现有项目的 `CLAUDE.md` 或 `.cursorrules` 复制到项目根目录（或直接保留原名），Zed 自动识别，规则零迁移。 3. 用命令面板执行 `agent: new thread` 开第一个 Agent 任务，故意让它改错一个文件，然后用 Checkpoint 回滚一次，熟悉“后悔药”。 4. 跑一个真实小任务（比如写个爬虫脚本），改完后按 `ctrl-shift-r` 逐块验收 diff，体会“按块接受”和“全收”的区别。 5. 进阶：本机装 Ollama 拉 `qwen2.5-coder:7b-base`，按暗格一的配置接成本地补全，实现零成本、零外流的完整 AI 编码环境。 ## 参考来源 1. Zed 官方文档 · Agent Panel：https://zed.dev/docs/ai/agent-panel 2. Zed 官方文档 · Edit Prediction（含免费额度与本地模型配置）：https://zed.dev/docs/ai/edit-prediction 3. Zed 官方文档 · LLM Providers（五种模型接入路径）：https://zed.dev/docs/ai/llm-providers 4. Zed 官方文档 · Rules 与 Skills 迁移说明：https://zed.dev/docs/ai/rules --- > 本文由「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 等场景全覆盖。