JetBrains IDEs 中使用 Claude Code

Claude Code 通过专用插件与 JetBrains IDEs 深度集成，提供交互式差异查看、代码选区上下文共享等强大功能，让 AI 辅助编程无缝融入你的开发工作流。

支持的 IDE

Claude Code 插件支持绝大多数 JetBrains IDE，包括：

• IntelliJ IDEA
• PyCharm
• Android Studio
• WebStorm
• PhpStorm
• GoLand

核心功能

功能	说明
快速启动	Mac 使用 Cmd+Esc，Windows/Linux 使用 Ctrl+Esc，直接从编辑器打开 Claude Code
Diff 查看	代码变更直接在 IDE 的 Diff 查看器中展示，而非在终端中
选区上下文共享	IDE 中当前选中的代码或标签页内容会自动共享给 Claude Code
文件引用快捷键	Mac 使用 Cmd+Option+K，Linux/Windows 使用 Alt+Ctrl+K，快速插入如 @src/auth.ts#L1-99 形式的文件引用
诊断信息共享	IDE 中的 lint 错误、语法错误等诊断信息会在你工作时自动共享给 Claude

---

安装配置

第一步：安装前提条件

在安装 JetBrains 插件之前，需要先安装 Claude Code CLI。

# macOS、Linux、WSL 安装
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell 安装
irm https://claude.ai/install.ps1 | iex

# 验证安装
claude --version

如需详细安装步骤，请参考 Claude Code 安装指南。

第二步：安装 JetBrains 插件

1. 打开你的 JetBrains IDE
2. 进入 Settings（设置）→ Plugins（插件）
3. 切换到 Marketplace（市场） 标签
4. 搜索 Claude Code
5. 点击 Install（安装）
6. 安装完成后重启 IDE

第三步：启动并连接 Claude Code

从 IDE 集成终端启动（推荐）

在 IDE 内置终端中运行以下命令，所有集成功能将自动激活：

claude

这是一个欢迎界面，按下 Enter 后，就可以开始干活了：

从外部终端连接

如果你使用的是外部终端，可以通过 /ide 命令将 Claude Code 连接到你的 JetBrains IDE：

# 先启动 Claude Code
claude

# 然后执行 /ide 命令连接 IDE
/ide

💡 提示：为确保 Claude 能访问与 IDE 相同的文件，请从 IDE 项目根目录启动 Claude Code。

第四步：配置 Claude Code

配置 Diff 工具

运行 Claude Code 后，通过以下步骤设置 Diff 显示方式：

# 启动 Claude Code
claude

# 进入配置
/config

将 diff 工具设置为 auto，代码变更将直接在 IDE Diff 查看器中显示；设置为 terminal 则保留在终端中展示。

配置插件设置

进入 Settings → Tools → Claude Code [Beta]，可以配置以下选项：

• Claude command（Claude 命令路径）：自定义运行 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 可在提示框中插入换行
• Enable automatic updates：自动检查并安装插件更新，重启后生效

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

配置 ESC 键（可选）

如果 ESC 键无法中断 Claude Code 操作，按以下步骤修复：

1. 进入 Settings → Tools → Terminal
2. 取消勾选 "Move focus to the editor with Escape"，或点击 "Configure terminal keybindings" 并删除 "Switch focus to Editor" 快捷键
3. 应用更改

---

特殊场景配置

远程开发（Remote Development）

使用 JetBrains Remote Development 时，必须将插件安装在远程主机上，而非本地客户端机器。

操作路径：Settings → Plugin (Host)

WSL2 配置

如果在 WSL2 环境下使用 Claude Code，且出现 "No available IDEs detected" 错误，通常是 WSL2 的 NAT 网络或 Windows 防火墙阻断了连接。

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

# 第一步：在 WSL 中查看 IP 地址
hostname -I
# 例如输出 172.21.123.45，子网为 172.21.0.0/16

# 第二步：以管理员身份打开 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 即可生效。

方案二：切换 WSL2 为镜像网络模式（需要 Windows 11 22H2 或更高版本）

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

[wsl2]
networkingMode=mirrored

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

---

常见问题排查

插件安装后功能未出现

• 确认 Claude Code 是从项目根目录启动的
• 检查 JetBrains 插件是否已在 IDE 设置中启用
• 尝试完全重启 IDE（可能需要多次重启）
• 远程开发场景下，确认插件已安装在远程主机上

提示 "No available IDEs detected"

• 确认插件已安装并启用
• 完全重启 IDE
• 确保 Claude Code 是从 IDE 集成终端中运行的
• WSL 用户请参考上方 WSL2 配置 章节

点击 Claude 图标提示 "command not found"

1. 在终端运行 claude --version，验证 Claude Code 已正确安装
2. 在插件设置中手动配置 Claude 命令路径
3. WSL 用户请使用前述 WSL 命令格式