是什么

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 拦截,需在系统设置中关闭

关联

实践要点

  • 选中代码后直接提问,Claude 自动感知选中内容
  • 用 @terminal:name 引用终端输出,无需复制粘贴
  • 扩展和 CLI 共享历史,可以用 claude --resume 在终端继续扩展中的对话
  • 在 VS Code 集成终端运行 claude 可以使用 CLI 专属功能(如 ! bash 快捷方式)
  • 用 vscode://anthropic.claude-code/open?prompt=review%20my%20changes 从外部工具打开 Claude