09 · JetBrains 集成系列导航上一篇 08 VS Code 集成 把 Claude Code 搬进了 VS Code。这一篇换个阵营——如果你的主力是 IntelliJ IDEA、PyCharm、WebStorm 这类 JetBrains 全家桶同样有原生插件玩法既像又不像。下一篇 10 桌面 app。A「我天天泡在 PyCharm 里VS Code 那套扩展跟我没关系吧」B「有原生插件装一下CmdEsc就能从编辑器里把 Claude 叫出来。」A「那它跟 VS Code 扩展是一回事diff、提及那些都有」B「内核是同一个 CLI但界面不是同一拨人做的——有些地方一样有些地方你得换个姿势。比如它默认是跑在 IDE 自带终端里的不是一个独立面板。」这是用 GoLand 写后端的人常有的疑问很典型JetBrains 用户总担心自己是「二等公民」好东西都先给 VS Code。说句实话这担心一半对一半不对。对的地方JetBrains 插件确实比 VS Code 扩展更轻它是把 CLI 跟 IDE 接通、让信息在两边流动而不是做一个大而全的图形面板。不对的地方该有的核心体验一个没少。这一篇就讲清楚怎么装、怎么连、和 VS Code 比差在哪、JetBrains 专属的几个坑ESC 键、WSL、远程开发怎么填。看完这一篇你会拿到在 IntelliJ / PyCharm / WebStorm 等 JetBrains IDE 里装好 Claude Code 插件的完整步骤「IDE 内置终端」和「外部终端/ide」两种连接方式分别什么时候用一张「JetBrains 插件 vs VS Code 扩展」的对照表外加 JetBrains 专属快捷键ESC 键中断失灵、WSL2「检测不到 IDE」、远程开发这三个高频坑的官方解法01 先理清楚插件到底做了什么很多人装完插件一脸懵「我装了插件怎么没看到一个像 VS Code 那样的聊天面板」先给结论JetBrains 插件不是一个独立的聊天窗口它是一座「桥」。Claude Code 本体还是那个跑在终端里的 CLI插件干的活是把 IDE 和 CLI 接通——你在编辑器里选中的代码、IDE 报的 lint 错误、Claude 想做的改动能在「IDE」和「终端里的 Claude」之间自动来回传。类比手机和电脑之间的隔空投送AirDrop。文件、剪贴板本来各待各的设备上开了隔空投送两台设备就「认识」了——电脑上复制手机上直接粘。插件就是 IDE 和 Claude 之间的这条通道你在 PyCharm 里选中一段代码终端里的 Claude 立刻就「看见」了不用复制粘贴。所以有个关键认知在 JetBrains 里你跟 Claude 对话的地方是 IDE 自带的集成终端——不是一个新开的侧边面板。这是和 VS Code 最大的体感差异VS Code 扩展给你一个图形对话面板JetBrains 则让你在内置终端里跑claude插件在背后喂上下文。对话在终端、diff 弹到 IDE 原生查看器两边好处都占着而且几乎零学习成本——命令、快捷键、/斜杠命令全是终端那一套。第一次在 IntelliJ 装插件本来还会担心要重新适应界面结果发现就是熟悉的那个终端 Claude只是它突然「长了眼睛」能看到你选了什么、IDE 标红了哪里。 一句话总结JetBrains 插件是 IDE 和 CLI 之间的「隔空投送」对话在内置终端里发生、diff 弹进 IDE不是一个独立聊天面板。02 支持哪些 IDE先对个号JetBrains 是一整个家族不是单个软件。好消息是Claude Code 插件覆盖了主流的几乎全部。官方明确列出的支持名单IDE主要语言 / 场景IntelliJ IDEAJava / Kotlin后端、Android 老本行PyCharmPython数据、AI、脚本WebStorm前端 JS / TSPhpStormPHPGoLandGoAndroid Studio安卓开发基于 IntelliJ官方说法是「适用于大多数JetBrains IDE」——名单外的 JetBrains IDERubyMine、CLion、Rider 等大概率也能用但官方没背书能装上就用、出问题以「未明确支持」对待。类比同一品牌的不同车型共用一套车机系统。IntelliJ、PyCharm、WebStorm 就像同厂家的轿车、SUV、跑车定位不同但底层是同一个平台都构建在 IntelliJ Platform 上。所以一个插件通吃这篇里所有操作步骤不管你用 IntelliJ 还是 GoLand菜单路径都一致。下面演示用 PyCharm。一个 Claude Code 插件通吃所有 JetBrains IDE因为它们共用 IntelliJ 平台底座上图把这层关系画清楚了最上面的 Claude Code 插件只有一个向下扇出适配每个 IDE而 IntelliJ IDEA、PyCharm、WebStorm 等虽各管一门语言却都坐在同一个 IntelliJ Platform 底座上——所以一个插件装一次处处能用安装配置步骤也处处一致。 一句话总结主流 JetBrains IDE 都支持它们共用同一个 IntelliJ 平台底座——安装和配置步骤在哪个 IDE 里都一模一样。03 安装插件 CLI缺一不可这步最容易出岔子因为JetBrains 集成需要两样东西都到位插件和 Claude Code CLI 本体少哪个都不行。类比手机 App 后台账号。装了 App插件却没注册后台账号CLI打开就是个空壳——插件负责界面集成真正干活的「后台」是 CLI。所以装插件前先确认 CLI 在。第一步先确认 CLI 装好了跟着这个系列从头读的话第 02 篇就装好 CLI 了。不确定就在任意终端跑claude --version预期输出打印出一串版本号类似2.x.x (Claude Code)。如果提示command not found说明 CLI 还没装。回到 02 安装 那篇装一下或者用官方安装命令分平台# macOS / Linux / WSLcurl -fsSL https://claude.ai/install.sh | bash# Windows PowerShellirm https://claude.ai/install.ps1 | iex国内提示安装 CLI、之后的登录授权、以及让 Claude 干活全程都要连 Anthropic 的服务需要访问国外网站。这点和终端版、VS Code 版都一致。第二步装 JetBrains 插件两条路都能走推荐第一条。方式一IDE 里搜推荐打开你的 JetBrains IDE进Settings设置→ Plugins插件Mac 快捷键Cmd,Windows/LinuxCtrlAltS切到Marketplace市场标签搜索Claude Code点Install安装装完务必重启 IDE方式二去插件市场官网装直接访问 JetBrains 插件市场的 Claude Code 页面按页面指引安装。注意插件名带[Beta]后缀——说明它还在 Beta 阶段行为可能随版本变化以官方文档为准。功能能用但别当板上钉钉的稳定版。第三步重启 IDE别跳过官方专门强调了一句安装插件后你可能需要完全重启 IDE 才能让它生效。「完全重启」是彻底退出再打开不是关个窗口。这个坑很容易栽进去——装完在 IDE 里跑claude集成功能死活不激活以为插件坏了彻底退出 IntelliJ 重开一切正常。这坑官方也列在「插件不工作」排查第一条足见多常见。代码语言javascriptAI代码解释先 claude --version 确认 CLI 在 一句话总结JetBrains 集成 CLI 本体 插件两样都要装装完一定完全重启 IDE这是最高频的「装了不生效」原因。04 连接两种姿势看你从哪启动插件装好、IDE 重启完下一步是把 Claude Code 跟 IDE「连上」。连上后选区共享、diff 弹进 IDE、诊断共享才会激活。连接方式取决于你从哪里启动 Claude。姿势一从 IDE 内置终端启动推荐自动连最省事。打开 IDE 自带的集成终端一般在底部有个Terminal标签页直接跑claude预期Claude Code 启动所有集成功能自动激活不用任何手动连接动作。因为你在 IDE 的「肚子里」启动插件天然知道该跟哪个 IDE 接通。类比在自家客厅连 Wi-Fi。在家里打开手机自动连上不用输密码。内置终端启动 Claude 就是这体验——环境对了连接自动完成。姿势二从外部终端启动用/ide手动连如果你习惯用 iTerm、Windows Terminal 这类独立终端那就先启动 Claude再手动接通claude然后在 Claude 对话里输入/ide预期Claude 列出检测到的 JetBrains IDE选中对应的那个连接建立、功能激活。类比在别人家连 Wi-Fi得手动选网络——/ide就是这个动作。一个容易忽略的前提从项目根目录启动不管哪种姿势官方都强调如果你希望 Claude 能访问和 IDE 相同的文件请从与 IDE 项目根目录相同的目录启动 Claude Code。说白了IDE 打开的是哪个项目就在那个项目的根目录下启动claude。在~/Downloads这种目录启动Claude 看到的文件就和 IDE 里的项目对不上号了。用内置终端启动天然满足这点——这也是推荐姿势一的另一个原因。启动来源连接方式项目目录IDE 内置终端自动激活无需操作默认就在项目根目录 ✅外部终端iTerm 等手动跑 /ide 选 IDE需自己 cd 到项目根目录一般全程用 IDE 内置终端就够了——连接自动完成、目录天然对齐、终端和代码同窗口CmdEsc一按就在两者间跳。除非手头已经开着外部终端在跑别的才用/ide临时接一下。 一句话总结IDE 内置终端启动 自动连、目录天然对齐推荐外部终端启动 跑/ide手动连。无论哪种都从项目根目录启动。05 它能干什么五个集成功能连上之后插件给的「增益」官方列了五个逐一说重点看和 VS Code 的差异汇总看本节末的对照表。① 快速启动编辑器里按CmdEscMac/CtrlEscWindows/Linux直接打开 Claude也可点 UI 里的按钮。这个用得最勤——写着代码想问一句不用鼠标点终端标签一个快捷键焦点就过去了。② 选区上下文共享IDE 里当前选中的代码、或打开的标签页自动共享给 Claude。选中一段问「这段为什么报错」它知道你指哪段。③ 文件引用快捷键按CmdOptionKMac/AltCtrlKLinux/Windows插入一条文件引用形如src/auth.ts#L1-99带路径和行号让 Claude 精确定位。④ Diff 查看代码改动直接在 IDE 的 diff 查看器里展示而非终端里用文本符号画默认不一定开得设auto下节讲。⑤ 诊断共享IDE 的 lint 警告、语法错误那些红线黄线自动共享给 Claude它能直接「看到」标红了哪里不用你复述报错。两个安全 / 易错点单独拎出来⚠️安全和 VS Code 一致如果文件命中你设的 Read 拒绝规则它的选区共享会被拦住、不发给 Claude以官方文档为准。.env这类敏感文件建议加上。 ⚠️易错文件引用快捷键和 VS Code 不一样——VS Code 是OptionK/AltKJetBrains 多一个键是CmdOptionK/AltCtrlK从 VS Code 切过来最容易按错。诊断共享这点体会最深。JetBrains 的代码检查本就是业界最强之一——搁以前得把标红的报错复制给终端 Claude现在它直接读得到。比如 PyCharm 标了一个「未使用的导入」加几个类型不匹配的黄线只说一句「把 IDE 标出来的问题修一下」它就照着诊断一条条修了不用你贴一行报错。集成功能JetBrainsVS Code备注快速启动Cmd/CtrlEscCmd/CtrlEsc一致选区 / 标签共享✅ 自动✅ 自动一致文件引用快捷键CmdOptionK / AltCtrlKOptionK / AltK不同Diff 弹进 IDE✅需设 auto✅一致诊断共享✅ 自动✅ 自动一致对话界面形态IDE 内置终端独立图形面板核心差异 一句话总结五大增益里选区共享、诊断共享、diff 弹进 IDE 和 VS Code 基本一致最大差异是对话跑在内置终端还有文件引用快捷键多按一个键。06 配置把 diff 调出来再调插件装好连上还不够有两处配置值得花两分钟调一下体验差很多。配置一把 diff 工具设成auto重要前面说过 diff 能弹进 IDE但这取决于一个配置项。在 Claude Code 里跑/config找到 diff 工具diff tool设为auto/config取值效果auto改动在 IDE 的 diff 查看器里并排显示推荐terminal改动留在终端里用文本符号画这里强烈建议设auto——既然用了 IDE就把 JetBrains 那个好用的并排 diff 视图利用起来终端文本 diff 在改动一多时真费眼。配置二插件设置Settings → Tools → Claude Code [Beta]插件本身的设置藏在Settings → Tools → Claude Code [Beta]里。几个值得知道的Claude commandClaude 命令路径默认claude如果你的claude不在标准 PATH 里可填绝对路径如/usr/local/bin/claude或npx anthropic-ai/claude-code。点 Claude 图标提示「command not found」时多半就是这里要配。抑制「Claude 命令未找到」的通知嫌提示烦可以关掉。启用 OptionEnter 多行输入仅 macOS开启后提示框里OptionEnter插入换行。Option 键被意外捕获、影响打字就关掉它改完需重启终端。启用自动更新自动检查并安装插件更新重启时应用。这几项里最该记的是最上面那行Claude command路径——点 Claude 图标报「command not found」十有八九就是它要配。 WSL 用户特别注意把 Claude 命令设成wsl -d Ubuntu -- bash -lic claude把Ubuntu换成你的 WSL 发行版名。 一句话总结进 Claude Code 跑/config把 diff 设成auto再去Settings → Tools → Claude Code [Beta]调插件——其中Claude command 路径是排查「命令未找到」的关键。07 JetBrains 用户专属的三个坑下面这三个坑是 JetBrains 用户比 VS Code 用户更容易撞上的官方单独列了解法。坑一ESC 键中断失灵JetBrains 终端有个老毛病你想按ESC中断 Claude 正在跑的操作结果焦点「啪」一下跳到编辑器去了操作没断成。原因是它默认把ESC绑成了「把焦点移到编辑器」。解法进Settings → Tools → Terminal二选一取消勾选「使用 Escape 将焦点移动到编辑器」Move focus to the editor with Escape或点「配置终端快捷键」删掉「切换焦点到编辑器」Switch focus to Editor这个绑定应用更改改完ESC就能正常中断了。强烈建议装完就顺手改掉——不然某次 Claude 跑飞了你想叫停按ESC没反应那一下是真急。坑二WSL2 提示「未检测到可用的 IDE」在 WSL2 上用 Claude Code JetBrains IDE跑/ide经常报「No available IDEs detected」。根因不是插件坏了而是 WSL2 的 NAT 网络或 Windows 防火墙把「WSL2 里的 Claude」和「Windows 上的 IDE」的连接挡了WSL1 不受影响。官方给了两个方案推荐方案一放行防火墙因为它不动现有网络模式# 第一步在 WSL shell 里查 IPhostname -I# 假设输出 172.21.123.45记下子网 172.21.0.0/16# 第二步以管理员身份开 PowerShell建防火墙规则IP 范围按你的子网改New-NetFirewallRule -DisplayName Allow WSL2 Internal Traffic -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16然后重启 IDE 和 Claude Code让规则生效。方案二是把 WSL2 切成「镜像网络」需 Windows 11 22H2 或更高在 Windows 用户目录的.wslconfig里加[wsl2]段、设networkingModemirrored再wsl --shutdown重启。用 Windows 10 的别折腾镜像网络直接用方案一。坑三远程开发插件得装在「远程主机」如果你用 JetBrains 的远程开发Remote Development——本地客户端连到远程服务器写代码——有个反直觉的点插件必须装在「远程主机」上不是装在你本地的客户端机器上。安装路径是Settings → Plugin (Host)。常见的翻车是在本地客户端装了插件怎么都连不上折腾半天才发现装错地方。记住Claude 实际在哪台机器干活插件就装哪台。远程开发里干活的是远程主机插件就归它。坑一句话解法ESC 不能中断Settings → Tools → Terminal取消「Escape 移焦点到编辑器」WSL2 检测不到 IDE放行 Windows 防火墙推荐或切镜像网络然后重启远程开发连不上插件装在远程主机Settings → Plugin (Host)不是本地客户端 一句话总结ESC 失灵改终端快捷键、WSL2 检测不到放行防火墙、远程开发插件装远程主机——这三个是 JetBrains 专属高频坑装完顺手把 ESC 那个改掉。08 动手环节10 分钟在 JetBrains 里跑通全流程下面这套从零走一遍每步都给了「你该看到什么」照着做就能自验。用 PyCharm 演示其他 JetBrains IDE 步骤完全一样。第 0 步确认 CLI 在—— 跑claude --version预期打印版本号如2.x.x (Claude Code)报command not found就先回 02 安装。第 1 步装插件并重启—— PyCharm → Settings → Plugins → Marketplace搜Claude Code→ Install完全退出 PyCharm 再重开。预期重启后 Settings → Tools 下能看到Claude Code [Beta]。第 2 步建个最小练手项目—— 新建文件demo.pydefgreet(name):returnHello nameprint(greet(world))第 3 步从 IDE 内置终端启动 Claude—— 打开 PyCharm 底部的Terminal标签跑claude。预期集成功能自动激活内置终端启动无需/ide首次会引导你登录 Anthropic 账户浏览器完成授权。第 4 步把 diff 设成auto—— 在 Claude 里跑/config把 diff 工具设为auto这样下一步改动会弹进 PyCharm 的 diff 查看器。第 5 步选中代码 提问验证选区共享在编辑器里选中greet函数那两行回到 Claude 终端输入这段选中的函数有什么可以改进的地方预期Claude 基于你选中的两行作答可能建议用 f-string、加类型注解——它没反问你「哪个函数」说明选区共享生效了。这是验证「隔空投送」通没通的关键一步。第 6 步让它改看 diff 弹进 IDE接着输入帮我把它改成用 f-string并加上类型注解预期因为上一步设了auto改动在 PyCharm 的 diff 查看器里并排显示——左边原始return Hello name右边改后return fHello {name}签名也加了类型注解。看清楚了再接受。跑到这步插件装好、CLI 连通、选区共享、diff 弹进 IDE 这四件核心你就都验过一遍了。要是第 5 步它反问你哪个函数、或第 6 步 diff 没弹进 IDE回头按第 03、04、06 节查。09 小结这一篇把 Claude Code 装进了 JetBrains 全家桶核心就这几件事插件是「桥」不是「面板」它把 IDE 和 CLI 接通对话跑在 IDE 内置终端、diff 弹进 IDE 原生查看器不像 VS Code 给你一个独立聊天面板。装要装两样CLI 本体 插件缺一不可装完一定完全重启 IDE这是最高频的「装了不生效」原因。连有两种姿势IDE 内置终端启动自动连推荐、外部终端跑/ide手动连都从项目根目录启动。三个专属坑ESC 中断失灵改终端快捷键、WSL2 检测不到 IDE放行防火墙、远程开发插件装远程主机。你现在应该能在自己的 JetBrains IDE 里独立装好插件、把 Claude 和 IDE 连通、用选区共享把上下文喂准、让改动弹进 IDE 的 diff 查看器审阅。JetBrains 用户不是二等公民——该有的核心体验一个没少。到这里VS Code 和 JetBrains 两大 IDE 阵营都覆盖了。它们的共同点是都要先有一个 IDE再把 Claude 接进去。那如果你压根不想开 IDE只想要一个独立的、开箱即用的 Claude 客户端呢下一篇10 桌面 appDesktop——Claude Code 还有个独立的桌面应用不依附任何编辑器双击就能用。我们看看它适合什么人、和 IDE 集成版怎么取舍以及它有哪些 IDE 版给不了的便利。