Claude Code JetBrains 插件完全指南：安装、配置与实用技巧

本页目录15

AI 摘要 · 已核查整理于 2026-05-05原文:JetBrains IDEs — Claude Code Documentation(Anthropic)IDE 与集成

要点速览

插件支持 IntelliJ IDEA、PyCharm、WebStorm 等主流 JetBrains IDE，需同时安装 `claude` CLI 和 Marketplace 插件两部分
快捷键 `Cmd+Esc`（Mac）或 `Ctrl+Esc`（Windows/Linux）可直接唤起 Claude Code；`Cmd+Option+K` / `Alt+Ctrl+K` 可快速插入文件引用
代码变更可在 IDE 内置 Diff 查看器展示，通过 `/config` 将 diff 工具设为 `auto` 即可启用
外部终端可通过 `/ide` 命令连接到当前 JetBrains IDE 并激活全部集成功能
WSL2 用户需添加 Windows 防火墙规则或切换镜像网络模式解决「No available IDEs detected」问题
启用自动编辑权限时存在绕过权限提示的安全风险，建议使用手动审批模式

本文是对官方文档「JetBrains IDEs」的中文要点摘要，完整内容以原文为准。原文链接：https://code.claude.com/docs/en/jetbrains

支持的 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 按钮
IDE 内 Diff 查看	代码变更直接在 IDE 内置差异查看器展示，无需切换终端
选区上下文共享	当前选中内容或标签页自动传递给 Claude Code；`Read` deny 规则可阻止指定文件被共享
文件引用快捷键	`Cmd+Option+K`（Mac）/ `Alt+Ctrl+K`（Linux/Windows）插入文件引用，格式如 `@src/auth.ts#L1-99`
诊断信息同步	lint 错误、语法错误等 IDE 诊断信息实时共享给 Claude

安装步骤

插件本身不内置 CLI，需分两步安装：

安装 Claude Code CLI：按官方 quickstart 完成安装，确保 claude 命令在系统 PATH 中可用；若路径不对，可在插件的 Claude command 设置中填写完整路径。
安装 JetBrains 插件：从 JetBrains Marketplace 搜索「Claude Code [Beta]」并安装，安装后完整重启 IDE（可能需多次）。

无需 API Key，支持 Claude Pro、Max、Team、Enterprise 订阅或 Claude Console 账号，首次运行 claude 时会弹出登录引导。

使用方式

从 IDE 集成终端启动

在 IDE 集成终端中直接运行 claude，所有集成功能立即激活。

从外部终端连接

claude
/ide

在任意外部终端运行 claude 后，输入 /ide 命令即可连接到当前 JetBrains IDE 并激活全部功能。建议从 IDE 项目根目录启动，确保 Claude 的文件访问路径与 IDE 一致。

配置说明

Claude Code 内配置（`/config`）

运行 claude 后执行 /config，将 diff 工具设为 auto 可在 IDE 内展示差异，设为 terminal 则保留终端模式。

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

Claude command：自定义 CLI 路径，如 /usr/local/bin/claude 或 npx @anthropic-ai/claude-code
Suppress notification for Claude command not found：跳过「找不到 Claude command」的通知提示
Enable using Option+Enter for multi-line prompts：仅限 macOS，启用后 Option+Enter 可在提示词中插入换行；若 Option 键被意外捕获可关闭，更改后需重启终端
Enable automatic updates：自动检测并安装插件更新，重启后生效
WSL 用户：将 Claude command 设为 wsl -d Ubuntu -- bash -lic "claude"（替换为实际发行版名称）

ESC 键配置

若 ESC 键无法中断 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)），而非本地客户端。

WSL2 网络配置

WSL2 下出现「No available IDEs detected」，通常因 NAT 网络或 Windows 防火墙阻断了 WSL2 与 Windows 上 IDE 的通信（WSL1 直接使用宿主网络，不受影响）。

方案一：添加防火墙规则（推荐，可保留现有 WSL2 网络模式）

在 WSL Shell 中运行 hostname -I 获取子网地址，以管理员身份在 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

执行后重启 IDE 和 Claude Code。

方案二：切换镜像网络模式（需 Windows 11 22H2+）

在 Windows 用户目录的 .wslconfig 文件中添加：

[wsl2]
networkingMode=mirrored

然后在 PowerShell 中执行 wsl --shutdown 重启 WSL。

常见问题排查

现象	排查方向
插件已装但功能不出现	确认从项目根目录启动；检查插件已启用；完整重启 IDE（可能需多次）
显示「No available IDEs detected」	确认插件安装并启用；从 IDE 集成终端运行；WSL 用户检查网络配置
点击图标显示「command not found」	用 `claude --version` 验证安装；在插件设置中填写完整 CLI 路径

安全注意事项

启用自动编辑权限后，Claude Code 可能修改 IDE 配置文件，存在绕过权限提示执行 bash 命令的风险。建议：

使用手动审批模式逐一审核编辑操作
仅在可信提示词环境下使用 Claude Code
留意 Claude Code 有权访问和修改的文件范围

查看官方原文:JetBrains IDEs — Claude Code Documentation ← 返回 Blog