WebStorm / IntelliJ IDEA 中安装与配置 Claude Code 完整教程

JetBrains 系 IDE（IntelliJ IDEA、WebStorm、PyCharm、GoLand、Rider、PhpStorm、CLion、RubyMine 等）共享同一套底层平台，本文写的所有终端、字体、Tool Window 配置在这些 IDE 里操作路径完全一致。下面以 IntelliJ IDEA / WebStorm 为例讲解，其他产品可以无缝照抄。

在 JetBrains IDE 里使用 Claude Code 的方式

JetBrains 自家的 AI Assistant 插件可以做侧边栏聊天和补全，但 Claude Code CLI 走的是另一条路：在 IDE 内置终端里跑一个 Agent 进程，直接读写项目文件、跑 git 操作、跑测试。这种方式的好处是不需要额外插件，跨产品一致。

前置：先在系统层装好 Claude Code CLI

打开任意系统终端（macOS/Linux 终端，Windows 推荐 PowerShell 或 WSL）：

npm install -g @anthropic-ai/claude-code

如果没有 Node.js，先用 nvm 或官方安装包装一个 LTS：

# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

# Windows 请去 nodejs.org 下载安装包，或者使用 WSL

验证：

claude --version
# @anthropic-ai/claude-code@x.x.x

第1步：打开 JetBrains 内置终端

在已经打开项目的 IDE 里，用以下任一方式打开内置终端 Tool Window：

Windows / Linux：Alt + F12
macOS：Option + F12

或者菜单：View → Tool Windows → Terminal。终端默认在项目根目录启动，这是 Claude Code 正确读写项目文件的前提。

第2步：把 Terminal Tool Window 移到右侧

JetBrains 默认把 Terminal 放在底部，但和 Cursor / VS Code 一样，竖屏布局更适合 Claude Code 的输出。

操作方式：

鼠标移到 Terminal Tool Window 的标题栏（写着 Terminal 的那一行）
点击右上角的齿轮图标 ⚙️
选择 View Mode → Right Top 或直接拖动 Tool Window 到右边的 stripe

也可以右键点击 Terminal 标题栏，在 Move to 子菜单中选 Right Top / Right Bottom。

移好后效果是：左边代码、右边 Terminal，IDE 的 Project 视图照常在最左侧。

第3步：设置默认 Shell（关键）

JetBrains 终端的 Shell 配置入口比较深，但配错会直接导致 nvm 不生效、PATH 缺失，所以必须显式设好。

入口：File → Settings → Tools → Terminal（macOS：IntelliJ IDEA → Settings → Tools → Terminal）

关键字段：

字段	说明	推荐值
Shell path	启动哪个 shell	macOS: `/bin/zsh -l`，Linux: `/bin/bash -l`
Start directory	终端启动目录	留空，默认项目根
Shell integration	启用命令检测	勾选
Use Option as Meta key	macOS 选项键	勾选（vim 用户）

关键参数：

macOS： Shell path 写 /bin/zsh，下面的 Shell options 写 -l（login shell）。或者把 path 改成 /bin/zsh -l 也可以。带 -l 才会读取 ~/.zprofile，nvm/Homebrew/Mise 的环境变量才会进来
Linux： Shell path 写 /bin/bash，Shell options 写 -l
Windows： 见下一步

设置完点击 Apply，然后关闭已打开的 Terminal Tool Window 再重开（设置只对新开的终端生效）。

第4步：Windows 上的 Shell 配置

Windows 用 JetBrains 跑 Claude Code 推荐两种 Shell，二选一：

方案 A：WSL（最推荐）

前提：已经装好 WSL2 + Ubuntu。Shell path 填：

C:\Windows\System32\wsl.exe

Shell options 留空。这样新开终端会直接进 WSL 默认发行版，所有 Linux 命令、nvm、claude 都用 Linux 二进制，避开 Windows 路径分隔符的坑。

方案 B：Git Bash

前提：已经装好 Git for Windows。Shell path 填：

C:\Program Files\Git\bin\bash.exe

Shell options 写：

--login -i

Git Bash 提供一个 MSYS2 风格的 POSIX 环境，npm、claude 命令都能跑，但路径转换偶尔会有意外，遇到奇怪报错时优先怀疑是路径问题。

不推荐 PowerShell + Claude Code 这套组合 —— 不是不能跑，而是 ANSI 颜色、信号处理、路径都会有零散小问题。

第5步：配置 Console Font（解决乱码）

Claude Code 输出会用到 Powerline 风格符号、emoji、进度条字符。JetBrains 的终端字体在 Settings 里有专门的 Console Font 配置。

入口：File → Settings → Editor → Color Scheme → Console Font

把 Use console font instead of the default 打勾，然后：

Font family：填 MesloLGS NF、JetBrains Mono 或任意 Nerd Font
Size：14 起步
Line spacing：1.0

JetBrains 自家的 JetBrains Mono 默认就支持大部分字符，但缺 Powerline 图标，所以推荐用 MesloLGS NF —— 提前去 romkatv 的 GitHub release 里下载安装到系统字体目录。

如果输出里仍有方块字符，确认两件事：

Console Font 而不是 Editor Font 改了（这是两个独立设置）
系统层确实安装了字体（macOS 用 Font Book、Windows 装到 C:\Windows\Fonts、Linux 拷到 ~/.local/share/fonts/ 后跑 fc-cache -fv）

第6步：启动 Claude Code

终端、Shell、字体都配好后，在 JetBrains Terminal 里输入：

claude

第一次运行会跳浏览器登录。授权后回到终端，看到 > 提示符就表示可以开始用。

试着输入：

读一下 README.md 并总结这个项目用到的依赖

Claude Code 会读取项目根目录下的 README.md 并给出摘要。

第7步：让 IDE 自动 reload Claude Code 改过的文件

当 Claude Code 改了磁盘上的文件时，JetBrains 默认会检测变化，但有时会弹出 conflict 对话框，挺烦人。建议把以下两项调好：

入口：File → Settings → Appearance & Behavior → System Settings

勾选 Save files automatically if application is idle for X seconds
勾选 Save files when switching to a different application or a built-in terminal
勾选 Synchronize external changes on frame or editor tab activation

最后一个特别关键，确保从外部（CLI）改的文件回到 IDE 能立刻看到。

常见问题排查

问题一：JetBrains 终端里 `claude: command not found`

原因： Shell 没用 login 模式启动，PATH 不完整。或者 Windows 上 npm 全局目录没加到系统 PATH。

排查：

# 先看 PATH
echo $PATH

# 再看 claude 在哪
which claude
# 或 Windows
where claude

# 看 npm 全局目录
npm config get prefix

解决：

macOS / Linux：回到第3步把 Shell options 改成 -l
Windows：把 %APPDATA%\npm（Node 自带 npm 的默认全局目录）加到系统 环境变量 → 用户变量 → PATH，然后重启 IDE（不是关窗口，是退出进程）

问题二：用 nvm 但 Node.js 版本不对

现象： macOS 系统终端里 node -v 是 v20，但 JetBrains 终端里 node: command not found 或版本不对。

原因： nvm 是 shell function，必须由 login shell 加载 ~/.nvm/nvm.sh 才会激活。

解决：

Settings → Tools → Terminal 里 Shell options 必须包含 -l
确认 ~/.zshrc 或 ~/.bashrc 末尾有：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

在 IDE 里关闭所有 Terminal Tool Window 标签，再开一个新终端

如果还不行，临时方案是在终端里手动 nvm use --lts 一次。

问题三：Claude Code 改了文件但 IDE 没刷新

现象： 终端里 Claude Code 显示已经改了 src/main.ts，但 IDE 编辑器里还是旧内容。

原因： IDE 的文件系统监视器没及时拿到事件，或者编辑器有未保存的修改导致冲突。

解决：

第7步里 Synchronize external changes on frame or editor tab activation 必须勾上
主动触发刷新：File → Reload All from Disk（macOS：Cmd + Shift + Option + Y）
文件较多时点 IDE 主窗口标题栏也会触发同步
Linux 上文件监视器有 inotify 上限，大型仓库可能丢事件，调大上限：

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

问题四：Smart Paste / 粘贴时 IDE 干扰 Claude Code 输入

现象： 在 Claude Code 里粘贴一段多行代码，IDE 偷偷加了缩进或转义。

原因： JetBrains 的 Smart Paste 在某些 Shell 集成模式下会渗透到终端粘贴流程。

解决：

Settings → Tools → Terminal 里关掉 Paste Special（如果有）
Settings → Editor → General → Smart Keys 里取消 Smart paste（这会全局生效，看个人偏好）
终极方案：在 Claude Code 提示符上按下 Ctrl + V 之前先按一次 Esc，确保焦点完全在终端进程里

Linux 用户特别注意： 中间键粘贴（X11 selection）和 Ctrl + Shift + V（终端粘贴）走的是两套缓冲区，复制时优先用 Ctrl + Shift + C，粘贴用 Ctrl + Shift + V。

问题五：Console Font 配了但不生效

现象： Settings 里明明改了 Console Font 为 MesloLGS NF，重启后又回到 JetBrains Mono。

排查：

是不是改成了 Editor Font 而不是 Console Font？这俩是两个独立面板
Use console font instead of the default 这个勾必须打上，否则 Console Font 设置不生效
字体名是否完全一致 —— 系统字体里如果叫 MesloLGS Nerd Font，就不能写成 MesloLGS NF
关闭 IDE 完全退出再打开，部分 JetBrains 版本对字体改动需要重启

验证清单

逐条核对：

CLI 可用：JetBrains Terminal 里 claude --version 输出版本号
登录态正常：claude 启动后直接进入 > 提示符
终端在右侧：Terminal Tool Window 已经移到 Right Top
字体正常：Claude Code 启动横幅、图标、进度符号都不是方块
文件同步：让 Claude Code 改一个文件，切回编辑器看到内容自动更新
跨 IDE 一致：同样的配置在 PyCharm / GoLand 等 JetBrains 产品里也能跑通

全部通过，就可以在 JetBrains 全家桶里愉快地用 Claude Code 了。

在 JetBrains IDE 里使用 Claude Code 的方式

前置：先在系统层装好 Claude Code CLI

第1步：打开 JetBrains 内置终端

第2步：把 Terminal Tool Window 移到右侧

第3步：设置默认 Shell（关键）

第4步：Windows 上的 Shell 配置

第5步：配置 Console Font（解决乱码）

第6步：启动 Claude Code

第7步：让 IDE 自动 reload Claude Code 改过的文件

常见问题排查

问题一：JetBrains 终端里 claude: command not found

问题二：用 nvm 但 Node.js 版本不对

问题三：Claude Code 改了文件但 IDE 没刷新

问题四：Smart Paste / 粘贴时 IDE 干扰 Claude Code 输入

问题五：Console Font 配了但不生效

验证清单

相关阅读

问题一：JetBrains 终端里 `claude: command not found`