Zed 编辑器中使用 Claude Code：终端配置与协作模式

Zed 是用 Rust 写的极速编辑器，启动速度和文本渲染都比 VS Code/Cursor 快一个数量级。Zed 自带 AI 助手（Zed AI / Assistant Panel），但很多人习惯用 Claude Code CLI 跑 Agent 任务。本文讲在 Zed 内置终端跑 Claude Code 的全套配置，以及 Zed 独有的 Channel 多人协作模式下怎么用 Claude Code。

---

Zed 里的两套 AI 工作流

	Zed Assistant Panel	Claude Code CLI
触发	Ctrl/Cmd + ? 打开 Panel	内置终端跑 claude
后端模型	用户自配 API（OpenAI、Anthropic、Ollama）	Anthropic 官方
配置	~/.config/zed/settings.json	Claude Code 自己的配置
修改文件	编辑器内嵌建议	终端 unified diff
Agent 能力	有限（最近版本加强）	强（多轮、可执行命令）
计费	用户自带 API key（按调用付）	Anthropic 账户

两套可以并存：写小段代码 / Inline Assistant 用 Zed 自家的，跨文件 Agent / 跑命令用 Claude Code CLI。

---

前置：安装 Claude Code CLI

# Node.js 18+
node --version

# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

Zed 在 macOS 和 Linux 上是稳定版，Windows 仍处于 alpha 阶段（截止本文写作时间），下文 Windows 部分会单独标注限制。

---

在 Zed 内置终端启动 Claude Code

第1步：打开内置终端

Zed 终端快捷键和 VS Code 一致：

• Windows / Linux / macOS：Ctrl + `（macOS 也是 Ctrl 不是 Cmd，注意）

或者菜单栏：Terminal → New Terminal。

也可以用命令面板（Cmd/Ctrl + Shift + P）搜索 terminal: new。

第2步：把终端 Dock 到右侧

Zed 默认终端在底部。把它 Dock 到右侧：

• 鼠标拖动终端面板的标题栏到屏幕右侧
• 或者命令面板搜索 workspace: toggle right dock

Zed 的 Dock 系统比 VS Code 简单——只有 Left / Right / Bottom 三个固定位置，但拖拽响应非常快，没有 Electron 那种延迟。

第3步：跑 claude

claude

第一次启动浏览器自动开授权页，登录后命令行接到 token。

---

Zed 终端配置

Zed 的配置都在 ~/.config/zed/settings.json（macOS/Linux）或 %APPDATA%\Zed\settings.json（Windows）。命令面板搜 zed: open settings 也能直接打开。

字体配置

Zed 自家字体 Zed Mono 已经内置 Powerline 字符和大量符号，多数情况下不会乱码。但如果想用其他字体：

{
  "terminal": {
    "font_family": "MesloLGS NF",
    "font_size": 13,
    "line_height": "comfortable",
    "font_features": {
      "calt": true,
      "liga": true
    }
  }
}

font_features 里 calt 和 liga 控制连字（比如 => 连成箭头）。Claude Code 的 ASCII 表格在开了连字之后会更好看。

Shell 配置

{
  "terminal": {
    "shell": {
      "program": "/bin/zsh"
    },
    "working_directory": "current_project_directory",
    "blinking": "off",
    "copy_on_select": true
  }
}

working_directory: "current_project_directory" 让新终端默认在项目根目录开。

copy_on_select: true 是 Zed 终端的好功能——选中文字自动复制，省一步 Cmd+C。

颜色主题

Zed 内置的 One Dark / One Light 已经针对终端做过优化。如果觉得 Claude Code 的输出颜色不舒服，换成：

{
  "theme": {
    "mode": "dark",
    "dark": "Ayu Dark",
    "light": "Ayu Light"
  }
}

Ayu Dark 在深色背景下对蓝色和绿色的对比度更高，Claude Code 的 git diff 输出（绿色 + / 红色 -）更醒目。

---

Zed Assistant 与 Claude Code CLI 的取舍

Zed Assistant 适合

• Inline Assist（Cmd/Ctrl + Enter）在编辑器内嵌生成代码，一边看一边接受/拒绝
• Assistant Panel（Cmd/Ctrl + ?）开一个右侧面板和 AI 对话，能引用文件作为 context
• Slash Commands 比如 /file、/diagnostics 把当前 buffer 直接喂给模型
• 需要用 OpenAI / 自部署 Ollama 的场景

Claude Code CLI 适合

• 跨文件 Agent 任务：一次扫描全项目然后批量改
• 要执行命令：跑测试、跑 lint、git operations
• MCP 工具：Claude Code 的 MCP 生态比 Zed Assistant 的 Slash Commands 更丰富
• 断网恢复：终端 session 留着上下文不丢

实际工作流：写代码主要用 Zed 自家的 Inline Assist（速度快、无需切换焦点），遇到「请把这个项目从 commonjs 迁到 esm」这种大动作就让 Claude Code 跑 Agent。

---

Zed Channel 协作模式下的 Claude Code

Zed 最独特的功能是 Channel——多人实时协同编辑（类似 Google Docs 那种光标同步），完全免费、开源、官方托管。

加入 Channel

1. 左下角点头像 → Sign in with GitHub
2. 命令面板搜 collab: open channels
3. 创建或加入一个 Channel
4. 邀请其他人进入

在 Channel 里使用 Claude Code

Zed 的 Channel 共享的是编辑器 Buffer，不共享终端。也就是说：

• 你在自己的终端跑 claude，对话在你这边显示，其他人看不到
• 但 Claude Code 修改的文件（如果是 Channel 内的项目）会实时同步给所有协作者
• 其他人会看到文件变化和你光标的位置

协作工作流推荐

模式 A：一个人开 Claude Code，其他人围观结果

• A 开终端跑 claude，对 Claude 说「重构 src/auth.js」
• Claude Code 改文件，A 这边的 Zed 自动同步给 Channel 内所有人
• B、C、D 在自己的 Zed 里实时看到代码变化
• 所有人可以同时审查，不满意就直接编辑还原

模式 B：每个人独立开 Claude Code，分工不同模块

• A 改前端组件，B 改后端 API，每人自己开 claude
• 文件改动通过 Channel 同步
• 用 git 分支隔离，避免冲突

避坑： 不要两个人同时让 Claude Code 改同一个文件，会出现你这边删一行、他那边加一行的并发改动，Claude Code 是基于读到的文件状态做修改的，并发场景下很容易产生不一致。建议在同一时刻只有一个人启动 Agent 任务。

---

常见问题排查

问题一：Zed 终端找不到 claude 命令

现象： macOS 系统终端能跑 claude，Zed 终端报 command not found。

原因： macOS 上 Zed 启动时不会跑 ~/.zshrc，只跑 ~/.zshenv 或 login shell 的初始化。

解决方案 A：把 PATH 写到 ~/.zshenv

# ~/.zshenv（Zed 启动时会读取）
export PATH="$HOME/.npm-global/bin:$PATH"
export PATH="$(npm config get prefix 2>/dev/null)/bin:$PATH"

解决方案 B：让 Zed 终端用 login shell

{
  "terminal": {
    "shell": {
      "program": "/bin/zsh",
      "args": ["-l"]
    }
  }
}

-l 参数让 zsh 以 login shell 启动，会读 .zprofile，nvm 等也会被加载。

问题二：Windows 上 Zed 启动慢/崩溃

现象： Windows 上的 Zed 启动卡顿、打开大项目崩溃、终端有时不响应。

原因： Zed Windows 版仍是 alpha，部分 GPU 驱动不兼容、文件监视器不稳定。

缓解方案：

• 使用最新 Preview 版本（zed.dev/releases/preview），bug 修得快
• 关闭 GPU 加速（如果界面闪烁）：settings.json 加 "gpu_acceleration": false
• 在 WSL2 里用 Linux 版 Zed（需要配 X11 或 WSLg）

如果 Windows 上 Zed 不稳定，强烈建议先用 VS Code 或 Cursor，等 Zed Windows 进入 stable 阶段再切换。

问题三：Zed 内置 AI 占用了 Claude Code 的快捷键

现象： 想在终端里按 Cmd+Enter 给 Claude Code 提交多行输入，但 Zed 的 Inline Assist 跳出来。

解决： Zed 终端 buffer 里大部分快捷键自动透传给终端进程，但 Inline Assist 是全局的。可以在 keymap.json 里禁用：

[
  {
    "context": "Terminal",
    "bindings": {
      "cmd-enter": null,
      "ctrl-enter": null
    }
  }
]

null 表示在终端 context 下不绑这个键，让它原样透传给 Claude Code。

问题四：Channel 协作模式下 Claude Code 改的文件没同步

现象： A 让 Claude Code 改了文件，A 这边看到了，但 B 的 Zed 里还是旧内容。

原因： Zed Channel 同步的是 Zed 内的 buffer 内容，Claude Code 是直接写磁盘的。如果 A 这边 Zed 还没把磁盘文件 reload 到 buffer，就不会触发 Channel 同步。

解决：

• A 这边在 Zed 里点一下文件让它 reload（或者命令面板 editor: reload file）
• 配置自动 reload：

{
  "auto_signature_help": true,
  "use_autoclose": true,
  "auto_save": "on_focus_change"
}

• 或者 A 在 Claude Code 改完后手动 git add . && git commit，B 拉一下，更稳但更慢。

问题五：Linux 上 Zed 终端字体渲染糊

现象： Linux 上 Zed 的终端字体看起来发糊、间距不对。

解决： Zed 在 Wayland 下渲染用 Vulkan，部分老显卡驱动有问题。设置里加：

{
  "terminal": {
    "font_family": "JetBrainsMono Nerd Font",
    "font_size": 14,
    "font_weight": 400
  }
}

如果还是糊，临时强制走 X11：启动时设环境变量 WINIT_UNIX_BACKEND=x11 zed。

---

与 VS Code 对比表

维度	VS Code	Zed
启动速度	2-5 秒	毫秒级
内存占用	几百 MB（Electron）	100 MB 以下（原生 Rust）
终端快捷键	Ctrl/Cmd + `	Ctrl + `（macOS 也是 Ctrl）
官方 Claude Code 扩展	有	无
内置 AI	无（需装扩展）	有（Assistant Panel）
多人协作	需 Live Share 扩展	内置 Channel
Windows 支持	完整 stable	alpha，不稳定
扩展生态	极丰富	较少（早期阶段）
Vim 模式	装扩展	内置
配置方式	UI 设置 + JSON	纯 JSON

简短结论： Zed 在 macOS / Linux 上是体验最快的编辑器，配 Claude Code CLI 写代码的延迟感最低。如果你看重启动速度、做远程协作（Channel）、不依赖 VS Code 那一堆扩展，Zed + Claude Code CLI 是顶级组合。但 Windows 用户暂时建议绕开。

---

验证全部配置完成

1. 验证 CLI

claude --version

2. 验证 Zed 终端正常

打开 Zed → Ctrl + → 跑 claude，能进入交互模式且无字体乱码。

3. 验证 Channel 协作（可选）

如果要用协作模式：

• 创建一个 Channel，邀请同事加入
• 在 Channel 里打开同一个项目
• 你这边跑 claude 改一个文件
• 同事那边 Zed 应该实时显示文件变化

三项都通过，Zed + Claude Code 的工作环境就配置完成了。