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(推荐)
- 打开 IDE → Settings / Preferences → Plugins
- 切到 Marketplace 标签
- 搜索
Claude Code - 点击 Install,重启 IDE
或直接访问:plugins.jetbrains.com/plugin/27310-claude-code-beta-
前提条件
需要先安装 Claude Code CLI:
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows
irm https://claude.ai/install.ps1 | iex启动使用
从 IDE 内置终端启动
打开 IDE 内置终端(Alt+F12),进入项目目录,运行:
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 代码重构
- 在 IntelliJ 里选中一段旧的 callback 代码
Cmd+Esc唤起 Claude Code- 直接说:
将选中的代码重构为 CompletableFuture 链式调用,保持功能不变 - Claude 读取选中内容,在 IDE Diff 视图里展示改动
- 确认后修改生效
场景:Python 错误修复
- PyCharm 提示某个函数的类型错误(自动传给 Claude)
Ctrl+Esc唤起 Claude Code- 说:
修复这个类型错误 - 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 工具配置
claude
/config
# 将 diff tool 设为 auto,自动检测 JetBrains IDE常见问题排查
插件没有响应?
- 确认 Claude Code CLI 已安装:
which claude - 从项目根目录启动,不是任意目录
- 完全重启 IDE(有时候需要多次)
IDE 未被检测到?
- 确认插件已启用(不只是安装)
- 从 IDE 内置终端而不是外部终端启动 Claude Code
- WSL 用户需要特别配置,参考 WSL 故障排查指南
ESC 键不能中断操作?
- Settings → Tools → Terminal
- 取消勾选 "Move focus to the editor with Escape",或删除 "Switch focus to Editor" 快捷键
- 应用后 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 官方文档