Claude Code 与任何具有终端的集成开发环境 (IDE) 都能很好地配合使用。只需运行 claude，您就可以开始使用了。

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

  • Visual Studio Code（包括 Cursor、Windsurf 和 VSCodium 等流行分支）
  • JetBrains IDE（包括 IntelliJ、PyCharm、Android Studio、WebStorm、PhpStorm 和 GoLand）

​
功能

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

​
安装

要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安装 Claude Code：

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

​
使用方法

​
从您的 IDE

从您的 IDE 集成终端运行 claude，所有功能都将激活。

​
从外部终端

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

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

​
配置

IDE 集成与 Claude Code 的配置系统配合使用：

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

​
JetBrains 插件设置

您可以通过转到 设置 → 工具 → Claude Code [Beta] 来配置 Claude Code 插件设置。以下是可用的设置：

​
常规设置

  • Claude 命令：指定点击 Claude 图标时运行 Claude 的自定义命令（例如，claude、/usr/local/bin/claude 或 npx @anthropic/claude）
  • 抑制 Claude 命令未找到的通知：跳过关于未找到 Claude 命令的通知
  • 启用使用 Option+Enter 进行多行提示（仅限 macOS）：启用时，Option+Enter 在 Claude Code 提示中插入新行。如果您遇到 Option 键被意外捕获的问题，请禁用此功能（需要重启终端）
  • 启用自动更新：自动检查并安装插件更新（重启时应用）

对于 WSL 用户：您可能会发现将 wsl -d Ubuntu -- bash -lic "claude" 设置为您的 Claude 命令很有用（将 Ubuntu 替换为您的 WSL 发行版名称）

​
ESC 键配置

如果 ESC 键无法中断 JetBrains 终端中的 Claude Code 操作：

  1. 转到设置 → 工具 → 终端
  2. 执行以下任一操作：
    • 取消选中”使用 Escape 将焦点移动到编辑器”，或
    • 点击”配置终端键绑定”并删除”切换焦点到编辑器”快捷键
  3. 应用更改

这允许 ESC 键正确中断 Claude Code 操作。

​
故障排除

​
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 是否有安装扩展的权限

​
JetBrains 插件无法工作

  • 确保您从项目根目录运行 Claude Code
  • 检查 JetBrains 插件是否在 IDE 设置中启用
  • 完全重启 IDE。您可能需要多次执行此操作
  • 对于 JetBrains 远程开发，确保 Claude Code 插件安装在远程主机中，而不是本地客户端上

如果您使用 WSL 或 WSL2 且未检测到 IDE，请参阅我们的 WSL2 故障排除指南，了解网络配置和防火墙设置。

如需更多帮助，请参阅我们的故障排除指南。

​
安全性

当 Claude Code 在启用自动编辑权限的 IDE 中运行时，它可能能够修改可由您的 IDE 自动执行的 IDE 配置文件。这可能会增加在自动编辑模式下运行 Claude Code 的风险，并允许绕过 Claude Code 对 bash 执行的权限提示。在 IDE 中运行时，请考虑启用 IDE 安全功能（如 VS Code 受限模式），对编辑使用手动批准模式，或格外小心确保 Claude 仅用于受信任的提示。