Cursor 中安装与配置 Claude Code 完整教程

Cursor 是基于 VS Code 二次开发的 AI 编辑器，本身自带的内置 AI 主要面向轻量补全和小范围对话；而 Claude Code CLI 则是一套独立的命令行 Agent，可以在项目根目录长时间执行多步骤任务、读写大量文件、跑测试和构建。两者并不冲突，但本文聚焦的是后者：如何在 Cursor 的内置终端里把 Claude Code CLI 跑起来。

---

Cursor 内的两种使用方式

	内置 AI（Composer / Chat）	Claude Code CLI
调用方式	侧边栏聊天框	终端里输入 claude
适合场景	单文件改动、补全	多文件、长任务、自动化
模型选择	Cursor 后端切换	直连 Anthropic

下面从零开始走一遍 CLI 在 Cursor 中的安装与配置。

---

前置：先在系统层装好 Claude Code CLI

在 Cursor 内打开任何一种终端（macOS 是 iTerm/Terminal，Windows 推荐 PowerShell 或 WSL，Linux 用默认 shell），运行：

npm install -g @anthropic-ai/claude-code

如果系统没有 Node.js，请先用 nvm 安装一个 LTS 版本：

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

# Windows
# 推荐去 nodejs.org 下载 LTS 安装包，或者用 WSL 后再 nvm install --lts

安装完后验证：

claude --version
# 输出类似：@anthropic-ai/claude-code@x.x.x

只有这一步通过，下面在 Cursor 里才能直接调用 claude 命令。

---

第1步：在 Cursor 里打开一个项目

启动 Cursor 后，用 File → Open Folder（macOS：Cmd + O；Windows / Linux：Ctrl + O）打开任意一个本地项目目录。Claude Code 会把这个目录视为工作根目录，所有文件读写都从这里开始。

---

第2步：打开内置终端

Cursor 沿用了 VS Code 的快捷键：

• Windows / Linux：Ctrl + `
• macOS：Cmd + `

或者通过菜单：Terminal → New Terminal。终端默认在你打开的项目根目录启动，这一点很关键 —— Claude Code 会把当前 cwd 当作项目根。

---

第3步：启动 Claude Code

在终端里直接输入：

claude

第一次运行会跳出登录引导，浏览器会自动打开 Anthropic 的授权页面。用你的账号登录并点击 Authorize，回到 Cursor 终端会看到 > 提示符，意味着已经进入交互模式，可以直接输入自然语言。

如果浏览器没自动打开，可以手动复制终端里给出的 URL 到浏览器。

---

第4步：把终端面板移到右侧

默认终端在 Cursor 编辑区下方，宽度有限，Claude Code 的界面经常折行不好看。把它移到右侧后，左边写代码、右边和 CLI 对话，效率高很多。

操作方式： 右键点击终端标签栏（写着 bash、zsh 或 pwsh 的那一行），在弹出菜单里选择 Move Panel Right（中文版叫「将面板移到右侧」）。

也可以直接在 Cmd/Ctrl + Shift + P 调出命令面板，搜索：

Workbench: Move Panel Right

---

第5步：配置终端字体

Claude Code 会输出大量 box-drawing、emoji 和 Powerline 风格的进度符号。如果终端字体不支持这些字符，会看到方块、问号或乱码。

推荐字体（任选其一）：

• MesloLGS NF：Powerlevel10k 配套字体，对 Claude Code 的输出兼容性最好
• JetBrains Mono：JetBrains 出品的开源等宽字体，可读性优秀
• FiraCode Nerd Font：自带连字与图标支持

下载安装后（系统级安装，不是 Cursor 内安装），打开 Cursor 设置（Cmd/Ctrl + ,），点击右上角图标进入 settings.json，添加：

{
  "terminal.integrated.fontFamily": "MesloLGS NF",
  "terminal.integrated.fontSize": 14,
  "terminal.integrated.lineHeight": 1.2,
  "terminal.integrated.cursorStyle": "line",
  "terminal.integrated.cursorBlinking": true
}

保存后立即生效，无需重启 Cursor。如果当前终端实例还显示旧字体，关闭再重开一个新终端即可。

---

第6步：配置默认 Shell

Cursor 跨平台行为略有差异，建议显式指定默认 Shell，避免不同机器表现不一致。

macOS（推荐 zsh）：

{
  "terminal.integrated.defaultProfile.osx": "zsh",
  "terminal.integrated.profiles.osx": {
    "zsh": {
      "path": "/bin/zsh",
      "args": ["-l"]
    }
  }
}

注意 args: ["-l"] 表示以 login shell 启动，这样 ~/.zprofile 会被加载，nvm、Homebrew、Mise 等环境变量才会生效。

Linux（bash 或 zsh）：

{
  "terminal.integrated.defaultProfile.linux": "bash",
  "terminal.integrated.profiles.linux": {
    "bash": {
      "path": "/bin/bash",
      "args": ["-l"]
    }
  }
}

Windows（推荐 WSL，其次 Git Bash）：

{
  "terminal.integrated.defaultProfile.windows": "Ubuntu (WSL)",
  "terminal.integrated.profiles.windows": {
    "Ubuntu (WSL)": {
      "path": "C:\\Windows\\System32\\wsl.exe",
      "args": ["-d", "Ubuntu"]
    },
    "Git Bash": {
      "source": "Git Bash"
    }
  }
}

WSL 下跑 Claude Code 可以避免大量 Windows 路径分隔符、行尾符相关的小坑。

---

第7步：可选 —— 把项目根作为终端 cwd

如果你经常在多 root 工作区里切来切去，建议加这条：

{
  "terminal.integrated.cwd": "${workspaceFolder}"
}

这样新开终端始终落在当前项目根目录，Claude Code 不会跑错地方。

---

常见问题排查

问题一：在 Cursor 终端里 claude: command not found

原因： Claude Code 装在了 npm 全局目录，但该目录没在 PATH 里；或者 Cursor 终端用的不是 login shell，没读取 .zshrc。

排查：

# 看 npm 全局目录在哪
npm config get prefix
# macOS/Linux 典型输出：/usr/local 或 /Users/你/.nvm/versions/node/v20.x.x

# 检查 claude 文件存在与否
ls -la "$(npm config get prefix)/bin/claude"

如果文件存在但命令找不到，把这行加到 ~/.zshrc 或 ~/.bashrc：

export PATH="$(npm config get prefix)/bin:$PATH"

然后完全退出 Cursor（Cmd + Q / 任务管理器关掉所有进程）再重新打开 —— 仅关闭窗口不行。

---

问题二：用了 nvm，Cursor 终端里 Node.js 版本不对

现象： 系统终端 node -v 是 v20，Cursor 里却是 v16 或 node: command not found。

原因： Cursor 终端没启用 login shell，nvm 没被 source 进来。

解决： 确保 ~/.zshrc（macOS）或 ~/.bashrc（Linux）里包含：

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

并且在 Cursor settings.json 里给 shell args 加 -l（见第6步）。

如果还有问题，按 Cmd/Ctrl + Shift + P 执行 Terminal: Kill All Terminals，再重新开一个。

---

问题三：登录失败 / 浏览器一直打不开

现象： 输入 claude 后看到 Failed to open browser，或浏览器打开但回调超时。

解决方案：

1. 手动复制终端给出的 URL 到任意浏览器
2. 如果在远程服务器或 SSH 环境，用 claude --help 看看是否有 --no-browser 之类的离线登录选项
3. 检查防火墙是否阻止了 localhost 回调端口
4. 实在不行，先在系统终端（不是 Cursor 内置终端）里 claude 登录一次，登录态会写到 ~/.claude/ 目录，Cursor 里的 CLI 会复用这份登录态

---

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

现象： Claude Code 启动后，进度条、图标位置全是 □ 或 ?。

解决：

1. 确认你已经在系统层（不是 Cursor 内）安装了 MesloLGS NF / JetBrains Mono Nerd Font
2. 字体名称在不同系统略有差异，macOS 上字体管理器里查到的名称可能是 MesloLGS Nerd Font
3. 在 Cursor settings.json 里把字体名用引号写完整，多字体回退可以这样写：

{
  "terminal.integrated.fontFamily": "'MesloLGS NF', 'JetBrains Mono', Menlo, monospace"
}

4. Windows 上如果用 PowerShell，需要在 PowerShell 自身的字体设置里也改一遍，否则旧 conhost 会接管渲染

---

问题五：Cursor 内置 AI 和 Claude Code 同时挂着会卡

现象： 同时开 Composer 和 Claude Code CLI 跑长任务，Cursor 整体响应变慢。

解决： Cursor 内置 AI 和 CLI 都是独立网络请求，本身不冲突，但都会吃 CPU。建议：

• 跑大型重构时只用 Claude Code CLI，关掉 Composer 的「Auto Apply」
• 在 settings.json 里给终端单独限制 GPU：

{
  "terminal.integrated.gpuAcceleration": "off"
}

Apple Silicon 机器上一般不需要关 GPU 加速。

---

验证清单

按下面这五条逐一打勾，就算配置完成：

1. CLI 可用：终端 claude --version 能输出版本号
2. 登录态正常：claude 启动后直接进入 > 提示符，没要求重新登录
3. 终端在右侧：Cursor 编辑区在左、终端在右，互不遮挡
4. 字体清晰：Claude Code 启动横幅里的图标和进度符号显示正常
5. 能读项目：在 Claude Code 里输入「读一下 README 并总结这个项目」，能正确返回文件内容摘要

全部打勾后，Cursor + Claude Code 的开发流就跑通了，可以一边在编辑器里写、一边让 CLI 跑长任务。

---

相关阅读

• 实战工作流：Cursor + Claude Code：日常开发完整工作流

其他编辑器安装教程：

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

相关编辑器工作流：

• VS Code + Claude Code：远程开发与 Dev Container
• WebStorm + Claude Code：JS/TS 项目实战工作流
• Vim + Claude Code：纯键盘终端工作流
• Neovim + Claude Code：Lua 生态深度集成
• Zed Channel 多人协作开发：搭配 Claude Code 实战