Claude Code 在 Windows 设置环境变量:4 种方法完整对比(OpenClaw 团队实测)
我们是 OpenClaw 拼车的维护团队。这篇文章把 Windows 上配置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 的全部姿势捋一遍——临时调试用哪种、长期开发用哪种、什么时候必须重开终端,一次性讲清楚。
想直接跳过手工配置? OpenClaw 拼车 setup.sh 一行命令把环境变量、CLI、配置文件全包了:
curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20xWindows 用户可以在 WSL 或 Git Bash 里执行,省去后面手工 setx 的所有步骤。
为什么要配这两个变量
Claude Code CLI 启动时会读 ANTHROPIC_BASE_URL(API 接入点)和 ANTHROPIC_AUTH_TOKEN(鉴权 token)。本机配好了,claude 命令一跑就直接打通。OpenClaw 拼车提供的 token 也是塞这两个变量里——兼容官方 SDK,没有任何私有协议。
下面四种方法各有适用场景,挑一种就够。
方法 1:PowerShell 临时变量(推荐用于调试)
PowerShell 里直接赋值,只在当前窗口生效,关掉就没了。适合「临时跑一次」「调试不同 endpoint」这种场景。
$env:ANTHROPIC_BASE_URL = "你的 url"
$env:ANTHROPIC_AUTH_TOKEN = "你的 key"跑完命令窗口一关,环境就干净——不会污染其他项目。
方法 2:CMD(命令提示符)临时变量
老牌 CMD 也能用,语法换成 set:
set ANTHROPIC_BASE_URL=你的 url
set ANTHROPIC_AUTH_TOKEN=你的 key注意 = 两边不能加空格,CMD 对此非常较真。同样只在当前会话有效。
方法 3:setx 永久写入(推荐用于日常开发)
如果你天天要用 Claude Code,建议直接 setx 写到用户环境变量里:
setx ANTHROPIC_BASE_URL "你的 url"
setx ANTHROPIC_AUTH_TOKEN "你的 key"关键陷阱:
setx写完后,当前窗口里读不到新值——必须关掉重开一个新的 CMD/PowerShell,才能在新会话中拿到。这是最常见的「我明明设置了为什么不生效」原因。
setx 默认写到「用户变量」。如果想写到「系统变量」(所有用户共享),加 /M 参数(需要管理员权限):
setx ANTHROPIC_BASE_URL "你的 url" /M方法 4:图形化界面(适合不熟命令行的用户)
懒得敲命令?走 Windows 自带的环境变量编辑器:
- 右键「此电脑」 → 「属性」
- 点击「高级系统设置」
- 点击「环境变量」
- 在「用户变量」或「系统变量」里点「新建」
- 分别添加
ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN两条
或者更快的路径:Win + R → 输入 sysdm.cpl → 高级 → 环境变量。
设置完同样需要新开一个终端窗口。
验证:环境变量到底有没有生效
无论你用哪种方法,配完都建议跑一下 echo 确认:
PowerShell:
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKENCMD:
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%如果输出空白或者还是旧值,几乎一定是「窗口没重开」——关掉再开就好。
一张表选对方法
| 方法 | 持久化 | 是否需重开终端 | 推荐场景 |
|---|---|---|---|
PowerShell $env: | 否 | 否(当下生效) | 临时调试 / 切换 endpoint |
CMD set | 否 | 否 | 老脚本 / 临时跑一次 |
setx | 是 | 是 | 日常开发首选 |
| 图形化界面 | 是 | 是 | 不熟命令行的用户 |
OpenClaw 拼车:跳过这些手工步骤
老实说,手工配环境变量的最大问题不是难,而是容易忘。换台机器、重装系统、新开虚拟机——每次都要重来一遍,token 还得自己保管。
OpenClaw 拼车给出的解法是把这些动作打包进一行命令:
curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20xWindows 用户在 WSL、Git Bash 或 PowerShell(带 curl)里跑这条,setup.sh 会自动:
- 拉 OpenClaw CLI 安装(如果未装)
- 写好
~/.openclaw/openclaw.json配置 - 把拼车 token 注入到对应 profile
- 跑一次
openclaw doctor自检
之后你就不用再操心 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 这两个变量了——OpenClaw Gateway 会在内部代为持有,CLI 启动时自动注入子进程。换机器只要再跑一次 setup.sh。
常见问题
Q:方法 1/2 设置完关了窗口就没了,是 bug 吗?
不是。临时变量本来就只在会话内生效,这是设计如此。要持久化用方法 3 或 4。
Q:setx 设置后 echo 不出来?
100% 是窗口没重开。setx 不影响当前进程的环境块,新值只在新进程里可见。
Q:用户变量和系统变量怎么选?
只给自己用——选用户变量;机器上多个账号都要用——选系统变量(需要管理员)。OpenClaw 拼车的 token 建议放用户变量,避免误泄漏给其他账号。
Q:能不能把 token 写到 PowerShell $PROFILE 里?
可以,但不推荐——明文存档容易随仓库泄露。OpenClaw 默认走系统 keyring 或加密文件,比明文环境变量安全。
相关文章
- Windows 安装 Claude Code 完整指南 — 从 Node.js 到第一次
claude命令 - OpenClaw 完整指南 — 项目总览,搞懂 Gateway 架构
- OpenClaw CLI 命令完整参考 — 全部子命令速查
立即开始
curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x更多接入选项见 https://cp.bizq.net/setup。