Appearance
JetBrains IDEs 集成
Claude Code 通过专用插件与 JetBrains IDE 深度集成，提供交互式 Diff 查看、选区上下文自动共享、快速启动快捷键和 IDE 诊断信息同步。从 JetBrains Marketplace 安装 Claude Code 插件并重启 IDE 即可使用。本文涵盖安装步骤、所有核心功能、插件设置配置（Claude 命令路径、多行输入、ESC 键行为）、远程开发和 WSL 特殊配置，以及插件不工作、IDE 未检测到等常见问题的排查方法。
支持的 IDE
如果你是从 Claude Code settings 页面跳过来的，可以先看结论：JetBrains 插件本身负责 IDE 内启动、Diff、选区上下文和快捷键；权限规则、默认模型、Hooks、MCP 仍主要由 settings.json 和项目配置控制；登录失败则回到认证配置排查。
Claude Code 插件支持大多数 JetBrains IDE，包括：
- IntelliJ IDEA
- PyCharm
- Android Studio
- WebStorm
- PhpStorm
- GoLand
功能
| 功能 | 说明 |
|---|---|
| 快速启动 | Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code，或点击 UI 中的 Claude Code 按钮 |
| Diff 查看 | 代码变更直接在 IDE 的 Diff 查看器中显示，而非终端 |
| 选区上下文 | 当前选中内容和活动标签页自动共享给 Claude Code |
| 文件引用快捷键 | Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用（如 @File#L1-99） |
| 诊断信息共享 | IDE 的诊断错误（lint、语法错误等）在工作时自动共享给 Claude |
安装
通过 Marketplace 安装
从 JetBrains Marketplace 找到并安装 Claude Code 插件，然后重启 IDE。
如果还没安装 Claude Code CLI，请先参考快速上手完成安装。
使用方式
从 IDE 内使用
在 IDE 集成终端中运行 claude，所有集成功能自动激活。
从外部终端连接
在任意外部终端中，使用 /ide 命令连接到 JetBrains IDE，激活所有功能：
bash
claude然后输入：
/ide如果希望 Claude 访问与 IDE 相同的文件，请从 IDE 项目根目录启动 Claude Code。
配置
Claude Code 设置
IDE 场景里常见的配置分三类：
| 目标 | 应该在哪里改 | 说明 |
|---|---|---|
| 让 Diff 在 IDE 中打开 | /config 或 Claude Code 设置 | diff 工具设为 auto |
| 控制允许哪些命令自动执行 | settings.json 的 permissions | 项目共享规则放 .claude/settings.json |
| 设置默认模型、statusLine、Hooks | settings.json | IDE 插件不替代 Claude Code 配置文件 |
| 指定 Claude 命令路径 | JetBrains 插件设置 | 适合 CLI 不在 PATH 或使用 WSL 命令时 |
| 解决登录、API Key、OAuth 冲突 | 认证配置 | 先用 /status 看当前认证方式 |
通过 Claude Code 的设置配置 IDE 集成：
- 运行
claude - 输入
/config命令 - 将 diff 工具设置为
auto（在 IDE 中显示 diff），或terminal（在终端中显示）
插件设置
进入 Settings → Tools → Claude Code [Beta]：
通用设置
| 设置项 | 说明 |
|---|---|
| Claude command | 指定 Claude 的运行命令（如 claude、/usr/local/bin/claude 或 npx @anthropic-ai/claude-code） |
| Suppress notification for Claude command not found | 跳过找不到 Claude 命令时的通知 |
| Enable using Option+Enter for multi-line prompts（仅 macOS） | 开启后 Option+Enter 在 Claude Code 提示框插入换行符。如果 Option 键被意外捕获，禁用此选项（需要重启终端） |
| Enable automatic updates | 自动检查并安装插件更新（重启后生效） |
ESC 键配置
如果 ESC 键无法中断 JetBrains 终端中的 Claude Code 操作：
- 进入 Settings → Tools → Terminal
- 取消勾选 "Move focus to the editor with Escape"，或
- 点击 "Configure terminal keybindings" 并删除 "Switch focus to Editor" 快捷键
- 应用更改
这样 ESC 键就可以正确中断 Claude Code 操作了。
特殊配置
远程开发
插件必须安装在远程主机上，而非本地客户端机器。
WSL 配置
WSL 配置可能需要：
- 正确的终端配置
- 网络模式调整
- 防火墙设置更新
故障排查
插件不工作
- 确认从项目根目录运行 Claude Code
- 检查 IDE 设置中 JetBrains 插件是否已启用
- 完全重启 IDE（可能需要重启多次）
- 远程开发用户：确认插件安装在远程主机而非本地
IDE 未被检测到
- 验证插件已安装并启用
- 完全重启 IDE
- 确认从集成终端运行 Claude Code
- WSL 用户：参见 WSL 故障排查指南
点击 Claude 图标显示"命令未找到"
- 验证 Claude Code 已安装：
npm list -g @anthropic-ai/claude-code - 在插件设置中配置 Claude 命令路径
- WSL 用户：在配置部分使用 WSL 命令格式
安全注意事项
在启用自动编辑权限的 JetBrains IDE 中运行时，Claude Code 可能修改 IDE 配置文件，而这些文件可能被 IDE 自动执行。这可能在自动编辑模式下带来额外风险，并可能绕过 Claude Code 的 Bash 执行权限提示。
在 JetBrains IDE 中运行 Claude Code 时，建议：
- 对编辑操作使用手动审批模式
- 格外注意确保 Claude 只接收可信的提示词
- 了解 Claude Code 有权限修改哪些文件
如需更多帮助，参见故障排查指南。
下一步阅读
- settings.json 配置指南：权限、默认模型、statusline 和项目配置位置。
- 认证配置：Claude Code 登录失败、API Key 优先级和 OAuth 冲突。
- 桌面应用快速入门：不想在 IDE 终端里工作时，可以改用桌面版 Code 标签页。
- 故障排查指南：IDE 未检测到、WSL 和插件问题。
常见问题
Q: 在 JetBrains IDE 中使用 Claude Code 还需要额外安装 CLI 吗？
是的。JetBrains 插件提供 IDE 集成功能，但底层仍然运行 Claude Code CLI。需要先参考快速上手安装 CLI，再安装 JetBrains 插件。
Q: 在外部终端（不是 IDE 集成终端）中能用 JetBrains 集成功能吗？
可以。在任意外部终端启动 Claude Code 后，输入 /ide 命令即可连接到 JetBrains IDE，激活 Diff 查看、选区上下文共享等所有集成功能。
Q: 远程开发（Remote Development）时插件安装在哪里？
必须安装在远程主机上，通过 Settings → Plugin (Host) 安装，而不是本地客户端机器。本地安装的插件在远程开发模式下不会生效。
Q: IDEA 或 WebStorm 里改了 settings.json，为什么 Claude Code 没变化？
先确认 Claude Code 是从同一个项目根目录启动的，再运行 /status 查看加载的配置来源。如果是外部终端连接 IDE，还要确认外部终端的当前目录和 IDE 打开的项目目录一致。
Q: JetBrains 插件读取 VS Code 扩展的设置吗？
不读取。JetBrains 插件有自己的插件设置；但两者底层都使用 Claude Code，因此会共享项目 CLAUDE.md、.claude/settings.json、MCP、Hooks、Skills 等 Claude Code 配置。