Windows 用户指南：10分钟在电脑上装好 Claude Code（零基础版）

一、检查环境

Claude Code 依赖 Git 和 Node.js。先检查一下是否已安装。

打开命令提示符

按 Win + R，输入 cmd，按回车。

检查 Git

git --version

• 显示 git version 2.x.x → ✅ 已安装，跳过第二步

• 提示"不是内部或外部命令" → ❌ 需要安装 Git

检查 Node.js

node --versionnpm --version

• 显示版本号 → ✅ 已安装，跳过第三步

• 提示"不是内部或外部命令" → ❌ 需要安装 Node.js

二、安装 Git（如需要）

下载

浏览器打开：https://git-scm.com/download/win

点击 "Click here to download" 下载安装包。

安装

双击下载的 .exe 文件，一路点 "Next"，最后点 "Install"。

验证

重新打开命令提示符，输入：

git --version

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

三、安装 Node.js（如需要）

下载

浏览器打开：https://nodejs.org/

点击绿色的 "LTS" 按钮下载。

安装

双击下载的 .msi 安装包，一路点 "Next"，最后点 "Install"。

验证

重新打开命令提示符，输入：

node --versionnpm --version

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

四、npm 换国内镜像

先换成国内镜像源，后续安装会快很多。

在命令提示符里执行：

npm config set registry https://registry.npmmirror.com

五、安装 Claude Code

换镜像后安装

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

⚠️ 如果提示权限错误，右键命令提示符 → 选择"以管理员身份运行"，再执行安装。

验证

claude --version

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

六、注册阿里云百炼平台

访问百炼平台

浏览器打开：https://bailian.console.aliyun.com/

点击右上角登录/注册，可用支付宝、淘宝账号或手机号注册。

开通服务

登录后按提示开通服务，查看是否有免费额度。

获取 API Key

1. 左侧菜单找到 "API-KEY管理"

2. 点击 "创建API Key"

3. 给 Key 起个名字，点击确认

4. 立即复制 API Key 保存到记事本（只显示一次！）

⚠️ 复制后立即保存，关闭页面后无法再次查看。

七、用 CC Switch 配置连接百炼

下载 CC Switch

浏览器打开：https://github.com/farion1231/cc-switch/releases

找到 CC-Switch-v{x.x.x}-Windows.msi 文件下载。

安装 CC Switch

双击下载的 .msi 文件，一路点"下一步"完成安装。

安装完成后，在开始菜单搜索 "CC Switch" 打开。

配置 Claude Code 连接百炼

1. 打开 CC Switch，点击顶部的 "Claude Code" 选项卡

2. 找到 Provider 设置，选择"百炼/通用兼容"或"DashScope"

3. 填写配置信息：

• API Key：你的百炼 API Key

• Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1

1. 点击 "Save" 或 "Enable" 保存

💡 CC Switch 支持 50+ 预设配置，如果你用的不是百炼，可以在 Provider 列表里找到对应的选项。

八、开始使用

启动

命令提示符输入：

claude

看到欢迎界面就可以开始对话了。

基本操作

• 提问：直接输入，按回车

• 写代码：说"帮我写一个..."

• 修 bug：粘贴报错，说"这里报错了"

• 退出：输入 /exit

常用命令

• /help —— 显示帮助

• /clear —— 清屏

• /exit —— 退出

• /status —— 查看当前配置

• /model —— 切换模型

使用示例

帮我用 Python 写一个计算器

这个代码报错了，帮我看看（粘贴代码）

解释一下这段代码是做什么的（粘贴代码）

九、常见问题

Q1：提示"不是内部或外部命令"？

重新安装：

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

Q2：提示权限错误？

右键命令提示符 → 以管理员身份运行，再执行安装。

Q3：连接失败或 API key 无效？

1. 确认 CC Switch 配置正确

2. 确认 API Key 复制正确（无多余空格）

3. 确认百炼服务已开通

4. 重新打开命令提示符

Q4：切换模型

百炼支持多个模型，可输入：

/model qwen-plus

或在项目目录创建 .claude/settings.json，内容如下：

{ "model": "qwen-plus" }

总结

按照以上步骤，你应该已经完成了：

✅ 安装 Git（如需要）✅ 安装 Node.js（如需要）✅ 安装 Claude Code✅ 注册百炼并获取 API Key✅ 配置连接百炼平台✅ 成功运行 Claude Code

现在你可以开始 AI 编程之旅了！

下一步建议：

1. 找一个小型项目，用 Claude Code 帮你写代码

2. 尝试让它解释一段你看不懂的代码

3. 研究一下 Claude Code 的 /skills 功能

参考链接

• Claude Code 文档：https://docs.claude.ai/code

• 阿里云百炼：https://bailian.console.aliyun.com/

有帮助的话，欢迎转发给需要的朋友！