教程

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 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 MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18教程Claude Code 输出格式控制完全指南:JSON、流式、结构化输出使用方法Claude Code 和 Claude API 输出格式完整控制指南:--output-format 参数(text/json/stream-json)、非交互模式(-p)的输出控制、结构化 JSON 输出(--json-schema 字段约束)、流式输出(Server-Sent Events)的处理方式、include-partial-messages 流式渐进显示、以及 CI/CD 管道中解析 JSON 输出的实用技巧。2026/3/18教程Claude Code 项目初始化最佳实践:新项目 5 分钟搭建完美 AI 编程环境Claude Code 新项目最佳初始化流程:CLAUDE.md 标准模板(项目背景/技术栈/代码规范/禁止操作)、.claudeignore 初始配置、.claude/commands/ 常用命令预置、settings.json 权限与模型设置、--init 命令的自动化初始化、项目级 vs 全局配置的优先级说明,以及不同类型项目(Web前端/后端API/全栈/开源库)的专项初始化模板。2026/3/18教程Claude Code 权限管理完全指南:精确控制 AI 能执行哪些操作Claude Code 权限系统完整解析:四种权限模式(default/acceptEdits/bypassPermissions/plan)、--allowedTools 和 --disallowedTools 精确工具控制、Bash 命令白名单语法(通配符匹配)、settings.json 持久化权限配置、CLAUDE.md 中的权限规则声明、CI/CD 自动化场景的权限配置、以及如何在效率和安全之间找到平衡点。2026/3/18教程Claude Code 自定义斜杠命令完全指南:用 /命令 封装常用工作流Claude Code 自定义斜杠命令(slash commands)完整教程:命令文件创建位置(.claude/commands/)、Markdown 格式规范、$ARGUMENTS 参数传递、项目级命令 vs 用户全局命令的区别、实用命令示例(/review、/test、/deploy-check、/refactor、/standup)、命令组合调用,以及如何在团队中共享和版本管理自定义命令。2026/3/18