Claude Code 通过官方 JetBrains 插件与 IntelliJ IDEA、PyCharm、WebStorm 等 IDE 深度集成，提供交互式 Diff 查看、选择上下文共享、诊断信息自动传递等功能。
支持的 IDE
- IntelliJ IDEA
- PyCharm
- Android Studio
- WebStorm
- PhpStorm
- GoLand
- 以及其他大多数 JetBrains IDEs
核心功能
| 功能 | 描述 |
|---|---|
| 快速启动 | Cmd+Esc（Mac）/ Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code |
| Diff 查看 | 代码变更直接显示在 IDE Diff 查看器，而非终端 |
| 选择上下文 | IDE 中当前选中内容/标签页自动与 Claude Code 共享 |
| 文件引用快捷键 | Cmd+Option+K（Mac）/ Alt+Ctrl+K（Linux/Windows）插入文件引用（如 @File#L1-99） |
| 诊断信息共享 | IDE 的 Lint、��法错误等诊断信息在你工作时自动传递给 Claude |
安装
从 JetBrains Marketplace 安装
- 在 IDE 中打开：Settings → Plugins → Marketplace
- 搜索「Claude Code」
- 安装 Claude Code Beta 插件
- 完全重启 IDE（仅重载可能不够）
如果还没安装 Claude Code CLI，先按 快速上手指南 安装。
使用方式
从 IDE 内置终端使用
在 IDE 的集成终端中运行 claude，所有集成功能自动激活。
从外部终端连接
在任意外部终端运行 /ide 命令将 Claude Code 连接到已打开的 JetBrains IDE：
bash
claude
> /ide如果希望 Claude 访问与 IDE 相同的文件，确保从 IDE 项目根目录启动 Claude Code。
配置
Claude Code 设置（Diff 工具）
claude
/config → Diff tool → auto（自动检测 IDE）
设为 auto 后，Claude Code 自动将代码差异在 IDE Diff 查看器中展示。
JetBrains 插件设置
在 IDE 中打开：Settings → Tools → Claude Code [Beta]
通用设置：
| 设置项 | 说明 |
|---|---|
| Claude command | 自定义运行 Claude 的命令（如 claude、/usr/local/bin/claude、npx @anthropic/claude） |
| Suppress notification for Claude command not found | 找不到 Claude 命令时跳过通知 |
| Enable using Option+Enter for multi-line prompts（仅 macOS） | 启用后 Option+Enter 在提示词中插入换行（如果 Option 键被意外捕获可禁用，需重启终端） |
| Enable automatic updates | 自动检查并安装插件更新（重启后生效） |
WSL 用户专用配置：
将 Claude command 设置为：
wsl -d Ubuntu -- bash -lic "claude"
（将 Ubuntu 替换为你的 WSL 发行版名称）
ESC 键配置
如果在 JetBrains 终端中 ESC 键无法中断 Claude Code 操作：
- 打开 Settings → Tools → Terminal
- 任选其一：
- 取消勾选「Move focus to the editor with Escape」
- 或点击「Configure terminal keybindings」，删除「Switch focus to Editor」快捷键
- 应用更改
远程开发
Claude Code 支持 JetBrains 远程开发场景（如 SSH 远程主机、JetBrains Gateway）：
- 在远程主机上安装 Claude Code CLI
- 插件连接后，所有操作在远程环境中执行
- 本地 IDE 的 Diff 查看器和诊断功能正常工作
故障排查
| 问题 | 解决方案 |
|---|---|
| 插件无效果 | 确保完全重启 IDE（不只是重载插件） |
| IDE 未被检测到 | 从 IDE 集成终端运行 claude，或在外部终端运行 /ide 手动连接 |
| 找不到 claude 命令 | 在插件设置中指定完整路径（如 /usr/local/bin/claude） |
| WSL 连接问题 | 设置命令为 wsl -d Ubuntu -- bash -lic "claude" |
| ESC 键不响应 | 在终端设置中取消「Move focus to editor with Escape」 |
与 VS Code 集成的对比
| 功能 | JetBrains 插件 | VS Code 扩展 |
|---|---|---|
| 交互式 Diff | ✅ IDE 内查看 | ✅ 内置 Diff 编辑器 |
| 选择上下文共享 | ✅ | ✅ |
| 文件引用快捷键 | ✅ Cmd+Option+K | ✅ |
| 诊断信息共享 | ✅ 自动 | ✅ 自动 |
| Chrome 浏览器自动化 | ❌ 暂不支持 | ✅ 支持 |
| 快速启动快捷键 | Cmd+Esc | Cmd+Esc |
原文：JetBrains IDEs - Claude Code Docs | 来源：Anthropic 官方文档