在你的 IDE 中添加 Claude Code

了解如何将 Claude Code 添加到你喜欢的集成开发环境（IDE）中

Claude Code 适用于任何带有终端的集成开发环境。只需运行 claude，即可开始使用。

此外，Claude Code 还为流行的 IDE 提供了专用集成，带来如交互式差异查看、选区上下文共享等功能。目前支持以下 IDE：

• • Visual Studio Code（包括 Cursor、Windsurf 和 VSCodium 等流行分支）

功能

• • 快速启动：使用 Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）可直接从编辑器打开 Claude Code，或点击界面中的 Claude Code 按钮
• • 差异查看：代码更改可直接在 IDE 的差异查看器中显示，而不是在终端。你可以在 /config 中进行配置
• • 选区上下文：IDE 当前的选区/标签会自动与 Claude Code 共享
• • 文件引用快捷键：使用 Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用（如 @File#L1-99）
• • 诊断信息共享：IDE 的诊断错误（如 lint、语法等）会在你工作时自动与 Claude 共享

安装

VS Code 及其分支

在 VS Code 及其分支（如 Cursor、Windsurf、VSCodium）中安装 Claude Code：

1. 1. 打开 VS Code
2. 2. 打开集成终端
3. 3. 运行 claude —— 扩展会自动安装

使用方法

在 IDE 内

在 IDE 的集成终端运行 claude，所有功能即可激活。

在外部终端

在任何外部终端使用 /ide 命令，将 Claude Code 连接到你的 IDE 并激活所有功能。

如果希望 Claude 能访问与你 IDE 相同的文件，请从 IDE 项目根目录启动 Claude Code。

配置

IDE 集成支持 Claude Code 的配置系统：

1. 1. 运行 claude
2. 2. 输入 /config 命令
3. 3. 调整你的偏好。将差异工具设置为 auto 可启用自动 IDE 检测

故障排查

VS Code 扩展未安装

• • 确保你是在 VS Code 的集成终端中运行 Claude Code
• • 确保你的 IDE 对应的 CLI 已安装：

• • VS Code：需有 code 命令
• • Cursor：需有 cursor 命令
• • Windsurf：需有 windsurf 命令
• • VSCodium：需有 codium 命令
• • 如未安装，可用 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux）搜索”Shell Command: Install ‘code’ command in PATH”（或对应 IDE 的命令）

• • 检查 VS Code 是否有权限安装扩展

如需更多帮助，请参阅故障排查指南。