教程

Claude Code JetBrains 插件完全指南:IntelliJ / PyCharm / WebStorm 接入 AI 编程

Claude Code JetBrains 插件完整指南:支持 IntelliJ IDEA/PyCharm/WebStorm/Android Studio 等全系列 IDE、Marketplace 安装步骤、Cmd+Esc 快速唤起、IDE Diff 视图、选中代码自动共享、诊断信息自动传递、实际工作流场景、配置调优与常见问题排查。

2026/3/144分钟 阅读ClaudeEagle

VS Code 用户有官方扩展,JetBrains 生态同样有专属插件。本文介绍如何在 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE 里安装和使用 Claude Code,发挥 AI 编程全部潜力。

支持的 IDE

Claude Code 插件支持整个 JetBrains 家族:

  • IntelliJ IDEA(Java / Kotlin)
  • PyCharm(Python)
  • WebStorm(JavaScript / TypeScript)
  • Android Studio(Android 开发)
  • PhpStorm(PHP)
  • GoLand(Go)

安装插件

方式一:JetBrains Marketplace(推荐)

  1. 打开 IDE → Settings / PreferencesPlugins
  2. 切到 Marketplace 标签
  3. 搜索 Claude Code
  4. 点击 Install,重启 IDE

或直接访问:plugins.jetbrains.com/plugin/27310-claude-code-beta-

前提条件

需要先安装 Claude Code CLI:

bash
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows
irm https://claude.ai/install.ps1 | iex

启动使用

从 IDE 内置终端启动

打开 IDE 内置终端(Alt+F12),进入项目目录,运行:

bash
claude

启动后所有集成功能自动激活。

从外部终端连接

已经在外部终端里跑着 Claude Code?在 Claude Code 里输入 /ide 命令连接到 JetBrains IDE:

/ide

Claude Code 会自动检测正在运行的 JetBrains IDE 并建立连接。

核心功能

1. 快速唤起:Cmd+Esc

在任何地方按 Cmd+Esc(Mac)/ Ctrl+Esc(Windows/Linux)直接打开 Claude Code 终端,无需离开编辑器。

2. IDE Diff 视图

代码改动直接在 JetBrains 内置 Diff 查看器里显示,不是终端里的文本对比。

好处:

  • 可视化改动更直观
  • 可以直接在 Diff 视图里接受/拒绝修改
  • 与 IDE 的 VCS 集成无缝衔接

3. 选中代码自动共享

在编辑器里选中代码,Claude Code 会自动看到你选中的内容——不需要手动复制粘贴。

快捷键:Cmd+Option+K(Mac)/ Alt+Ctrl+K(Windows/Linux) → 自动插入当前文件和选中行的引用,如 @File.java#L15-42

4. 诊断信息自动传递

IDE 检测到的 lint 错误、语法错误、类型错误会自动传给 Claude Code,不需要你手动描述错误。

实际体验:IntelliJ 标红的代码 → Claude 自动看到 → 直接说"修复这个错误"即可。

实际工作流示例

场景:Java 代码重构

  1. 在 IntelliJ 里选中一段旧的 callback 代码
  2. Cmd+Esc 唤起 Claude Code
  3. 直接说:将选中的代码重构为 CompletableFuture 链式调用,保持功能不变
  4. Claude 读取选中内容,在 IDE Diff 视图里展示改动
  5. 确认后修改生效

场景:Python 错误修复

  1. PyCharm 提示某个函数的类型错误(自动传给 Claude)
  2. Ctrl+Esc 唤起 Claude Code
  3. 说:修复这个类型错误
  4. Claude 已经看到错误信息,直接给出修复方案

场景:审查 PR 改动

# 在内置终端里 git fetch origin pull/123/head:pr-123 git checkout pr-123 claude

然后说:审查这个 PR,检查 Java 最佳实践和潜在的并发问题

插件配置

打开 Settings → Tools → Claude Code [Beta]

配置项说明
Claude command指定 claude 可执行文件路径(如 /usr/local/bin/claude
Enable automatic updates自动检查插件更新
Option+Enter 多行输入macOS 下按 Option+Enter 换行而不发送

Diff 工具配置

bash
claude
/config
# 将 diff tool 设为 auto,自动检测 JetBrains IDE

常见问题排查

插件没有响应?

  • 确认 Claude Code CLI 已安装:which claude
  • 从项目根目录启动,不是任意目录
  • 完全重启 IDE(有时候需要多次)

IDE 未被检测到?

  • 确认插件已启用(不只是安装)
  • 从 IDE 内置终端而不是外部终端启动 Claude Code
  • WSL 用户需要特别配置,参考 WSL 故障排查指南

ESC 键不能中断操作?

  1. Settings → Tools → Terminal
  2. 取消勾选 "Move focus to the editor with Escape",或删除 "Switch focus to Editor" 快捷键
  3. 应用后 ESC 可以正常中断 Claude Code

远程开发注意事项

使用 JetBrains Gateway 连接远程服务器时:

  • 插件必须安装在远程主机上,不是本地客户端
  • 在远程主机上安装 Claude Code CLI
  • SSH 密钥和 Anthropic API 凭证配置在远程主机

安全提醒

开启自动接受编辑(Auto-edit)模式时,Claude Code 可能修改 IDE 配置文件(这些文件可能会被 IDE 自动执行)。建议:

  • 日常使用保持手动确认模式
  • 只在信任的代码库里开启自动模式
  • 定期检查 Claude Code 有权访问哪些目录

来源:JetBrains IDEs - Claude Code Docs | Anthropic 官方文档

相关文章推荐

教程Claude Code JetBrains 插件完全指南:IntelliJ、PyCharm、WebStorm 使用教程Claude Code JetBrains 插件完整配置指南:支持 IntelliJ、PyCharm、WebStorm、Android Studio,含安装步骤、5 个核心功能(IDE Diff 查看器、选中自动共享、诊断错误自动发送)、WSL 配置和常见问题排查。2026/4/12教程Claude Code JetBrains 插件集成指南:IntelliJ/PyCharm/WebStorm 安装、配置与 WSL 特殊设置Claude Code JetBrains 插件集成完整指南:支持 IntelliJ/PyCharm/Android Studio/WebStorm/PhpStorm/GoLand 六大 IDE、五大核心功能(快速启动 Cmd+Esc/Diff 查看/选择上下文/文件引用 Cmd+Option+K/诊断信息自动共享)、Marketplace 安装步骤、/ide 命令从外部终端连接、Diff 工具设为 auto、WSL 专用命令配置、ESC 键修复,以及与 VS Code 扩展的功能对比表。2026/3/5教程Claude Code JetBrains IDE 集成完整指南:IntelliJ、PyCharm、WebStorm 使用教程Claude Code JetBrains 插件完整使用指南:支持 9 种 IDE(IntelliJ/PyCharm/WebStorm/GoLand/Rider/CLion/Android Studio 等);Marketplace 安装步骤;4 大核心功能(侧边栏对话面板/@ 文件引用/选中代码触发/Inline Diff 审查);Java 重构/Python 类型注解/Kotlin 依赖升级 3 个工作流;VS Code 扩展 vs JetBrains 插件对比;以及快捷键配置和常见问题解决。2026/5/6教程Claude Code 平台选择指南:CLI、Desktop、VS Code、网页版、手机端,哪个最适合你Claude Code 平台选择完整指南:CLI、Desktop、VS Code、JetBrains、网页版、手机 App 全面对比,含各平台独有能力、远程控制选项、集成方案和选择建议流程图。2026/4/12教程Claude Code Skills 进阶:动态上下文注入、路径限定激活和 Subagent 集成深度指南Claude Code Skills 三个高级特性深度指南:动态上下文注入(!! 命令预处理原理、内联和多行语法、实战健康检查 Skill 含 6 个命令块、安全注意事项);路径限定自动激活(TypeScript 严格模式/SQL 安全/React 组件三个实战示例);context: fork 在 Subagent 运行(适用场景判断、agent 类型选择);以及三种特性组合的完整 PR 审查 Skill 示例。2026/5/10教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10