JetBrains IDE 集成

Claude Code 与 JetBrains IDE 的集成插件，提供交互式 diff 查看、选中内容共享、诊断错误自动传递等功能。

核心机制

JetBrains 插件通过本地 MCP 服务器与 Claude Code CLI 通信。与 VS Code 扩展不同，JetBrains 集成主要增强 CLI 的 IDE 体验，而非提供独立的图形界面。

支持的 IDE

IntelliJ IDEA、PyCharm、Android Studio、WebStorm、PhpStorm、GoLand 等主流 JetBrains IDE。

核心功能

快速启动：Cmd+Esc（Mac）/ Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code
Diff 查看：代码变更在 IDE 内置 diff 查看器中展示（而非终端）
选中内容共享：当前选中内容或标签页自动共享给 Claude Code
文件引用快捷键：Cmd+Option+K（Mac）/ Alt+Ctrl+K（Linux/Windows）插入文件引用（如 @src/auth.ts#L1-99）
诊断错误共享：IDE 的 lint 和语法错误自动传递给 Claude

安装与使用

从 JetBrains Marketplace 安装 Claude Code 插件
完全重启 IDE
从 IDE 集成终端运行 claude（所有集成功能自动激活）
外部终端中运行 /ide 命令连接到 JetBrains IDE

重要：从项目根目录启动 Claude Code，确保与 IDE 访问相同的文件。

配置

diff 工具：/config → 设置 diff tool 为 auto（在 IDE 中显示）或 terminal（在终端显示）。

插件设置（Settings → Tools → Claude Code [Beta]）：

Claude command：自定义 claude 命令路径（如 /usr/local/bin/claude）
ESC 键配置：如果 ESC 不能中断操作，去 Settings → Tools → Terminal，取消勾选 “Move focus to the editor with Escape”

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

WSL2 连接问题

症状：运行 claude 显示 “No available IDEs detected”

原因：WSL2 的 NAT 网络或 Windows 防火墙阻止了 WSL2 与 Windows 主机上 IDE 的连接。WSL1 不受影响。

方案一（推荐）：添加防火墙规则

# 以管理员身份运行 PowerShell
# 先获取 WSL2 IP 子网
hostname -I  # 在 WSL 内运行，如 172.21.123.45
 
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

方案二：切换到 mirrored 网络模式（需要 Windows 11 22H2+）

# ~/.wslconfig（Windows 用户目录）
[wsl2]
networkingMode=mirrored

然后 wsl --shutdown 重启。

远程开发

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

常见问题

插件不工作：确保从项目根目录运行，检查插件已启用，完全重启 IDE（可能需要多次）。

IDE 未检测到：验证插件已安装并启用，从集成终端运行 claude，WSL 用户检查网络配置。

command not found：claude --version 验证安装，在插件设置中配置 claude 命令路径。

与其他概念的关联

vs-code — VS Code 集成（功能更丰富的图形界面）
cli-reference — CLI 完整功能
troubleshoot-install — 安装和登录问题

实践要点

JetBrains 集成是 CLI 的增强，不是替代，核心交互仍在终端
安全注意：auto-edit 模式下 Claude 可能修改 IDE 配置文件，建议使用手动审批模式
远程开发场景下插件必须装在远程主机，这是最常见的配置错误
WSL2 用户的 IDE 检测问题几乎都是网络隔离导致的，防火墙规则方案最稳定

Wiki AI

目录