Claude Code VS Code 插件为 VS Code 和 Cursor 提供原生图形界面，支持内联 Diff 审查、@-mentions 文件引用、多会话、Plan 模式和 Checkpoint 回滚等功能。
安装插件
前提条件：VS Code 1.98.0 或更高版本
方式一（直接链接）：
方式二（Extensions 视图）：按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows/Linux），搜索「Claude Code」，点击安装。
安装后若不显示，重启 VS Code 或从命令面板运行「Developer: Reload Window」。
插件内置 CLI，无需单独安装 Node.js。
打开 Claude Code 面板（4 种方式）
| 方式 | 操作 |
|---|---|
| 编辑器工具栏（最快） | 打开文件后，点击右上角 Spark 图标（仅有文件打开时显示） |
| Activity Bar | 左侧边栏 Spark 图标，始终可见；打开会话列表 |
| 命令面板 | Cmd/Ctrl+Shift+P → 输入「Claude Code」→ 选择「Open in New Tab」 |
| 状态栏 | 窗口右下角「✱ Claude Code」，即使无文件打开也可点击 |
发送提示词
Claude 自动看到你的选中文本。按 Option+K（Mac）/ Alt+K（Win/Linux）在提示词中插入 @-mention 引用（格式如 @file.ts#5-10）。
审查修改：Claude 修改文件时显示并排对比（原始 vs 提议），可接受、拒绝或追加说明。
@-mentions 文件引用
> Explain the logic in @auth # 模糊匹配 auth.js、AuthService.ts 等
> What's in @src/components/ # 引用目录（末尾加斜杠）
> Explain @report.pdf page 3-10 # 大 PDF 只读指定页范围
- 选中文本：Claude 自动可见；提示框底部显示已选行数。点击眼睛图标可隐藏选中内容
- 拖拽文件：按住
Shift拖拽文件到提示框作为附件
权限模式
| 模式 | 说明 |
|---|---|
| Ask permissions（默认） | 每次操作前询问，可接受/拒绝/修改 |
| Plan mode | Claude 描述计划，自动在 VS Code 中打开 Markdown 文档供注释，批准后才开始执行 |
| Auto-accept | 自动接受文件编辑，迭代更快 |
点击提示框底部模式指示器切换；默认模式在 VS Code 设置 claudeCode.initialPermissionMode 中配置。
提示框命令菜单（/）
| 功能 | 说明 |
|---|---|
| 附加文件 | 添加文件到上下文 |
| 切换模型 | 选择不同的 Claude 模型 |
| 扩展思考 | 启用复杂问题的深度推理模式 |
| /usage | 查看 Plan 用量 |
| 自定义 | 访问 MCP 服务器、Hooks、Memory、Permissions、插件 |
多会话
- 编辑器标签页：从 Activity Bar 打开多个会话作为编辑器标签
- 侧边栏面板：拖动 Claude 面板到侧边栏并排显示
- 多个会话共享配置，但各自独立运行
续接对话
点击 Claude Code 面板顶部下拉菜单：
- 按关键词搜索或按时间（今天/昨天/7 天内）浏览
- 悬停会话显示重命名和删除操作
续接远程会话（claude.ai 网页会话）：
- 打开 Past Conversations 下拉
- 切换到 Remote 标签（需要 Claude.ai 订阅登录，不支持 Console 账号）
- 仅显示通过 GitHub 仓库启动的网页会话
- 点击下载并在本地继续（不同步回 claude.ai）
Checkpoint 回滚
VS Code 插件支持 Checkpoint——在会话中任意点回退到之前的文件状态：
- 每次 Claude 修改文件前自动创建 Checkpoint
- 在对话历史中找到目标位置，点击「Rewind to here」
- 文件状态回滚到该点，对话历史保留
Chrome 浏览器自动化
通过 Claude Code Chrome 扩展（Beta），VS Code 插件可以控制浏览器：
- 抓取网页内容、截图、测试 UI
- 需要安装 Chrome 扩展并在 VS Code 中连接
VS Code 命令与快捷键
| 命令 | 操作 |
|---|---|
Option+K / Alt+K | 在提示词中插入 @-mention（选中文本时） |
Shift+Enter | 提示框多行输入（不发送） |
Cmd/Ctrl+Shift+P → Claude Code | 所有 Claude Code 命令 |
VS Code 插件 vs CLI 对比
| 功能 | VS Code 插件 | CLI |
|---|---|---|
| 内联 Diff 审查 | 是 | 否 |
| Plan 模式（Markdown 文档） | 是 | 否 |
| @-mentions（选中行范围） | 是 | 仅文件 |
| Checkpoint 回滚 | 是 | 是 |
| 多会话并排 | 是 | 需要多终端 |
| 终端输出加入提示词 | 是 | 否（不适用） |
| 后台进程监控 | 是 | 否 |
| 完整 CLI 选项（-p 等） | 需通过集成终端 | 是 |
在 VS Code 中使用 CLI：打开集成终端（Ctrl+`），直接运行 claude -p 等命令。CLI 和插件可以同时运行在同一项目上，共享配置文件（CLAUDE.md、MCP、Hooks、Settings）。
常见问题
| 问题 | 解决方案 |
|---|---|
| 插件无法安装 | 确认 VS Code ≥ 1.98.0；检查网络和代理设置 |
| Spark 图标不可见 | 需要先打开一个文件（编辑器工具栏图标仅有文件时显示） |
| Claude Code 无响应 | 检查登录状态；确认网络可访问 api.anthropic.com |
| 卸载插件 | Extensions 视图右键 → Uninstall；删除 ~/.claude 彻底清理 |
原文：Use Claude Code in VS Code - Claude Code Docs | 来源：Anthropic 官方文档