WebStorm / IntelliJ IDEA 中使用 Claude Code：安装与配置完整教程
在 WebStorm、IntelliJ IDEA、PyCharm 等 JetBrains 全家桶中安装 Claude Code CLI、配置内置终端、与 AI Assistant 共存使用的完整教程。
JetBrains 全系列 IDE（WebStorm、IntelliJ IDEA、PyCharm、GoLand、Rider、CLion、RubyMine、PhpStorm、DataGrip）都基于同一个 IntelliJ 平台，所以在任何一个里跑 Claude Code 的方法都一样。本文以 WebStorm 为例演示，其他 JetBrains IDE 步骤完全一致，只是菜单名前缀不同。
三种使用方式对比
| 内置终端 + CLI | JetBrains AI Assistant | 第三方插件 | |
|---|---|---|---|
| 安装 | 装 CLI，无需插件 | IDE 内启用，需订阅 | Marketplace 装 |
| 后端模型 | Anthropic 官方 | OpenAI / Anthropic | 看插件 |
| 计费 | Anthropic 账户 | JetBrains AI Pro 订阅 | 看插件 |
| 修改文件 | 终端 unified diff | IDE 内嵌 Diff | 看插件 |
| 推荐度 | ⭐⭐⭐⭐⭐ 最稳定 | ⭐⭐⭐ 与编辑器深度集成 | ⭐⭐ 体验不一致 |
本文重点讲第一种——在 JetBrains 内置终端跑 claude，不依赖任何插件，所有功能等价于在系统终端运行。
前置：安装 Claude Code CLI
JetBrains 不像 VS Code 有官方扩展，唯一的方法就是先在系统层面装好 CLI。在系统终端（不是 JetBrains 内）跑：
# 检查 Node.js 版本（要求 18+）
node --version
# 全局安装
npm install -g @anthropic-ai/claude-code
# 验证
claude --version
Windows 用户特别注意：JetBrains 的内置终端在 Windows 上默认走 cmd.exe，npm 装的全局命令不一定立即可用，建议改成 Git Bash 或 WSL（下文会讲）。
在 JetBrains 内置终端启动 Claude Code
第1步：打开内置终端
JetBrains 的终端快捷键不像 VS Code 那么直观：
- Windows / Linux：
Alt + F12 - macOS：
Option + F12
或者菜单栏：View → Tool Windows → Terminal。
也可以在底部 Tool Window 的图标栏点 Terminal 标签（默认在底部最左边）。
第2步：运行 claude
claude
第一次启动会要求登录，浏览器自动打开 Anthropic 授权页面。授权后命令行自动接到 token。
第3步：把终端移到右侧
JetBrains 默认的终端在底部，宽度同样太窄。
操作： 右键点击 Terminal 工具窗口的标题栏，选择 Move to → Right。
或者点击 Terminal 标签页右上角的齿轮图标（Settings），选择 Move to → Right Top / Right Bottom。
JetBrains 的 Tool Window 比 VS Code 灵活——可以拆出 Right Top 和 Right Bottom 两个独立区域，把项目浏览器放 Right Top，把 Claude Code 终端放 Right Bottom，左边一整列代码，效率很高。
设置默认 Shell
打开 File → Settings（macOS：WebStorm → Preferences），导航到：
Tools → Terminal
里面有几个关键配置：
Shell Path
默认终端使用的 Shell。常见配置：
| 系统 | 推荐 Shell Path |
|---|---|
| macOS | /bin/zsh 或 /opt/homebrew/bin/fish |
| Linux | /bin/bash 或 /usr/bin/zsh |
| Windows（WSL） | wsl.exe |
| Windows（Git Bash） | C:\Program Files\Git\bin\bash.exe |
| Windows（PowerShell） | powershell.exe |
Windows 用户强烈推荐： 改成 WSL 或 Git Bash。原生 cmd 跑 npm 全局命令经常出 PATH 问题，npm 装的 claude.cmd 路径需要手动加到环境变量。
启动目录
勾选 Start directory: Project root 让终端默认在项目根目录开。
复制粘贴
勾选 Override IDE shortcuts 后，Ctrl+C / Ctrl+V 在终端里就是复制粘贴而不是 IDE 自己的快捷键，对 Claude Code 交互很重要——Ctrl+C 是 Claude Code 中断当前任务的关键操作。
完整的推荐 Tools → Terminal 设置截图复制不出来，但关键字段如下：
Shell path: C:\Program Files\Git\bin\bash.exe (Windows 例子)
Start directory: Project root
Application Settings:
[v] Audible bell
[v] Close session when it ends
[v] Mouse reporting
[v] Copy to clipboard on selection
[v] Paste on middle mouse button click
Project Settings:
[v] Use Option as Meta key (macOS only)
配置字体（避免符号乱码）
Claude Code 用的进度条和图标在 JetBrains 默认字体下经常乱码。
Console Font 设置位置
File → Settings → Editor → Color Scheme → Console Font
推荐字体：
| 字体 | 特点 | 下载 |
|---|---|---|
| JetBrains Mono | JetBrains 官方字体，免费，自带连字 | 内置 |
| DejaVu Sans Mono | Linux 默认，符号覆盖广 | Linux 自带 |
| MesloLGS NF | 含 Powerline 字符，进度条最完整 | 需手动下载 |
| FiraCode Nerd Font | 漂亮的连字 + Nerd Font 图标 | 需手动下载 |
推荐配置：
Font: MesloLGS NF
Size: 13
Line height: 1.2
[v] Show ligatures
Fallback font: JetBrains Mono
Fallback font 很关键 —— 主字体不支持的字符会自动从 Fallback 字体取，避免方块。
单独的 Terminal 字体
JetBrains 区分 Editor / Console / Terminal 三套字体设置。Editor → Color Scheme → Console Font 控制运行窗口的字体；终端字体在：
File → Settings → Editor → Color Scheme → Console Font
同时勾选 Use console font instead of the default 才会生效。
与 AI Assistant 共存
JetBrains 自家的 AI Assistant（需 JetBrains AI Pro 订阅）是装到 IDE 里的插件，提供：
- 代码补全建议（行内提示）
- 右键 → AI Actions → Explain code / Refactor / Generate test
- 工具栏的 AI Chat 面板
它和 Claude Code CLI 完全独立，两者可以同时工作：
- AI Assistant 解决「写代码时」的辅助：补全、解释、单文件重构
- Claude Code CLI 解决「跨文件 / 跑命令 / Agent 任务」：批量改、跑测试、git 操作
冲突点： 都会修改文件。建议工作流：
- 用 AI Assistant 补全和写小段代码（保留 IDE 内嵌 Diff 体验）
- 写完一段保存（
Ctrl+S） - 切到终端用 Claude Code 跑跨文件任务、跑测试
- Claude Code 修改完之后 IDE 会自动检测文件变化提示 reload
JetBrains 的文件监视机制比 VS Code 严格，Claude Code 改文件时如果 IDE 这边有未保存的改动会冲突，记得改之前先保存。
常见问题排查
问题一：Windows JetBrains 终端里 claude 命令找不到
现象： Windows 系统 Terminal 里能跑 claude，但 WebStorm 里报 'claude' is not recognized。
原因： WebStorm 默认 Shell 是 cmd.exe，npm 装的 claude.cmd 在 %APPDATA%\npm 下，这个路径在 cmd 里需要在 PATH 中。
解决方案 A（推荐）： 改用 Git Bash 或 WSL。
Settings → Tools → Terminal → Shell path 改成：
C:\Program Files\Git\bin\bash.exe
或者 WSL：
wsl.exe
重启终端就能找到 claude 命令。
解决方案 B（保留 cmd）： 把 npm 全局路径加到系统环境变量：
%APPDATA%\npm
加完后重启 WebStorm（不是关闭重开终端，要完全重启 IDE）才会生效。
问题二：macOS 上用 nvm，JetBrains 终端识别不到 node
现象： node --version 在系统终端里能跑，JetBrains 里报错。
原因： JetBrains 终端可能没有以 login shell 启动，nvm 的初始化脚本不会跑。
解决： Settings → Tools → Terminal → Shell path 改成：
/bin/zsh -l
-l 参数让 zsh 以 login shell 启动，会加载 ~/.zprofile 和 ~/.zshrc，nvm 才会初始化。
问题三：终端字体配置改了不生效
现象： 改了 Editor → Color Scheme → Console Font，终端字体还是老样子。
解决： 必须勾选 Use console font instead of the default。如果还不行，重启 IDE。
问题四：终端里粘贴 Claude Code 给的多行代码出现奇怪格式
现象： Claude Code 给一段长代码，复制到 IDE 编辑器里粘贴出现莫名缩进或格式错乱。
原因： IDE 的「Smart Paste」功能在自动调整缩进。
解决： Settings → Editor → General → Smart Keys 里把 Reformat on paste 改成 None 或 Indent block。
问题五：Claude Code 改了文件，IDE 里看不到更新
现象： Claude Code 在终端里说改完了，但 IDE 编辑器还是旧内容。
解决： JetBrains 默认有文件监视，但有时候网络盘或 WSL 下面会失效。手动触发：File → Reload All from Disk（Ctrl+Alt+Y / Cmd+Option+Y）。
如果经常出现，开启 Settings → Appearance & Behavior → System Settings → Synchronize external changes when switching to the IDE window。
与 VS Code 对比表
| 维度 | VS Code | JetBrains（WebStorm 等） |
|---|---|---|
| 终端快捷键 | Ctrl/Cmd + ` | Alt+F12 / Option+F12 |
| 官方 Claude Code 扩展 | 有 | 无（只能用终端 CLI） |
| 默认 Shell（Windows） | 走系统默认 | 默认 cmd，建议改 Git Bash |
| 内置 AI | 无（要装 Copilot 等） | AI Assistant（需订阅） |
| 文件监视刷新 | 自动且及时 | 通常自动，偶尔要手动 reload |
| 终端配置粒度 | 简单 | 细致（区分 Editor/Console/Terminal） |
| 内存占用 | 较轻 | 较重（IDE 自身索引服务） |
| 适合场景 | 通用前端、轻量后端 | 大型项目、强类型语言（Java、Kotlin、Go） |
简短结论： JetBrains 系列没有 Claude Code 官方扩展，纯靠终端 CLI，所以在 JetBrains 里用 Claude Code = 在内置终端跑 claude。优势是 JetBrains 的项目索引、重构能力强，配合 Claude Code 的 Agent 跑跨文件任务非常顺。
验证全部配置完成
1. 验证 CLI 在 JetBrains 终端里可用
claude --version
2. 验证字体没有乱码
在终端里跑：
claude
启动界面里的进度条、图标如果显示正常（不是方块或问号），字体配置就 OK。
3. 测试一个 Agent 任务
让 Claude Code 跑一个跨文件的小任务，比如：
扫描整个项目里所有的 console.log，列出文件名和行号
如果能正确扫描并返回结果，说明 Claude Code 可以正常读取项目文件，全部配置完成。