从零搭建 Windows AI 开发环境：nvm 、Claude Code 与 IDEA 插件配置实录

今天在 Windows 上完整走了一遍 AI 开发环境的搭建流程，从 Node 版本管理到 Claude Code，再到 IDEA 插件源配置，中间踩了不少坑。这篇博客把整个过程和解决方案记录下来，希望能帮到遇到类似问题的朋友。

一、用 nvmd 管理 Node 版本

为什么选 nvmd

传统 nvm 在 Windows 上依赖 Shell 钩子，切换版本时有明显延迟。nvmd（nvm-desktop 的命令行工具）不依赖钩子，支持项目级版本管理，切换速度更快。

安装要点

从 GitHub Releases 下载 nvm-desktop 安装包，Windows 下运行 .exe 即可。安装前务必彻底卸载其他 Node 版本管理工具，并清理相关环境变量，避免路径冲突。

安装后打开客户端，进入设置，把 Node 镜像地址切到国内源，否则版本列表可能加载不出来：

复制代码

https://npmmirror.com/mirrors/node/

环境变量不生效的坑

这是今天遇到的第一个大坑。安装后运行 nvmd list 报错，提示环境变量没配置好。原因是 nvm-desktop 写入环境变量后，已经打开的终端窗口不会自动刷新。

让环境变量立即生效的方法：

CMD 用户直接重新打开窗口，或执行：

cmd 复制代码

echo %PATH%

PowerShell 用户执行：

powershell 复制代码

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

更关键的是 Windows 的 PATH 优先级陷阱 ：系统 PATH 永远优先于用户 PATH。如果之前装过 Node.js，它的路径在系统 PATH 里，会"抢走"优先级，导致 nvmd 的命令被覆盖。解决办法是把 nvmd 的路径（C:\Users\你的用户名\.nvmd\bin）手动加到系统变量的 Path 里，并移到最上面。

二、安装 Claude Code

安装方式

Claude Code 是终端里的 AI 编程助手，需要付费的 Claude 订阅或 Anthropic Console 账户。

考虑到已经配好了 Node 环境，我直接用 npm 安装：

bash 复制代码

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

注意不要加 sudo，否则可能引发权限问题。

官方现在更推荐原生安装脚本，PowerShell 用户可运行：

powershell 复制代码

irm https://claude.ai/install.ps1 | iex

验证与登录

重启终端后运行 claude --version，看到版本号即成功。然后在项目目录下运行 claude，按引导完成登录。

一个 Windows 细节

Claude Code 在 Windows 上执行 shell 命令时，优先找 Git Bash，找不到才用 PowerShell。建议顺手装一个 Git for Windows，兼容性更好。

三、IDEA 插件仓库配置

配置国内镜像

IDEA 插件市场加载慢是常见问题，配置国内镜像可以缓解：

Ctrl + Alt + S 打开 Settings → Plugins
点击齿轮图标 → Manage Plugin Repositories
添加镜像地址，推荐 JetBrains 官方中国区镜像或阿里云合作镜像：
复制代码
```
https://plugins.jetbrains.com.cn
```
用 ↑ 按钮把新镜像移到官方仓库上方，保存重启

"链接失败"的排查

配置完提示链接失败，按以下顺序排查：

浏览器直接访问镜像地址，确认是网络问题还是 IDEA 问题
换源：plugins-cn.jetbrains.com 在部分网络下不稳定，可换 plugins.jetbrains.com.cn
检查代理 ：Settings → HTTP Proxy，先试 No proxy
清缓存重启 ：File → Invalidate Caches and Restart
检查系统时间，偏差过大会导致 TLS 握手失败
兜底：删掉自定义仓库，只用官方源 https://plugins.jetbrains.com

四、关于 Multica

今天还了解了 Multica 这个把 AI 编码助手转变为团队协作者的平台。官网下载地址是：

复制代码

https://multica.ai/download

也可以用 winget 安装：

powershell 复制代码

winget install --id Multica.MulticaDesktop --exact

安装后用注册邮箱登录，桌面应用会自动检测并连接 Claude Code。

总结

今天这套流程走下来，最大的感受是 Windows 环境变量是万恶之源。无论是 nvmd 的 PATH 优先级问题，还是 npm 全局目录没加进 PATH，本质都是环境变量在作祟。遇到命令找不到、版本不对，第一反应应该是检查 PATH。

另一个经验是：国内网络环境下，镜像源的选择比配置本身更重要。npmmirror、JetBrains 中国镜像这些源，稳定性和连通性直接决定体验。

希望这篇记录能帮到同样在 Windows 上折腾 AI 开发环境的朋友。