JetBrains IDEs

在 JetBrains IDE（包括 IntelliJ、PyCharm、WebStorm 等）中使用 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，或点击 UI 中的 Claude Code 按钮
• 差异查看：代码更改可以直接在 IDE 差异查看器中显示，而不是在终端中显示
• 选择上下文：IDE 中的当前选择或标签页会自动与 Claude Code 共享
• 文件引用快捷方式：使用 Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用，例如 @src/auth.ts#L1-99
• 诊断共享：IDE 中的诊断错误（如 lint 和语法错误）在您工作时会自动与 Claude 共享

安装

市场安装

从 JetBrains 市场查找并安装 Claude Code 插件，然后重启您的 IDE。

如果您还没有安装 Claude Code，请参阅快速入门指南了解安装说明。

ℹ️ 安装插件后，您可能需要完全重启 IDE 才能使其生效。

使用

从您的 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 命令：指定自定义命令来运行 Claude，例如 claude、/usr/local/bin/claude 或 npx @anthropic-ai/claude-code
• 抑制 Claude 命令未找到的通知：跳过有关找不到 Claude 命令的通知
• 启用使用 Option+Enter 进行多行提示：仅在 macOS 上。启用后，Option+Enter 在 Claude Code 提示中插入新行。如果 Option 键被意外捕获，请禁用。需要终端重启。
• 启用自动更新：自动检查并安装插件更新，在重启时应用

💡 对于 WSL 用户：将 wsl -d Ubuntu -- bash -lic "claude" 设置为您的 Claude 命令（将 Ubuntu 替换为您的 WSL 发行版名称）

ESC 键配置

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

1. 转到 Settings → Tools → Terminal
2. 执行以下任一操作：
   • 取消选中”使用 Escape 将焦点移动到编辑器”，或
   • 点击”配置终端快捷键”并删除”切换焦点到编辑器”快捷方式
3. 应用更改

这将允许 ESC 键正确中断 Claude Code 操作。

特殊配置

远程开发

⚠️ 使用 JetBrains 远程开发时，您必须通过 Settings → Plugin (Host) 在远程主机上安装插件。

插件必须安装在远程主机上，而不是在您的本地客户端计算机上。

WSL 配置

如果您在 WSL2 上使用 Claude Code 和 JetBrains IDE，并看到”未检测到可用的 IDE”，原因通常是 WSL2 的 NAT 网络或 Windows 防火墙阻止了 WSL2 和在 Windows 主机上运行的 IDE 之间的连接。WSL1 直接使用主机的网络，不受影响。

允许 WSL2 流量通过 Windows 防火墙

这是推荐的修复方法，因为它保持您现有的 WSL2 网络模式。

1. 查找您的 WSL2 IP 地址：从您的 WSL shell 内部运行：

   hostname -I
   

   记下子网，例如 172.21.123.45 在 172.21.0.0/16 中。

2. 创建防火墙规则：以管理员身份打开 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
   

3. 重启您的 IDE 和 Claude Code：关闭并重新打开两者，以使新规则生效。

将 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 显示”未检测到可用的 IDE”：

• 验证插件已安装并启用
• 完全重启 IDE
• 检查您是否从集成终端运行 Claude Code
• 对于 WSL 用户，请参阅上面的 WSL 配置

命令未找到

如果点击 Claude 图标显示”命令未找到”：

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

安全考虑

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

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

• 对编辑使用手动批准模式
• 特别小心确保 Claude 仅与受信任的提示一起使用
• 了解 Claude Code 有权修改哪些文件

如需 IDE 外的 Claude Code 安装或登录问题，请参阅故障排除安装和登录。

---

本文翻译自 Anthropic Claude Code 官方文档，最近一次同步：2025-05-01。