最近好几个朋友私信问的是同一件事：Windows 下怎么把 Claude Code 装起来。其实很多人看到别人在终端里敲几行命令就能让 AI 帮忙改代码，第一反应都是“去官网下载一个客户端”，结果真正开始研究才发现，这东西没有一个像样的 .exe 安装包入口，折腾半天还卡在第一步。我当初在 Windows 上第一次跑通 Claude Code 也绕了不少弯路，这次就把完整过程、每一条命令、终端输出和踩坑点全部整理出来。这篇不是真的贴满截图，但会把关键画面用文字还原，你照着终端输出对号入座就能走通。

先说结论：Claude Code 是一个跑在终端里的 AI 编程助手，不是传统意义的图形软件。Windows 原生想把它装好，真正依赖的其实是 Node.js、npm、PowerShell/Windows Terminal 这一套基础环境。搞清楚这个前提，后面所有问题都会变得简单。

如果你已经有能正常登录的 Claude 或 Anthropic API 账号，并且能在本地终端执行命令，那么这篇内容只围绕一件事：让 Claude Code 稳定跑在 Windows 上，并且装完后知道怎么配置、怎么排错、怎么把它接入日常开发流程。新手建议从前往后读，老手可以直接跳到安装命令和报错对照部分。

1. 安装之前先理清这三件事：终端、Node.js 和 Git

1.1 为什么 Claude Code 不是“下个 exe 双击安装”

Claude Code 本质上是一个 Node.js 命令行程序，官方通过 npm 仓库发布，名字叫 @anthropic-ai/claude-code。安装后它在终端里启动自己的交互界面，支持多行输入、斜杠命令、实时流式输出，甚至能直接操作你的文件系统，前提是它运行在某个项目目录下。

这对长期使用图形界面的人来说有点反直觉。你可以把它理解成“买回家需要自己组装的工具架”，而不是“开箱即用的电饭煲”。想让它工作，必须先有底座：Node.js 运行时、npm 包管理器、一个趁手的终端。Git 不是 Claude Code 运行时的硬性依赖，但只要你想让它在真实项目里干活，基本离不开 Git，所以我会建议一起装掉。

1.2 Node.js 版本怎么选才够稳

Claude Code 对 Node.js 有版本要求，理论上满足 18 以上就能跑，但我实际测试下来最省心的版本是 20 LTS。18 不是不行，只是部分较新的 CLI 功能或依赖包在 18 上偶尔会出现小毛病；22 也可以，但如果不是追求新特性，没必要在环境层面给自己增加变量。

Windows 上安装 Node.js 最省事的方式是直接用 winget，在终端里输入下面命令：

powershell复制winget install OpenJS.NodeJS.LTS

这行命令会安装当前最新的 Node.js LTS 版本。如果你更习惯图形化安装，也可以去官网下载 .msi 安装包，一路 Next，默认配置即可。这里有个容易踩的坑：安装完 Node.js 以后，如果你是在同一个旧终端窗口里继续输入 node -v，很可能会提示找不到命令。这不是没装成功，而是终端的环境变量是在启动时读取的，旧窗口不会自动刷新 PATH，随便打开一个新的终端窗口再执行就正常了。

安装完成后，建议先验证版本：

powershell复制node -v
npm -v

我的输出分别是 v20.18.0 和 10.8.2，如果你系统里 npm 版本比较老，可以先升级一下 npm 本身：

powershell复制npm install -g npm@10

1.3 终端：Windows Terminal 和 PowerShell 选哪个

很多教程默认你用的是 CMD，但 Claude Code 的交互界面在 CMD 里虽然能跑，显示效果不太行，对 ANSI 颜色和 Unicode 符号支持都一般。Windows 自带的 PowerShell 5.1 也能用，但我更推荐先装 Windows Terminal，让日常操作舒服很多。

powershell复制winget install Microsoft.WindowsTerminal

Windows Terminal 不是 Claude Code 的必需品，但它提供的等宽字体渲染、Ctrl+C / Ctrl+V 快捷键、多标签页、自动换行，都会让长时间在终端里聊天和改代码的体验完全不一样。如果你暂时不想装，直接打开 PowerShell 也能继续下面的安装。

2. 安装方式横向对比：我为什么把 npm 当作主路线

2.1 三种能跑通的安装方式与各自的适用人群

Claude Code 的安装方式不止一种。我在 Windows 上实际试过三条路线：npm 全局安装、PowerShell 远程脚本安装、在 WSL 里按 Linux 方式安装。三条线都能跑通，但体验和前置条件差别不小。