Claude Code 不只是命令行工具——VS Code 扩展提供了图形化界面、内联 Diff 审查、对话历史、多 Session 并行等功能,让你在熟悉的编辑器里享受完整的 AI 编程体验。
安装
系统要求:VS Code 1.98.0 或以上
方式一:直接点击安装链接:
方式二:扩展商店搜索:
Cmd+Shift+X(Mac)/Ctrl+Shift+X(Windows/Linux)打开扩展面板- 搜索 "Claude Code"
- 点击安装
安装后首次打开会提示登录,支持:
- 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.js、AuthService.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 Tab(
Cmd+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 官方文档