在 VS Code 中使用 Claude Code：扩展的使用方法

如前文功能部分所述，plan 模式适合较大的变更。有个细节当时略过：Claude 会先运行探索性命令，并将完整方案保存到文件。您可先添加评论，再进行任何写入。即便我最终改动了大部分方案，我依然觉得这份书面方案很有用。

对于聚焦上下文，请使用带行号范围的@ 提及：@app.ts#5-10 会让 Claude 聚焦在特定区域。按住 Shift 并将文件拖入提示框会将其作为附件添加；在 Mac 上使用 Option+K（或在 Windows/Linux 上用 Alt+K）可直接插入您当前文件与选区的 @ 提及。

值得掌握的 VS Code 快捷键

这些快捷键来自Anthropic 的 VS Code 扩展文档，涵盖我在面板中最常用的组合。

权限模式的循环切换仍在 CLI 中进行：在集成终端按 Shift+Tab 可在默认、plan 与 accept-edits 模式之间切换。完整的斜杠命令集合，请参阅我们的Claude Code 斜杠命令指南。

检查点会在整个会话中跟踪 Claude 对文件的编辑。将鼠标悬停在会话中的任意消息上即可显示回退按钮。选项包括：在保留代码更改的同时分叉会话、在保留会话历史的同时回滚代码，或两者兼顾。检查点保留 30 天。它们不跟踪 bash 命令：rm、mv 与 cp 不在检查点系统内。对于任何破坏性操作，Git 仍是更可靠的安全网。

在 VS Code 中使用 Claude Code 进行调试与重构

两种工作流遵循相同步骤：提供上下文、审阅建议更改、验证结果。难点在于如何收集合适的上下文。

调试

通过直接粘贴错误、用 @terminal:name 引用终端输出，或让 Claude 通过 mcp__ide__getDiagnostics 从问题面板中拉取信息来共享错误。Claude 会追踪根因、以 diff 形式提出修复方案，然后由您运行测试进行验证。

Claude Code 未与 VS Code 原生调试器集成：没有断点、单步、实时变量。通过粘贴错误与读取诊断的方式已能覆盖大多数情形。如果您确实需要调试器，社区有一个 MCP 服务器（GitHub 上的 claude-debugs-for-you）可以填补空白，但需要单独配置。

对于 Web 的实时调试， @browser 可通过Chrome 版 Claude 扩展（1.0.36 或更高版本）把 Claude 连接到 Chrome。像 @browser go to localhost:3000 and check the console for errors 这样的提示可以让 Claude 检查实时浏览器状态，而无需您切换窗口。

重构

Claude 擅长处理跨文件的协同变更：在大型代码库中重命名函数、在库之间迁移等。diff 审阅步骤能避免其“鲁莽行事”。

本文任何部分中， CLAUDE.md 的重要性在此处最为突出。若没有加载项目特定的约定，Claude 会默认采用其从代码库中推断的模式，而这可能与您的真实期望不符。如在设置部分所述，/init 会给出一个起始文件；在进行大型重构会话前花十分钟精炼它是值得的。

上下文压缩是长会话中的实际限制。当上下文窗口被填满后，Claude 会通过总结较早的对话来自动压缩，此后可能会遗忘早先的决策。在开始新阶段前手动运行 /compact，比等待自动压缩在任务中途触发更可预测。

VS Code 中的 Claude Code 与终端工作流对比

Anthropic 的文档称 VS Code 扩展是“在 VS Code 中使用 Claude Code 的推荐方式”。该扩展带来了终端无法提供的功能：并排 diff 查看器、以 Markdown 文档呈现且可编辑的方案审阅、多会话分标签页，以及用于实时 Web 调试的 @browser。

但在能力上，终端更胜一筹。 ! bash 快捷、Tab 补全、完整斜杠命令集合，以及诸如 tail -200 app.log | claude -p "..." 这类基于管道的工作流都是 CLI 独有。MCP 服务器的配置也仅能在终端完成。在扩展中，您可以用 /mcp 管理已有服务器，但无法新增。

两者并不互斥。在 VS Code 集成终端中运行 claude 依然能获得 IDE 集成：diff 查看、选区上下文共享与诊断共享均可工作。于扩展中启动的会话可以通过 claude --resume 在终端中继续。需要强制 CLI 连接 VS Code 的 diff 查看器与诊断桥接时，可在集成终端运行 claude --ide。

多数开发者会两者兼用：VS Code 处理多文件与细致审阅，终端用于快任务与自动化。也有人全程停留在终端，说实话也完全可行。如果您更偏好 Cursor 而非 VS Code，我们的Cursor 中的 Claude Code 指南也涵盖了相同的扩展工作流。不论如何，我们的完整 CLI 工作流都值得了解。

VS Code 中的 Claude Code 与 GitHub Copilot 对比

正如开头所述，“VS Code 中的 Claude”可能指原生扩展、通过GitHub Copilot 模型选择器访问的 Claude，或是集成终端中的 CLI。原生扩展与 Copilot 共用模型，但并非同一产品，而且工作方式截然不同。

在 Copilot 里，Claude 模型运行在 GitHub 的聊天与补全范式中：无本地操作系统沙箱、无自定义 MCP 集成、无原生终端命令。在 Claude Code 扩展中，相同模型可使用多达 100 万 token 的上下文窗口、可跨文件执行任务，并可使用检查点、plan 模式与 MCP 服务器。

二者适配的工作不同。Copilot 的核心是行内自动补全。Claude Code 完全不做自动补全。Copilot 的代理模式进步很大，但在社区基准中，处理跨多文件的任务往往稍显滞后。并无绝对孰优孰劣。

原生扩展与 Copilot：同一模型，不同体验。图片由作者提供。

关于价格：Copilot Pro 为 $10/月，含 300 次高级请求。Claude Code Pro 为 $20/月。许多同时使用二者的开发者会选择 $10 的 Copilot（输入时自动补全）加 $20 的 Claude Code（更审慎、规模更大的任务）。两者覆盖工作流的不同环节，重叠不多。Anthropic 也与 GitHub 合作将 Claude 模型引入 Copilot，以承担自动补全一侧。

安全与隐私考量

Anthropic 不会使用您的代码来训练 Claude 模型。Free、Pro 与 Max 用户可在账号设置中选择退出数据日志；Team、Enterprise 与 API 计划默认不记录。关于权限模式、MCP 服务器与沙箱等超出 VS Code 表层的细节，请参阅我们的Claude Code 安全指南。

不论何种模式，以下路径始终受保护：.git、.vscode、.idea、.husky 与 .claude（其自身工作子目录除外），以及 .gitconfig、.gitmodules，以及若干 shell 与工具配置文件。这在自动接受模式下尤为重要，该模式在写入时不暂停，可能会修改 settings.json 与 tasks.json。提交前请检查 git diff。

沙箱会将 bash 命令限制在您的工作目录内，并阻止未授权的网络访问。默认关闭；可用 /sandbox 打开。

Auto 模式以分类器取代逐操作批准，在执行前审查动作，阻止诸如批量删除文件、向未授权端点发送数据，以及对 main 的强制推送等。Anthropic 将其描述为 --dangerously-skip-permissions 的更安全替代方案。

本地会话记录以明文存储在 ~/.claude/projects/ 下，保留 30 天（可通过 cleanupPeriodDays 调整）。在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 的企业部署遵循各自提供商的数据条款。Auto 模式不适用于这些提供商；它需要直接使用 Anthropic API。

VS Code 扩展常见问题排查

大多数安装问题都集中在少数几类。我几乎都遇到过。

• 缺少火花图标：请打开一个实际的文件，而不仅是文件夹。可在命令面板点击（Developer: Reload Window）重载窗口，或点击右下角状态栏中的火花入口，即使未打开文件也可使用。

• 扩展冲突：若 Claude Code 无法激活，请暂时禁用其他 AI 扩展（如 Cline、Continue 等）。

• 受限模式：Claude Code 无法在 VS Code 的受限模式下运行。请将工作区标记为受信任。

• Windows 文件锁定：若在大型多文件会话中途写入失败，请折叠资源管理器面板并暂停活动调试器。

• macOS Tahoe 的 Cmd+Esc 冲突：系统的游戏覆盖层可能会拦截 Cmd+Esc。若焦点切换失效，请在 VS Code 键盘快捷键（Cmd+K Cmd+S）中重新绑定 Claude Code: Focus input。

• 使用 Bedrock 或 Vertex 登录而非 Anthropic：您可以将 Claude Code 指向云提供商的端点。我们的本地与替代模型设置指南介绍了非订阅路径。

如以上方法均无效，Anthropic 维护了专门的故障排除指南。

限制与取舍

该扩展是 CLI 的子集。如在终端对比部分所述，Tab 补全、 ! bash 快捷与基于管道的工作流都仅在 CLI 可用，dontAsk 模式用于 CI 流水线也只在 CLI 中可用。

后台任务的可见性有限；对于需要密切观察的任务，集成终端更为透明。

批准是按文件进行而非按 hunk：如果 Claude 在同一文件中某个函数改对了、另一个改错了，您需要全部接受，再手动回滚不需要的部分。

用量限制是大多数 Pro 用户最先遇到的痛点。速率限制按滚动时间窗计算，而非按消息，且在高峰时段消耗更快。偶尔使用 Pro 足够；若全天工作，Max 5x 或 Max 20x 更为现实。不建议依赖社区估算；Anthropic 未公布精确计数，且可能变化。

在 Windows 上，VS Code 的项目资源管理器与 Claude 的写入操作之间的文件锁定问题比在 macOS 或 Linux 上更常见。大型多文件会话前折叠资源管理器面板并暂停活动调试器通常能避免此问题。

结语

VS Code 中的 Claude Code 是以任务为中心、审阅优先的编码代理。diff 查看器、plan 模式与检查点的存在，都是因为弄清代理实际改了什么，比尽快得到初稿更重要。

终端工作流不会消失；对于脚本化、自动化或偏 CLI 的工作，它仍是更好的界面。但如果您的工作需要在落地前逐条阅读每个提议的更改，那么编辑器更契合。

Claude Code 每周都会更新，因此文中的部分内容会较快过时。我们的Claude Code 最佳实践与Claude Code 2.1 指南是保持更新的良好后续。若您看到的与本文不符，请先查看官方更新日志。

如果您想系统化地练习 Claude 模型与代理工作流，推荐我们的Introduction to Claude Models 课程。