Windows版Claude_Code保姆级安装与配置教程

Windows 版 Claude Code 保姆级安装与配置教程（零基础适用）

适用平台：Windows 10 1809+ / Windows 11
更新日期：2026 年 5 月
Claude-Code-常用教程：Claude-Code-常用教程

一、Claude Code 是什么？

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。它在终端中运行，能读懂你的项目代码，帮你写代码、改 Bug、重构、解释逻辑——直接在命令行里对话即可。

与 ChatGPT / Copilot 的区别：

二、准备工作

在开始之前，确认你具备以下条件：

需要安装的软件（下文逐步教你）：

1. Git for Windows
2. Node.js（LTS 版本）
3. Claude Code
4. cc-switch（API 切换工具）

三、安装 Git for Windows

Claude Code 的部分功能依赖 Git 环境，建议优先安装。

3.1 下载

打开浏览器，访问 Git 官网下载页：

https://git-scm.com/download/win

页面会自动识别你的系统，点击Click here to download下载 64 位安装包。

3.2 安装

1. 双击下载的.exe文件
2. 安装路径：保持默认即可，点 Next
3. 组件选择：保持默认，点 Next
4. 开始菜单文件夹：保持默认，点 Next
5. 默认编辑器：选你熟悉的（不懂就保持 Vim），点 Next
6. PATH 环境：选择“Git from the command line and also from 3rd-party software”（中间那个选项），这一步很重要，确保命令行能识别 git 命令
7. 后续所有选项保持默认，一路 Next 直到 Install
8. 安装完成，点 Finish

3.3 验证

按Win + R，输入cmd，回车打开命令提示符，输入：

git--version

看到类似git version 2.51.1.windows.1的输出，说明安装成功。

四、安装 Node.js

Claude Code 通过 npm 安装，需要先装 Node.js。

4.1 下载

访问 Node.js 官网：

https://nodejs.org

点击LTS（长期支持版）按钮下载，版本号以偶数结尾（如 22.x.x LTS）。

4.2 安装

1. 双击.msi安装包
2. 勾选“I accept the terms in the License Agreement”，点 Next
3. 安装路径保持默认，点 Next
4. 不要取消勾选任何组件，特别是 npm 和 Add to PATH，点 Next
5. 点 Install，等待完成
6. 点 Finish

4.3 验证

打开新的命令提示符窗口（必须是新窗口），输入：

node--versionnpm--version

分别看到版本号输出（如v22.14.0和10.9.2），说明安装成功。

⚠️ 如果提示"不是内部或外部命令"，关掉所有命令行窗口重新打开再试。仍不行则需手动添加环境变量：此电脑 → 右键属性 → 高级系统设置 → 环境变量 → 系统变量的 Path → 编辑 → 新建 → 填入C:\Program Files\nodejs（自己的路径）→ 确定保存。

五、安装 Claude Code

提供三种安装方式，推荐方式一。

方式一：原生安装（推荐，最简单）

打开PowerShell（右键开始菜单 → Windows PowerShell），依次执行：

# 允许运行安装脚本（只需执行一次）Set-ExecutionPolicyRemoteSigned-Scope CurrentUser# 输入 Y 确认# 安装 Claude Codeirmhttps://claude.ai/install.ps1|iex

等待下载安装完成即可。

方式二：npm 安装

npminstall-g@anthropic-ai/claude-code

方式三：WinGet 安装

winget install Anthropic.ClaudeCode

验证安装

claude--version

看到版本号输出，说明安装成功。

六、首次登录 Claude Code

6.1 启动

在命令提示符或 PowerShell 中输入：

claude

首次启动会提示你登录（上图是配置好的）。

6.2 登录授权

1. 终端中输入/login，会显示一个授权链接
2. 按住Ctrl点击链接（或复制到浏览器打开）
3. 在浏览器中登录你的 Claude 账号并授权
4. 终端显示登录成功
   

6.3 验证

登录后直接在终端输入问题测试：

> 你好，请介绍一下你自己

如果 Claude 正常回复，说明一切就绪。

七、安装 cc-switch（API 一键切换工具）

7.1 为什么需要 cc-switch？

Claude Code 默认使用 Anthropic 官方 API。如果你需要切换到其他 API 供应商（如国内中转服务），手动改环境变量非常麻烦。cc-switch 是一个开源桌面工具，可以一键切换不同 API 配置。

7.2 下载

访问 cc-switch 的 GitHub Releases 页面：

https://github.com/farion1231/cc-switch/releases

找到最新版本，Windows 用户下载：

• 安装版：CC-Switch-vX.X.X-Windows.msi（双击安装，推荐）
• 便携版：CC-Switch-vX.X.X-Windows-Portable.zip（解压即用，免安装）

7.3 安装

安装版：双击.msi文件，按向导完成安装即可。

便携版：解压 zip 到任意目录，双击CC Switch.exe运行。

7.4 首次启动

启动后，cc-switch 会自动检测已安装的 Claude Code 等工具，并最小化到系统托盘。

八、使用 cc-switch 配置和切换 API

8.1 添加 API 供应商

1. 打开 cc-switch
2. 左侧分组栏选择Claude
3. 点击右上角“+”按钮添加供应商
4. 选择自定义配置（或对应供应商模板）
   

8.2 填写配置字段

以通用自定义配置为例，各字段说明如下：

💡Base URL 和 API Key 从哪来？在你使用的 API 供应商网站注册账号 → 创建 API Key → 复制 Base URL 和 Key 填入即可。

8.3 一键切换

配置完成后，切换 API 只需两步：

1. 在 cc-switch 中点击你想使用的供应商
2. 点击“应用”或“切换”按钮

cc-switch 会自动修改 Claude Code 的环境变量，无需手动操作。

8.4 验证切换成功

切换后，打开新的终端窗口，输入：

claude

然后问一个问题，确认能正常对话即可。

⚠️ 切换 API 后需要重新打开终端窗口启动 Claude Code，旧窗口的环境变量不会更新。

九、常见问题

Q1：安装 Claude Code 时报错"无法加载文件，因为在此系统上禁止运行脚本"

Set-ExecutionPolicyRemoteSigned-Scope CurrentUser

输入 Y 确认后重新安装。

Q2：claude命令提示"不是内部或外部命令"

• 关闭所有终端窗口，重新打开再试
• 如果仍不行，重启电脑
• 确认 Node.js 安装时勾选了 Add to PATH

Q3：安装时 Windows Defender 误报病毒

这是误报。点击"更多信息" → "仍要运行"即可。也可以临时将安装目录加入 Defender 排除项。

Q4：登录时浏览器打不开授权链接

手动复制终端中显示的完整 URL，粘贴到浏览器地址栏打开。

Q5：Claude Code 启动后提示网络错误

• 检查网络能否访问 claude.ai
• 如使用代理，确保终端也配置了代理环境变量

Q6：cc-switch 切换后 Claude Code 仍用旧 API

• 关闭旧终端，打开新终端再启动claude
• 在 cc-switch 中确认当前选中的供应商是你想要的

Q7：npm install 报错权限不足

用管理员身份打开 PowerShell 再执行安装命令。

Q8：Git 安装后命令行仍找不到 git

• 关闭并重新打开终端
• 确认安装时选择了"Git from the command line and also from 3rd-party software"

Q9：如何卸载 Claude Code？

npmuninstall-g@anthropic-ai/claude-code

或通过系统设置 → 应用 → 找到 Claude Code → 卸载。

十、常用命令速查

安装流程总结

安装 Git for Windows → 安装 Node.js → 安装 Claude Code → 登录账号 → 安装 cc-switch → 配置 API → 开始使用

按顺序走完以上步骤，你就可以在 Windows 上愉快地使用 Claude Code 了。