duo dou前阵子有朋友在技术群里问我：明明照着教程敲了 npm install -g @anthropic-ai/claude-code，安装过程也提示成功了，可一执行 claude 就提示“不是内部或外部命令”，是不是 Claude Code 这东西在 Windows 上水土不服？其实不是工具的问题，多半是装之前的路线没有选对。Claude Code 是 Anthropic 推出的命令行 AI 编程工具，它能直接在终端里读你的项目、改代码、批量执行命令、跑测试，等于把一套能实际动手的“AI 结对程序员”放进了本地环境。
这篇文章我会围绕 Windows 系统，把 Claude Code 从环境准备、安装登录、模型接入到配置管理的完整流程讲一遍。内容偏向可以直接照做的实战路径，也会把 Windows 上最容易踩的几个报错单独拆开讲透。无论你打算用官方模型，还是想把它接到其他兼容 Anthropic 接口的模型服务上，按这个顺序走基本不会走弯路。下面直接开始。
1. 装之前先定路线：PowerShell 原生跑还是 WSL 跑
我在帮不同的人排查安装问题时发现，很多问题的根源不是安装命令写错，而是从一开始就没想清楚 Claude Code 要跑在哪一套环境里。Claude Code 本质是一个 Node.js 写的命令行程序，理论上 Windows 原生能跑，Linux 也能跑，npm 包装上就能执行。但“能跑”和“跑得顺”是两回事。
1.1 原生 Windows 方式适合哪些场景
原生 Windows 路线指的是直接在你的 Windows 系统上安装 Node.js，然后在 PowerShell、Windows Terminal 或者 CMD 里用 npm 安装 Claude Code。好处非常明显：不需要额外装虚拟机、不需要理解 WSL 的文件系统，你在 Windows 桌面上创建的代码目录，Claude Code 可以直接访问，路径就是平时的 C:\work\project 这样的形式，没有任何隔阂。
坏处也比较隐蔽。Claude Code 在执行工具调用时，很多默认命令和路径处理逻辑是围绕 bash 语法设计的，而 Windows 默认的 shell 是 PowerShell 或 CMD，语法、管道、转义规则都不一样。比如一条 grep 命令、一段路径拼接、一个 $HOME 的环境变量写法，在两种 shell 里的表现可能完全不同。如果你只是拿 Claude Code 改改前端小项目、做代码审查，原生 Windows 完全够用；如果你打算让它跑比较重的脚本、批量处理文件、甚至自动操作 Docker 之类的工具，原生 Windows 会让你花不少时间在“处理 shell 差异”上。
1.2 WSL 路线为什么更接近官方环境
WSL 是 Windows 官方提供的 Linux 子系统，Windows 10/11 现在都能用。装一个 Ubuntu 发行版之后，Claude Code 实际运行在 Linux 环境里，命令语法、文件权限、包管理逻辑都和官方文档的示例保持一致。这样做的最大价值是：Claude Code 执行命令时，你不需要反复替它处理 Windows 和 Linux 之间的差异，它自己就知道该怎么读写路径、怎么调用 shell 命令。
WSL 也并非没有成本。你需要理解 Linux 基础操作，比如用 apt 安装软件、用 nvm 管理 Node、使用 ~/.claude/ 这类点开头的配置文件。如果你之前完全没接触过 Linux，刚开始会有不少陌生感。但放在长期使用的角度，这份学习成本是值得的，因为 Claude Code 后续的绝大多数高级用法、社区教程、MCP 扩展配置，默认都以 Linux/macOS 环境为例。你能在 WSL 里跑通，就等于打通了绝大部分官方支持和社区经验。
1.3 两条路线的对比结论
| 对比项 | 原生 Windows | WSL 子系统 |
|---|---|---|
| 安装门槛 | 较低，只需 Node.js | 中，需安装 WSL 和发行版 |
| 命令兼容性 | 一般，PowerShell 语法差异多 | 高，与官方文档一致 |
| 文件访问 | 直接访问 Windows 目录 | 通过 /mnt/c 挂载访问 |
| 适合人群 | 轻度使用、前端开发 | 深度编程、自动化、后端开发 |
| 常见报错 | PATH、执行策略、脚本问题 | WSL 版本、内核更新问题 |
我的建议是：如果你当前主要在 Windows 上做开发，又希望把 Claude Code 作为日常高频工具，直接选 WSL 路线；如果你只是偶尔想试一下 AI 编程助手，先走原生 Windows 也不会有太大问题。后面这两条路径的详细步骤我都会讲，你可以先跟着环境准备部分走一遍，再敲第一条实际命令验证。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 动手准备环境：别让 Node、WSL、VS Code 拖后腿
很多人装 Claude Code 失败，问题常常不在 Claude Code 本身，而是前置环境没过关。我这里说的前置环境不是指“电脑配置够不够高”，而是指 Node 版本、终端工具、WSL 内核这些容易被忽略的基础设施。
2.1 Node.js 与 npm 的版本与安装方式
Claude Code 要求 Node.js 版本在 18 以上，实际使用中我更推荐装 Node.js LTS 版，稳定性更好。Windows 上最简单的方式是用 winget 安装官方包：
powershe复制