Skip to content

JetBrains IDEs

Claude Code 通过专用插件与 JetBrains IDE 集成,提供交互式差异查看、选择上下文共享等功能。

支持的 IDE

  • IntelliJ IDEA
  • PyCharm
  • Android Studio
  • WebStorm
  • PhpStorm
  • GoLand

功能

  • 快速启动:使用 Cmd+Esc(Mac)或 Ctrl+Esc(Windows/Linux)直接从编辑器打开 Claude Code
  • 差异查看:代码更改可以直接在 IDE 差异查看器中显示
  • 选择上下文:IDE 中的当前选择/标签页会自动与 Claude Code 共享
  • 文件引用快捷方式:使用 Cmd+Option+K(Mac)或 Alt+Ctrl+K(Linux/Windows)插入文件引用
  • 诊断共享:IDE 中的诊断错误在您工作时会自动与 Claude 共享

安装

市场安装

从 JetBrains 市场查找并安装 Claude Code 插件,然后重启您的 IDE。

自动安装

在集成终端中运行 claude 时,插件也可能会自动安装。

注意:安装插件后,您必须完全重启 IDE 才能生效。

使用

从您的 IDE

从 IDE 的集成终端运行 claude,所有集成功能都将处于活跃状态。

从外部终端

在任何外部终端中使用 /ide 命令将 Claude Code 连接到您的 JetBrains IDE:

bash
claude
> /ide

配置

Claude Code 设置

  1. 运行 claude
  2. 输入 /config 命令
  3. 将差异工具设置为 auto 以进行自动 IDE 检测

插件设置

转到 Settings → Tools → Claude Code [Beta]:

  • Claude 命令:指定自定义命令来运行 Claude
  • 启用自动更新:自动检查并安装插件更新

对于 WSL 用户:将 wsl -d Ubuntu -- bash -lic "claude" 设置为您的 Claude 命令。

ESC 键配置

如果 ESC 键不能中断 JetBrains 终端中的 Claude Code 操作:

  1. 转到 Settings → Tools → Terminal
  2. 取消选中"使用 Escape 将焦点移动到编辑器"
  3. 应用更改

特殊配置

远程开发

使用 JetBrains 远程开发时,您必须通过 Settings → Plugin (Host) 在远程主机上安装插件。

WSL 配置

WSL 用户可能需要额外配置才能使 IDE 检测正常工作。

故障排除

插件不工作

  • 确保您从项目根目录运行 Claude Code
  • 检查 JetBrains 插件在 IDE 设置中是否已启用
  • 完全重启 IDE

IDE 未检测到

  • 验证插件已安装并启用
  • 完全重启 IDE
  • 检查您是否从集成终端运行 Claude Code

命令未找到

  • 验证 Claude Code 已安装
  • 在插件设置中配置 Claude 命令路径

安全考虑

当 Claude Code 在 JetBrains IDE 中运行时,请考虑:

  • 对编辑使用手动批准模式
  • 特别小心确保 Claude 仅与受信任的提示一起使用

aicodex 文档网站