Claude Code JetBrains IDE 集成完整指南：IntelliJ、PyCharm、WebStorm 使用教程

Claude Code 官方 JetBrains 插件让你在 IntelliJ IDEA、PyCharm、WebStorm、GoLand、Rider 等 JetBrains IDE 里直接使用 Claude Code，无需切换到终端。本文是 JetBrains 集成的完整使用指南。

---

支持的 JetBrains IDE#

---

安装#

从 JetBrains Marketplace 安装#

1. 打开 IDE → Settings/Preferences
2. Plugins → Marketplace
3. 搜索 "Claude Code"
4. 安装 Anthropic 官方插件
5. 重启 IDE

验证安装#

安装后在 IDE 里会出现：

• 右侧工具栏：Claude Code 图标
• View 菜单 → Tool Windows → Claude Code
• 底部状态栏：Claude Code 连接状态

---

核心功能#

侧边栏对话面板#

打开方式：

• 点击右侧工具栏的 Claude Code 图标
• View → Tool Windows → Claude Code
• 快捷键：Alt+Shift+A（可自定义）

在侧边栏里：

• 输入自然语言指令
• 查看 Claude 的思考过程
• 审查文件变更（inline diff）
• 批准或拒绝每一步操作

@ 文件引用#

在对话框里输入 @ 触发文件自动补全：

@src/main/java/com/example/UserService.java 优化这个类的查询方法，当前有 N+1 问题

支持：

• 文件：@src/main.py
• 目录：@src/services/
• 当前打开的文件：@当前文件（或在编辑器里选中代码后触发）

在编辑器里选中代码触发#

1. 在编辑器里选中一段代码
2. 右键 → Claude Code
3. 或使用快捷键（可配置）

预置操作：

• Explain：解释选中代码
• Fix：修复 Bug
• Optimize：性能优化
• Add Tests：为选中函数生成测试
• Add Docs：生成 JavaDoc/docstring

内联变更审查（Inline Diff）#

Claude 对文件做修改时，IDE 里直接显示 diff 视图：

• 绿色高亮：新增内容
• 红色删除线：删除内容
• Accept All：一键接受所有变更
• Reject All：一键拒绝所有变更
• 也可以逐行接受/拒绝

这是 JetBrains 集成相比纯终端使用的最大优势：直接在 IDE 里可视化审查，而不是在终端里滚动查看 diff。

---

配置#

IDE 插件设置#

Settings → Tools → Claude Code

使用 CLI 配置（共享设置）#

JetBrains 插件和 CLI 共享同一个 ~/.claude/settings.json 和项目级 .claude/settings.json。在终端里配置的 CLAUDE.md、Hooks、MCP 服务器，在 JetBrains 里同样生效。

---

常用工作流#

Java 项目：重构 Service 层#

1. 打开 UserService.java 2. 在 Claude Code 侧边栏输入： "把这个类里所有同步方法改为异步（CompletableFuture）， 保持现有的错误处理逻辑不变" 3. Claude 分析整个类，列出变更计划 4. 在 IDE 里 review inline diff 5. 逐方法接受变更

Python 项目：添加类型注解#

1. 选中某个 Python 文件（或多个文件） 2. 在侧边栏输入： "为这些函数添加 Python 3.10+ 类型注解， 使用 union 语法（X | Y 而非 Optional[X]）" 3. Claude 推断类型，添加注解 4. IDE 的类型检查器实时验证注解是否正确

Kotlin/Gradle 项目：依赖升级#

"检查 build.gradle.kts 里所有依赖的当前版本， 找出有重大版本升级的依赖， 列出升级前需要注意的 Breaking Changes"

---

和 VS Code 扩展的对比#

结论：写 Java/Kotlin/Python/Go 用 JetBrains IDE 的用户，选 JetBrains 插件体验更原生；JavaScript/TypeScript 生态用 VS Code 扩展。

---

常见问题#

问题 1：侧边栏显示"Claude Code not connected"#

检查顺序： 1. claude --version（确认 CLI 已安装） 2. claude auth login（确认已登录） 3. 重启 IDE 4. Settings → Tools → Claude Code → Test Connection

问题 2：在 IDE 里变更没有自动触发 Hooks#

确认 Hooks 配置在 .claude/settings.json 里，且文件在项目根目录。JetBrains 插件的工作目录是 IDE 打开的项目根目录。

问题 3：Inline Diff 显示乱码#

检查文件编码设置：Settings → Editor → File Encodings，建议全部设置为 UTF-8。

问题 4：JetBrains 版本太旧#

JetBrains 插件要求 IDE 版本 2023.3+。打开 JetBrains Toolbox → 更新到最新版本。

---

快捷键配置#

在 Settings → Keymap → 搜索 "Claude Code" 里配置：

---

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