Claude Code 保姆级安装教程（Windows）#

本文面向第一次接触命令行工具的小白用户，目标是让你在没有任何基础的情况下，也能在 Windows 上把 Claude Code 完整跑起来。整个过程只需要跟着截图一路点「Next」即可，遇到需要动脑子的地方我会额外解释「为什么要这么选」。

Claude Code 是 Anthropic 推出的终端里的 AI 编程助手：你用它来读代码、改代码、跑命令、排查问题，就像身边坐了一个随时在线的资深工程师。它不是一个独立的大软件，而是运行在**终端（命令行）**里的一个工具，因此需要先准备好两个「地基」：

Git：Claude Code 靠它来做版本控制和代码操作；
Node.js：Claude Code 本身是用 JavaScript 写的，需要 Node.js 这个运行环境才能启动。

参考教程：

安装 Git 的截图和步骤说明，参考了 CSDN 李同学的《Git for Windows 详细安装教程》（链接：原文链接），感谢原作者的整理
安装 Node.js 的截图和步骤说明，参考了 CSDN 多加点辣也没关系的《npm 安装与配置教程》（链接：原文链接），在此一并致谢。

下面我们就按顺序装好这三样东西。

一、安装前的环境要求#

在开始之前，先确认你的电脑满足以下条件：

Windows 10 或 Windows 11（64 位）；
有一个管理员账号（安装软件时需要权限）；
网络可以正常访问外网（部分步骤可能需要科学上网或国内镜像，文中会说明）；
不需要任何编程基础，只需要会「双击」和「点 Next」。

整篇文章分三大步：装 Git → 装 Node.js → 装 Claude Code。建议按顺序来，因为后一步依赖前一步。

二、第一步：安装 Git#

2.1 下载 Git for Windows#

打开浏览器，访问 Git 官方下载页，页面通常会根据你的系统自动给出 Windows 版本的下载按钮。

如果官网下载太慢，也可以用我准备的夸克网盘备用链接：夸克网盘（提取码 KaFV）。

下载得到一个类似 GitforWindows-x64-Setup.exe 的安装程序，记住它保存在哪个文件夹（一般是「下载」目录）。

Pasted image 20260803221724.png

2.2 开始安装（全程跟着点「Next」）#

找到刚下载的安装程序，双击运行。下面每一步都配了截图，看不懂选项含义直接点 Next 用默认即可，我在关键处会标「注意」。

（1）许可证

先是 GNU 通用公共许可证，直接点 Next 继续。

Pasted image 20260803221408.png

（2）选择安装位置

建议保持默认路径（C:\Program Files\Git），直接点 Next。

注意：如果改到其他盘，后续配置环境变量会麻烦一点，新手不推荐改。

Pasted image 20260803222340.png

（3）选择安装组件

默认即可，直接点 Next。

Pasted image 20260803222415.png

（4）开始菜单文件夹

直接点 Next 用默认设置。

![Couldn’t upload file](Pasted image 20260803222509.png)

（5）选择默认编辑器

这里默认用 Vim 作为 Git 的编辑器。直接点 Next 即可。

说明：Vim 是命令行里的一个老牌编辑器，平时你基本用不到它。选默认不会对你后续使用 Claude Code 有任何影响。

Pasted image 20260803222534.png

（6）调整初始分支名称

建议选择 “Let Git decide”（让 Git 自己决定），然后点 Next。

Pasted image 20260803222614.png

（7）调整 PATH 环境变量 ⭐ 这一项比较重要

推荐选择第二项：“Git from the command line and also from 3rd-party software”。这样装完后，你可以在系统自带的 CMD、PowerShell 里直接输入 git 命令。选好后点 Next。

为什么要选第二项？第一项只能在某些特定终端里用 Git；第三项会把一堆 Unix 工具塞进系统 PATH，可能和其它软件冲突。第二项最省心。

Pasted image 20260803222632.png

（8）选择 HTTPS 后端

使用默认选项，点 Next。

Pasted image 20260803222645.png

（9）配置行尾符号转换

选择 “Checkout Windows-style, commit Unix-style line endings”（Windows 风格检出、Unix 风格提交），然后点 Next。这是跨平台协作的标准配置，能避免不同系统换行符打架。

Pasted image 20260803222658.png

（10）配置终端模拟器

选择 “Use MinTTY”（使用 MinTTY 作为 Git Bash 的终端），点 Next。MinTTY 比 Windows 默认控制台更好用、支持中文显示。

Pasted image 20260803222713.png

（11）配置 git pull 的默认行为

选择默认值即可，点 Next。

Pasted image 20260803222725.png

（12）选择凭证助手

选择 “Git Credential Manager Core”（凭证管理器），点 Next。它会在你第一次输入账号密码后帮你记住，以后推送代码不用重复登录。

Pasted image 20260803222830.png

（13）配置额外功能

勾选 “Enable file system caching”（启用文件系统缓存，提速），以及 “Enable symbolic links”（启用符号链接），然后点 Install 开始安装。

Pasted image 20260803222850.png

（14）等待安装完成

进度条走完就装好了。

Pasted image 20260803222906.png

2.3 验证 Git 是否安装成功#

按 Win + R 键，输入 cmd 打开命令提示符，输入下面命令检查版本：

1
git --version

如果屏幕上打印出类似 git version 2.xx.x.windows.1 的版本号，说明 Git 安装成功。

Pasted image 20260803222923.png

三、第二步：安装 Node.js#

Claude Code 是基于 Node.js 运行的，所以必须先装好 Node.js（npm 会随它一起装好，后面装 Claude Code 要用到 npm）。

3.1 下载 Node.js（选 LTS 版本）#

打开 Node.js 官网下载页。

Pasted image 20260803223812.png

一般来说点 LTS（Long Term Support，长期支持版）下载，这是最稳定的版本，适合日常使用。根据你电脑系统选择：比如 Windows 64 位就点 Windows Installer (.msi) 下的 64-bit 开始下载。

Pasted image 20260803223916.png

3.2 安装 Node.js#

双击下载好的 .msi 安装包，一路 Next 到底，最后点 Finish 完成。

Pasted image 20260803223946.png

Pasted image 20260803224000.png

Pasted image 20260803224023.png

3.3 验证 Node.js 与 npm#

同样按 Win + R → 输入 cmd 打开命令行，分别执行：

1
node -v

如果显示版本号（如 v20.x.x），说明 Node.js 安装成功。

Pasted image 20260803224023.png

1
npm -v

npm 是 Node.js 的包管理工具，安装 Node.js 时会自动带上。如果这里也能打印出版本号，说明 npm 也正常。

Pasted image 20260803224041.png

四、第三步：安装 Claude Code#

前置的 Git 和 Node.js 都就绪后，就可以安装主角 Claude Code 了。

4.1 使用 npm 全局安装#

确认 Node.js 可用后，在命令行执行下面这条命令（全局安装 Claude Code）：

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

如果你的网络访问 npm 官方源很慢或失败，可以换成国内镜像源再装：

1
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

4.2 验证安装#

安装完成后，输入下面命令看是否能打印出版本号：

1
claude --version

只要显示出类似 X.Y.Z 的版本号，就说明 Claude Code 安装成功。

Pasted image 20260803224810.png

4.3 启动并登录#

直接输入命令启动 Claude Code：

1
claude

Pasted image 20260803224925.png

第一次启动会有一系列初始化设置，一路按默认（回车 / 选默认项）即可。

Pasted image 20260803224946.png

接着会要求你登录 Claude 官方账号。如果你已经订阅了 Claude 的付费计划（Pro / Max），按提示在浏览器里完成授权登录即可开始使用。

4.4 没有官方账号？接入第三方 API#

如果你没有 Claude 官方订阅，也可以用兼容 Anthropic Messages API 的第三方大模型服务来驱动 Claude Code。做法是在环境变量里设置 ANTHROPIC_BASE_URL（第三方接口地址）和 ANTHROPIC_API_KEY（你的 API Key）， Claude Code 就会把请求转发到对应服务。

各家服务的具体接入步骤官方都写好了，照着配就行，这里不再赘述：

五、常见问题（FAQ）#

Q1：输入 git / node / claude 提示「不是内部或外部命令」？ 多半是刚装完软件、当前命令行窗口还没刷新环境变量。解决办法：关掉命令行窗口重新打开一个再试。如果还不行，回头检查安装时 Git 的 PATH 那一步有没有选对第二项。

Q2：npm 安装 Claude Code 卡住或报网络错误？ 换成国内镜像源再装（见 4.1 的第二条命令）。如果还慢，可以挂代理后重试。

Q3：提示 Node.js 版本太低？ Claude Code 需要 Node.js 18 及以上。重新去官网下载安装最新的 LTS 版本即可（见第三节）。

Q4：启动 claude 后不知道怎么退出？ 在对话框里输入 /exit 或按 Ctrl + C 两次即可退出。

Q5：用第三方 API 登录后还是连不上？ 通常是 ANTHROPIC_BASE_URL 或 ANTHROPIC_API_KEY 填错，或该服务余额不足。对照对应服务商的官方接入文档逐项核对。

六、总结#

到这里，你已经完成了 Git + Node.js + Claude Code 的完整安装，并成功启动。回顾一下全流程：

装 Git（一路 Next，PATH 选第二项最关键）；
装 Node.js（选 LTS，一路 Next）；
用 npm install -g 装 Claude Code，用 claude 启动并登录；
没有官方账号就用第三方 API（配两个环境变量）。

恭喜，你的终端里现在有了一个能陪你写代码、读代码、改 Bug 的 AI 搭档。接下来就可以在任意项目文件夹里输入 claude，开始你的第一个 AI 辅助编程任务了。