Windows 下安装 Claude Code 保姆教程

❀相信很多朋友跟我一样，第一次在 Windows 上安装 Claude Code 时踩了不少坑——npm 镜像速度慢、直连 Anthropic 服务又报错、不知道还要用 CC Switch 切换模型...这篇文章就是把我自己踩过的坑整理出来，给大家一份完整的避坑指南。按照下面的步骤来，保证你能顺利跑起来！

在开始之前，请先下载并安装以下软件：

软件	版本	下载地址	说明
Node.js	v24.14.1+	[nodejs.org](https://nodejs.org/)	JavaScript 运行时环境
Git	2.53.0+	[git-scm.com](https://git-scm.com/download/win)	版本控制系统
Claude Code	v2.1.104+	npm install	Anthropic CLI 工具
CC Switch	v3.12.3	[下载地址](https://github.com/AnyHuman/CC-Switch/releases)	模型切换工具
VS Code	最新版	[code.visualstudio.com](https://code.visualstudio.com/Download)	代码编辑器（推荐）
Notepad++	8.7.1+	[notepad-plus-plus.org](https://notepad-plus-plus.org/downloads/)	文本编辑器（可选）
MiniMax API	-	[platform.minimaxi.com](https://platform.minimaxi.com)	国内模型服务商

首先检查系统中是否已安装 Node.js、npm 和 Git。打开命令提示符（CMD）或 PowerShell，执行以下命令检查版本：

node -vnpm -vgit --version

由于 npm 默认镜像在国外，下载速度较慢，建议先设置为国内镜像，然后全局安装 Claude Code：

npm config set registry https://registry.npmmirror.comnpm install -g @anthropic-ai/claude-code

安装完成后，在命令行直接运行 claude 命令：

claude

由于国内网络限制，会出现无法连接到 Anthropic 服务的错误：

这是因为 Claude Code 默认使用 Anthropic 官方 API，国内无法直接访问。我们需要使用 CC Switch 工具切换到国内模型服务商。

CC Switch 是一款模型切换工具，可以帮助国内用户通过 MiniMax 等国内模型服务商使用 Claude Code。

打开 CC Switch，点击"添加新供应商"，在预设供应商列表中找到 MiniMax 并选择。

按照以下信息进行配置：

配置项	值
供应商名称	MiniMax
官网链接	https://platform.minimaxi.com
API Key	您的 MiniMax API Key（点击"获取 API Key"跳转获取）
请求地址	https://api.minimaxi.com/anthropic

💡 提示：MiniMax Coding Plan 特惠，Starter 套餐 29 元起

配置完成后，点击"测试模型"按钮，验证 MiniMax 模型是否可连接。

配置完成后，重新在命令行运行 Claude Code：

claude

首次运行会提示选择终端主题样式，推荐选择 Dark mode（暗黑模式），然后按 Enter 确认。

使用 /model 命令可以查看当前使用的模型，也可以切换到其他可用模型。

配置完成后，就可以开始使用 Claude Code 了。可以直接告诉它你想做什么，例如：

Claude Code 的主要能力包括：

恭喜！您已成功在 Windows 系统上安装并配置好 Claude Code，现在可以开始使用了。