教程

Claude Code VS Code 扩展完全指南:安装、核心功能与高效使用技巧

Claude Code VS Code 扩展完整指南:安装方法与登录配置、界面布局定制、@ 文件引用技巧、三种权限模式(正常/Plan/自动接受)、对话历史管理、多 Session 并行、检查点回退、Chrome 浏览器连接、快捷键速查表与 VS Code 扩展 vs CLI 功能对比。

2026/3/135分钟 阅读ClaudeEagle

Claude Code 不只是命令行工具——VS Code 扩展提供了图形化界面、内联 Diff 审查、对话历史、多 Session 并行等功能,让你在熟悉的编辑器里享受完整的 AI 编程体验。

安装

系统要求:VS Code 1.98.0 或以上

方式一:直接点击安装链接:

方式二:扩展商店搜索:

  1. Cmd+Shift+X(Mac)/ Ctrl+Shift+X(Windows/Linux)打开扩展面板
  2. 搜索 "Claude Code"
  3. 点击安装

安装后首次打开会提示登录,支持:

  • Claude Pro / Max / Teams / Enterprise 订阅
  • Anthropic Console(API Key 直连)
  • AWS Bedrock / Google Vertex AI / Azure AI

界面布局

默认 Claude 面板在右侧 Secondary Sidebar。可以拖拽到任意位置:

位置适合场景
右侧边栏(默认)编码时保持 Claude 可见
左侧边栏习惯把工具放左边
编辑器标签页需要更大对话区域

核心功能详解

1. @ 引用文件和代码

在提示框里输入 @ 后跟文件名,Claude 会自动读取该文件:

解释 @auth.ts 里的认证逻辑 @src/components/ 这个目录下有哪些组件? 对比 @UserService.ts 和 @AdminService.ts 的权限控制方式有什么区别

实用技巧:支持模糊匹配,输入 @auth 会匹配 auth.jsAuthService.ts 等。

选中代码自动提供上下文:在编辑器里选中代码,Claude 会自动看到你选中的内容(提示框底部显示选中行数)。按 Option+K(Mac)/ Alt+K 可插入带行号的 @ 引用。

2. 权限模式切换

点击提示框底部的模式指示器切换:

模式行为适用场景
正常模式(默认)每次改动前询问确认日常使用,保持控制
Plan Mode先展示计划,确认后再执行复杂任务,需要审查方案
自动接受直接执行不询问信任度高的任务,追求速度

Plan Mode 特别之处:VS Code 会把 Claude 的计划自动在编辑器里打开为 Markdown 文档,你可以直接在文档里加注释、修改计划,然后让 Claude 按修改后的方案执行。

3. 对话历史

点击面板顶部下拉菜单查看历史对话,支持:

  • 按关键词搜索
  • 按时间浏览(今天 / 昨天 / 最近 7 天)
  • 重命名对话(悬停出现操作按钮)
  • 恢复任意历史对话继续

4. 多 Session 并行

打开命令面板(Cmd+Shift+P),搜索 "Claude Code":

  • Open in New TabCmd+Shift+Esc):在新标签页开一个对话
  • Open in New Window:在新窗口开对话

每个 Session 独立历史和上下文,可以同时进行多个任务:

  • 一个 Session 写功能
  • 另一个 Session 修复 Bug
  • 第三个 Session 做代码审查

状态指示:标签页上的小圆点表示状态——蓝色代表等待你确认权限,橙色代表 Claude 完成了但标签页不在焦点。

5. 检查点(Checkpoints)与回退

VS Code 扩展支持检查点——Claude 每次改动前自动保存状态。

悬停到任意消息,显示回退按钮,三种选项:

  • 从这里分叉对话:保留代码改动,从这个消息开始新对话分支
  • 回退代码到这里:把文件改动退回到这个时间点,保留对话历史
  • 分叉对话并回退代码:两者都做,完全重新来过

出现方向错误时无需担心,随时可以回退。

6. 连接 Chrome 浏览器

安装 Claude in Chrome 扩展(v1.0.36 以上)后,可以让 Claude 直接操作浏览器:

@browser 打开 localhost:3000,检查控制台有没有报错 @browser 在登录页面填写测试账号并提交,看看有什么问题

适合前端开发调试、自动化测试场景。

快捷键速查

快捷键功能
Cmd+Esc / Ctrl+Esc切换焦点:编辑器 ↔ Claude 提示框
Cmd+Shift+Esc / Ctrl+Shift+Esc在新标签页打开对话
Cmd+N / Ctrl+N(Claude 获焦时)开始新对话
Option+K / Alt+K(编辑器获焦时)插入当前文件选中行的 @ 引用
Shift+Enter多行输入(不发送)
/打开命令菜单

常用命令

在提示框里输入 / 打开命令菜单:

/usage # 查看上下文用量 /compact # 手动压缩上下文 /model # 切换模型 /clear # 清空对话 /plugins # 管理插件 /memory # 查看和编辑 Auto Memory

插件管理

输入 /plugins 打开插件管理界面,支持:

  • 安装/卸载插件
  • 按作用域安装(全局 / 项目 / 本地仓库)
  • 添加自定义插件市场(GitHub 仓库、URL 或本地路径)

VS Code 扩展 vs 命令行

功能VS Code 扩展命令行
图形化 Diff 审查
内联对话历史有限
检查点回退
多 Session 并行✅ 多标签/窗口需多个终端
! 直接执行 bash
Tab 自动补全命令
完整 MCP 服务器配置部分完整

推荐:日常开发用 VS Code 扩展;需要管道集成、脚本自动化时切换到集成终端里跑 CLI。


来源:Use Claude Code in VS Code | Anthropic 官方文档

相关文章推荐

教程Claude Code 平台选择指南:CLI、Desktop、VS Code、网页版、手机端,哪个最适合你Claude Code 平台选择完整指南:CLI、Desktop、VS Code、JetBrains、网页版、手机 App 全面对比,含各平台独有能力、远程控制选项、集成方案和选择建议流程图。2026/4/12教程Claude Code VS Code 插件使用指南:安装、@ 文件引用、内联 diff 和多会话并行Claude Code VS Code 插件完整指南:安装配置、@ 引用精确代码行、内联 diff 审阅、多会话标签页并行、Plan 模式文档预览,及与 CLI 的功能对比表。2026/4/10教程Claude Code VS Code 插件完整指南:@-mentions、多会话、Checkpoint 回滚与 CLI 对比Claude Code VS Code 插件完整指南:安装方法(直接链接/Extensions 搜索/Cursor 支持)、四种打开面板方式(编辑器工具栏/Activity Bar/命令面板/状态栏)、@-mentions 文件引用(模糊匹配/目录/PDF 指定页/拖拽附件)、三种权限模式(Ask/Plan 自动 Markdown 文档/Auto-accept)、提示框命令菜单(/usage/MCP/扩展思考)、多会话管理(标签页/侧边栏)、远程会话续接(Local/Remote 两标签)、Checkpoint 回滚、Chrome 浏览器自动化、VS Code 插件 vs CLI 功能对比表,以及四大常见问题解决。2026/3/8教程Claude Code Skills 进阶:动态上下文注入、路径限定激活和 Subagent 集成深度指南Claude Code Skills 三个高级特性深度指南:动态上下文注入(!! 命令预处理原理、内联和多行语法、实战健康检查 Skill 含 6 个命令块、安全注意事项);路径限定自动激活(TypeScript 严格模式/SQL 安全/React 组件三个实战示例);context: fork 在 Subagent 运行(适用场景判断、agent 类型选择);以及三种特性组合的完整 PR 审查 Skill 示例。2026/5/10教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10教程Claude Code Slack 集成完整指南:团队协作、CI 通知和权限管理Claude Code Slack 集成完整指南:5 大核心功能(频道触发任务/代码问答/CI 通知/PR 审查/Routines 结果推送);安装配置步骤;4 个权限等级(read/write/execute/pr)及频道级配置;人工审批工作流;GitHub Actions + Slack 通知自动化;4 个团队协作场景(新人上手/PM 提需求/频道分工规范/结构化请求模板);以及官方 Slack 集成 vs OpenClaw 方案的对比。2026/5/8