Zed 编辑器中安装与配置 Claude Code 完整教程

Zed 是一款用 Rust 写的高性能编辑器，启动毫秒级、滚动跟手、内置原生协作。它的内置终端在 macOS 和 Linux 上已经相当稳定，Windows 版还在 alpha 阶段（截至 2026 年初仍是预览）。本文带你在 Zed 里把 Claude Code CLI 跑起来。

---

前置：先装好 Zed 和 Claude Code CLI

装 Zed：

• macOS / Linux：去 zed.dev 下载官方安装包，或者：

# macOS
brew install --cask zed

# Linux（一键脚本）
curl -f https://zed.dev/install.sh | sh

• Windows：访问 zed.dev 下载 alpha 版安装包；alpha 阶段建议优先在 WSL Ubuntu 内装 Zed Linux 版本

装 Claude Code CLI：

npm install -g @anthropic-ai/claude-code
claude --version
# @anthropic-ai/claude-code@x.x.x

如果还没 Node.js：

# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

---

第1步：在 Zed 里打开项目

启动 Zed 后：

• macOS：Cmd + O 选择项目目录
• Linux：Ctrl + O
• 或者命令行直接进：zed ~/code/my-project

Zed 把这个目录作为当前 workspace，内置终端默认从这里启动。

---

第2步：打开内置终端

Zed 的内置终端快捷键和 VS Code 一样：

Ctrl + `

注意：macOS 上也是 Ctrl + （不是 Cmd`），这是 Zed 比较反直觉的一点。Zed 把大部分终端 / 面板相关快捷键沿用了 VS Code 的 Ctrl 系，而不是 macOS 习惯的 Cmd 系。

或者通过命令面板：

• macOS：Cmd + Shift + P → 输入 terminal: new
• Linux / Windows：Ctrl + Shift + P → 输入 terminal: new

---

第3步：在终端里启动 Claude Code

claude

第一次会跳浏览器登录授权，回到 Zed 终端看到 > 提示符就成功了。

如果在 macOS 上看到 claude: command not found，先看下面的常见问题一，是 Zed 不读 .zshrc 的经典问题。

---

第4步：把终端 Dock 到右侧

Zed 终端默认在底部，宽度限制下 Claude Code 输出会折行。Dock 到右侧后竖屏布局更舒服。

操作方式：

1. 右键点击终端面板的标签栏
2. 选择 Dock to Right

或者通过命令面板：

workspace: toggle bottom dock
workspace: toggle right dock

也可以在 settings.json 里直接配死：

{
  "terminal": {
    "dock": "right",
    "default_width": 640
  }
}

default_width 单位是像素，640 在 1080p / 1440p 屏上比较合适，4K 屏可以调到 800-960。

---

第5步：Zed 配置文件位置

Zed 的所有配置都在一个 JSON 文件里，路径：

系统	路径
macOS / Linux	~/.config/zed/settings.json
Windows	%APPDATA%\Zed\settings.json

打开方式：

• 命令面板：zed: open settings
• 或快捷键：macOS Cmd + ,、Linux Ctrl + ,

如果文件不存在，Zed 第一次保存设置时会自动生成。

---

第6步：字体配置

Zed 自带一款叫 Zed Mono 的字体，开箱即用、可读性优秀，但不支持 Powerline 图标。Claude Code 输出的进度符号、Nerd Font 图标在 Zed Mono 下会显示为方块。

两条路：

路径 A：保留 Zed Mono 做编辑器字体，仅终端切到 Nerd Font

{
  "buffer_font_family": "Zed Mono",
  "buffer_font_size": 15,
  "terminal": {
    "font_family": "MesloLGS NF",
    "font_size": 14
  }
}

这样代码编辑区是 Zed Mono，终端是 MesloLGS NF，Claude Code 图标正常显示。

路径 B：全局都用 Nerd Font

{
  "buffer_font_family": "JetBrains Mono",
  "buffer_font_size": 15,
  "terminal": {
    "font_family": "MesloLGS NF",
    "font_size": 14,
    "line_height": "comfortable"
  }
}

注意字体必须先安装到系统字体目录，Zed 才能识别：

• macOS：双击 .ttf 文件，点击「安装字体」
• Linux：cp *.ttf ~/.local/share/fonts/ && fc-cache -fv
• Windows：右键 .ttf → 安装

line_height 可选值："comfortable"（推荐）、"standard"、自定义浮点数（如 1.3）。

---

第7步：Shell 与 working_directory 配置

Zed 终端默认从当前 workspace 根目录启动，但 Shell 的选择得显式配，特别是 macOS 上。

{
  "terminal": {
    "shell": {
      "program": "/bin/zsh"
    },
    "working_directory": "current_project_directory",
    "env": {
      "TERM": "xterm-256color"
    }
  }
}

Shell 平台差异：

• macOS： program: "/bin/zsh"，但关键：Zed 默认用非 login shell 启动，nvm/Homebrew 的环境变量不会自动加载。需要显式加 -l：

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

注意 with_arguments 这个嵌套写法是 Zed 的 schema，不能直接写 args 平铺。

• Linux：

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

• Windows（alpha）： 推荐 WSL：

{
  "terminal": {
    "shell": {
      "with_arguments": {
        "program": "wsl.exe",
        "args": ["-d", "Ubuntu"]
      }
    }
  }
}

working_directory 的可选值：

• "current_project_directory"：当前项目根（Claude Code 推荐）
• "first_project_directory"：第一个项目根
• "always_home"：用户 home
• { "always": "/some/path" }：固定路径

---

第8步：选择主题（git diff 友好）

Claude Code 经常在终端里输出 git diff、文件变更列表，主题对 +/- 行的高亮配色直接影响阅读体验。

推荐组合：

• Ayu Dark / Ayu Mirage：橙色和绿色对比强烈，diff 一眼能看清
• Tokyo Night Storm：深色背景下 ANSI 颜色饱和度合适
• One Dark Pro：经典选择，Claude Code 输出可读性好

切换方式：

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

或者命令面板：theme selector: toggle，可视化预览。

如果想给终端单独配色（独立于编辑器主题），暂时 Zed 还不支持，整个 UI 共享一套主题。

---

第9步：完整 settings.json 示例

把上面所有片段合一：

{
  "theme": {
    "mode": "dark",
    "dark": "Ayu Dark",
    "light": "One Light"
  },
  "buffer_font_family": "Zed Mono",
  "buffer_font_size": 15,
  "ui_font_size": 14,
  "terminal": {
    "dock": "right",
    "default_width": 720,
    "font_family": "MesloLGS NF",
    "font_size": 14,
    "line_height": "comfortable",
    "working_directory": "current_project_directory",
    "shell": {
      "with_arguments": {
        "program": "/bin/zsh",
        "args": ["-l"]
      }
    },
    "env": {
      "TERM": "xterm-256color"
    }
  },
  "vim_mode": false,
  "auto_save": "on_focus_change"
}

auto_save: on_focus_change 这条 Zed 用户强烈推荐 —— 切到终端跑 Claude Code 时会自动把编辑器里的改动保存，避免和 CLI 改文件冲突。

---

常见问题排查

问题一：macOS 上 Zed 不读 .zshrc，claude: command not found

现象： 系统终端里 claude 跑得好好的，Zed 内置终端里就找不到。

原因： macOS 上 Zed 默认以非 login、非 interactive shell 启动终端，.zshrc 和 .zprofile 都不会被自动 source。nvm、Homebrew 安装的 Node 也就不在 PATH 里了。

解决：

1. 按第7步把 shell 改成 login shell（args: ["-l"]）
2. 检查 .zprofile 里有没有 Homebrew / nvm 的 PATH 设置：

# ~/.zprofile（不是 .zshrc！）
eval "$(/opt/homebrew/bin/brew shellenv)"   # Apple Silicon
# 或
eval "$(/usr/local/bin/brew shellenv)"      # Intel

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

login shell 会先读 .zprofile，所以把 PATH 相关放这里更稳。

3. 改完后完全退出 Zed（Cmd + Q）再开，光关闭窗口不行

---

问题二：Windows 版 Zed 终端不稳定 / 闪退

现象： Windows alpha 版 Zed 内置终端偶尔渲染异常、键入延迟、ANSI 颜色错乱。

原因： Zed 的 Windows 终端实现基于 ConPTY，alpha 阶段还在打磨，部分场景下兼容性有问题。

临时方案：

1. 首选：在 WSL Ubuntu 里装 Linux 版 Zed，体验和 macOS 一样稳

# 在 WSL Ubuntu 里
curl -f https://zed.dev/install.sh | sh
zed ~/code/my-project

2. 实在要用 Windows 版，把 shell 切成 WSL（见第7步），相当于让 Zed 终端做一个 wsl.exe 的 frontend，绕开原生 ConPTY 的部分坑
3. 等 Zed 稳定版发 Windows 版（关注 zed.dev 公告）

---

问题三：终端字体显示乱码或方块

现象： Claude Code 启动横幅里的图标、Powerline 符号、emoji 全是 □ 或 ?。

排查：

1. 字体是否在系统层装好

# macOS / Linux 检查
fc-list | grep -i meslo
# 或
fc-list | grep -i nerd

2. Zed settings.json 里字体名是否和系统字体一致

不同系统对同一字体的命名可能略有差异：

• MesloLGS NF vs MesloLGS Nerd Font vs MesloLGSNerdFont-Regular
• JetBrainsMono Nerd Font vs JetBrains Mono Nerd Font

最保险的做法：

# macOS
fc-list | grep -i meslo | head -3
# 输出里第一个分号前的字体名直接拿来用

3. 字体回退链：

{
  "terminal": {
    "font_fallbacks": ["MesloLGS NF", "JetBrains Mono", "Menlo", "monospace"]
  }
}

---

问题四：终端 Dock 拖拽行为奇怪 / 拖到右侧又跳回底部

现象： 想把终端拖到右侧，拖到一半弹回去，或拖完之后下次启动 Zed 又回到底部。

原因： Zed 的 dock 状态是 per-workspace 持久化的，但有时新版本 schema 变化会清空状态。

解决：

1. 不要靠拖拽，直接在 settings.json 写死：

{
  "terminal": {
    "dock": "right"
  }
}

2. 如果还是会跳回底部，检查是不是 Zed 自动更新到了新版本，schema 名换了 —— 进 zed: open default settings 看下当前版本期望的字段名（不会改默认配置，只是参考）
3. 升级 Zed 到最新稳定版后再调，alpha / preview 通道这类 UI 行为偶尔会变

---

验证清单

逐条对照：

1. CLI 可用：Zed 终端里 claude --version 能输出版本号
2. 登录态正常：claude 启动后直接进入 > 提示符
3. 终端在右侧：终端 Dock 在右侧，宽度合适
4. 字体清晰：Claude Code 启动横幅、图标、进度符号显示正常
5. Shell 完整：echo $PATH 能看到 nvm / Homebrew 的路径
6. 能读项目：让 Claude Code「读 README 并总结这个项目」，能正确返回内容
7. diff 可读：让 Claude Code「对比当前改动和 main 分支」，git diff 输出的红绿配色清晰

全部通过，Zed 上的 Claude Code 工作流就跑通了。Zed 极快的启动速度配 Claude Code 的 Agent 能力，是一套相当顺手的组合。

---

相关阅读

• 实战工作流：Zed Channel 多人协作开发：搭配 Claude Code 实战

其他编辑器安装教程：

• VS Code 中安装与配置 Claude Code
• Cursor 中安装与配置 Claude Code
• WebStorm / IntelliJ 中安装与配置 Claude Code
• Vim / Neovim 中安装与配置 Claude Code

相关编辑器工作流：

• VS Code + Claude Code：远程开发与 Dev Container
• Cursor + Claude Code：日常开发完整工作流
• WebStorm + Claude Code：JS/TS 项目实战工作流
• Vim + Claude Code：纯键盘终端工作流
• Neovim + Claude Code：Lua 生态深度集成