全部教程Windows 安装 Claude Code 完整指南:免 WSL 直装 + 拼车一键接入

Windows 安装 Claude Code 完整指南:免 WSL 直装 + 拼车一键接入

OpenClaw 拼车团队带你过一遍 Windows 上跑 Claude Code 的最短路径——不装 WSL、不折腾 Linux 子系统,全程在原生 PowerShell / CMD 里搞定。

很多人第一次装 Claude Code 都被官方教程引导去装 WSL。WSL 不是不好,但对完全没碰过 Linux 的同学来说,「再装一个操作系统」这一步本身就是劝退点:网络问题、磁盘问题、Hyper-V 没开、虚拟化在 BIOS 里关了……一连串坑。

好消息:从 Node.js 拿到 Claude Code 的官方 npm 包之后,Windows 原生 Shell 就能直接跑。这篇文章把全部步骤拆细,配上 OpenClaw 拼车 token 接入方式,让你 10 分钟内敲出第一个 claude 命令。

想跳过手工接 token? 一行命令搞定全部配置:

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

在 Git Bash 或 WSL 里跑这条,下方的环境变量步骤可以全部跳过。


总览:全程 4 步

  1. 装 Node.js(这是 Claude Code 的运行时)
  2. 用 npm 装 @anthropic-ai/claude-code
  3. 配两个环境变量(ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL
  4. 打开终端,敲 claude

下面挨个讲。


步骤 1:安装 Node.js

Claude Code 是个 Node CLI,所以本机必须先有 Node。

打开 Node.js 官网,挑 Windows Installer (.msi) 下载。芯片架构按你的机器选:

  • 一般 Intel/AMD 桌面机:x64
  • ARM 笔记本(如 Surface Pro X):ARM64

下载完一路下一步,安装器会顺手把 nodenpm 加到 PATH。装完打开新的 PowerShell 或 CMD,验证:

node -v
npm -v

两条命令都吐出版本号就 OK。建议 Node 版本 ≥ 18。

如果 node 命令找不到,多半是新窗口没开——关掉重开。


步骤 2:用 npm 装 Claude Code

国内网络环境直连 npmjs.com 经常慢,这里用 npmmirror.com 镜像加速:

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

-g 表示全局安装,装完后 claude 命令在任意目录都能用。如果你家网络直连 npm 没问题,去掉 --registry 参数也行。

装完跑一下:

claude --version

吐出版本号,CLI 部分就完工了。


步骤 3:配置环境变量(图形化最稳)

Claude Code 启动时要读两个变量:

  • ANTHROPIC_AUTH_TOKEN——鉴权 token(OpenClaw 拼车给你的那个)
  • ANTHROPIC_BASE_URL——API 接入点

图形化方式(推荐新手走这条路):

  1. Win + R,输入 sysdm.cpl,回车
  2. 切到 高级 选项卡,点 环境变量
  3. 在「系统变量」(或「用户变量」二选一)里点 新建
  4. 变量名填 ANTHROPIC_AUTH_TOKEN,变量值填你的 token,确定
  5. 重复一次,新建 ANTHROPIC_BASE_URL,填对应 URL
  6. 一路点确定关掉所有对话框

系统变量 vs 用户变量:只给自己用——选用户变量;多账号共享——系统变量(需管理员)。

命令行方式(一行搞定):

setx ANTHROPIC_AUTH_TOKEN "你的 token"
setx ANTHROPIC_BASE_URL "你的 base url"

setx 写完必须重开终端才能在新窗口里读到值。这是 Windows 行为,不是 bug。完整 4 种方法对比见我们的 Windows 环境变量配置文


步骤 4:跑起来

打开新的 PowerShell 或 CMD(一定要新开,老窗口读不到刚设置的环境变量),输入:

claude

CLI 启动后能正常进入交互界面,说明全链路打通了。


OpenClaw 拼车:把上面三步压缩成一行

老实讲,上面这套流程对 Windows 用户已经算「友好」了,但还是有几个常见翻车点:

  • npm 镜像配错,安装卡住
  • 环境变量拼写错(ANTHROPIC_AUTH_TOKEN 写成 ANTHROPIC_API_TOKEN
  • setx 写完忘了重开窗口,以为没生效
  • token 直接写在系统环境变量里,明文落盘

OpenClaw 拼车的 setup.sh 是为这些场景准备的——一行命令把 CLI 装好、token 接好、配置文件写好、自检跑完:

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

Windows 推荐在 Git BashPowerShell(带 curl) 里执行。如果你已经装了 WSL,那就直接在 WSL 终端跑。

setup.sh 跑完之后:

  • OpenClaw CLI 已就绪(openclaw --version
  • 拼车 token 已写入 ~/.openclaw/openclaw.json 的对应 profile
  • openclaw doctor 已自检过,红绿灯一目了然
  • Claude Code 通过 OpenClaw Gateway 接入,启动时由 Gateway 注入凭据,不需要你手工配 ANTHROPIC_AUTH_TOKEN

后续要切换 token、换机器、加新频道,都只用 openclaw config 子命令——比手敲 setx 再重开窗口稳得多。

立即上车:https://cp.bizq.net/setup


常见问题

Q:完全不装 WSL 真的够用吗?

够用。Claude Code 本质是个 Node CLI,npm 包在 Windows 原生环境跑得很好。WSL 只在你需要 Linux 工具链(如 grep、sed、特定 docker 操作)时才有意义。

Q:能不能用 nvm-windows 装 Node?

可以,而且推荐。nvm-windows 让你在多个 Node 版本间切换,避免「装了 Node 18,新项目要 20」的尴尬。安装顺序:先卸载 .msi 装的 Node,再装 nvm-windows,再 nvm install 20 && nvm use 20

Q:claude 命令报「找不到」怎么办?

按以下顺序排查:

  1. npm config get prefix,看 npm 全局目录
  2. 把这个目录加到系统 Path
  3. 关掉所有终端窗口,重开

Q:官方 endpoint 和拼车 endpoint 能并存吗?

能。OpenClaw 配置里支持多个 auth profile,按模型路由。详细配置参考 OpenClaw CLI 命令完整参考


相关文章


立即开始

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

完整接入入口:https://cp.bizq.net/setup