别把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 服务器用于改进产品，官方文档用警告框专门标注了这一点。介意数据外流的话，管住手别点那个大拇指。

选型一图流

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["手动压缩或摘要续线程"]

信息差总结

行动指南

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 等场景全覆盖。