SpyBara
Go Premium

vs-code.md 2026-09-09 22:58 UTC to 2026-09-10 23:00 UTC

This page contains 255 additions and 188 deletions.

2026
Thu 10 23:00 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Wed 23 23:57 Fri 25 23:58

在 VS Code 中使用 Claude Code

安装和配置 VS Code 的 Claude Code 扩展。获得 AI 编码协助，包括内联差异、@-提及、计划审查和快捷键。

VS Code 编辑器，右侧打开 Claude Code 扩展面板，显示与 Claude 的对话

VS Code 扩展为 Claude Code 提供了原生图形界面，直接集成到您的 IDE 中。这是在 VS Code 中使用 Claude Code 的推荐方式。

使用该扩展，您可以在接受 Claude 的计划之前审查和编辑它们、在进行编辑时自动接受、@-提及具有特定行范围的文件、访问对话历史记录，以及在单独的选项卡或窗口中打开多个对话。

前置条件

安装前，请确保您拥有：

  • VS Code 1.94.0 或更高版本
  • Anthropic 账户：任何付费 Claude 订阅（Pro、Max、Team 或 Enterprise）或 Claude Console 账户都可以使用，无需 API 密钥。首次打开扩展时，您将使用此账户登录。如果您通过第三方提供商（如 Amazon Bedrock 或 Google Cloud 的 Agent Platform）访问 Claude，请参阅使用第三方提供商了解设置说明。

安装扩展

点击您的 IDE 的链接以直接安装：

或在 VS Code 中，按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows/Linux）打开扩展视图，搜索"Claude Code"，然后点击安装。

该扩展也可以安装在其他 VS Code 分支中，如 Devin Desktop 或 Kiro。在编辑器的扩展视图中搜索"Claude Code"，或从 Open VSX 注册表 安装。如果您的编辑器无法安装该扩展，请安装 CLI 并在其集成终端中运行 claude。CLI 可在任何终端中使用。

开始使用

安装后，您可以通过 VS Code 界面开始使用 Claude Code：

1

打开 Claude Code 面板

在整个 VS Code 中，Spark 图标表示 Claude Code：<img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

打开 Claude 的最快方法是点击编辑器右上角编辑器工具栏中的 Spark 图标。只有当您打开了文件时，该图标才会出现。

VS Code 编辑器显示编辑器工具栏中的 Spark 图标

打开 Claude Code 的其他方式：

  • 活动栏：点击左侧边栏中的 Spark 图标以打开会话列表。点击任何会话以将其作为完整编辑器选项卡打开，或开始新的会话。此图标在活动栏中始终可见。
  • 命令面板：Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux），输入"Claude Code"，然后选择一个选项，如"在新选项卡中打开"
  • 状态栏：如果您已将 preferredLocation 设置为 sidebar，或使用Claude Code: Open in Side Bar 打开了 Claude，请点击窗口右下角的 ✱ Claude Code。即使没有打开文件，这也有效。

您可以拖动 Claude 面板以在 VS Code 中的任何位置重新定位它。有关详细信息，请参阅自定义您的工作流。

2

登录

第一次打开面板时，会出现登录屏幕。点击登录并在浏览器中完成授权。

如果您稍后看到未登录 · 请运行 /login，扩展程序会自动重新打开登录屏幕。如果它没有出现，请从命令面板使用开发者：重新加载窗口重新加载窗口。

如果您在 shell 中设置了 ANTHROPIC_API_KEY 但仍然看到登录提示，VS Code 可能没有继承您的 shell 环境。从终端使用 code . 启动 VS Code，以便它继承您的环境变量，或改为使用您的 Claude 账户登录。

登录后，会出现学习 Claude Code 检查清单。通过点击显示给我来完成每一项，或使用 X 关闭它。要稍后重新打开它，请在 VS Code 设置中的扩展程序 → Claude Code 下取消选中隐藏入门。

3

发送提示

要求 Claude 帮助您处理代码或文件，无论是解释某些内容的工作原理、调试问题还是进行更改。

以下是询问文件中特定行的示例：

VS Code 编辑器，在 Python 文件中选择了第 2-3 行，Claude Code 面板显示关于这些行的问题，带有 @-mention 引用
4

审查更改

您看到的内容取决于提示框底部显示的权限模式：

  • 在自动或自动编辑模式下，Claude 在不询问的情况下编辑工作区中的大多数文件。
  • 在手动模式下，当 Claude 想要编辑文件时，它会显示原始内容和建议更改的并排比较，然后要求权限。您可以接受、拒绝或告诉 Claude 改为做什么。如果您在接受之前直接在差异视图中编辑建议的内容，Claude 会被告知您修改了它，因此它不会假设文件与其原始建议相匹配。
VS Code 显示 Claude 建议更改的差异，以及询问是否进行编辑的权限提示

有关您可以使用 Claude Code 做什么的更多想法，请参阅常见工作流。

使用提示框

提示框支持多项功能：

  • 权限模式：点击提示框底部的模式指示器来切换权限模式。在 Pro、Max 和 Team 计划上，Auto 是内置的起始权限模式。请参阅扩展程序如何选择起始权限模式了解会改变这一点的因素，以及指示器提供的每种权限模式。
    • Auto：分类器审查大多数操作，而不是询问您。请参阅 auto 模式了解它审查和阻止的内容。
    • Manual：Claude 在文件编辑和大多数 shell 命令之前请求权限。
    • Plan：Claude 描述它将做什么，并在进行更改之前等待批准。VS Code 自动将计划作为完整的 Markdown 文档打开，您可以在其中添加内联注释以在 Claude 开始之前提供反馈。
    • Edit automatically：Claude 进行编辑而不询问。
  • Model：从命令菜单中选择 Switch model… 以在会话中途更改模型。您也可以点击提示框底部的模型名称来打开相同的选择器。当当前模型支持工作量级别时，选择器还会显示 Effort 行。模型名称按钮和 Effort 行需要 Claude Code v2.1.257 或更高版本。
  • Command menu：点击 / 或输入 / 来打开命令菜单。选项包括附加文件、切换模型和切换扩展思考。Customize 部分提供对 MCP 服务器、slash commands、输出样式、hooks、memory、权限和插件的访问。带有终端图标的项目在集成终端中打开。

    • 要浏览 /usage 或 /remote-control 等命令，请在 Customize 部分中选择 Slash commands。对话框会列出它们并带有过滤框。选择一个来运行它。在提示框中输入 / 仍会内联建议命令。需要 Claude Code v2.1.257 或更高版本。

    • 在 Customize 部分中选择 Output styles 来选择输出样式，包括您的自定义样式。需要 Claude Code v2.1.257 或更高版本。

      要创建自定义样式，请从 Output styles 菜单中选择 Build a custom style。Claude Code 会在项目或用户级别为您编写样式文件。需要 Claude Code v2.1.261 或更高版本。

    • Settings 部分包括 Enable Remote Control for all sessions，它设置 remoteControlAtStartup 来控制新的交互式会话是否自动连接到 Remote Control。需要 Claude Code v2.1.203 或更高版本。

      当您在 VS Code 窗口中打开或关闭切换开关时，更改适用于该 VS Code 窗口中已打开的会话，而不仅仅是您之后启动的会话。如果您关闭它，打开的会话将断开连接。使用 Claude Code v2.1.261 或更高版本，更改也会到达您其他 VS Code 窗口中打开的会话。

    • Settings 部分还包括 Focus view，它隐藏工具调用、工具结果和思考在可展开的行后面，只留下您的提示和 Claude 的响应。Claude 的最新待办事项列表保持可见，Claude 提出的待处理问题的文本也保持可见；这需要 Claude Code v2.1.225 或更高版本。在那里切换它，使用 Ctrl+Option+F（Mac）/ Ctrl+Alt+F（Windows/Linux），或从命令面板使用 Claude Code: Toggle Focus view。更改适用于每个打开的会话并在会话之间持续。需要 Claude Code v2.1.221 或更高版本。

    • 要报告错误，请点击菜单底部的 Report a problem，或输入 /bug 或 /feedback 以及可选的描述来预填充报告。当您提交报告并且您在第一方连接上登录到 Anthropic 时，Claude Code 会将其发送给 Anthropic。在第三方提供商上，或没有 Anthropic 凭证的情况下，对话框仍会打开，但提交会显示错误并不发送任何内容：与 CLI 的 /bug 不同，扩展程序不会写入本地存档。需要 Claude Code v2.1.229 或更高版本。

  • Side questions：输入 /btw 后跟一个问题来提问您的会话而不添加到对话。答案在聊天旁边的面板中打开，您可以在其中提出后续问题。线程在窗口重新加载后仍然存在。Claude Code 保留最新的 20 个交换，并根据 cleanupPeriodDays 计划过期存储的线程，只要 Claude Code 可以安全地确定保留期。要清除线程，请点击面板中的垃圾箱图标。需要 Claude Code v2.1.227 或更高版本。
  • Context indicator：提示框显示您使用了多少 Claude 的上下文窗口。Claude 在需要时自动压缩，或者您可以手动运行 /compact。
  • Extended thinking：让 Claude 花更多时间推理复杂问题。通过命令菜单（/）打开它。Claude 的推理在对话中显示为折叠块：点击一个块来阅读它，或按 Ctrl+O 来展开或折叠会话中的每个思考块。有关详细信息，请参阅Extended thinking。
  • Multi-line input：按 Shift+Enter 添加新行而不发送。这也适用于问题对话框的"Other"自由文本输入。

参考文件和文件夹

使用 @-mentions 为 Claude 提供有关特定文件或文件夹的上下文。当您输入 @ 后跟文件或文件夹名称时，Claude 会读取该内容，可以回答有关它的问题或对其进行更改。Claude Code 支持模糊匹配，因此您可以输入部分名称来找到您需要的内容：

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

对于大型 PDF，您可以要求 Claude 读取特定页面而不是整个文件：单个页面、范围如第 1-10 页，或开放式范围如第 3 页及以后。

当您在编辑器中选择文本时，Claude 可以自动看到您突出显示的代码。提示框页脚显示选择了多少行。按 Option+K（Mac）/ Alt+K（Windows/Linux）来插入带有文件路径和行号的 @-mention（例如 @app.ts#5-10）。点击选择指示器来切换 Claude 是否可以看到您突出显示的文本 - 眼睛斜线图标表示选择对 Claude 隐藏。

您也可以在将文件拖入提示框时按住 Shift 来将它们添加为附件。点击任何附件上的 X 来从上下文中删除它。

恢复过去的对话

点击 Claude Code 面板顶部的 Session history 按钮来访问您的对话历史。您可以按关键字搜索或按时间浏览。点击任何对话来恢复它，包含完整的消息历史。有关恢复会话的更多信息，请参阅管理会话。

  • Session titles：新会话根据您的第一条消息接收 AI 生成的标题。
  • Rename and archive：将鼠标悬停在会话上以显示这些操作。重命名以给它一个描述性标题，或存档以将其移动到列表底部的 Archived sessions 组。

默认情况下，14 天内没有活动的会话会自动移动到 Archived sessions，除非它是打开的、未读的或在组中。自动存档需要 Claude Code v2.1.265 或更高版本。要更改期间或关闭它，请打开存档非活动会话设置并选择天数或 Never。

要恢复存档的会话，请展开 Archived sessions 并点击 Unarchive session。在 v2.1.257 之前，该操作是 Delete session，它隐藏了一个会话而无法恢复。您之前删除的会话在升级后会出现在 Archived sessions 下。

当您恢复的对话以计划模式结束时，Claude Code 会恢复计划模式。需要 Claude Code v2.1.246 或更高版本。Claude Code 在两种情况下不会恢复它：

  • 扩展程序从 claudeCode.initialPermissionMode 或从较早对话中继承的选择选择起始权限模式
  • 您配置了 claudeCode.claudeProcessWrapper

从 Claude.ai 恢复云会话

如果您使用网络上的 Claude Code，您可以直接在 VS Code 中恢复这些云会话。这需要使用 Claude.ai Subscription 登录，而不是 Anthropic Console。

1

打开会话历史

点击 Claude Code 面板顶部的 Session history 按钮。

2

选择 Web 选项卡

对话框显示两个选项卡：Local 和 Web。点击 Web 来查看来自 claude.ai 的会话。

3

选择要恢复的会话

浏览或搜索您的云会话。点击任何会话来下载它并在本地继续对话。

检查账户和使用情况

运行 /usage 来打开 Account & usage 对话框。对话框需要 claude.ai 登录，因此在第三方提供商上不提供。它显示您登录的账户、您的计划以及您计划限制的使用条形图，例如当前会话和周。每个条形图显示距离其限制重置还有多长时间。

对话框还分解了对您的计划限制有贡献的内容。它标记占最近使用量 10% 或更多的行为，例如缓存未命中、长上下文和子代理密集或高度并行的会话，每个都有减少它的提示。Attribution 表显示了每个 skill、subagent、plugin 和 MCP 服务器贡献了多少使用量。需要 Claude Code v2.1.174 或更高版本。

使用 Day 和 Week 切换来在过去 24 小时和过去 7 天之间切换。这些数字是近似的，并从此机器上的本地会话计算，因此不包括来自其他设备或 claude.ai 的使用情况。有关跟踪和减少使用情况的更多信息，请参阅跟踪您的成本。

自定义您的工作流

您可以重新定位 Claude 面板、运行多个对话、将会话列表组织成组，或切换到终端模式。

选择 Claude 的位置

您可以拖动 Claude 面板在 VS Code 中重新定位它。抓住面板的选项卡或标题栏并将其拖动到：

  • 次级侧边栏：窗口的右侧。在您编码时保持 Claude 可见。
  • 主侧边栏：左侧边栏，带有 Explorer、Search 等图标。
  • 编辑器区域：将 Claude 作为选项卡打开，与您的文件并排显示。适用于辅助任务。

运行 Developer: Reload Window 或重启 VS Code 后，聊天是否会返回其对话取决于它在哪里打开：

  • 编辑器选项卡：对话会随其选项卡返回。
  • 侧边栏：如果您在过去 10 分钟内发送了消息或 Claude 在其中做出了响应，对话会返回。如果它没有返回，请从 Session history 恢复对话。

运行多个对话

使用命令面板中的 Open in New Tab 或 Open in New Window 来启动其他对话。每个对话维护其自己的历史记录和上下文，允许您并行处理不同的任务。

使用选项卡时，spark 图标上的小彩色点表示状态：蓝色表示权限请求待处理，橙色表示 Claude 在选项卡隐藏时完成。

将会话组织成组

在 Activity Bar 的会话列表中，您可以将相关会话收集到命名的、可折叠的组中。需要 Claude Code v2.1.229 或更高版本。

  • 对会话进行分组或取消分组：右键单击会话以从其创建组、将其移动到现有组或将其从其组中删除。每个会话一次只属于一个组，因此将其移动到另一个组会将其从第一个组中删除。
  • 一次移动多个会话：Cmd-单击（Mac）/ Ctrl-单击（Windows/Linux）每个会话，或 Shift-单击以选择范围，然后右键单击选择。
  • 从其选项卡对会话进行分组：从命令面板运行 Claude Code: Add Session Tab to Group，或右键单击会话的编辑器选项卡，然后选择或创建组。需要 Claude Code v2.1.257 或更高版本。
  • 重命名或删除组：右键单击组标题。删除组仅删除组，其会话返回到未分组列表。

该扩展按工作区文件夹保存组，因此它们在窗口重新加载后仍然存在，并在您打开相同文件夹的每个窗口中出现。当您搜索列表时，该扩展在所有组中的一个平面列表中显示匹配项。

切换到终端模式

默认情况下，该扩展打开图形聊天面板。如果您更喜欢 CLI 风格的界面，请打开 Use Terminal setting 并勾选该框。

您也可以打开 VS Code 设置（Mac 上为 Cmd+, 或 Windows/Linux 上为 Ctrl+,），转到 Extensions → Claude Code，并勾选 Use Terminal。

管理插件

VS Code 扩展包含一个图形界面，用于安装和管理 plugins。在提示框中输入 /plugins 以打开管理插件界面。

安装插件

插件对话框显示两个选项卡：Plugins 和 Marketplaces。

在 Plugins 选项卡中：

  • 已安装的插件显示在顶部，带有切换开关以启用或禁用它们
  • 可用插件来自您配置的市场，显示在下方
  • 搜索以按名称或描述过滤插件
  • 点击任何可用插件上的安装

安装插件时，选择安装范围：

  • 为您安装：在您的所有项目中可用（用户范围）
  • 为此项目安装：与项目协作者共享（项目范围）
  • 本地安装：仅供您使用，仅在此存储库中（本地范围）

管理市场

切换到 Marketplaces 选项卡以添加或删除插件源：

  • 输入 GitHub 仓库、URL 或本地路径以添加新市场
  • 点击刷新图标以更新市场的插件列表
  • 点击垃圾桶图标以删除市场

进行更改后，横幅会提示您重启 Claude Code 以应用更改。

有关插件系统的更多信息，请参阅 Plugins 和 Plugin marketplaces。

使用 Chrome 自动化浏览器任务

将 Claude 连接到您的 Chrome 浏览器，以测试 Web 应用、使用控制台日志进行调试，以及在不离开 VS Code 的情况下自动化浏览器工作流。这需要 Claude in Chrome 扩展 版本 1.0.36 或更高版本。

在提示框中输入 @browser，然后输入您希望 Claude 执行的操作：

@browser go to localhost:3000 and check the console for errors

您也可以打开附件菜单来选择特定的浏览器工具，例如打开新标签页或读取页面内容。

Claude 为浏览器任务打开新标签页并共享您浏览器的登录状态，因此它可以访问您已登录的任何网站。

有关设置说明、完整的功能列表和故障排除，请参阅 在 Chrome 中使用 Claude Code。

VS Code 命令和快捷键

打开命令面板（Mac 上按 Cmd+Shift+P 或 Windows/Linux 上按 Ctrl+Shift+P），然后输入"Claude Code"以查看 Claude Code 扩展的所有可用 VS Code 命令。

某些快捷键取决于哪个面板处于"焦点"状态（接收键盘输入）。当光标在代码文件中时，编辑器处于焦点状态。当光标在 Claude 的提示框中时，Claude 处于焦点状态。使用 Cmd+Esc / Ctrl+Esc 在它们之间切换。

命令 快捷键 描述
Focus Input Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux) 在编辑器和 Claude 之间切换焦点
Open in Side Bar - 在侧边栏中打开 Claude
Open in Terminal - 在终端模式下打开 Claude
Open in New Tab Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Windows/Linux) 以编辑器选项卡形式打开新对话
Open in New Window - 在单独的窗口中打开新对话
New Conversation Cmd+N (Mac) / Ctrl+N (Windows/Linux) 开始新对话。需要 Claude 处于焦点状态且 enableNewConversationShortcut 设置为 true
Reopen Closed Session Cmd+Shift+T (Mac) / Ctrl+Shift+T (Windows/Linux) 重新打开最近关闭的 Claude 会话选项卡。当最后关闭的选项卡不是 Claude 会话时，会回退到 VS Code 的正常重新打开关闭编辑器功能。使用 enableReopenClosedSessionShortcut 禁用
Insert @-Mention Reference Option+K (Mac) / Alt+K (Windows/Linux) 插入对当前文件和选择的引用（需要编辑器处于焦点状态）
Toggle Focus view Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux) 隐藏或显示对话中的工具活动。在 Claude 面板或侧边栏可见时有效。需要 Claude Code v2.1.221 或更高版本
Rename Session Tab - 重命名活动 Claude 选项卡中的会话。该命令也出现在选项卡的右键菜单中。需要 Claude Code v2.1.257 或更高版本
Add Session Tab to Group - 将活动 Claude 选项卡中的会话添加到您选择或创建的会话组。该命令也出现在选项卡的右键菜单中。需要 Claude Code v2.1.257 或更高版本
Mark Session as Unread - 在会话列表中将活动 Claude 选项卡中的会话标记为未读。该命令也出现在选项卡的右键菜单中。需要 Claude Code v2.1.257 或更高版本
Show Logs - 查看扩展调试日志
Logout - 登出您的 Anthropic 账户

从其他工具启动 VS Code 选项卡

该扩展在 vscode://anthropic.claude-code/open 处注册了一个 URI 处理程序。使用它从您自己的工具（shell 别名、浏览器书签或任何可以打开 URL 的脚本）打开新的 Claude Code 选项卡。如果 VS Code 尚未运行，打开 URL 会先启动它。如果 VS Code 已在运行，URL 会在当前焦点的窗口中打开。

使用您的操作系统的 URL 打开程序调用处理程序。

open "vscode://anthropic.claude-code/open"

处理程序接受两个可选查询参数：

参数 描述
prompt 在提示框中预填充的文本。必须进行 URL 编码。提示框会被预填充但不会自动提交。
session 要恢复的会话 ID，而不是开始新对话。该会话必须属于 VS Code 中当前打开的工作区。如果找不到该会话，则改为开始新对话。如果该会话已在选项卡中打开，则该选项卡会获得焦点。要以编程方式捕获会话 ID，请参阅继续对话。

例如，要打开一个预填充了"review my changes"的选项卡：

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

要启动终端会话而不是 VS Code 选项卡，请使用 CLI 的 claude-cli:// 处理程序。请参阅从链接启动会话。

配置设置

该扩展有两种类型的设置：

  • VS Code 中的扩展设置：控制扩展在 VS Code 中的行为。使用 Cmd+,（Mac）或 Ctrl+,（Windows/Linux）打开，然后转到扩展 → Claude Code。您也可以输入 / 并选择 General Config 来打开设置。
  • ~/.claude/settings.json 中的 Claude Code 设置：在扩展和 CLI 之间共享。用于允许的命令、环境变量、hooks 和 MCP 服务器。在 Pro、Max 和 Team 计划上，它也是权限模式对话开始时的一个输入。切换权限模式列出了顺序。有关详细信息，请参阅设置。

扩展设置

VS Code 从您的用户设置中读取 initialPermissionMode，并忽略工作区值。在 v2.1.225 之前，VS Code 将该设置默认为 default 并应用工作区值。

设置 默认值 描述
useTerminal false 在终端模式而不是图形面板中启动 Claude
initialPermissionMode - 控制新对话的批准提示：default、plan、acceptEdits 或 bypassPermissions。manual 是 default 的别名，选择模式指示器中标记为 Manual 的模式。当您将其留空时，扩展会选择起始权限模式，如切换权限模式中所述。
preferredLocation panel Claude 打开的位置：sidebar（右侧）或 panel（新标签页）
autosave true Claude 读取或写入文件前自动保存文件
useCtrlEnterToSend false 使用 Ctrl/Cmd+Enter 而不是 Enter 来发送提示
enableNewConversationShortcut false 启用 Cmd/Ctrl+N 来开始新对话
enableReopenClosedSessionShortcut true 使用 Cmd/Ctrl+Shift+T 重新打开最近关闭的 Claude 会话标签页。当最后关闭的标签页不是 Claude 会话时，快捷键会运行 VS Code 的正常重新打开关闭编辑器命令。
archiveInactiveSessions 14 在无活动的这么多天后自动存档会话：1、2、7 或 14。设置为 0 以关闭。需要 Claude Code v2.1.265 或更高版本
hideOnboarding false 隐藏入门清单（毕业帽图标）
focusView false 将工具调用、工具结果和思考隐藏在可展开的行后面，只留下您的提示和 Claude 的响应。Claude 的最新待办事项列表保持可见；这需要 Claude Code v2.1.225 或更高版本。您也可以从命令菜单切换焦点视图。需要 Claude Code v2.1.221 或更高版本
respectGitIgnore true 从文件搜索中排除 .gitignore 模式
usePythonEnvironment true 运行 Claude 时激活工作区的 Python 环境。需要 Python 扩展。
environmentVariables [] 为 Claude 进程设置环境变量。对于共享配置，请改用 Claude Code 设置。
disableLoginPrompt false 跳过身份验证提示（用于第三方提供商设置）
allowDangerouslySkipPermissions false 在模式选择器中添加绕过权限。仅在没有互联网访问的沙箱中使用。
claudeProcessWrapper - 用于启动 Claude 进程的可执行文件。当存在时，捆绑的二进制路径作为参数传递。如果扩展构建不包含您的平台的二进制文件，请将其设置为单独安装的 claude 二进制文件。在包装的设置中，对话以手动模式开始，除非您设置了 initialPermissionMode 或在之前的对话中选择了手动、自动编辑或自动，因为扩展会跳过那里的设置和内置默认步骤；请参阅切换权限模式。激活时出现"不支持的平台"错误意味着您的平台没有捆绑的二进制文件；请参阅哪些平台有预构建的二进制文件。

使用屏幕阅读器

该扩展的聊天面板可与屏幕阅读器配合使用。您无需打开任何设置：该扩展会为每个用户宣布对话活动，无需进行任何视觉更改。这与 CLI 的可选 屏幕阅读器模式 不同，后者会调整终端界面。

聊天面板中的屏幕阅读器支持需要 Claude Code v2.1.236 或更高版本。

在对话期间，该扩展会宣布：

  • Claude 的回复：该扩展在每条回复完成时宣布一次，在文本流入时保持沉默。您的屏幕阅读器将代码块读作行数摘要，按标签读取链接，逐个单元格读取表格；完整回复在记录中保持可读。
  • 权限请求和问题：当权限提示出现时，该扩展会宣布请求，并命名 Claude 想要使用的工具。当 Claude 向您提问以及当 Claude 完成计划并等待您审查时，它以相同方式宣布。
  • 状态更改：当 Claude 开始工作、Claude 准备好接收您的输入以及 Claude Code 开始压缩对话时，该扩展会宣布。
  • 错误和模型提示：该扩展宣布对话中的错误，并在 使用额度同意提示 或 标记请求提示 出现时宣布。

记录中的每个回合都以视觉隐藏的标题开头，标题标记为启动该回合的提示，因此您可以使用屏幕阅读器的标题导航在回合之间跳转。您也可以使用 Tab 将焦点移动到记录本身，因为该扩展将其公开为标记的区域，并按您自己的速度读取。当 Claude 工作时，您的屏幕阅读器会读取一个文本标签来代替进度旋转器的动画。

当您重新打开会话或切换到另一个会话时，该扩展不会宣布任何内容：恢复的历史记录、待处理的权限提示和进行中的状态保持沉默，直到发生新的事情。

VS Code extension vs. Claude Code CLI

Claude Code 既可作为 VS Code extension（图形面板）使用，也可作为 CLI（终端中的命令行界面）使用。某些功能仅在 CLI 中可用。如果您需要仅限 CLI 的功能，请在 VS Code 的集成终端中运行 claude。这需要独立 CLI 安装：extension 不会将 claude 添加到您的 PATH。请参阅在 VS Code 中运行 CLI。

功能 CLI VS Code Extension
Commands and skills 全部 子集（输入 / 查看可用项）
MCP server config 是 是（在聊天面板中使用 /mcp 添加和管理服务器）
Checkpoints 是 是
! bash shortcut 是 否
Tab completion 是 否

Rewind with checkpoints

VS Code extension 支持 checkpoints，它可以跟踪 Claude 的文件编辑并让您回退到之前的状态。将鼠标悬停在任何消息上以显示回退按钮，然后从三个选项中选择：

  • Fork conversation from here：从此消息开始新的对话分支，同时保持所有代码更改完整
  • Rewind code to here：将文件更改恢复到对话中的此点，同时保持完整的对话历史记录
  • Fork conversation and rewind code：开始新的对话分支并将文件更改恢复到此点

有关 checkpoints 如何工作及其限制的完整详情，请参阅 Checkpointing。

Run CLI in VS Code

要在 VS Code 中使用 CLI，请打开集成终端（Windows/Linux 上为 Ctrl+`，Mac 上为 Cmd+`）并运行 claude。CLI 会自动与您的 IDE 集成，以支持 diff 查看和诊断共享等功能。

安装 extension 不会将 claude 放在您的 shell PATH 上。extension 为其聊天面板捆绑了 CLI 的私有副本，但在终端中输入 claude 需要独立 CLI 安装。运行一次安装，此页面上的命令（包括 claude mcp add 和 claude --resume）将在任何终端中工作。如果安装后仍未找到 claude，请验证您的 PATH。

如果使用外部终端，请在 Claude Code 中运行 /ide 以将其连接到 VS Code。

Switch between extension and CLI

extension 和 CLI 共享相同的对话历史记录。要在 CLI 中继续 extension 对话，请在终端中运行 claude --resume。这将打开一个交互式选择器，您可以在其中搜索并选择您的对话。

Include terminal output in prompts

使用 @terminal:name 在您的提示中引用终端输出，其中 name 是终端的标题。这让 Claude 可以看到命令输出、错误消息或日志，而无需复制粘贴。

Monitor background processes

与 CLI 相比，extension 中后台任务的可见性受限。为了获得更好的可见性，让 Claude 输出命令，以便您可以在 VS Code 的集成终端中运行它。

Connect to external tools with MCP

MCP（Model Context Protocol）服务器为 Claude 提供对外部工具、数据库和 API 的访问。

要在不离开 VS Code 的情况下管理 MCP 服务器，请在聊天面板中输入 /mcp。从打开的对话框中，您可以添加服务器、删除保存在本地、用户或项目范围的服务器、启用或禁用服务器、重新连接到服务器以及管理 OAuth 身份验证。在对话框中添加和删除服务器需要 Claude Code v2.1.261 或更高版本。

您也可以在 VS Code 的集成终端中运行 claude mcp add（Ctrl+` 或 Cmd+`）。对话框和终端命令保存到相同的 MCP 配置，来自任一方的更改在您之后启动的对话中生效。下面的示例添加了 GitHub 的远程 MCP 服务器，该服务器使用作为标头传递的个人访问令牌进行身份验证：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

将 YOUR_GITHUB_PAT 替换为您的个人访问令牌。claude mcp add 命令保存配置而不验证凭据，因此此处接受占位符值，但服务器稍后无法连接。要验证连接，请启动新对话，输入 /mcp，并检查服务器是否显示已连接。具有错误凭据的服务器显示失败。

配置后，要求 Claude 使用这些工具（例如，"Review PR #456"）。

要查找要连接的服务器，请参阅查找和构建 MCP 服务器。

使用 git

Claude Code 与 git 集成，帮助直接在 VS Code 中进行版本控制工作流。要求 Claude 提交更改、创建拉取请求或跨分支工作。要在具有自己的文件和分支的隔离 worktree 中启动 Claude，请参阅 使用 worktrees 运行并行会话。

创建提交和拉取请求

Claude 可以暂存更改、编写提交消息，并根据您的工作创建拉取请求：

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

创建拉取请求时，Claude 会根据实际代码更改生成描述，并可以添加有关测试或实现决策的上下文。

使用第三方提供商

默认情况下，Claude Code 直接连接到 Anthropic 的 API。如果您的组织使用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 来访问 Claude，请配置扩展以改用您的提供商：

1

禁用登录提示

打开禁用登录提示设置并勾选该框。

您也可以打开 VS Code 设置（Mac 上按 Cmd+, 或 Windows/Linux 上按 Ctrl+,），搜索"Claude Code login"，然后勾选禁用登录提示。

2

配置您的提供商

按照您的提供商的设置指南进行操作：

这些指南涵盖在 ~/.claude/settings.json 中配置您的提供商，这确保您的设置在 VS Code 扩展和 CLI 之间共享。

在第三方提供商上，扩展不提供需要 claude.ai 账户的功能，例如使用情况跟踪、语音听写和用于从 Claude.ai 恢复云会话的 Web 标签页。来自早期 /login 的 claude.ai 登录会保留下来但未被使用：扩展不会在任何请求中发送它。

安全和隐私

您的代码保持私密。Claude Code 处理您的代码以提供协助，但不会将其用于训练模型。有关数据处理的详细信息以及如何选择退出日志记录，请参阅数据和隐私。

启用自动编辑权限后，Claude Code 可以修改 VS Code 配置文件（如 settings.json 或 tasks.json），VS Code 可能会自动执行这些文件。为了在处理不受信任的代码时降低风险：

  • 为不受信任的工作区启用 VS Code 受限模式
  • 使用手动模式而不是自动编辑或自动编辑
  • 在接受更改之前仔细审查更改

内置 IDE MCP 服务器

当扩展处于活动状态时，它运行一个本地 MCP 服务器，CLI 会自动连接到该服务器。这是 CLI 在 VS Code 的原生 diff 查看器中打开 diff、读取您当前的 @-mentions 选择，以及——当您在 Jupyter notebook 中工作时——要求 VS Code 执行单元格的方式。

服务器名为 ide，从 /mcp 中隐藏，因为没有什么需要配置的。但是，如果您的组织使用 PreToolUse hook 来允许列表 MCP 工具，您需要知道它的存在。

选择和打开文件上下文。 连接时，CLI 会在您发送的每个提示中包含您当前的编辑器选择和活动文件的路径作为上下文。当发生这种情况时，记录会显示一行 ⧉ Selected N lines from <file>。要排除敏感文件（如 .env），请为其路径添加 Read 拒绝规则。匹配的拒绝规则可防止该文件的选定文本和打开文件通知到达 Claude。

传输和身份验证。 服务器绑定到 127.0.0.1 上的随机端口，范围在 10000–65535，端口不可配置。传输是未加密的 ws://；因为套接字仅限于本地回环，任何可以捕获流量的进程也可以从锁文件中读取令牌，所以 TLS 不会增加保护。每次扩展激活都会生成一个新的随机身份验证令牌，将其写入 ~/.claude/ide/<port>.lock 处的锁文件，CLI 必须将其作为 X-Claude-Code-Ide-Authorization 标头呈现才能连接。锁文件在 0700 目录中具有 0600 权限，因此只有运行 VS Code 的用户才能读取它。如果设置了 CLAUDE_CONFIG_DIR，锁文件将写入 $CLAUDE_CONFIG_DIR/ide/ 目录。

暴露给模型的工具。 服务器托管十几个工具，但只有两个对模型可见。其余的是 CLI 用于自己的 UI 的内部 RPC——打开 diff、读取选择、保存文件——在工具列表到达 Claude 之前被过滤掉。

工具名称（如 hooks 所见） 功能 只读
mcp__ide__getDiagnostics 返回语言服务器诊断——VS Code 的问题面板中的错误和警告。可选地限定到一个文件。 是
mcp__ide__executeCode 在活动 Jupyter notebook 的内核中运行 Python 代码。请参阅下面的确认流程。 否

Jupyter 执行始终先询问。 mcp__ide__executeCode 无法静默运行任何内容。在每次调用时，代码被插入为活动 notebook 末尾的新单元格，VS Code 将其滚动到视图中，原生快速选择器要求您执行或取消。取消——或用 Esc 关闭选择器——会向 Claude 返回错误，不会运行任何内容。当没有活动 notebook、未安装 Jupyter 扩展 (ms-toolsai.jupyter) 或内核不是 Python 时，该工具也会直接拒绝。

修复常见问题

扩展程序无法安装

Spark 图标不可见

当您打开文件时，Spark 图标会出现在编辑器工具栏（编辑器右上角）。如果您看不到它：

  1. 打开文件：该图标需要打开文件。仅打开文件夹是不够的。
  2. 检查 VS Code 版本：需要 1.94.0 或更高版本（帮助 → 关于）
  3. 重启 VS Code：从命令面板运行"Developer: Reload Window"
  4. 禁用冲突的扩展程序：临时禁用其他 AI 扩展程序（Cline、Continue 等）
  5. 检查工作区信任：该扩展程序在受限模式下不起作用

或者，如果您已将 preferredLocation 设置为 sidebar，或使用Claude Code: Open in Side Bar 打开了 Claude，请点击状态栏（右下角）中的"✱ Claude Code"。即使没有打开文件，这也能工作。您也可以使用命令面板（Cmd+Shift+P / Ctrl+Shift+P）并输入"Claude Code"。

Cmd+Esc 在 macOS 上无效

在 macOS Tahoe 及更高版本上，系统游戏覆盖快捷键默认绑定到 Cmd+Esc，并在按键到达 VS Code 之前拦截它。要释放该快捷键：

  1. 打开系统设置
  2. 转到键盘，然后键盘快捷键，然后游戏控制器
  3. 清除游戏覆盖复选框

或者，将扩展程序重新绑定到不同的键：打开 VS Code 键盘快捷键编辑器（Cmd+K Cmd+S），搜索 Claude Code: Focus input，并分配新的绑定。

Claude Code 从不响应

如果 Claude Code 没有响应您的提示：

  1. 检查您的互联网连接：确保您有稳定的互联网连接
  2. 开始新对话：尝试开始新对话以查看问题是否仍然存在
  3. 尝试 CLI：从终端运行 claude 以查看是否获得更详细的错误消息

如果问题仍然存在，请在 GitHub 上提交问题，并提供有关错误的详细信息。

卸载扩展

要卸载 Claude Code 扩展：

  1. 打开扩展视图（Mac 上按 Cmd+Shift+X 或 Windows/Linux 上按 Ctrl+Shift+X）
  2. 搜索"Claude Code"
  3. 点击卸载

如果你在 VS Code 集成终端中运行 claude，Claude Code 会自动重新安装扩展。要保持卸载状态，请在 /config 中关闭自动安装 IDE 扩展，或将 autoInstallIdeExtension 设置为 false。你也可以将 CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL 环境变量设置为 1。

要同时删除扩展数据并重置所有设置，请删除你的平台对应的扩展存储目录。

在 macOS 上：

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

在 Linux 上：

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

在 Windows 上，在 PowerShell 中：

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

如需更多帮助，请参阅故障排除指南。

后续步骤

现在您已在 VS Code 中设置了 Claude Code：