Claude Code通过专用插件与JetBrains IDE深度集成，提供交互式Diff查看、选区上下文自动共享、快速启动快捷键（Cmd+Esc/Ctrl+Esc）和IDE诊断信息同步。从JetBrains Marketplace安装Claude Code插件并重启IDE即可使用。本文涵盖插件安装、核心功能、设置项（Claude命令路径、多行输入、ESC键行为）、远程开发和WSL特殊配置，以及插件不工作、IDE未检测到等常见问题的解决方案。
Claude Code JetBrains IDE 集成指南：安装、配置与排查
支持的 IDE
Claude Code 插件支持以下 JetBrains IDE：
- IntelliJ IDEA
- PyCharm
- Android Studio
- WebStorm
- PhpStorm
- GoLand
功能
| 功能 | 说明 |
|---|---|
| 快速启动 | Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code，或点击 UI 中的 Claude Code 按钮 |
| Diff 查看 | 代码变更直接在 IDE 的 Diff 查看器中显示，而非终端 |
| 选区上下文 | 当前选中内容或活动标签页自动共享给 Claude Code。被 Read 拒绝规则 匹配的文件不会共享 |
| 文件引用快捷键 | Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用，例如 @src/auth.ts#L1-99 |
| 诊断信息共享 | IDE 中的 lint 错误、语法错误等诊断信息在工作时自动共享给 Claude |
安装
通过 Marketplace 安装
从 JetBrains Marketplace 找到并安装 Claude Code 插件，然后重启 IDE。
如果尚未安装 Claude Code CLI，请先参考快速入门指南完成安装。
安装插件后可能需要完全重启 IDE 才能生效。
使用方式
从 IDE 内使用
在 IDE 的集成终端中运行 claude，所有集成功能自动激活。
从外部终端使用
在任意外部终端中启动 Claude Code，然后输入 /ide 命令连接到 JetBrains IDE，激活所有功能：
claude然后输入：
/ide如果需要 Claude 访问与 IDE 相同的文件，请从 IDE 项目根目录启动 Claude Code。
配置
Claude Code 设置
通过 Claude Code 的设置配置 IDE 集成：
- 运行
claude - 输入
/config命令 - 将 diff 工具设置为
auto（在 IDE 中显示 diff），或terminal（在终端中显示 diff）
插件设置
进入 Settings → Tools → Claude Code [Beta]：
通用设置
| 设置项 | 说明 |
|---|---|
| Claude command | 指定运行 Claude 的命令，例如 claude、/usr/local/bin/claude 或 npx @anthropic-ai/claude-code |
| Suppress notification for Claude command not found | 跳过找不到 Claude 命令时的通知 |
| Enable using Option+Enter for multi-line prompts（仅 macOS） | 开启后 Option+Enter 在 Claude Code 提示框中插入换行符。如果 Option 键被意外捕获，禁用此选项（需要重启终端） |
| Enable automatic updates | 自动检查并安装插件更新（重启后生效） |
对于 WSL 用户：将
wsl -d Ubuntu -- bash -lic "claude"设置为 Claude 命令（将Ubuntu替换为你的 WSL 发行版名称）
ESC 键配置
如果 ESC 键无法中断 JetBrains 终端中的 Claude Code 操作：
- 进入 Settings → Tools → Terminal
- 二选一：
- 取消勾选 “Move focus to the editor with Escape”
- 或点击 “Configure terminal keybindings” 并删除 “Switch focus to Editor” 快捷键
- 应用更改
ESC 键就能正确中断 Claude Code 操作了。
特殊配置
远程开发
使用 JetBrains Remote Development 时，必须通过 Settings → Plugin (Host) 在远程主机上安装插件。
插件必须安装在远程主机上，而非本地客户端机器。
WSL 配置
如果在 WSL2 上使用 Claude Code，但 JetBrains IDE 显示 “No available IDEs detected”，通常原因是 WSL2 的 NAT 网络或 Windows 防火墙阻止了 WSL2 与 Windows 宿主机上运行的 IDE 之间的连接。WSL1 使用宿主机网络直连，不受影响。
两种解决方法：
方法一：通过 Windows 防火墙允许 WSL2 流量（推荐）
保留现有 WSL2 网络模式，无需修改。
- 在 WSL Shell 中运行
hostname -I，记下子网。例如172.21.123.45属于172.21.0.0/16。 - 以管理员身份打开 PowerShell，运行以下命令（将 IP 范围替换为你的子网）：
New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16- 关闭并重新打开 WSL 和 IDE 使新规则生效。
方法二：切换到 WSL2 镜像网络
需要 Windows 11 22H2 或更高版本。Windows 10 用户请使用方法一。
在 Windows 用户目录下的 .wslconfig 中添加：
[wsl2]
networkingMode=mirrored然后在 PowerShell 中运行 wsl --shutdown 重启 WSL。
故障排查
插件不工作
- 确保从项目根目录运行 Claude Code
- 检查 IDE 设置中 JetBrains 插件已启用
- 完全重启 IDE（可能需要多次）
- 远程开发用户：确认插件安装在远程主机
IDE 未被检测到
如果运行 claude 显示 “No available IDEs detected”：
- 验证插件已安装并启用
- 完全重启 IDE
- 确认从集成终端运行 Claude Code
- WSL 用户请参考上面的 WSL 配置
命令未找到
如果点击 Claude 图标显示 “command not found”：
- 在终端中运行
claude --version确认 Claude Code 已安装 - 在插件设置中配置 Claude 命令路径
- WSL 用户使用上面提到的 WSL 命令格式
安全注意事项
当 Claude Code 在启用自动编辑权限的 JetBrains IDE 中运行时，它可能修改 IDE 配置文件，这些文件能被 IDE 自动执行。这可能会增加在自动编辑模式下运行 Claude Code 的风险，并允许绕过 Claude Code 的 bash 执行权限提示。
在 JetBrains IDE 中运行时，建议：
- 对编辑操作使用手动审批模式
- 格外注意只对可信的提示使用 Claude
- 了解 Claude Code 有权修改哪些文件
有关 IDE 之外的 Claude Code 安装或登录问题，请参阅安装与登录故障排查。
常见问题
在 JetBrains 中 ESC 键无法中断 Claude Code 怎么解决？
进入 Settings → Tools → Terminal，取消勾选 “Move focus to the editor with Escape”，或删除 “Switch focus to Editor” 快捷键，然后应用更改即可。
WSL2 下 Claude Code 找不到 IDE 怎么办？
先确定网络模式：如果 WSL2 是 NAT 模式，在 PowerShell 中添加防火墙规则放行 WSL2 子网流量；如果 Windows 版本支持（11 22H2+），也可在 .wslconfig 中设置 networkingMode=mirrored 并重启 WSL。
JetBrains 插件和 VS Code 扩展的设置互通吗？
插件专属设置（如 Claude 命令路径、多行输入行为）是各自独立的。但两者都共享 Claude Code 底层的项目配置（CLAUDE.md、.claude/settings.json、MCP、Hooks、Skills），因此权限规则、模型选择等跨编辑器生效。