在 VS Code 里用 Claude Code

这篇适合谁

适合在 VS Code 里写代码、希望把 Claude Code 放在编辑器里用、而不是另开终端的人。读完你能安装扩展，打开对话，把选中的代码发给 Claude，逐处审阅它的改动，续接之前的会话，并处理最常见的安装问题。

扩展是什么

VS Code 扩展为 Claude Code 提供了编辑器内的图形界面，官方文档也推荐以这种方式在 VS Code 里使用 Claude Code^[1]。它的主要功能包括：在接受前查看并修改 Claude 的计划，自动接受已完成的编辑，用 @ 引用指定行范围的文件，保留对话历史，以及在多个标签页或窗口里同时开多个对话^[1]。

扩展还在聊天面板里内置了一份 CLI。如果想在 VS Code 的集成终端里直接输入 claude，还需要单独安装独立版的 CLI^[1]。

准备

需要 VS Code 1.94.0 或更高版本^[1]。还需要一个 Anthropic 账号：Pro、Max、Ultra、Team、Enterprise 等任何付费 Claude 订阅都可以，Claude Console 账号也可以，不需要 API 密钥^[1]。

扩展的版本号就是它内置的 Claude Code 版本。如果某个功能需要 Claude Code v2.1.286，就要装 2.1.286 或更高版本的扩展，扩展视图里能看到版本号^[1]。

第一步：安装

按 Mac 上的 Cmd+Shift+X 或 Windows、Linux 上的 Ctrl+Shift+X 打开扩展视图，搜索 "Claude Code"，点击 Install^[1]。

第二步：打开面板并登录

最快的方式是点击编辑器右上角 Editor Toolbar 里的 Spark 图标。这个图标只有在打开了文件时才会出现。也可以点击左侧 Activity Bar 里的 Spark 图标，或者用命令面板选择 "Open in New Tab" 之类的选项。状态栏里的 ✻ Claude Code 即使没有打开文件也能用^[1]。

第一次打开面板时会出现登录界面。点击 Sign in，在浏览器里完成授权即可^[1]。如果你的 shell 里设置了 ANTHROPIC_API_KEY，但仍然看到登录提示，多半是 VS Code 没有继承 shell 的环境变量。这时从终端运行 code . 启动 VS Code，就能读到这些变量^[1]。

第三步：带着选中的代码提问

Claude 会自动看到你选中的文本。在 Mac 上按 Option+K，在 Windows 和 Linux 上按 Alt+K，还能把 @file.ts#5-10 这样的引用插入提示词^[1]。

第四步：审阅改动

先看提示框底部显示的权限模式。Manual 模式下，Claude 在每次编辑前都会请求许可。它会并排显示修改前和修改后的版本，你可以接受、拒绝，或者告诉它换一种做法^[1]。

想逐处审阅，就点每处改动下面的 Accept this change 或 Reject this change。接受或拒绝整个文件同样会结束审阅。改动超过 100 处的 diff 会不带逐处按钮打开，这种情况应当整个文件一起审阅^[1]。

权限模式可以是 Auto、Manual、Plan 或 Edit automatically。Auto 模式下，分类器会替你审查大部分操作，而不是每次都来问你^[1]。Plan 模式下，Claude 先说明打算怎么做，等你批准再动手。VS Code 会把计划打开为 Markdown 文档，你可以在上面加行内批注；/plan 需要 Claude Code v2.1.280 或更高版本^[1]。

会话中途换模型，可以在命令菜单里选 Switch model…，也可以点击提示框底部的模型名称^[1]。

逐处审阅最适合改动较多的回复：可以留下满意的部分，拒绝其余部分，不必整体接受或放弃。改动超过 100 处时，逐处按钮会消失，这时应当把整个文件作为一个整体来审阅。Manual 模式适合刚接触陌生代码库的时候；熟悉之后切换到 Auto，能减少打断，但提交前仍要自己看一遍结果。

找回和续接会话

面板顶部的 Session history 按钮可以按关键词搜索过去的对话，也可以按时间浏览。点击某个对话即可续接^[1]。新会话会自动生成标题。连续 14 天没有活动的会话会被自动移入 Archived sessions，已打开、未读或在分组中的会话除外，archiveInactiveSessions 设置可以控制这个行为^[1]。

调整布局

面板可以拖到右侧的 secondary sidebar、左侧的 primary sidebar 或编辑区。preferredLocation 设置接受 sidebar 或 panel^[1]。lockEditorGroups 默认为 true，会锁定 Claude 为标签页开辟的编辑器分组；此时你在 Claude 标签页获得焦点时打开的文件，会进入另一个分组。不希望这样的话，关闭该设置即可^[1]。

Mac 上按 Cmd+Esc、Windows 和 Linux 上按 Ctrl+Esc，可以在编辑器和 Claude 之间切换焦点。Cmd+Shift+Esc 或 Ctrl+Shift+Esc 会以编辑器标签页的形式新开一个对话^[1]。

放在侧边栏适合一边读代码、一边和 Claude 对话；放在编辑区则适合临时处理一件旁支任务，它和你正在编辑的文件并排显示。

设置在哪里

扩展设置通过 Cmd+, 或 Ctrl+, 打开，然后进入 Extensions > Claude Code。Claude Code 的设置文件 ~/.claude/settings.json 由扩展和 CLI 共用^[1]。

使用云服务商

要使用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry，需要打开 Disable Login Prompt 设置，即 claudeCode.disableLoginPrompt，并在 ~/.claude/settings.json 中配置对应的服务商。这种情况下，需要 claude.ai 账号的功能将不可用^[1]。

因为设置文件是共用的，扩展和 CLI 读取的是同一份服务商配置，不必维护两份^[1]。

在面板里管理 MCP 服务器

MCP 服务器让 Claude 能访问外部工具、数据库和 API。在面板里管理它们，可以不离开编辑器。

在聊天面板中输入 /mcp，可以添加或删除 MCP 服务器，启用或停用它们，重新连接，并管理 OAuth 认证。在对话框里添加和删除服务器需要 Claude Code v2.1.261 或更高版本^[1]。

常见问题

如果看不到 Spark 图标，先检查是否打开了文件、VS Code 是否为 1.94.0 或更高版本，并用 Developer: Reload Window 重新加载窗口。扩展在受限模式（Restricted Mode）下也无法工作，所以工作区必须是受信任的^[1]。

macOS Tahoe 及更高版本默认把 Cmd+Esc 绑定给系统的 Game Overlay 快捷键，它可能在 VS Code 收到按键之前就拦截了。可以在系统设置里取消 Game Overlay 的勾选，或者把扩展的快捷键改绑到其他键上^[1]。

如果 Ctrl+J 在提示框里插入了换行，可以在 keybindings.json 里取消这个绑定：

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+j": null
      }
    }
  ]
}

下一步

官方页面列出了完整的命令、快捷键和设置，遇到版本要求相关的问题时以它为准^[1]。