教程

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 安装、配置与 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 MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18教程Claude Code 输出格式控制完全指南:JSON、流式、结构化输出使用方法Claude Code 和 Claude API 输出格式完整控制指南:--output-format 参数(text/json/stream-json)、非交互模式(-p)的输出控制、结构化 JSON 输出(--json-schema 字段约束)、流式输出(Server-Sent Events)的处理方式、include-partial-messages 流式渐进显示、以及 CI/CD 管道中解析 JSON 输出的实用技巧。2026/3/18教程Claude Code 项目初始化最佳实践:新项目 5 分钟搭建完美 AI 编程环境Claude Code 新项目最佳初始化流程:CLAUDE.md 标准模板(项目背景/技术栈/代码规范/禁止操作)、.claudeignore 初始配置、.claude/commands/ 常用命令预置、settings.json 权限与模型设置、--init 命令的自动化初始化、项目级 vs 全局配置的优先级说明,以及不同类型项目(Web前端/后端API/全栈/开源库)的专项初始化模板。2026/3/18教程Claude Code 权限管理完全指南:精确控制 AI 能执行哪些操作Claude Code 权限系统完整解析:四种权限模式(default/acceptEdits/bypassPermissions/plan)、--allowedTools 和 --disallowedTools 精确工具控制、Bash 命令白名单语法(通配符匹配)、settings.json 持久化权限配置、CLAUDE.md 中的权限规则声明、CI/CD 自动化场景的权限配置、以及如何在效率和安全之间找到平衡点。2026/3/18教程Claude Code 自定义斜杠命令完全指南:用 /命令 封装常用工作流Claude Code 自定义斜杠命令(slash commands)完整教程:命令文件创建位置(.claude/commands/)、Markdown 格式规范、$ARGUMENTS 参数传递、项目级命令 vs 用户全局命令的区别、实用命令示例(/review、/test、/deploy-check、/refactor、/standup)、命令组合调用,以及如何在团队中共享和版本管理自定义命令。2026/3/18