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 步
- 装 Node.js(这是 Claude Code 的运行时)
- 用 npm 装
@anthropic-ai/claude-code - 配两个环境变量(
ANTHROPIC_AUTH_TOKEN+ANTHROPIC_BASE_URL) - 打开终端,敲
claude
下面挨个讲。
步骤 1:安装 Node.js
Claude Code 是个 Node CLI,所以本机必须先有 Node。
打开 Node.js 官网,挑 Windows Installer (.msi) 下载。芯片架构按你的机器选:
- 一般 Intel/AMD 桌面机:x64
- ARM 笔记本(如 Surface Pro X):ARM64
下载完一路下一步,安装器会顺手把 node 和 npm 加到 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 接入点
图形化方式(推荐新手走这条路):
- 按
Win + R,输入sysdm.cpl,回车 - 切到 高级 选项卡,点 环境变量
- 在「系统变量」(或「用户变量」二选一)里点 新建
- 变量名填
ANTHROPIC_AUTH_TOKEN,变量值填你的 token,确定 - 重复一次,新建
ANTHROPIC_BASE_URL,填对应 URL - 一路点确定关掉所有对话框
系统变量 vs 用户变量:只给自己用——选用户变量;多账号共享——系统变量(需管理员)。
命令行方式(一行搞定):
setx ANTHROPIC_AUTH_TOKEN "你的 token"
setx ANTHROPIC_BASE_URL "你的 base url"
setx写完必须重开终端才能在新窗口里读到值。这是 Windows 行为,不是 bug。完整 4 种方法对比见我们的 Windows 环境变量配置文。
步骤 4:跑起来
打开新的 PowerShell 或 CMD(一定要新开,老窗口读不到刚设置的环境变量),输入:
claudeCLI 启动后能正常进入交互界面,说明全链路打通了。
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-20xWindows 推荐在 Git Bash 或 PowerShell(带 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 再重开窗口稳得多。
常见问题
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 命令报「找不到」怎么办?
按以下顺序排查:
npm config get prefix,看 npm 全局目录- 把这个目录加到系统
Path - 关掉所有终端窗口,重开
Q:官方 endpoint 和拼车 endpoint 能并存吗?
能。OpenClaw 配置里支持多个 auth profile,按模型路由。详细配置参考 OpenClaw CLI 命令完整参考。
相关文章
- Claude Code 在 Windows 设置环境变量 — 4 种环境变量配置方法对比
- OpenClaw 完整指南 — Gateway 架构总览
- OpenClaw VPS 部署指南 — 从 Windows 跨到 Linux 服务器
立即开始
curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x完整接入入口:https://cp.bizq.net/setup。