Windows系统上的官方Claude Code安装教程 Windows官方原版包【新手友好向快速安装指南】

577 阅读3分钟

一、前置组件安装

1.git安装

【此步骤在桌面】下载git 建议默认安装c盘 以防报错

访问 git-scm.com/downloads/w… ,安装时全都下一步,不要修改路径

2.nodejs安装

【此步骤在桌面】下载nodejs 建议默认安装c盘 以防报错

访问 nodejs.org/zh-cn/downl… ,安装时全都下一步,不要修改路径

3.安装情况验证

【此步骤在cmd界面】验证安装情况(cmd界面可通快捷键win+R快速打开,默认打开为cmd,也可手动输入cmd后,点击确定按键即可打开cmd界面)

在cmd界面执行以下命令验证安装情况:

node -v
npm -v

若提示「No suitable shell found」,是git没装好。请将 CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\git\bin\bash.exe 设置到系统环境变量中,重启终端再试。依旧无效,重装git,重启终端后再试

4.卸载已安装的claude code(未安装请跳过)

【此步骤在cmd界面】卸载已安装的claude code

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

5.安装官方原版claude code

【此步骤在cmd界面】安装官方原版的claude code

终端执行安装
npm install -g @anthropic-ai/claude-code

如果无法下载,网络有问题可以用以下命令(关闭魔法)
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

验证安装命令
claude --version

二、配置环境变量

1.一键配置环境变量(推荐使用)

1.1 复制一键安装命令

moacode官网的控制中心中找到“快速设置”模块,点击复制符合您系统的相应命令。

屏幕截图 2025-12-16 092748.png

1.2 一键安装

将上一步复制的命令粘贴到powershell中然后运行(按下Win+R打开“运行”窗口,输入命令:powershell即可打开),即可一键配置 claude code 环境。

255a39a5333dab7d2a8098bbfe88e78e.png

安装完成后可直接跳转到 “3. 保存好环境后重启终端!”

2.手动配置环境变量

2.1 查找API key

a.快速查找(小白推荐)

moacode官网的控制中心中找到“API配置”模块,点击复制您的API key即可。

屏幕截图 2025-12-21 152258.png

b.自定义API key

若您需要指定使用的模型,登入moacode官网,在左侧工具栏处点击接口模块,即可在右侧操作区域创建符合您需求的API key,完成后复制即可

屏幕截图 2025-12-20 154052.png

2.2 设置环境变量

【此步骤在控制面板】设置Windows系统环境变量

需要设置以下两个环境变量:

  • 变量名:ANTHROPIC_AUTH_TOKEN,变量值:你的key
  • 变量名:ANTHROPIC_API_KEY,变量值:你的key
  • 变量名:ANTHROPIC_BASE_URL,变量值:https://moacode.com

设置方法见下文「2.3 修改环境变量操作」

2.3 修改环境变量操作(若熟悉修改环境变量操作可直接跳过此步骤)

2.3.1 在Windows菜单搜索「编辑系统环境变量」并打开

屏幕截图 2025-11-17 164330.png

2.3.2 弹出系统属性窗口,选择「环境变量」

屏幕截图 2025-11-27 160523.png

2.3.3 确保只使用「系统变量」。每次新建变量之前,先完整检查用户变量和系统变量中是否已经有这个变量名了,若有请先删除,然后再新建

屏幕截图 2025-11-27 160155.png

3. 保存好环境后重启终端!

新建环境变量后,需要重启终端才会生效。如果重启终端还不生效,重启电脑。

三、使用Claude Code

1.新开一个cmd界面,开始享受Claude Code

【此步骤在cmd界面】重启终端、输入claude即可打开,赶快开始你的claude code之旅吧!

屏幕截图 2025-12-17 145259.png

您也可以在任意项目目录中开始使用 Claude Code:

# 导航到您的项目
$ cd your-project-folder

# 启动 Claude Code
$ claude

恭喜你完成了Claude Code的安装,现在开始你的Claude Code之旅吧!!!

*若您希望将Claude code接入Vscode/cursor使用可参考此快速部署教程:Claude code接入vscode/cursor教程【新手友好向快速安装指南】想提高你的编程效率吗?快来试试clau - 掘金

*若您在安装Claude code时遇到困难可参考此快速处理指南:Claude Code常见报错原因&问题合集还在为编程苦恼吗?快来试试claude code吧!本文将会以简单明了的步 - 掘金