JetBrains Claude Code

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 插件

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

JetBrains Claude Code

第三步：启动并连接 Claude Code

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

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

claude

JetBrains Claude Code

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

JetBrains Claude Code

从外部终端连接

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

# 先启动 Claude Code
claude

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

JetBrains Claude Code

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

第四步：配置 Claude Code

配置 Diff 工具

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

# 启动 Claude Code
claude

# 进入配置
/config

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

JetBrains Claude Code

配置插件设置

进入 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：自动检查并安装插件更新，重启后生效

JetBrains Claude Code

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

配置 ESC 键（可选）

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

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

JetBrains Claude Code

特殊场景配置

远程开发（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 文件中添加：