JetBrains

在 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE 里通过插件使用 Claude Code：安装、使用方式、配置、WSL 与远程开发、排障。

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

支持的 IDE

该插件适用于大多数 JetBrains IDE，包括 IntelliJ IDEA、PyCharm、Android Studio、WebStorm、PhpStorm 和 GoLand。

功能

快速启动：用 Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code，或点界面里的 Claude Code 按钮
查看 diff：Claude Code 在 IDE 的 diff 查看器里而不是终端里打开代码改动；可通过 /config 里的 Diff tool 设置更改
选区上下文：IDE 里当前的选区或标签页会自动与 Claude Code 共享；匹配的文件可以用 Read 拒绝规则阻止共享
文件引用快捷键：用 Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用，如 @src/auth.ts#L1-99
诊断共享：Claude 通过调用 getDiagnostics 工具读取 IDE 的检查诊断（如 lint 和语法错误）；Claude Code 不会在编辑后自行向插件请求诊断

安装

插件在 IDE 的集成终端里运行 claude 命令并连接它。它不自带 CLI，所以两部分都要安装：

如果还没装 CLI，按快速上手安装。claude 不在 PATH 里时，插件会显示「Cannot launch Claude Code」通知
从 JetBrains Marketplace 安装 Claude Code 插件，并重启 IDE

如果 claude 装在 IDE 找不到的地方，在插件的 Claude command 设置里填写完整路径。Claude Code 可用于任何付费 Claude 订阅（Pro、Max、Team 或 Enterprise）或 Claude Console 账号，不需要 API Key；首次运行 claude 时会提示你登录。

使用

从 IDE 里：在 IDE 的集成终端里运行 claude，所有集成功能都会生效。

从外部终端：在任何外部终端里用 /ide 命令把 Claude Code 连到你的 JetBrains IDE，激活所有功能：

claude

/ide

连接成功时，Claude Code 会用类似 Connected to IntelliJ IDEA. 的消息确认。如果它检测到正在运行的 IDE 没有装插件，/ide 会替你安装并让你重启 IDE。想让 Claude 能访问和 IDE 相同的文件，从 IDE 项目根目录启动 Claude Code。

配置

Claude Code 设置：运行 claude，输入 /config，把 Diff tool 设为 auto（在 IDE 里显示 diff）或 terminal（留在终端里）。Diff tool 条目只在 Claude Code 连接到 IDE 时才出现，所以要么从 JetBrains 终端运行 claude，要么先在外部终端运行 /ide。

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

Claude command：指定运行 Claude 的自定义命令，如 claude、/usr/local/bin/claude 或 npx @anthropic-ai/claude-code
Suppress notification for when Claude Command is not found：跳过找不到 Claude 命令的通知
Enable using Option+Enter for multi-line prompts：仅 macOS，启用后 Option+Enter 在 Claude Code 提示里插入换行；Option 键被意外捕获时关闭，需重启终端
Enable automatic updates：自动检查并安装插件更新，重启后生效

WSL 用户：把 Claude command 设为 wsl -d Ubuntu -- bash -lic "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」快捷键，然后应用更改。

特殊配置

远程开发：使用 JetBrains Remote Development 时，必须通过 Settings → Plugin (Host) 在远程主机上安装插件，而不是在本地客户端上。

WSL 配置：如果在 WSL2 上使用 JetBrains IDE 时看到「No available IDEs detected」，原因通常是 WSL2 的 NAT 网络或 Windows 防火墙阻止了 WSL2 与 Windows 主机上 IDE 之间的连接（WSL1 直接使用主机网络，不受影响）。

推荐：允许 WSL2 流量通过 Windows 防火墙：在 WSL 里运行 hostname -I，取地址的前两段后接 .0.0/16 作为子网（如地址是 172.21.123.45，子网为 172.21.0.0/16）；然后以管理员身份打开 PowerShell，按你的子网调整后运行：
```
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
```
然后关闭并重新打开两者，让新规则生效
或者把 WSL2 切换到镜像网络（需要 Windows 11 22H2 或更新版本；Windows 10 请用上面的防火墙规则）：在 Windows 用户目录的 .wslconfig 里添加下面内容，然后在 PowerShell 里运行 wsl --shutdown 重启 WSL：
```
[wsl2]
networkingMode=mirrored
```

排障

插件不工作：确认你在项目根目录运行 Claude Code；检查 IDE 设置里 JetBrains 插件已启用；完全重启 IDE（可能要重启多次）；远程开发时确保插件装在远程主机上。

检测不到 IDE（/ide 显示「No available IDEs detected」）：确认插件已安装并启用；完全重启 IDE；如果你期望不运行 /ide 就自动连接，检查你是从 IDE 的集成终端启动的 claude；WSL 用户见上面的 WSL 配置。

找不到命令（点 Claude 图标显示「command not found」）：在终端运行 claude --version 确认已安装；在插件设置里配置 Claude 命令路径；WSL 用户使用上面提到的 WSL 命令格式。

安全注意事项

当 Claude Code 在 JetBrains IDE 里以 acceptEdits 权限模式运行时，它可能能修改会被 IDE 自动执行的 IDE 配置文件，这可能增加风险。建议：编辑用 Manual 模式（因为 acceptEdits 和 auto 模式都会不经询问地批准工作目录内的编辑，受保护路径除外）；格外注意只对可信的提示使用 Claude；留意 Claude Code 有权修改哪些文件。

内置的 IDE MCP 服务器：插件活动时会运行一个 CLI 自动连接的本地 MCP 服务器，CLI 靠它在 IDE 原生 diff 查看器里打开 diff、为 @ 提及读取当前选区，并让 Claude 读取检查诊断。服务器名为 ide，在 /mcp 里隐藏。对模型可见的工具只有一个：mcp__ide__getDiagnostics（返回 IDE 的检查诊断，即编辑器里显示的错误和警告，每次调用覆盖一个文件，只读）。想排除 .env 这类敏感文件，为其路径添加 Read 拒绝规则。