焕德很多写代码的朋友应该都有这种感觉：工具链越来越重，IDE 越来越臃肿，但真正想解决一个具体问题时，反而要在菜单里翻半天。Claude Code 这种跑在终端里的 AI 编程代理，正好戳中了这个痛点——它不跟你抢编辑器，不搞花哨界面，直接在命令行里读你的项目代码、改文件、跑命令、提交代码，像雇了一个随叫随到的结对程序员。这篇文章是给 Windows 用户写的，我把自己从零开始安装、配置、跑通第一个任务的完整过程，踩过的坑、绕过的弯，全记录在这里。不管你是刚接触终端命令的新手，还是用惯了 Linux/macOS 的老手想看看 Windows 上怎么玩，照着走一遍应该都能跑起来。
先说清楚它能干什么：你给它一个任务，比如“把这个接口的单元测试补全”，它会自己翻项目结构、读相关文件、生成或修改代码、运行测试，然后告诉你改了什么、下一步建议做什么。整个过程在终端里完成，既能直接接管，也能每步确认。它不是 IDE 插件那种“补全代码”的层次，而是真正理解项目上下文的编码 Agent。
适合谁来参考？用 Windows 做开发、又想体验 AI 编程代理的人，工作上需要在多台 Windows 机器快速部署环境的人，以及踩了一堆错正准备放弃的人。这篇不是官方文档的翻译，是我实际装完、用起来之后，按顺序整理的一份可复现清单。
1. 安装前的环境准备
1.1 检查 Windows 版本与权限
先把底座弄明白。Claude Code 官方支持 Windows 10/11，但我实际测下来，Windows 11 的体验最顺，Windows 10 旧版本偶尔会在终端交互和文件监听上有小毛病。建议先确认几个前提：
- 系统版本尽量新，Windows 10 也至少是 22H2 之后的版本
- 建议使用 Windows Terminal，而不是老旧的 conhost 窗口
- 安装过程需要管理员权限，但日常使用普通权限就行
- 磁盘剩余空间至少 2GB（Node.js 运行时 + 缓存 + 项目环境留出余量）
权限这块有个容易忽略的点：如果你用的是公司统一分发的电脑，可能有软件安装策略限制，npm 全局安装目录会被重定向，装完命令找不到。这时候优先检查当前用户是否有 C 盘用户目录的写入权限，npm 默认装到 %APPDATA%\npm 下，只要这个目录能写，就有很大概率能绕开管理员限制。
1.2 Node.js 与 npm 的版本要求
Claude Code 是 npm 包，Node.js 是它的运行底座。版本要求是 Node.js 18+，但我个人建议直接上 20 LTS 或 22 LTS。原因不是玄学：旧版本 Node 的 fetch、Web Stream 等 API 实现不完整，Claude Code 在流式输出和长任务处理时容易出现中断或内存问题，新版本稳很多。
安装 Node.js 有两种常见路径，官方安装包和 Windows 包管理器 winget：
bash复制winget install OpenJS.NodeJS.LTS
装完务必开一个新的终端窗口，然后验证版本：
bash复制node --version
npm --version
我遇到过很多次“明明装完了却提示找不到 node”，十有八九是终端会话没有重启，PATH 环境变量没刷新。另外提醒一句：如果你机器上已经装了 nvm-windows 之类的版本管理工具，请先用 nvm list 确认当前激活的版本，别装完 A 版本结果 shell 里用的是 B 版本，排查半天才发现是版本没切过来。
1.3 更新 PowerShell 执行策略
这是 Windows 上最容易卡住新手的一步。Claude Code 装完之后，需要运行 claude 命令启动，但 PowerShell 出于安全考虑，默认禁止执行来自网络的脚本，会直接报红字：
text复制无法加载文件 ...因为在此系统上禁止运行脚本
解决办法是在管理员权限的 PowerShell 里修改执行