Claude Code 在 VS Code 里安装后，就能用原生面板、内联 diff、@文件引用、会话历史和多个对话标签直接写代码、审查改动、排查问题。先确认 VS Code 版本不低于 1.98.0，再登录 Anthropic 账户；如果看不到 Spark 图标，通常是没打开文件、窗口未重载或被其他扩展冲突。
Claude Code VS Code 扩展怎么安装和配置
Claude Code VS Code 扩展提供原生图形界面，直接集成到 IDE 里，是在 VS Code 中使用 Claude Code 的推荐方式。它支持在接受前审查计划、自动接受编辑、用选中文本或 @file.ts#5-10 引用上下文、查看会话历史，以及在不同标签页或窗口中打开多个会话。
安装要求
安装前请确认：
- VS Code 1.98.0 或更高版本
- 一个 Anthropic 账户（首次打开扩展时登录）。如果你使用 Amazon Bedrock 或 Google Vertex AI，改看使用第三方提供商
扩展包含 CLI（命令行接口），你可以在 VS Code 的集成终端里使用它来调用高级功能。细节见VS Code 扩展与 Claude Code CLI 的区别。
安装扩展
直接点击对应 IDE 的安装链接：
或者在 VS Code 中按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows/Linux）打开扩展视图，搜索 Claude Code，然后点击 Install。
这个扩展也能安装到 Windsurf、Kiro 这类 VS Code 分支里。你可以在编辑器的扩展视图里搜索 Claude Code，或者从 Open VSX registry 安装。如果你的编辑器无法安装扩展，直接在它的集成终端里运行 claude 即可。CLI 可在任何终端中使用。
如果安装后没有出现扩展，重启 VS Code，或者在命令面板里运行 Developer: Reload Window。
快速开始
安装完成后，可以直接通过 VS Code 界面开始使用 Claude Code：
打开 Claude 面板
整个 VS Code 中，Spark 图标都表示 Claude Code：
最快的打开方式是点击编辑器右上角 Editor Toolbar 里的 Spark 图标。这个图标只有在打开了文件时才会显示。
打开 Claude Code 的其他方式：
- Activity Bar：点击左侧边栏里的 Spark 图标，打开会话列表。点击任意会话可把它作为完整编辑器标签页打开，也可以新建一个会话。这个图标始终可见。
- Command Palette：按
Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux），输入Claude Code，然后选择例如 Open in New Tab 的命令 - Status Bar：点击窗口右下角的 ✱ Claude Code。即使没有打开文件，这个入口也可用
你可以拖动 Claude 面板，把它放到 VS Code 的任意位置。具体方式见自定义工作流。
首次登录
第一次打开面板时，会出现登录界面。点击 Sign in，然后在浏览器里完成授权。
如果后面看到 Not logged in · Please run /login，扩展通常会自动重新打开登录界面。如果没有自动出现，在命令面板里运行 Developer: Reload Window。
如果你的 shell 里已经设置了 ANTHROPIC_API_KEY，但 VS Code 仍然要求登录，说明 VS Code 可能没有继承 shell 环境。用终端启动 VS Code：code .，让它继承环境变量；或者直接登录 Claude 账户。
登录后会出现 Learn Claude Code 清单。你可以逐项点击 Show me 跟着看，也可以点右上角的 X 关闭。之后如果想重新打开，到 VS Code 设置里进入 Extensions → Claude Code，取消勾选 Hide Onboarding。
发送提示
你可以让 Claude 帮你解释代码、排查问题，或者直接修改文件。
Claude 会自动读取你选中的文本。按
Option+K（Mac）或Alt+K（Windows/Linux）还能把一个@引用插入到提示里，比如@file.ts#5-10。
下面是一个针对文件中某一行提问的示例：
审查 Claude 的改动
当 Claude 想修改文件时，会先显示原始内容和建议修改的并排对比，然后询问你是否允许。你可以接受、拒绝，或者让 Claude 按别的方式改。
如果你在 diff 视图里、还没接受之前就直接改了建议内容，Claude 会被告知你已经修改过它，不会再假定文件仍然和原始方案一致。
想了解更多能做什么，可以看Common workflows。
也可以在命令面板运行 Claude Code: Open Walkthrough，查看基础功能的引导流程。
使用提示框
提示框支持这些功能：
- 权限模式：点击提示框底部的模式指示器切换模式。普通模式下，Claude 每次动作前都会请求权限。计划模式下，Claude 会先描述准备做什么并等待批准，VS Code 会把计划作为完整 Markdown 文档打开，你可以在 Claude 开始前直接添加行内评论。自动接受模式下，Claude 会直接修改，不再逐步询问。默认模式可在 VS Code 设置里的
claudeCode.initialPermissionMode配置。 - 命令菜单：点击
/或输入/打开命令菜单。这里可以附加文件、切换模型、切换 extended thinking、查看计划用量（/usage）、启动 Remote Control 会话（/remote-control）。Customize 区域里还能访问 MCP servers、hooks、memory、permissions 和 plugins。带终端图标的项目会在集成终端中打开。 - 上下文指示器：提示框会显示 Claude 当前用了多少上下文窗口。Claude 会在需要时自动压缩，也可以手动运行
/compact。 - extended thinking：让 Claude 在复杂问题上花更多时间推理。可以通过命令菜单（
/）切换。Claude 的推理过程会以折叠块形式出现在对话里：点开单个块可以查看，或者按Ctrl+O展开或折叠当前会话里的所有 thinking 块。详见Extended thinking。 - 多行输入：按
Shift+Enter可以换行而不发送。这在问题对话框里的“Other”自由文本输入框中也适用。
引用文件和文件夹
用 @ 提及可以把特定文件或文件夹上下文交给 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 只读指定页，而不是整个文件：单页、页码范围（如 pages 1-10），或者开放范围（如 page 3 onward）。
在编辑器里选中文本后，Claude 会自动看到你高亮的代码。提示框底部会显示选中了多少行。按 Option+K（Mac）或 Alt+K（Windows/Linux）可以插入一个带文件路径和行号的 @ 引用，例如 @app.ts#5-10。点击选区指示器，可以切换 Claude 是否能看到你高亮的文本；眼睛划线图标表示已对 Claude 隐藏。
你也可以在拖动文件到提示框时按住 Shift，把它们作为附件添加。点击任一附件上的 X 可把它从上下文中移除。
恢复过去的对话
点击 Claude Code 面板顶部的 Session history 按钮，就能查看会话历史。你可以按关键词搜索，也可以按时间浏览（Today、Yesterday、Last 7 days 等）。点击任意会话即可带着完整消息历史继续。新会话会根据第一条消息自动生成标题。把鼠标悬停在会话上，会出现重命名和删除操作：重命名可改成更清晰的标题，删除会把它从列表中移除。关于恢复会话的更多内容，见Manage sessions。
恢复来自 Claude.ai 的远程会话
如果你使用 Claude Code on the web，可以直接在 VS Code 中恢复那些远程会话。这需要用 Claude.ai Subscription 登录，而不是 Anthropic Console。
- 点击 Claude Code 面板顶部的 Session history 按钮。
- 对话框里会有两个标签页：Local 和 Remote。点击 Remote 查看来自 claude.ai 的会话。
- 浏览或搜索你的远程会话。点击任意会话即可下载它，并在本地继续对话。
只有从 GitHub 仓库启动的 web 会话才会出现在 Remote 标签页里。恢复时只会把对话历史加载到本地，不会把改动同步回 claude.ai。
自定义工作流
上手后，你可以重新摆放 Claude 面板、同时运行多个会话，或者切到终端模式。
Claude 放在哪更合适
你可以拖动 Claude 面板，把它放到 VS Code 的任意位置。抓住面板标签页或标题栏拖到这里：
- Secondary sidebar：窗口右侧，写代码时还能一直看到 Claude
- Primary sidebar：窗口左侧，和 Explorer、Search 等视图放在一起
- Editor area：作为标签页打开，和文件并排处理副任务
主会话建议放在侧边栏，额外任务再打开其他标签页。Claude 会记住你上次选的位置。Activity Bar 里的会话列表图标和 Claude 面板图标不是同一个东西：会话列表图标始终显示在 Activity Bar 里，而 Claude 面板图标只有在它停靠到左侧边栏时才会出现在那里。
同时运行多个对话
可以从命令面板选择 Open in New Tab 或 Open in New Window，启动额外的对话。每个对话都有自己独立的历史和上下文，适合并行处理不同任务。
在标签页模式下，Spark 图标上的小圆点会显示状态：蓝色表示有待处理的权限请求，橙色表示 Claude 在标签页隐藏时已经完成任务。
切换到终端模式
默认情况下，扩展打开的是图形聊天面板。如果你更喜欢 CLI 风格的界面，可以打开 Use Terminal 设置 并勾选。
也可以在 VS Code 设置里（Mac 用 Cmd+,，Windows/Linux 用 Ctrl+,）进入 Extensions → Claude Code，勾选 Use Terminal。
管理插件
VS Code 扩展里自带一个图形界面，用来安装和管理 plugins。在提示框输入 /plugins，就会打开 Manage plugins 界面。
安装插件
插件对话框有两个标签页：Plugins 和 Marketplaces。
在 Plugins 标签页里：
- 顶部显示已安装插件，可以用开关启用或禁用
- 下方显示你已配置市场中的可用插件
- 可以按名称或描述搜索插件
- 点击任意可用插件的 Install
安装插件时，需要选择安装范围：
- Install for you：在你所有项目里都可用（用户范围）
- Install for this project：和项目协作者共享（项目范围）
- Install locally：只对你可用，而且只在这个仓库里有效（本地范围）
管理市场
切换到 Marketplaces 标签页，可以添加或移除插件来源：
- 输入 GitHub 仓库、URL 或本地路径，添加新的 marketplace
- 点击刷新图标，更新某个 marketplace 的插件列表
- 点击垃圾桶图标，移除某个 marketplace
修改后会出现提示条，要求你重启 Claude Code 以应用更新。
VS Code 里的插件管理底层使用的是同一套 CLI 命令。你在扩展里配置的 plugins 和 marketplaces，CLI 里也能用，反过来也一样。
更多关于插件系统的内容，见Plugins和Plugin marketplaces。
用 Chrome 自动化浏览器任务
你可以把 Claude 连接到 Chrome 浏览器，在 VS Code 里直接测试 Web 应用、查看控制台日志、自动执行浏览器流程。这个功能需要安装 Claude in Chrome 扩展 1.0.36 或更高版本。
在提示框输入 @browser，后面接要执行的操作：
@browser go to localhost:3000 and check the console for errors你也可以打开附件菜单，选择特定的浏览器工具，比如新建标签页或读取页面内容。
Claude 会为浏览器任务打开新标签页，并共享你的浏览器登录状态，因此它可以访问你已经登录的网站。
安装步骤、完整能力列表和排查方式，见Use Claude Code with Chrome。
VS Code 命令和快捷键
打开命令面板（Mac 用 Cmd+Shift+P，Windows/Linux 用 Ctrl+Shift+P），输入 Claude Code 就能看到 Claude Code 扩展的全部 VS Code 命令。
有些快捷键取决于当前哪个面板处于“聚焦”状态，也就是接收键盘输入。光标在代码文件里时，编辑器处于聚焦状态；光标在 Claude 提示框里时，Claude 处于聚焦状态。用 Cmd+Esc / Ctrl+Esc 可以在两者之间切换。
这里列的是控制扩展的 VS Code 命令。并不是所有内置 Claude Code 命令都能在扩展里使用。细节见VS Code 扩展与 Claude Code CLI 的区别。
| Command | Shortcut | Description |
|---|---|---|
| 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) |
插入当前文件和选区的引用（要求编辑器处于焦点） |
| Show Logs | - | 查看扩展调试日志 |
| Logout | - | 退出 Anthropic 账户 |
从其他工具启动 VS Code 标签页
扩展注册了一个 URI 处理器：vscode://anthropic.claude-code/open。你可以通过 shell alias、浏览器书签脚本，或者任何能打开 URL 的工具，直接打开一个新的 Claude Code 标签页。如果 VS Code 还没启动，打开这个 URL 会先启动 VS Code；如果已经在运行，则会在当前聚焦的窗口里打开。
用你操作系统的 URL 打开方式调用即可。
open "vscode://anthropic.claude-code/open"xdg-open "vscode://anthropic.claude-code/open"在 PowerShell 中：
Start-Process "vscode://anthropic.claude-code/open"在 cmd.exe 里，start 会把第一个带引号的参数当成窗口标题，所以要在 URL 前先传一个空标题：
start "" "vscode://anthropic.claude-code/open"这个处理器支持两个可选查询参数：
| 参数 | 说明 |
|---|---|
prompt |
预填到提示框里的文本，必须进行 URL 编码。只会预填，不会自动发送。 |
session |
要恢复的会话 ID，而不是新建会话。该会话必须属于 VS Code 当前打开的 workspace。找不到时会回退到新会话。如果该会话已经在某个标签页打开，会直接切到那个标签页。要程序化获取 session ID，见 Continue conversations。 |
例如，打开一个预填 review my changes 的标签页：
vscode://anthropic.claude-code/open?prompt=review%20my%20changes如果你想启动的是终端会话，而不是 VS Code 标签页，要用 CLI 的 claude-cli:// 处理器。见 Launch sessions from links。
配置设置
扩展有两类设置：
- VS Code 中的扩展设置：控制扩展在 VS Code 里的行为。按
Cmd+,（Mac）或Ctrl+,（Windows/Linux），进入 Extensions → Claude Code。也可以输入/，选择 General Config 打开设置。 - Claude Code 设置：位于
~/.claude/settings.json，供扩展和 CLI 共享。用于允许命令、环境变量、hooks 和 MCP servers。细节见Settings。
你可以在
settings.json里加入"$schema": "https://json.schemastore.org/claude-code-settings.json"，这样在 VS Code 里就能获得所有可用设置的自动补全和行内校验。
扩展设置
| Setting | Default | Description |
|---|---|---|
useTerminal |
false |
启动终端模式而不是图形面板 |
initialPermissionMode |
default |
控制新对话的授权提示：default、plan、acceptEdits 或 bypassPermissions。详见permission modes。 |
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 默认的重新打开关闭编辑器命令 |
hideOnboarding |
false |
隐藏引导清单（毕业帽图标） |
respectGitIgnore |
true |
文件搜索时排除 .gitignore 模式 |
usePythonEnvironment |
true |
运行 Claude 时激活工作区的 Python 环境。需要 Python 扩展。 |
environmentVariables |
[] |
为 Claude 进程设置环境变量。需要共享配置时，优先使用 Claude Code 设置。 |
disableLoginPrompt |
false |
跳过认证提示（用于第三方提供商配置） |
allowDangerouslySkipPermissions |
false |
在模式选择器里增加 Auto mode 和 Bypass permissions。Auto mode 有 plan、admin、model 和 provider 要求，所以即使打开这个开关，也可能仍然不可用。Bypass permissions 只应在没有互联网访问的沙箱里使用。 |
claudeProcessWrapper |
- | 用来启动 Claude 进程的可执行文件。如果有捆绑二进制，会把它的路径作为参数传入。若扩展构建不包含你平台的内置二进制，可把这里设成单独安装的 claude 二进制。 |
VS Code 扩展与 Claude Code CLI 的区别
Claude Code 同时提供 VS Code 扩展（图形面板）和 CLI（终端命令行）两种方式。某些功能只在 CLI 中可用。如果你需要 CLI 专属功能，可以在 VS Code 的集成终端里运行 claude。
| Feature | CLI | VS Code Extension |
|---|---|---|
| Commands and skills | All | Subset（输入 / 查看可用项） |
| MCP server config | Yes | Partial（可通过 CLI 添加；在聊天面板里用 /mcp 管理已有服务器） |
| Checkpoints | Yes | Yes |
! bash shortcut |
Yes | No |
| Tab completion | Yes | No |
用检查点回退
VS Code 扩展支持 checkpoints，可以跟踪 Claude 的文件编辑并回退到之前的状态。把鼠标悬停在任意消息上会显示回退按钮，然后可以选这三种操作：
- Fork conversation from here：从这条消息开始创建一个新的对话分支，同时保留所有代码改动
- Rewind code to here：把文件改动回退到这一步，同时保留完整对话历史
- Fork conversation and rewind code：同时新建对话分支并把代码回退到这一步
完整说明和限制见Checkpointing。
在 VS Code 中运行 CLI
如果你想留在 VS Code 里同时使用 CLI，打开集成终端（Windows/Linux 用 Ctrl+` ，Mac 用 Cmd+` ），然后运行 claude。CLI 会自动和你的 IDE 集成，支持 diff 视图和诊断信息共享。
如果你使用的是外部终端，在 Claude Code 里运行 /ide 连接到 VS Code。
在扩展和 CLI 之间切换
扩展和 CLI 共享同一份会话历史。要在 CLI 中继续扩展里的对话，在终端运行 claude --resume。它会打开一个交互式选择器，你可以搜索并选择之前的会话。
在提示里包含终端输出
用 @terminal:name 在提示中引用终端输出，其中 name 是终端标题。这样 Claude 可以看到命令输出、错误信息或日志，不需要你手动复制粘贴。
监控后台进程
当 Claude 运行长时间命令时，扩展会在状态栏显示进度。但和 CLI 相比，后台任务的可见性有限。若想更清楚地观察，最好让 Claude 直接输出命令，然后你在 VS Code 的集成终端里手动运行。
用 MCP 连接外部工具
MCP（Model Context Protocol）服务器可以让 Claude 访问外部工具、数据库和 API。
要添加 MCP server，在集成终端（Ctrl+` 或 Cmd+`）里运行 claude mcp add。下面的示例添加了 GitHub 的远程 MCP server，它通过 personal access token 作为请求头认证：
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"配置完成后，直接让 Claude 使用这些工具即可，比如输入“Review PR #456”。
如果想不离开 VS Code 管理 MCP server，在聊天面板输入 /mcp。MCP 管理对话框可以启用/禁用服务器、重新连接到服务器，以及管理 OAuth 认证。可用 server 列表见 MCP documentation。
使用 git
Claude Code 和 git 集成得很紧密，可以直接在 VS Code 里帮你做版本控制相关工作。你可以让 Claude 提交代码、创建 pull request，或者跨分支工作。
创建提交和 pull request
Claude 可以帮你暂存改动、编写 commit message，并根据你的工作创建 pull request：
> commit my changes with a descriptive message
> create a pr for this feature
> summarize the changes I've made to the auth module创建 pull request 时，Claude 会根据实际代码变更生成描述，也可以补充测试或实现决策的上下文。
使用 git worktrees 并行处理任务
使用 --worktree（-w）参数，可以在一个隔离的 worktree 里启动 Claude，每个 worktree 都有自己的文件和分支：
claude --worktree feature-auth每个 worktree 都保留独立的文件状态，同时共享 git 历史。这样多个 Claude 实例在处理不同任务时就不会互相干扰。更多细节见Run parallel sessions with Git worktrees。
使用第三方提供商
默认情况下，Claude Code 直接连接 Anthropic 的 API。如果你的组织通过 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 使用 Claude，就要把扩展配置成使用对应提供商：
- 打开 Disable Login Prompt setting 并勾选
- 按照你的提供商指南完成设置：
这些指南会说明如何在 ~/.claude/settings.json 中配置提供商，这样 VS Code 扩展和 CLI 之间就能共享设置。
安全与隐私
你的代码会保持私有。Claude Code 会处理你的代码来提供帮助，但不会用它来训练模型。关于数据处理以及如何选择退出日志记录，见 Data and privacy。
如果启用了自动编辑权限，Claude Code 可能会修改 VS Code 的配置文件，比如 settings.json 或 tasks.json，而这些文件可能会被 VS Code 自动执行。处理不受信任的代码时，建议：
- 对不受信任的工作区启用 VS Code Restricted Mode
- 编辑时使用手动批准模式，而不是自动接受
- 在接受前仔细检查变更
内置 IDE MCP server
扩展激活后，会运行一个本地 MCP server，CLI 会自动连接到它。CLI 在 VS Code 里打开 diff 视图、读取当前选区做 @ 提及，以及在 Jupyter notebook 中请求执行 cell，都是通过它完成的。
这个 server 名为 ide，并且因为没有可配置项，所以在 /mcp 中是隐藏的。如果你的组织使用 PreToolUse hook 来允许名单化 MCP tools，就需要知道它的存在。
选区与当前文件上下文。 连接后，CLI 会把当前编辑器选区和活动文件路径作为每次提示的上下文。发生这种情况时，对话记录里会出现一行 ⧉ Selected N lines from <file>。如果想排除 .env 这类敏感文件，可以为该路径添加一个 Read deny rule。匹配到的 deny rule 会同时阻止选中文本和该文件的“已打开”提示送到 Claude。
传输与认证。 这个 server 监听 127.0.0.1 的随机高位端口，其他机器无法访问。每次扩展激活时都会生成新的随机 auth token，CLI 连接时必须提供它。token 会写入 ~/.claude/ide/ 下的锁文件，权限是 0600，所在目录权限是 0700，因此只有运行 VS Code 的用户能读取。
向模型暴露的工具。 这个 server 里实际有十多个工具，但模型只能看到两个。其余工具属于 CLI 自己的内部 RPC，用于打开 diff、读取选区、保存文件等，在工具列表到达 Claude 之前就会被过滤掉。
| Tool name (as seen by hooks) | What it does | Writes? |
|---|---|---|
mcp__ide__getDiagnostics |
返回语言服务器诊断信息，也就是 VS Code Problems 面板里的错误和警告。可选地只针对某个文件。 | No |
mcp__ide__executeCode |
在当前活跃 Jupyter notebook 的内核里运行 Python 代码。见下方确认流程。 | Yes |
Jupyter 执行一定会先询问。 mcp__ide__executeCode 不能静默运行。每次调用时，代码都会作为一个新 cell 插入到当前 notebook 的末尾，VS Code 会把它滚动到可见区域，然后弹出原生 Quick Pick，让你选择 Execute 或 Cancel。取消——或者按 Esc 关闭选择器——都会把错误返回给 Claude，而不会执行任何内容。如果没有活动中的 notebook、没有安装 Jupyter 扩展（ms-toolsai.jupyter），或者当前 kernel 不是 Python，这个工具会直接拒绝。
Quick Pick 的确认和
PreToolUsehook 是分开的。mcp__ide__executeCode被 allowlist 允许，只代表 Claude 可以“提出要运行一个 cell”；真正让它执行的，是 VS Code 里的 Quick Pick。
常见问题怎么排查
扩展装不上
- 确认 VS Code 版本兼容（1.98.0 或更高）
- 检查 VS Code 是否有安装扩展的权限
- 尝试从 VS Code Marketplace 直接安装
Spark 图标不显示怎么解决
Spark 图标会在有文件打开时显示在 Editor Toolbar（编辑器右上角）。如果你看不到它：
- 先打开一个文件：必须有文件打开，只有文件夹不够
- 检查 VS Code 版本：需要 1.98.0 或更高（Help → About）
- 重载窗口：在命令面板里运行 Developer: Reload Window
- 禁用冲突扩展：临时关闭其他 AI 扩展（Cline、Continue 等）
- 检查 workspace trust：Restricted Mode 下扩展不会工作
另外，你也可以点击右下角状态栏里的 ✱ Claude Code。这个入口即使没有打开文件也始终可用。或者直接用命令面板（Cmd+Shift+P / Ctrl+Shift+P）启动。
macOS 上 Cmd+Esc 没反应怎么解决
在 macOS Tahoe 及之后版本里，系统默认把 Cmd+Esc 绑定给 Game Overlay，系统会在 VS Code 之前拦截这个按键。要释放这个快捷键：
- 打开 System Settings
- 进入 Keyboard，再进入 Keyboard Shortcuts，再进入 Game Controllers
- 取消勾选 Game Overlay
也可以把扩展改绑到别的按键：打开 VS Code Keyboard Shortcuts editor（Cmd+K Cmd+S），搜索 Claude Code: Focus input，然后重新指定快捷键。
Claude Code 一直不响应怎么排查
如果 Claude Code 不响应你的提示：
- 检查网络连接是否稳定
- 新建一个对话试试，确认问题是不是只出现在当前会话
- 在终端运行
claude，看是否能得到更详细的错误信息
如果还是有问题，可以到 GitHub 提交 issue，并附上错误细节。
卸载扩展
卸载 Claude Code 扩展：
- 打开扩展视图（Mac 用
Cmd+Shift+X，Windows/Linux 用Ctrl+Shift+X） - 搜索
Claude Code - 点击 Uninstall
如果还要删除扩展数据并重置全部设置：
rm -rf ~/.vscode/globalStorage/anthropic.claude-code需要更多帮助时，见 troubleshooting guide。
下一步
在 VS Code 中把 Claude Code 配好之后，可以继续看：
- Common workflows，了解常见开发场景
- MCP，把外部工具接入 Claude
- Settings，自定义允许命令、钩子等配置
常见问题
Claude Code VS Code 扩展怎么安装？
在 VS Code 扩展视图里搜索 Claude Code，点击 Install 就能安装。你也可以直接点官方安装链接，或从 Open VSX registry 安装。安装前需要 VS Code 1.98.0 或更高版本，并登录 Anthropic 账户。
为什么 VS Code 里看不到 Spark 图标？
先确认已经打开了一个文件；只有文件夹不够。再检查 VS Code 是否至少是 1.98.0，必要时执行 Developer: Reload Window。如果仍然看不到，可以临时关闭其他 AI 扩展，或直接从右下角状态栏的 ✱ Claude Code 打开。
Claude Code VS Code 扩展和 CLI 有什么区别？
扩展提供图形界面、内联 diff、会话历史和多标签页；CLI 则保留全部命令、! Bash 快捷方式和 Tab 补全。两者共享会话历史，也都能读取同一套 Claude Code 设置。