Claude Code for Cursor 使用教程

Claude Code 的 VS Code 扩展完全兼容 Cursor，你可以在 Cursor 中安装 Claude Code 扩展，获得原生的 Agentic Coding 体验——自动阅读代码库、跨文件编辑、运行终端命令，直接在 Cursor 中完成复杂的编程任务。Claude Code 作为独立的扩展运行，与 Cursor 的 Tab 补全、Cmd+K、Chat 等功能互不影响。Claude

VIP_CQCRE

3151人浏览 · 2026-03-19 23:58:47

VIP_CQCRE · 2026-03-19 23:58:47 发布

Cursor 是基于 VS Code 的 AI 编程编辑器，内置了丰富的 AI 功能。Claude Code 的 VS Code 扩展完全兼容 Cursor，你可以在 Cursor 中安装 Claude Code 扩展，获得原生的 Agentic Coding 体验——自动阅读代码库、跨文件编辑、运行终端命令，直接在 Cursor 中完成复杂的编程任务。

本文档主要介绍如何通过 AceData Cloud 的代理服务，在 Cursor 中配置和使用 Claude Code 扩展。

申请流程

要使用 Claude Code，首先可以到 Claude Messages 服务页面，识别下方二维码：

然后点击「Acquire」按钮，获取请求所需要的凭证：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费体验 Claude Code 服务。

安装插件

系统要求

Cursor 最新版本（基于 VS Code 1.98.0+）

安装步骤

在 Cursor 中，按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows/Linux）打开扩展视图，搜索 Claude Code，找到 Anthropic 官方发布的插件并点击「Install」安装：

Cursor 扩展市场中的 Claude Code 插件

也可以通过以下链接直接安装：

Cursor 安装链接

安装后在弹出的信息提示中选择信任，即可完成安装。

“
如果安装后扩展没有出现，请重启 Cursor 或在命令面板中执行「Developer: Reload Window」。

配置 AceData Cloud API

第一次打开插件时，会提示登录 Anthropic 官方账号。我们可以跳过官方登录，通过配置 AceData Cloud 的代理 API 来使用，无需官方订阅。

步骤一：配置环境变量

你可以选择在以下任一位置配置环境变量：

选项 A：用户级配置（所有项目适用）

编辑 ~/.claude/settings.json（如果不存在则创建），添加 env 配置，将 {token} 替换为你在 AceData Cloud 控制台获取的 API 令牌：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}

选项 B：项目级配置（仅当前项目）

在项目根目录创建 .claude/settings.json（共享配置）或 .claude/settings.local.json（个人配置，gitignored）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}

“
提示：API 令牌可在 AceData Cloud 控制台中查看。ANTHROPIC_AUTH_TOKEN 的值会被自动添加 Bearer 前缀发送到服务端。项目级配置优先级高于用户级配置。建议在团队项目中使用 .claude/settings.json 共享配置，个人敏感信息放在 .claude/settings.local.json 中。

步骤二：禁用登录提示（可选）

如果不想每次打开都看到登录提示，可以在 Cursor 设置中禁用：

按 Cmd+,（Mac）或 Ctrl+,（Windows/Linux）打开设置，搜索「Claude Code login」，找到 Disable Login Prompt 选项并勾选即可。

配置完成后，重新打开 Claude Code 插件面板，即可正常开始使用。

打开 Claude Code 面板

安装并配置完成后，有多种方式打开 Claude Code：

方式	操作
编辑器工具栏	点击编辑器右上角的 ✦ Spark 图标（需要打开一个文件）
状态栏	点击底部状态栏右侧的「✱ Claude Code」（无需打开文件）
命令面板	`Cmd+Shift+P` / `Ctrl+Shift+P`，搜索「Claude Code」
快捷键	`Cmd+Esc` （Mac）/ `Ctrl+Esc`（Windows/Linux）切换焦点

Claude Code 默认采用编辑区视图作为聊天区域，可视区域更大。你也可以将面板拖动到侧边栏或其他位置。

Cursor 内置 AI 与 Claude Code 的区别

Cursor 自带了 AI 编程功能（如 Tab 补全、Cmd+K 编辑、Chat 等）。Claude Code 扩展作为独立的 Agent，与 Cursor 内置 AI 互为补充：

特性	Cursor 内置 AI	Claude Code 扩展
工作模式	内联补全 + 对话	完整 Agent（自主读写文件、执行命令）
代码修改	单文件内联编辑	跨文件自主编辑，支持 Diff 审查
终端操作	不直接操作终端	可以运行终端命令（安装依赖、运行测试等）
上下文	手动选择上下文	自动分析整个代码库
权限控制	无	多级权限模式（Ask / Plan / Auto）
MCP 支持	Cursor 自带 MCP	Claude Code 有独立的 MCP 配置

两者可以同时使用，互不冲突。

基本使用

对话交互

在 Claude Code 面板中直接输入自然语言即可与 Claude 交互。例如：

「帮我分析这个项目的整体架构」
「这段代码有 Bug，帮我修一下」
「把这个函数重构一下，提升可读性」
「给这个模块写单元测试」

Claude Code 会自动理解你的代码库上下文，跨文件进行分析和编辑。当 Claude 需要修改文件时，会显示 Diff 对比视图，你可以选择接受或拒绝修改。

上下文引用

在对话中使用 @ 符号可以引用特定文件或上下文：

@filename.py — 引用指定文件（支持模糊匹配）
@src/components/ — 引用整个目录（需要尾部斜杠）
@terminal:name — 引用终端输出

选中编辑器中的代码后，按 Option+K（Mac）/ Alt+K（Windows/Linux）可以快速插入 @ 引用（如 @app.ts#5-10）。

斜杠命令

点击对话框中的 / 图标，或直接输入 /，可以使用丰富的内置功能：

命令	功能
`/new`	新建对话
`/model`	切换模型
`/compact`	压缩上下文
`/mcp`	配置 MCP 服务
`/config`	打开设置
`/usage`	查看用量
`/memory`	管理 Claude 记忆
`/help`	显示帮助信息

审阅代码变更

当 Claude 需要修改文件时，会显示 Diff 对比视图，展示原始代码和修改后的对比。你可以选择接受或拒绝每项修改，也可以告诉 Claude 你想要的不同做法。

权限模式

通过面板底部的模式指示器可以切换不同的权限模式：

模式	说明
Default（Ask）	每次操作前询问确认（默认）
Plan	Claude 先制定计划等待审批，确认后才执行
acceptEdits	自动接受文件编辑，但终端命令仍需确认
bypassPermissions	跳过所有权限提示，完全自动化（谨慎使用）

多会话并行

使用命令面板中的 Open in New Tab 或 Open in New Window 可以启动多个独立对话，每个对话维护独自的历史和上下文，可以并行处理不同任务。

其他设置

切换模型

Claude Code 支持切换不同的模型，例如 Claude Sonnet、Claude Opus 等。可以通过 /model 命令或在插件设置的 Selected Model 中配置。

自动模式

在插件设置中可以将 Initial Permission Mode 设为 bypassPermissions，开启后 Claude Code 执行文件编辑、终端命令等操作时不再逐一弹窗确认，实现全自动化工作流。

也可以设为 acceptEdits 实现自动接受编辑但终端命令仍需确认的半自动模式。

“
注意：开启自动模式前请确保你了解其风险，建议在可信的项目环境中使用。

在终端中使用 CLI

如果你更偏好命令行风格，可以在 Cursor 设置中勾选 Use Terminal，Claude Code 会以 CLI 模式在集成终端中运行。你也可以直接打开 Cursor 集成终端，运行 claude 命令。

常见问题

连接失败怎么办？

确认 ~/.claude/settings.json 或 .claude/settings.json 中环境变量配置正确，特别是 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
确认 API 令牌有效（可在控制台查看）
检查网络连接是否正常，确保能访问 https://api.acedata.cloud
重启 Cursor 后重试