JetBrains IDE

在 IntelliJ、PyCharm、WebStorm 等 JetBrains IDE 中使用 Claude Code

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，或点击界面中的 Claude Code 按钮
• 差异查看：代码变更可直接在 IDE 的差异查看器中显示，而非终端
• 选区上下文：IDE 中的当前选区或标签页会自动共享给 Claude Code。Read 拒绝规则会阻止匹配文件的共享
• 文件引用快捷方式：使用 Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用，如 @src/auth.ts#L1-99
• 诊断共享：IDE 中的诊断错误（如 lint 和语法错误）会在工作时自动共享给 Claude

安装

该插件在 IDE 的集成终端中运行 claude 命令并与其连接。它不包含 CLI 的独立副本，因此需要同时安装两部分：

如果 claude 安装在 IDE 无法找到的位置，请在插件的 Claude 命令设置 中设置完整路径。

Claude Code 适用于任何付费 Claude 订阅（Pro、Max、Team 或 Enterprise）或 Claude Console 账户，无需 API 密钥。首次运行 claude 时，系统会提示你登录。

使用

从 IDE 中

从 IDE 的集成终端运行 claude，所有集成功能都将激活。

从外部终端

在任何外部终端中使用 /ide 命令将 Claude Code 连接到你的 JetBrains IDE 并激活所有功能：

claude

/ide

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

配置

Claude Code 设置

通过 Claude Code 的设置配置 IDE 集成：

1. 运行 claude
2. 输入 /config 命令
3. 将差异工具设置为 auto 以在 IDE 中显示差异，或设置为 terminal 以保留在终端中

插件设置

通过 Settings → Tools → Claude Code [Beta] 配置 Claude Code 插件：

常规设置

• 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：自动检查并安装插件更新，在重启时应用

ESC 键配置

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

1. 前往 Settings → Tools → Terminal
2. 选择以下任一方式：
   • 取消勾选"Move focus to the editor with Escape"，或
   • 点击"Configure terminal keybindings"并删除"Switch focus to Editor"快捷键
3. 应用更改

这样 ESC 键就能正确中断 Claude Code 操作。

特殊配置

远程开发

插件必须安装在远程主机上，而非本地客户端机器。

WSL 配置

如果你在 WSL2 上使用 JetBrains IDE 运行 Claude Code 时看到"No available IDEs detected"，原因通常是 WSL2 的 NAT 网络或 Windows 防火墙阻止了 WSL2 与运行在 Windows 主机上的 IDE 之间的连接。WSL1 直接使用主机的网络，不受影响。

允许 WSL2 流量通过 Windows 防火墙

这是推荐的修复方案，因为它保留了现有的 WSL2 网络模式。

hostname -I

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 中添加：

[wsl2]
networkingMode=mirrored

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

故障排除

插件无法工作

如果插件已安装但 Claude Code 功能未在 IDE 中显示：

• 确保你从项目根目录运行 Claude Code
• 检查 JetBrains 插件是否在 IDE 设置中已启用
• 完全重启 IDE（可能需要多次）
• 对于远程开发，确保插件安装在远程主机上

未检测到 IDE

如果运行 claude 显示"No available IDEs detected"：

• 验证插件是否已安装并启用
• 完全重启 IDE
• 确认你从集成终端运行 Claude Code
• WSL 用户，请参阅上方的 WSL 配置

命令未找到

如果点击 Claude 图标显示"command not found"：

1. 在终端中运行 claude --version 验证 Claude Code 是否已安装
2. 在插件设置中配置 Claude 命令路径
3. WSL 用户，请使用配置部分提到的 WSL 命令格式

安全注意事项

当 Claude Code 在 JetBrains IDE 中以 acceptEdits 权限模式 运行时，它可能能够修改 IDE 可自动执行的 IDE 配置文件。这可能会增加在 acceptEdits 模式下运行 Claude Code 的风险，并允许绕过 Claude Code 对 bash 执行的权限提示。

在 JetBrains IDE 中运行时，请考虑：

• 对编辑使用手动批准模式
• 格外小心，确保仅将 Claude 用于受信任的提示
• 注意 Claude Code 有权修改哪些文件

对于 IDE 外部的 Claude Code 安装或登录问题，请参阅排查安装和登录问题。