VS Code扩展（测试版）
VS Code扩展目前处于测试版，让您通过直接集成到IDE中的原生图形界面实时查看Claude的更改。VS Code扩展使喜欢可视化界面而非终端的用户更容易访问和与Claude Code交互。功能
VS Code扩展提供：- 原生IDE体验：通过Spark图标访问的专用Claude Code侧边栏面板
- 带编辑的计划模式：在接受之前审查和编辑Claude的计划
- 自动接受编辑模式：在Claude进行更改时自动应用
- 文件管理：@提及文件或使用系统文件选择器附加文件和图像
- MCP服务器使用：使用通过CLI配置的模型上下文协议服务器
- 对话历史：轻松访问过去的对话
- 多个会话：同时运行多个Claude Code会话
- 键盘快捷键：支持CLI中的大多数快捷键
- 斜杠命令：直接在扩展中访问大多数CLI斜杠命令
要求
- VS Code 1.98.0或更高版本
安装
从Visual Studio Code扩展市场下载并安装扩展。更新
要更新VS Code扩展：- 使用
Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux）打开VS Code命令面板 - 搜索”Claude Code: Update”
- 选择命令以更新到最新版本
工作原理
安装后，您可以通过VS Code界面开始使用Claude Code：- 点击编辑器侧边栏中的Spark图标打开Claude Code面板
- 以与在终端中相同的方式提示Claude Code
- 观看Claude分析您的代码并建议更改
- 直接在界面中审查和接受编辑
- 提示：将侧边栏拖宽以查看内联差异，然后点击它们展开查看完整详情
尚未实现
以下功能在VS Code扩展中尚不可用：- 完整的MCP服务器配置：您需要首先通过CLI配置MCP服务器，然后扩展将使用它们
- 子代理配置：通过CLI配置子代理以在VS Code中使用它们
- 检查点：在特定点保存和恢复对话状态
- 高级快捷键：
#快捷键添加到内存!快捷键直接运行bash命令
- Tab补全：使用tab键进行文件路径补全
安全考虑
当Claude Code在启用自动编辑权限的VS Code中运行时，它可能能够修改可被您的IDE自动执行的IDE配置文件。这可能会增加在自动编辑模式下运行Claude Code的风险，并允许绕过Claude Code对bash执行的权限提示。 在VS Code中运行时，请考虑：- 为不受信任的工作区启用VS Code限制模式
- 对编辑使用手动批准模式
- 格外小心确保Claude仅用于受信任的提示
传统CLI集成
我们发布的第一个VS Code集成允许在终端中运行的Claude Code与您的IDE交互。它提供选择上下文共享（当前选择/标签页自动与Claude Code共享）、在IDE而非终端中查看差异、文件引用快捷键（Mac上的Cmd+Option+K或Windows/Linux上的Alt+Ctrl+K插入文件引用如@File#L1-99）以及自动诊断共享（lint和语法错误）。
传统集成在您从VS Code的集成终端运行claude时自动安装。只需从终端运行claude，所有功能即可激活。对于外部终端，使用/ide命令将Claude Code连接到您的VS Code实例。要配置，运行claude，输入/config，并将差异工具设置为auto以进行自动IDE检测。
扩展和CLI集成都适用于Visual Studio Code、Cursor、Windsurf和VSCodium。
故障排除
扩展无法安装
- 确保您有兼容版本的VS Code（1.85.0或更高版本）
- 检查VS Code是否有安装扩展的权限
- 尝试直接从市场网站安装
传统集成无法工作
- 确保您从VS Code的集成终端运行Claude Code
- 确保您的IDE变体的CLI已安装：
- VS Code：
code命令应该可用 - Cursor：
cursor命令应该可用 - Windsurf：
windsurf命令应该可用 - VSCodium：
codium命令应该可用
- VS Code：
- 如果命令未安装：
- 使用
Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux）打开命令面板 - 搜索”Shell Command: Install ‘code’ command in PATH”（或您的IDE的等效命令）
- 使用