Windows 安装 Claude Code
本页在 Windows 上从零安装官方 Claude Code 并接入 MoaCode。
一、安装前置组件
1. 安装 Git
从 git-scm.com/downloads/win 下载安装包。
TIP
建议保持默认路径安装到 C 盘,安装过程一路「下一步」即可,不要修改选项。
2. 安装 Node.js
从 nodejs.org/zh-cn/download 下载 Windows 安装包(.msi),同样默认路径一路下一步。
3. 验证安装
Win + R 输入 cmd 打开命令行:
bash
node -v
npm -v两条命令都能输出版本号即为成功。
报 "No suitable shell found"
说明 Git 未正确安装。在系统环境变量中新增:
CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe重启终端后再试;仍无效则重装 Git。
二、安装 Claude Code
bash
# 如装过旧版先卸载(未装过跳过)
npm uninstall -g @anthropic-ai/claude-code
# 安装官方 Claude Code
npm install -g @anthropic-ai/claude-code
# 网络受阻时改用国内镜像
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com
# 验证
claude --version三、接入 MoaCode
方式一:一键配置(推荐)
登录 Dashboard,在 Quick setup 选择 Claude Code → Copy Windows,把命令粘贴到 PowerShell 运行即可,然后跳到「四、启动使用」。
方式二:手动配置环境变量
- 获取 API Key:Dashboard 的 API configuration 复制主 Key;或在 API management 创建指定模型的专用 Key
Win + R输入sysdm.cpl→ 高级 → 环境变量,在系统变量中新建三项:
| 变量名 | 值 |
|---|---|
ANTHROPIC_AUTH_TOKEN | 你的 API Key |
ANTHROPIC_API_KEY | 你的 API Key |
ANTHROPIC_BASE_URL | https://moacode.org |
WARNING
新建前先检查是否已有同名变量(比如其他服务商的残留配置),先删除再新建。保存后必须重启终端;仍不生效则重启电脑。
四、启动使用
新开一个终端:
bash
cd 你的项目目录
claude首次启动询问是否使用该 API Key,选 Yes 一路回车即可。