Cursor 中的 Claude Code：安装与工作流指南

Cursor 自带自家的 AI 代理。它可以编辑文件、运行命令，并在您的代码库中协同工作。那么，为什么还要在同一个编辑器里再安装一个代理呢？

Claude Code 是 Anthropic 的代理式编码工具：它读取您的代码库、规划变更、编辑文件、运行测试，并将差异（diff）交还给您审核。VS Code 扩展把这套工作流带到了基于 VS Code 构建的 Cursor 中。结果就是在同一个窗口里并列存在两个独立的 AI 系统，各自拥有独立的上下文、计费与工作方式。是否有用，取决于您正在构建什么。

在继续之前：“Cursor 中的 Claude Code”目前可能有两层含义。其一是 Claude Code 扩展（本文讨论的内容）；其二是在 Cursor 的内置模型选择器中选择 Claude 模型（这是一款完全独立的产品，只是把 Claude 作为后端）。我会在单独一节再回到这个区别。如果您想要的是两款工具作为独立产品的正面对比，我们另有一篇Claude Code vs. Cursor 文章可供参考。

什么是 Cursor 中的 Claude Code？

Claude Code 是 Anthropic 的代理式编码工具。它能读取代码库、编辑文件、运行终端命令、管理 git 工作流，并通过MCP（Model Context Protocol）连接外部服务。它提供 CLI、VS Code 扩展、桌面应用和网页版。

Cursor 构建于 VS Code 衍生环境之上，且官方支持 Claude Code 的 VS Code 扩展。Anthropic 文档中将“为 Cursor 安装”列为与标准 VS Code 安装并行的直接路径。这不是社区的变通方案。

一个编辑器里的两套 AI 工作流。图片作者自制。

让人困惑的是：当有人说“Cursor 中的 Claude Code”，他可能指的是在 Cursor 内运行 Claude Code 自己的扩展或 CLI，这会带来 Anthropic 的完整代理式工作流与独立面板、权限模型和会话历史；也可能指把 Claude 模型作为 Cursor 自己原生 AI 的后端。这两者相关，但不是同一款产品，行为方式也不同。

Claude Code 与 Cursor 中的 Claude 模型

下面是两者各自实际代表的含义。

Cursor 中的 Claude 模型

Cursor 有一个模型选择器，允许您在Claude Sonnet、Claude Opus、GPT、Gemini 等模型间切换。在“自动”模式下，Cursor 会自动选择模型。当您在 Cursor 的聊天或代理模式中使用 Claude Sonnet 时，您在使用的是 Cursor 的产品：它的交互体验、它的计费、它的上下文管理。模型是 Claude，但体验属于 Cursor。

Cursor 中的 Claude Code

在 Cursor 中安装 Claude Code 扩展后，您会得到它的独立面板、独立上下文窗口，以及与您的 Anthropic 订阅或 API Key 绑定的计费。两者可以在同一编辑器窗口中同时运行，但不共享上下文。Claude Code 并不了解 Cursor 原生代理正在做什么。

在 Cursor 的模型选择器中选择“Claude Sonnet”并不等同于安装 Claude Code。如果您想要 Claude Code 的“计划并执行”工作流以及CLAUDE.md 项目记忆，您需要安装扩展或使用 CLI。开发者社区的一句话很贴切地概括了差异：“Cursor 是带有 AI 功能的 IDE。Claude Code 是具有 IDE 访问能力的 AI 代理。”

如何在 Cursor 中设置 Claude Code

在 Cursor 中设置 Claude Code 有三条路径可选，哪条合适取决于您的情况。

首先：Claude Code 需要付费的 Anthropic 方案。Claude.ai 的免费层不包含此功能。最低为每月 20 美元的 Pro 方案。您还需要运行 VS Code 引擎版本 1.98.0 或更高版本的 Cursor。

三条路径是：

• 路径一：VS Code 扩展（官方，大多数开发者推荐）
• 路径二：集成终端（如果已安装 Claude Code，摩擦最小）
• 路径三：MCP 服务器（进阶，用于团队环境或多工具设置）

如果您的机器上已安装 Claude Code，请直接跳到路径二。

路径一：VS Code 扩展（推荐）

在 Mac 上使用 Cmd+Shift+X，或在 Windows 和 Linux 上使用 Ctrl+Shift+X 打开 Cursor 的扩展面板。搜索“Claude Code”，安装由 Anthropic 发布的扩展。扩展 ID 为 anthropic.claude-code。

在 Cursor 中搜索 Claude Code。图片作者自制。

需要提前知道的一点：该扩展有时不会出现在 Cursor 的市场搜索中。这种情况并不少见，建议您事先有所准备。如果没有显示，Anthropic 的VS Code 文档中有“为 Cursor 安装”的按钮，会直接触发 cursor:extension/anthropic.claude-code URI。如果这也失败，同一页面提供手动 VSIX 安装说明。

安装完成后，当您打开的是文件而非仅文件夹时，编辑器工具栏会出现一个“火花”图标。该图标也会出现在左侧边栏的活动栏和右下角状态栏中，这两处在未打开文件时也可见。首次会话时点击任意位置，然后点击登录，通过浏览器完成认证。

如果遇到异常，值得检查以下事项：

• 如果安装后图标未出现，请从命令面板运行 “Developer: Reload Window”

• 如果您的 shell 中已有 ANTHROPIC_API_KEY 但仍看到登录提示，请在终端中使用 cursor . 启动 Cursor，使其继承您的环境变量

路径二：集成终端（摩擦最小）

如果您的机器上已安装 Claude Code，可以完全跳过扩展。在 Cursor 中使用`Ctrl+`` 打开集成终端，并输入 claude`。Claude Code 会在终端中运行交互式会话，而编辑器与其并排保持打开。这可以完全避免扩展的兼容性问题。

如果尚未安装 Claude Code，建议使用原生安装器。它是自包含的，不需要 Node.js，并会在后台自动更新：

# macOS, Linux, or WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell (requires Git for Windows)
irm https://claude.ai/install.ps1 | iex

npm 方式（npm install -g @anthropic-ai/claude-code）仍可用，但已属于传统方式。

路径三：MCP 服务器（进阶）

如果只是个人使用，可跳过本节。

对于要构建多工具 MCP 环境的团队，您可以将 Claude Code 作为本地 MCP 服务器运行，并在 Cursor 的 MCP 设置中通过添加以下内容到 mcp.json 来连接：

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["--mcp"]
    }
  }
}

这会将 Claude Code 的工具与您配置的其他 MCP 服务器并列暴露。它可与 Cursor 协同工作。多数个人开发者并不需要它。

在 Cursor 中使用 Claude Code 能做什么

Claude Code 的能力范围比多数人对聊天式工具的预期更广。在 Cursor 中您可以：

• 直接读取相关文件来解释不熟悉或遗留代码
• 跨多个文件规划并实现功能，在更改落地前提供审阅步骤
• 从错误信息或堆栈跟踪入手调试，向后追溯到代码库中的根因
• 生成测试、运行并修复失败直至通过
• 暂存变更、撰写提交信息、创建分支并发起拉取请求

值得了解的还有 @ 提及语法。输入 @ 加文件或文件夹名即可将其拉入上下文。Claude Code 支持模糊匹配，部分文件名也可。如果您在编辑器中选中了代码，Claude 会自动看到。