JetBrains IDEs 集成

Claude Code 通过专用插件与 JetBrains IDE 深度集成，提供交互式 Diff 查看、选中内容上下文共享等功能。

支持的 IDE

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

核心功能

功能	说明
快速启动	Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code
Diff 查看	代码变更直接在 IDE 的 Diff 查看器中显示，而非终端
选中内容上下文	当前选中内容和活动标签页自动共享给 Claude Code
文件引用快捷键	Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用（如 @File#L1-99）
诊断信息共享	IDE 的诊断错误（lint、语法错误等）在工作时自动共享给 Claude

安装

通过 JetBrains 市场安装

1. 在 JetBrains 插件市场搜索安装 Claude Code 插件
2. 重启 IDE

如果还没有安装 Claude Code CLI，请先参考 快速开始 安装。

安装插件后可能需要完全重启 IDE（有时需要重启多次）才能生效。

使用方式

在 IDE 集成终端中使用

在 IDE 的集成终端运行 claude，所有集成功能会自动激活。

在外部终端中连接

在任意外部终端中，使用 /ide 命令连接到 JetBrains IDE：

claude

然后在 Claude Code 中输入：

/ide

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

配置

Claude Code 设置

1. 运行 claude
2. 输入 /config 命令
3. 将 diff 工具设置为 auto（自动检测 IDE）

插件设置

进入 Settings → Tools → Claude Code [Beta]：

通用设置：

设置项	说明
Claude command	指定 Claude 的运行命令（如 claude、/usr/local/bin/claude 或 npx @anthropic/claude）
抑制"命令未找到"通知	跳过找不到 Claude 命令时的通知
启用 Option+Enter 多行输入（仅 macOS）	开启后 Option+Enter 在提示框插入换行符
启用自动更新	自动检查并安装插件更新（重启后生效）

WSL 用户：将 Claude 命令设置为 wsl -d Ubuntu -- bash -lic "claude"（将 Ubuntu 替换为你的 WSL 发行版名称）

ESC 键配置

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

1. 进入 Settings → Tools → Terminal
2. 取消勾选 "Move focus to the editor with Escape"，或
3. 点击 "Configure terminal keybindings" 删除 "Switch focus to Editor" 快捷键

特殊配置

远程开发

重要：使用 JetBrains Remote Development 时，必须在远程主机中安装插件（Settings → Plugin (Host)），而不是本地客户端。

WSL 配置

WSL 用户可能需要额外配置才能正确检测 IDE：

• 正确的终端配置
• 网络模式调整
• 防火墙设置更新

详见 WSL 故障排查指南。

故障排查

插件不工作

• 确认从项目根目录运行 Claude Code
• 检查 IDE 设置中是否启用了 JetBrains 插件
• 完全重启 IDE（可能需要多次）
• 远程开发用户：确认插件安装在远程主机而非本地

IDE 未被检测到

• 验证插件已安装并启用
• 完全重启 IDE
• 确认从集成终端运行 Claude Code
• WSL 用户：参见 WSL 故障排查指南

点击 Claude 图标显示"命令未找到"

1. 验证 Claude Code 已安装：npm list -g @anthropic-ai/claude-code
2. 在插件设置中配置 Claude 命令路径
3. WSL 用户：使用上述 WSL 命令格式

安全注意事项

在启用自动编辑权限的 JetBrains IDE 中运行时，Claude Code 可能修改 IDE 配置文件，这些文件会被 IDE 自动执行。这可能增加在自动编辑模式下运行的风险，并可能绕过 Claude Code 的 Bash 执行权限提示。

在 JetBrains IDE 中使用时，建议：

• 使用手动审批模式进行编辑
• 确保只使用可信的提示词
• 了解 Claude Code 有权限修改哪些文件

相关资源

• VS Code 集成：VS Code 和 Cursor 扩展
• 故障排查：常见问题解决方案
• 快速开始：CLI 安装和配置