Cursor 中使用 Claude Code：安装、配置与 vs VS Code 对比
在 Cursor 编辑器中安装 Claude Code CLI、配置内置终端、与 Cursor 自带 AI 协同使用的完整教程，包含与 VS Code 的差异说明。
Cursor 是基于 VS Code 的 fork，所以在 Cursor 里跑 Claude Code 的体验和 VS Code 几乎一致。但有一个关键概念要分清：Cursor 自带的 AI（Cursor Tab、Cmd+K、Cmd+L）是 Cursor 自家的产品，本文讲的是在 Cursor 内置终端里跑 Claude Code CLI，两者完全独立、可以并存。
Cursor 内的两套 AI 系统
| Cursor 内置 AI | Claude Code CLI | |
|---|---|---|
| 触发方式 | Cmd/Ctrl + K、Cmd/Ctrl + L、Tab 补全 | 内置终端里跑 claude |
| 后端模型 | Cursor 自选（GPT-4、Claude、自家） | 直接调用 Anthropic 官方 |
| 计费 | Cursor 订阅（Pro $20/月） | Anthropic API 或 Claude Pro/Max 套餐 |
| 修改文件 | 内嵌 Diff 视图 | 终端里 unified diff |
| 多步骤任务 | 一次性补全为主 | Agent 循环、可执行命令 |
| 适合场景 | 一行代码自动补全、单文件重构 | 跨文件改动、跑测试、git 操作 |
两套系统可以同时开着：写代码时用 Cursor Tab 自动补全，写完一段后用 Cmd+L 让 Cursor 解释一下；遇到要跨文件大改、需要执行命令的任务，切到右侧终端让 Claude Code 跑 Agent。
前置：先装 Claude Code CLI
在 Cursor 里跑 Claude Code 的前提是系统级别已经装好了 CLI。如果还没装，先在系统终端（不是 Cursor 内）跑：
# 需要 Node.js 18 及以上
node --version
# 全局安装
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
# 应输出：@anthropic-ai/claude-code@x.x.x
Windows 用户推荐先装好 WSL2，在 WSL 里跑 npm install，体验最稳定。
在 Cursor 内置终端启动 Claude Code
第1步：打开内置终端
Cursor 沿用 VS Code 的快捷键：
- Windows / Linux：
Ctrl + `（反引号） - macOS：
Cmd + `
或者菜单栏：Terminal → New Terminal。终端默认在当前打开的项目根目录启动。
第2步：运行 claude
在终端里直接输入：
claude
第一次运行会引导登录，浏览器会自动打开 Anthropic 授权页面，登录后授权一下，命令行会自动接到 token，不需要手动复制。
进入交互模式后会看到 > 提示符，就可以直接和 Claude Code 对话了。
第3步：把终端面板移到右侧（强烈推荐）
默认终端在底部占一条横条，宽度太窄，Claude Code 的对话很快就会折行变得难读。
操作： 右键点击终端面板的标题栏（显示 “TERMINAL” / “终端” 那行），选择 Move Panel Right / 将面板移到右侧。
移动后左侧是代码编辑区，右侧是 Claude Code 终端，左右各占一半，互不遮挡。代码改动 Claude Code 会直接写到磁盘，编辑器会自动刷新。
配置优化
配置终端字体（避免符号乱码）
Claude Code 用了一些 Powerline 字符画进度条和图标，普通字体会显示成方块或问号。推荐字体：
- MesloLGS NF（Powerlevel10k 推荐字体，免费）
- JetBrains Mono（自带连字，看起来美观）
- FiraCode Nerd Font（带 Nerd Font 图标）
下载安装到系统后，在 Cursor 设置里配置。按 Ctrl/Cmd + Shift + P，搜索 Open User Settings (JSON)，添加：
{
"terminal.integrated.fontFamily": "MesloLGS NF",
"terminal.integrated.fontSize": 13,
"terminal.integrated.lineHeight": 1.2
}
字体改完终端会立即生效，不需要重启 Cursor。
设置默认 Shell
跨平台的默认 Shell 配置：
{
"terminal.integrated.defaultProfile.osx": "zsh",
"terminal.integrated.defaultProfile.linux": "bash",
"terminal.integrated.defaultProfile.windows": "Git Bash"
}
Windows 上推荐顺序：WSL > Git Bash > PowerShell。WSL 里 npm 全局包管理最规范，不会出 PATH 问题。
Cursor 专属：让内置 AI 不打扰终端
Cursor 默认开启 Cursor Tab 在所有面板补全（包括终端历史命令）。如果觉得在终端里也跳出补全建议很烦，可以关闭：
设置里搜索 cursor.cpp.disabledLanguages，或者在 Cursor 设置 → Features → Tab → 把 Tab in Terminal 关掉。
Cursor AI 与 Claude Code CLI 的取舍
什么时候用 Cursor 内置 AI
- 单行/单段代码补全（Tab）
- 当前文件的局部重构（
Cmd/Ctrl + K） - 简单问答 “这段代码什么意思”（
Cmd/Ctrl + L） - 不想跳出编辑器、想要 Diff 内嵌的场景
什么时候用 Claude Code CLI
- 跨多个文件的改动：CLI 可以一次性扫描整个项目然后批量修改
- 需要执行命令：跑测试、跑 lint、git commit、git rebase 都能用 Claude Code 的 Agent 模式自动完成
- 多轮 Agent 任务：“修复所有 ESLint 报错”、“把这个项目从 JS 迁移到 TS”
- 配置 MCP 工具：连数据库、连 Sentry、连 Linear，CLI 走 MCP 协议方便
- 长任务可以挂着跑：终端会保留所有历史，断网也不会丢上下文
实际工作流里，多数 Cursor 用户保留两套：写代码靠 Tab 补全提速，遇到大动作就用 Claude Code 的 Agent 跑。
常见问题排查
问题一：Cursor 终端里 claude 命令找不到
现象： 系统 Terminal 里能跑 claude，但 Cursor 终端里报 command not found。
原因： Cursor 启动时继承的环境变量和你的 Shell 配置文件可能不同步。
解决：
# 第1步：在系统终端确认安装路径
npm config get prefix
# 输出比如：/Users/yourname/.nvm/versions/node/v20.10.0
# 第2步：把 bin 路径加到 PATH（写到 ~/.zshrc 或 ~/.bashrc）
export PATH="$(npm config get prefix)/bin:$PATH"
# 第3步：重启 Cursor（完全退出，不是关闭窗口）
macOS 用户：Cursor 启动时不会跑 ~/.zshrc 里的全部内容，确认 PATH 设置在 ~/.zshenv 里也写一份。
问题二：用 nvm 装的 Node，Cursor 终端找不到
现象： node --version 在系统终端正常，Cursor 终端报错。
解决： 在 Cursor 的 settings.json 里配置：
{
"terminal.integrated.inheritEnv": true,
"terminal.integrated.profiles.osx": {
"zsh-with-nvm": {
"path": "zsh",
"args": ["-l"]
}
},
"terminal.integrated.defaultProfile.osx": "zsh-with-nvm"
}
-l 参数让 zsh 以 login shell 启动，会自动加载 nvm。
问题三：Cursor 自动同步设置导致 AI 配置混乱
现象： 启用了 Cursor 的设置同步后，Claude Code 的终端字体配置被覆盖。
解决： Cursor 同步只覆盖 cursor.* 开头的配置，terminal.integrated.* 不会被同步出问题。如果发现配置丢失，重新打开 settings.json 检查是否被 Workspace 设置覆盖了。
问题四：Cursor 内置 AI 和 Claude Code 同时改文件冲突
现象： Cursor 的 Cmd+K 在文件里加了一段，Claude Code Agent 又改了同一处，发生冲突。
解决： 操作完一个 AI 之后，先在编辑器里 Ctrl/Cmd + S 保存，再启动另一个 AI。Claude Code 改文件前会读取磁盘最新状态，所以保存好就不会丢东西。
与 VS Code 对比表
| 维度 | VS Code | Cursor |
|---|---|---|
| 终端启动快捷键 | Ctrl/Cmd + ` | Ctrl/Cmd + ` 完全一致 |
| 官方 Claude Code 扩展 | 支持，侧边栏对话 | 支持，从 OpenVSX 装 |
| 内置 AI 助手 | 无（除非装 Copilot/Cody） | 自带 Cursor Tab、Cmd+K |
| 配置文件位置 | ~/.vscode/settings.json | ~/.cursor/settings.json |
| 与 Claude Code CLI 冲突 | 无 | 无（两套系统独立） |
| Marketplace | 微软官方 | OpenVSX（部分扩展缺失） |
| 性能 | 标准 Electron | 比 VS Code 略重（多了 AI 后台） |
简短结论： 在 Cursor 用 Claude Code CLI 体验和 VS Code 一样好，差别只在于 Cursor 多了一套自家 AI 可以辅助。如果你已经在用 Cursor Pro 订阅，把 Claude Code CLI 加进来当 Agent 模式用，两者互补；如果是 Pro 订阅没开通也想用 AI，单独跑 Claude Code CLI 就够了。
验证全部配置完成
1. 验证 CLI
claude --version
2. 验证内置终端
在 Cursor 内置终端跑 claude，应能进入交互模式并显示 > 提示符。
3. 验证两套系统并存
打开任意一个项目文件，先用 Cmd/Ctrl + L 让 Cursor 内置 AI 解释代码（确认 Cursor AI 工作），然后切到终端跑 claude 问同样的问题（确认 CLI 工作）。两边都能正常返回结果，配置就完成了。