Claude Code JetBrains 插件完全指南：IntelliJ、PyCharm、WebStorm 使用教程

VS Code 用户有官方插件，JetBrains 用户同样有。如果你的主力 IDE 是 IntelliJ IDEA、PyCharm、WebStorm 或 Android Studio，这篇文章就是你的配置指南。

支持的 IDE#

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

基本上 JetBrains 家族的主流 IDE 都支持。

安装#

方法 1：JetBrains Marketplace#

1. IDE 里打开 Settings → Plugins
2. 搜索「Claude Code」
3. 找到 Claude Code (Beta) 插件
4. 点 Install
5. 重启 IDE（可能需要重启两次才生效）

方法 2：直接搜索#

在 IDE 的 Settings → Marketplace 里搜索 Claude Code，直接安装。

注意：插件安装后一定要重启 IDE，很多问题都是没重启导致的。

5 个核心功能#

1. 快速启动快捷键#

不用切换到终端，直接在 IDE 里唤起 Claude Code：

• Mac：Cmd+Esc
• Windows/Linux：Ctrl+Esc

或者点 UI 里的 Claude Code 按钮。

2. IDE Diff 查看器#

这是 JetBrains 插件相比纯命令行最大的优势：Claude Code 提出的代码修改直接显示在 IDE 的 Diff 查看器里，而不是在终端里显示文本 diff。

JetBrains 的 Diff 查看器有语法高亮、行号、代码折叠，review 起来比终端文本清晰多了。

3. 选中内容自动共享#

在编辑器里选中一段代码，Claude Code 自动把你选中的内容作为上下文。不用手动 @ 引用，选中什么 Claude 就能看到什么。

4. 文件引用快捷键#

快速插入 @文件名#行号 引用：

• Mac：Cmd+Option+K
• Windows/Linux：Alt+Ctrl+K

比手动输入快得多，而且会自动加上行号范围（如 @Auth.java#45-80）。

5. 诊断错误自动共享#

IDE 检测到的 lint 错误、语法错误等自动发送给 Claude，不需要你手动复制粘贴错误信息。Claude 能直接看到 IDE 标记的所有问题。

两种使用方式#

方式 1：IDE 内置终端（推荐）#

在 JetBrains IDE 的内置终端里运行 claude，所有集成功能自动激活。

方式 2：外部终端 + /ide 命令#

如果你习惯用外部终端（iTerm2 等），可以用 /ide 命令连接：

claude
/ide   # 连接到当前打开的 JetBrains IDE

前提：在和 IDE 项目根目录相同的目录下运行 claude，这样 Claude 才能访问同样的文件。

配置#

Claude Code 侧配置（diff 工具）#

claude
/config
# 把 diff 工具设为 auto（自动检测 IDE）

JetBrains 插件侧配置#

打开 Settings → Tools → Claude Code [Beta]：

WSL 用户的 Claude command 配置：

（把 Ubuntu 替换成你的 WSL 发行版名）

ESC 键不能中断操作？#

JetBrains 默认 ESC 键会把焦点移到编辑器，导致无法中断 Claude Code。修复：

1. Settings → Tools → Terminal
2. 取消勾选「Move focus to the editor with Escape」
3. 或者在「Configure terminal keybindings」里删除「Switch focus to Editor」快捷键
4. Apply

远程开发配置#

使用 JetBrains Remote Development（SSH 连接远程服务器）时，插件必须安装在远程主机上，不是本地客户端：

Settings → Plugin (Host) → 搜索并安装 Claude Code

这是最容易犯的错误，很多人装在了本地 client 上，结果插件不工作。

常见问题排查#

插件不工作#

1. 确认从项目根目录运行 Claude Code
2. 检查 IDE Settings 里插件是否启用
3. 完全重启 IDE（可能要重启两次）
4. Remote Development 用户：确认插件安装在 remote host 上

IDE 没有被检测到#

1. 确认插件已安装并启用
2. 完全重启 IDE
3. 确认从 IDE 内置终端运行 claude
4. WSL 用户参考 WSL 排查指南

点击 Claude 图标显示「command not found」#

# 验证 Claude Code 已安装
npm list -g @anthropic-ai/claude-code

# 手动配置路径
# Settings → Tools → Claude Code → Claude command 填写完整路径

安全注意事项#

在 JetBrains IDE 里开启 auto-edit 模式时，Claude Code 可能修改 IDE 配置文件（这些文件可被 IDE 自动执行）。这意味着在 JetBrains 里使用 auto-edit 模式风险比在普通终端里略高。

建议：在 JetBrains 里默认使用手动确认模式，只对可信任的任务开启 auto-edit。

来源：Claude Code JetBrains 官方文档 | 整理：ClaudeEagle