AI 编程

在 Cursor 中使用 Claude Code：安装、工作流与取舍

梳理 Claude Code 在 Cursor 中的三种接入方式、与 Cursor 原生 AI 的差异、权限模式与适用场景，帮助开发者选择合适的编码代理工作流。

阅读时长: 10 分钟
共 4646字
作者: eimoon.com
#AI #开源工具 #编程技巧

在 Cursor 中使用 Claude Code：安装、工作流与取舍

Cursor 已经自带 AI 代理，能够编辑文件、执行命令并理解整个代码库。即便如此，仍然有不少开发者会在同一个编辑器里再接入 Claude Code。原因不在于二者谁替代谁，而在于它们的工作方式不同。

Claude Code 是面向编程任务的代理式工具，能够读取代码库、规划修改、编辑文件、运行测试，并返回可审查的 diff。由于 Cursor 建立在 VS Code 体系之上，Claude Code 的 VS Code 扩展可以直接运行在 Cursor 中。这样一来，同一个窗口里会同时存在两套 AI 系统：各自维护上下文、各自计费、各自执行任务。

真正需要先区分清楚的一点是：

  • 在 Cursor 的模型选择器里选用 Claude 模型
  • 在 Cursor 中安装并运行 Claude Code 扩展或 CLI

这两件事相关，但不是同一个产品，也不会带来同一种体验。

Claude Code 在 Cursor 里到底是什么

Claude Code 是 Anthropic 的代理式编码工具，支持：

  • 读取并理解代码库
  • 编辑文件
  • 运行终端命令
  • 管理 Git 工作流
  • 通过 MCP（Model Context Protocol）连接外部服务

它既可以作为 CLI 使用，也可以通过 VS Code 扩展、桌面应用和 Web 方式运行。

在 Cursor 中运行 Claude Code，指的是把 Claude Code 本身作为一套独立工作流接入编辑器，而不是仅仅把 Claude 模型当作 Cursor 原生 AI 的后端模型。安装完成后，Claude Code 会拥有自己的侧边面板、自己的上下文窗口、自己的会话历史和权限控制逻辑。

Cursor 里的 Claude 模型，与 Claude Code 有什么区别

1. Cursor 中的 Claude 模型

Cursor 自带模型选择器，可选择 Claude Sonnet、Claude Opus、GPT、Gemini 等模型，也可以交给自动模式决定。此时使用的是 Cursor 的产品能力：

  • 由 Cursor 管理交互界面
  • 由 Cursor 管理计费
  • 由 Cursor 管理上下文与代理行为
  • Claude 只是底层模型之一

也就是说，模型是 Claude，但体验属于 Cursor。

2. Cursor 中的 Claude Code

安装 Claude Code 扩展后，获得的是另一套独立系统：

  • 独立面板
  • 独立上下文窗口
  • 独立计费方式
  • 独立权限模型
  • 独立项目记忆机制

它与 Cursor 原生 AI 可以同时存在于同一个编辑器窗口里，但二者不共享上下文。Claude Code 不知道 Cursor 原生代理做过什么，反之亦然。

如果需要的是 Claude Code 的“先规划、后执行”工作流，以及 CLAUDE.md 项目记忆能力，就必须安装扩展或使用 CLI。仅在 Cursor 的模型选择器中选中 Claude，并不会获得这些能力。

适用前提与版本要求

在 Cursor 中使用 Claude Code 之前，需要满足以下条件：

  • Claude Code 需要付费的 Anthropic 方案
  • Claude.ai 免费层不包含 Claude Code
  • 最低为 Pro 方案，价格为 20 美元/月
  • Cursor 需要运行在 VS Code engine 1.98.0 或更高版本

接入方式共有三种：

  1. VS Code 扩展
  2. Cursor 集成终端中的 CLI
  3. MCP Server

其中：

  • 扩展方式适合大多数开发者
  • 终端方式阻力最低
  • MCP 方式面向更复杂的团队或多工具环境

安装路径一：通过 VS Code 扩展接入

这是最标准的方式。

安装步骤

打开 Cursor 的扩展面板：

  • macOS：Cmd+Shift+X
  • Windows / Linux：Ctrl+Shift+X

搜索 Claude Code，安装 Anthropic 发布的扩展，扩展 ID 为：

anthropic.claude-code

扩展搜索不到时的处理办法

在 Cursor 的扩展市场中，Claude Code 扩展有时不会正常显示。出现这种情况时，可以直接使用下面的扩展 URI 触发安装：

cursor:extension/anthropic.claude-code

如果这种方式仍然失败，则需要手动通过 VSIX 安装。

安装后如何启动

安装成功后，Claude Code 的图标会出现在以下位置之一：

  • 编辑器工具栏中的 Spark 图标
  • 左侧 Activity Bar
  • 右下角状态栏

首次启动时，需要点击 Sign in，通过浏览器完成认证。

常见异常处理

如果安装后看起来不正常，可以先检查这两项：

  • 图标没有出现：在命令面板执行 Developer: Reload Window
  • 已经设置了 ANTHROPIC_API_KEY，但仍提示登录：从终端用 cursor . 启动 Cursor，让它继承当前 shell 环境变量

安装路径二：通过 Cursor 集成终端运行 Claude Code

如果本机已经安装了 Claude Code，可以直接跳过扩展。

打开 Cursor 集成终端后执行：

claude

这样 Claude Code 会在终端里进入交互式会话，而编辑器仍保持打开状态。这个方式的优点很明确：完全绕开扩展兼容性问题。

安装 Claude Code CLI

如果还没有安装，推荐使用官方原生安装方式。它是自包含的，不依赖 Node.js，并支持后台自动更新。

macOS、Linux 或 WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

需要先安装 Git for Windows：

irm https://claude.ai/install.ps1 | iex

旧的 npm 安装方式

下面的方式仍然可用，但已经属于 legacy：

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

安装路径三：作为 MCP Server 接入

这条路径面向高级用法，个人开发通常不需要。

如果需要在团队环境或多工具 MCP 架构中使用 Claude Code，可以把它作为本地 MCP Server 运行，再通过 Cursor 的 MCP 配置接入。mcp.json 可以这样写：

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

这种方式会把 Claude Code 的工具暴露为 MCP 服务，与其他 MCP Server 并列工作。

在 Cursor 中，Claude Code 能做什么

Claude Code 在 Cursor 中承担的任务范围，远大于普通聊天式代码助手。常见能力包括：

  • 直接读取相关文件，解释陌生代码或遗留系统逻辑
  • 规划并实现跨多个文件的功能修改
  • 根据报错信息或堆栈回溯调试问题
  • 生成测试、运行测试，并修复失败项直到通过
  • 暂存改动、编写 commit message、创建分支、发起 PR

@ 引用语法

在面板中输入 @，然后跟文件名或目录名，可以把目标对象加入上下文。支持模糊匹配，因此文件名不必完整输入。

如果在编辑器中预先选中了一段代码，Claude Code 也会自动看到这段内容。

用 CLAUDE.md 维护项目级持久上下文

在项目根目录放置一个 CLAUDE.md 文件后，Claude Code 会在每次会话开始时读取它。

这个文件适合存放：

  • 构建命令
  • 架构决策
  • 编码规范
  • 偏好的库
  • 项目约定
  • 需要反复说明的背景信息

在 Claude 面板中执行：

/init

可以根据当前代码库自动生成一个初始版本。

如果有一些仅限个人使用、不希望提交到仓库的覆盖配置，可以创建：

CLAUDE.local.md

Claude Code 还会自动积累一类“自动记忆”，根据会话中的修正与模式形成内部笔记，不需要手动维护。

多文件修改与代码库理解

当 Claude Code 处理跨文件任务时，会遍历目录树、读取相关代码，并在同一会话中维持整体任务上下文。在扩展界面中，这通常表现为一系列待审查的 diff。每个 diff 都是在真正修改前先展示给操作者决定。

随着会话变长，上下文会不断积累。Claude 会在必要时自动压缩上下文。需要长期保留的重要信息，不应只写在对话里，而应写进 CLAUDE.md。

Checkpoints 回滚机制

扩展和 CLI 都支持 checkpoints。将鼠标悬停在 Claude 面板中的任意消息上，可以回退到更早状态：

  • 回滚文件改动
  • 回滚对话
  • 同时回滚二者

这个机制在自动接受修改的模式下尤其重要，因为它提供了额外的安全兜底。

Claude Code 扩展 与 终端 CLI 的差异

二者底层使用的是同一套 Claude 模型，区别在于交互方式和功能表面。

扩展侧重可视化审查；终端侧重完整命令面与自动化能力。

功能 扩展 终端 CLI
Diff 审查 可视化并排对比，可直接接受/拒绝 文本形式 diff
文件引用 支持 @ 引用、模糊匹配、行范围 手动输入路径
计划审查 以完整 Markdown 文档形式在编辑器打开 终端文本输出
Checkpoints 支持 支持
! bash 快捷方式 不支持 支持
Tab 补全 不支持 支持
Slash 命令 仅部分支持 全量支持
脚本与自动化 不适合 可与 pipe、CI 配合

选择建议

扩展适合以下场景：

  • 希望始终停留在编辑器内
  • 需要图形化审查 diff
  • 更关注“看清楚改了什么”

CLI 适合以下场景：

  • 需要完整命令能力
  • 要接入自动化脚本或 CI
  • 依赖终端操作习惯
  • 扩展因兼容性问题不可用

Claude Code 与 Cursor 原生 AI 的分工

二者功能确实有重叠：

  • 都能编辑文件
  • 都能执行任务
  • 都能读取代码库

但实际工作方式存在明显区别。

Cursor 原生 AI 的特点

到 2026 年 4 月，Cursor 的 AI 已经不只是补全工具，能力包括：

  • Tab 自动补全
  • Agent 模式，可读文件、执行命令
  • Agents Window，可在本地工作区、独立 git worktree、云端 VM 与远程环境中并行运行多个代理
  • Composer 2 等更强的编码模型能力

把 Cursor 理解成“带一点 AI 的 IDE”已经不准确，它本身已经具备高度自动化的代理能力。

Claude Code 的特点

Claude Code 的典型风格是：

  1. 先读代码
  2. 先给出计划
  3. 等待批准
  4. 再执行修改

它更强调任务分解、审查与可控执行。

二者的关键对比

维度 Cursor 原生 AI Claude Code 扩展
模型访问 多模型：Claude、GPT、Gemini、Composer 仅 Claude
Tab 自动补全 支持 不支持
权限模型 终端命令默认需批准 显式动作模式切换
持久项目记忆 Cursor Rules 文件 CLAUDE.md + 自动记忆
计费 Cursor 订阅 独立 Anthropic 订阅
上下文窗口 取决于所选模型 Opus 测试版最高可到 1M tokens
并行代理 支持，通过 Agents Window 支持，通过 git worktrees

实际分工更合理的方式

更常见的工作方式不是二选一，而是分工使用：

  • Cursor 原生 AI 负责日常编辑速度、Tab 补全、轻量迭代
  • Claude Code 负责更慎重的任务，如大范围重构、长时 автономous run、多文件修改、测试生成等

同一时间让两套代理同时改动同一批文件，容易产生冲突。更稳妥的做法是一次把一个任务明确交给一套系统。

权限、审批与安全模型

Claude Code 的权限模型与 Cursor 原生代理不同。

默认情况下，Claude Code 会在以下动作前请求批准：

  • 编辑文件
  • 执行终端命令

在输入框底部可以切换模式。日常最常用的是 default 和 plan。

可用模式

  • default：可自由读取文件；编辑和命令执行前都会询问
  • plan：只读取并提出计划；在批准前不执行任何操作
  • acceptEdits：自动批准文件编辑和常见文件系统命令；bash 命令仍会提示
  • auto：自动批准常规动作，对潜在危险动作进行标记；需要主动启用后才会出现在选择器中
  • bypassPermissions：跳过所有提示，仅适合无网络沙箱环境

如何选择模式

如果任务范围不清楚，起点应当是：

plan

如果已经明确修改边界，并且希望提高执行速度，可以转到：

default

auto 是 2026 年较早时候加入的模式，目标是减少频繁确认，但仍保留风险提示。即便使用自动模式，checkpoints 依然能提供回滚能力。

数据使用说明

Claude Code 不会使用代码数据训练模型。

已知限制与代价

在 Cursor 中使用 Claude Code，并不意味着获得一套完整替代方案，限制仍然存在。

功能限制

  • 没有内联 Tab 自动补全，输入时的建议仍来自 Cursor 原生 AI
  • diff 只能整体接受或整体拒绝，不能按行精细挑选
  • 扩展中不支持 ! bash 快捷方式、Tab 补全以及部分 slash 命令
  • 需要这些能力时，仍应改用终端里的 claude

兼容性问题

从 2025 年中到 2026 年初，Cursor 更新多次影响过 Claude Code 扩展，表现包括：

  • 面板位置丢失
  • 扩展失效
  • 需要手动重装

这是这套组合方案里最持续的风险点之一。它属于“官方支持，但偶尔脆弱”的状态。

成本问题

Claude Code 使用独立的 Anthropic 订阅，不包含在 Cursor Pro 中。

成本结构至少是：

  • Cursor Pro：20 美元/月
  • Claude Pro：20 美元/月起

如果长时间运行代理式任务，Claude Pro 很快可能不够用。重度用户通常会转向更高档位的 Max 方案，价格为：

  • 100 美元/月
  • 或 200 美元/月

何时应优先使用 Claude Code

以下任务更适合交给 Claude Code：

  • 大范围重构
  • 多文件联动改动
  • 需要先审查计划再执行
  • 从错误日志追踪到代码库根因
  • 自动生成并修复测试
  • 需要长上下文的代码库分析

何时继续使用 Cursor 原生 AI

以下场景更适合留在 Cursor 原生工作流中：

  • 日常快速编辑
  • Tab 补全
  • 轻量级 UI 调整
  • 高频短周期迭代
  • 不想维护第二套订阅与第二套记忆文件

常见问题

已经订阅 Cursor Pro，还需要单独为 Claude Code 付费吗

需要。Claude Code 通过 Anthropic 计费，不通过 Cursor。最低是 Claude Pro，20 美元/月起。两套订阅彼此独立。

Claude Code 和 Cursor 原生代理能共享上下文吗

不能。二者使用完全独立的上下文窗口。

  • Claude Code 读取 CLAUDE.md
  • Cursor 原生代理读取 .cursor/rules/

如果希望两边都拿到一致的项目上下文，就需要同时维护两套规则文件。

plan 模式和 default 模式的区别是什么

  • default 模式下，Claude 会边做边询问，每一步行动前都请求批准
  • plan 模式下，Claude 会先读取代码库并生成完整计划文档，在获得批准前不会动文件

只要任务涉及多个文件，plan 往往是更稳妥的起点。

可以使用自己的 Anthropic API Key，而不是订阅方案吗

可以。登录时可以选择 API Key，而不是浏览器认证。偶发使用适合按量付费；如果长期运行较长的代理会话，订阅方案通常更合适。

在 Cursor 中运行 Claude Code 是官方支持的吗

是。存在专门面向 Cursor 的安装路径和直接安装 URI。不过官方支持不等于完全无摩擦，Cursor 的更新确实多次影响过扩展稳定性。

Cursor 更新后扩展失效怎么办

可依次尝试：

  1. 在命令面板执行 Developer: Reload Window
  2. 手动通过 VSIX 重装扩展
  3. 暂时改用 Cursor 集成终端中的 claude

第三种办法通常最稳，因为它直接绕开扩展层。

关于

关注我获取更多资讯

月球基地博客公众号二维码，扫码关注获取更多 AI 与编程资讯
📢 公众号
月球基地博客作者个人微信二维码，扫码交流 AI 与编程话题
💬 个人号

本文链接地址：https://blog.eimoon.com/p/claude-code-in-cursor-guide/

作者：eimoon.com

分享转载说明：本文由作者原创，转载请注明出处。

© 2023 - 2026 longlikun
使用 Hugo 构建
主题 Stack 由 Jimmy 设计