是什么
Claude Code VS Code 扩展提供原生图形界面,直接集成到编辑器中。支持 VS Code、Cursor、Windsurf、Kiro 等 VS Code 分支,以及 Open VSX 注册表中的其他编辑器。扩展与 CLI 共享会话历史和配置,可以互相切换。
核心机制
核心功能:
- 侧边栏或标签页中的对话面板
- 文件编辑时的 side-by-side diff 审查(可直接编辑提案内容)
@引用文件和目录(支持模糊匹配和行范围)- 自动感知当前选中代码(
Option+K/Alt+K插入 @-mention) - 计划模式:Claude 提出方案后等待确认,自动打开 Markdown 文档供审查
- 多会话并行(每个标签独立上下文)
权限模式切换:点击提示框底部的模式指示器,支持 Ask/Plan/Auto accept/Auto/Bypass。
插件管理:/plugins 打开图形化插件管理界面,支持用户级、项目级或本地作用域安装。
Remote Control:/remote-control 启动,提示框上方显示连接状态横幅。
恢复远程会话:Session history → Remote 标签,可恢复 claude.ai 上的云端会话(需 claude.ai 订阅登录)。
内置 IDE MCP 服务器:扩展运行本地 MCP 服务器(名为 ide),提供两个工具:
mcp__ide__getDiagnostics:获取语言服务器诊断(Problems 面板的错误和警告)mcp__ide__executeCode:在 Jupyter notebook 中执行 Python 代码(每次都需要确认)
关键细节
常用快捷键:
| 快捷键 | 功能 |
|---|---|
Cmd+Esc / Ctrl+Esc | 切换编辑器和 Claude 焦点 |
Cmd+Shift+Esc / Ctrl+Shift+Esc | 在新标签页打开 Claude |
Option+K / Alt+K | 插入当前文件和选中行的 @-mention |
Cmd+Shift+T / Ctrl+Shift+T | 重新打开最近关闭的 Claude 会话 |
- 需要 VS Code 1.98.0+
- 第三方提供商(Bedrock/Vertex):勾选「Disable Login Prompt」,通过环境变量配置
- macOS Tahoe 上
Cmd+Esc可能被系统 Game Overlay 拦截,需在系统设置中关闭
关联
- jetbrains — JetBrains IDE 插件
- platforms-overview — 各平台对比
- remote-control — 远程控制本地会话
- chrome-extension — 浏览器自动化(VS Code 中用
@browser)
实践要点
- 选中代码后直接提问,Claude 自动感知选中内容
- 用
@terminal:name引用终端输出,无需复制粘贴 - 扩展和 CLI 共享历史,可以用
claude --resume在终端继续扩展中的对话 - 在 VS Code 集成终端运行
claude可以使用 CLI 专属功能(如!bash 快捷方式) - 用
vscode://anthropic.claude-code/open?prompt=review%20my%20changes从外部工具打开 Claude