Skip to content

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 运行即可,然后跳到「四、启动使用」。

方式二:手动配置环境变量 ​

  1. 获取 API Key:Dashboard 的 API configuration 复制主 Key;或在 API management 创建指定模型的专用 Key
  2. Win + R 输入 sysdm.cpl → 高级 → 环境变量,在系统变量中新建三项:
变量名值
ANTHROPIC_AUTH_TOKEN你的 API Key
ANTHROPIC_API_KEY你的 API Key
ANTHROPIC_BASE_URLhttps://moacode.org

WARNING

新建前先检查是否已有同名变量(比如其他服务商的残留配置),先删除再新建。保存后必须重启终端;仍不生效则重启电脑。

四、启动使用 ​

新开一个终端:

bash
cd 你的项目目录
claude

首次启动询问是否使用该 API Key,选 Yes 一路回车即可。

下一步 ​

MoaCode — One key. Every coding agent.