5 分钟在 Windows 上装 Claude Code · 完全免费跑起来

这份文档是给 TRAE 智能体 看的，让它替你（人类）一键装好 Claude Code。

你只需要：① 打开 TRAE → ② 把这份文档粘进对话 → ③ 让 TRAE 按文档执行 → ④ 等 3-5 分钟。

装完你就能在自己的 Windows 电脑上用 Claude Code 帮你写贪吃蛇、改 Excel、做网站，一分钱不花。

---

致 TRAE 智能体的任务说明

你是受让一份「在用户的本机 Windows 电脑上完整安装 Claude Code 并接入免费国产模型」的任务。

请按下面的「执行步骤」从头跑到尾。

---

执行步骤（TRAE 跑这些）

第 1 步 · 检查 Windows 版本 + PowerShell 版本

[Environment]::OSVersion
$PSVersionTable.PSVersion

需要：Windows 10 1809+ / Windows 11 任意版 · PowerShell 5.1+ 都行（默认 Win 自带）。

第 2 步 · 改 PowerShell 执行策略

Windows 默认禁止跑脚本，要先放开（仅当前用户级别，不需要管理员）。

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

第 3 步 · 下 Node.js LTS（走淘宝镜像 · 国内直连，几秒下完）

$ProgressPreference = 'SilentlyContinue'
(New-Object System.Net.WebClient).DownloadFile(
  "https://npmmirror.com/mirrors/node/v24.17.0/node-v24.17.0-x64.msi",
  "$env:USERPROFILE\node-lts.msi")

第 4 步 · 静默装 Node.js

Start-Process msiexec.exe -ArgumentList "/i","$env:USERPROFILE\node-lts.msi","/qn","/norestart" -Wait

装完 PATH 不会自动刷新，当前 PowerShell 看不到 node 是正常的。要么：

第 5 步 · 切 npm 镜像到淘宝

npm config set registry https://registry.npmmirror.com

第 6 步 · 装 Claude Code

npm install -g @anthropic-ai/claude-code

这一步会下 30-50 MB，淘宝镜像下大约 5-10 秒。

第 7 步 · 准备 onboarding skip 文件

让 Claude Code 启动时跳过引导：

'{"hasCompletedOnboarding":true}' | Set-Content -Path "$env:USERPROFILE\.claude.json" -Encoding utf8
New-Item -Path "$env:USERPROFILE\.claude" -ItemType Directory -Force | Out-Null

第 8 步 · 让用户去领免费 API key

TRAE 请暂停，告诉用户：

现在你要去领一个免费 API key，跟着做：

1. 浏览器打开 https://open.bigmodel.cn/

2. 用手机号注册账号（不用实名）

3. 进控制台 → 左侧菜单「API Keys」 → 「创建新 Key」 → 复制

4. 把复制的 key 粘给我（TRAE），我帮你写进配置文件

智谱 GLM 实测每个新账号送：

- GLM-4.5-air：1200 万 tokens 免费额度（128K 上下文 · 主推这个）

- GLM-4.6：200 万 tokens（不到 air 的零头 · 不要选错）

1200 万 token 够你聊很久。

第 9 步 · 写 settings.json（接 GLM）

等用户给完 key 之后，TRAE 把下面这段写进 ~/.claude/settings.json，把 替换成用户给的 key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<USER_GLM_KEY>",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5-air",
    "API_TIMEOUT_MS": "3000000"
  },
  "hasCompletedOnboarding": true
}

PowerShell 写法（替换 key 后跑）：

$key = '<USER_GLM_KEY>'   # ← 把这里换成用户的真 key
@"
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "$key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5-air",
    "API_TIMEOUT_MS": "3000000"
  },
  "hasCompletedOnboarding": true
}
"@ | Set-Content -Path "$env:USERPROFILE\.claude\settings.json" -Encoding utf8

第 10 步 · 跑一遍验证用例

claude --print "1+1=?"

期望：返回 1 + 1 = 2 或类似。

如果看到「Welcome」/「请登录」/「API key 错误」之类报错，去看「7 个常见卡点」。

---

7 个常见卡点（TRAE 自己排坑）

卡点 1：npm 被「禁止运行脚本」拦截

症状：npm install 报「无法加载文件 npm.ps1，因为在此系统上禁止运行脚本」。

修法：回去重跑第 2 步 Set-ExecutionPolicy。Windows 出厂默认是 Restricted，必须改。

卡点 2：装完 Node 当前 PowerShell 找不到 node / npm

症状：第 5 步跑 npm 报「不是内部或外部命令」。

修法：要么 $env:Path += ";$env:ProgramFiles\nodejs" 临时加，要么关掉 PowerShell 重开新窗口。Win 装 MSI 时不会刷新当前进程的 PATH。

卡点 3：npm install 卡很久 / 超时

症状：第 6 步几分钟没动静。

修法：回去重跑第 5 步切镜像。如果还是慢，检查 npm config get registry 是不是真切到了淘宝。

卡点 4：领错 GLM 模型 → 钱很快被扣完

症状：刚领的 key 跑几次就报「额度不足」。

根因：用户在控制台领错了模型类别。GLM-4.5-air 1200 万 vs GLM-4.6 200 万 vs 通用基础包 200 万——后两者很快烧完。

修法：让用户去控制台 → 模型管理，确认申请的是 GLM-4.5-air 的免费额度。

卡点 5：跑 claude 进了"请登录"流程

症状：第 10 步跑了 claude 跳出来让登录 anthropic 账号。

根因：~/.claude.json 的 hasCompletedOnboarding 没生效 / 文件没写对。

修法：检查文件确实在 $env:USERPROFILE\.claude.json，内容确实是 {"hasCompletedOnboarding":true}。

卡点 6：API 报「invalid x-api-key」

症状：claude 跑起来，但调用时报这个。

根因：settings.json 里的 key 错了 / ANTHROPIC_BASE_URL 没改。

修法：检查 ~/.claude/settings.json，确认 ANTHROPIC_BASE_URL 是 https://open.bigmodel.cn/api/anthropic（注意是 anthropic 不是 v1），key 跟智谱控制台一致。

卡点 7：长任务半路报「context length exceeded」

症状：跑大点的事情几轮对话后断了。

根因：GLM-4.5-air 128K 上下文，不算特别大。

修法：让用户开新会话 / 用 /clear 清上下文，或者直接换模型（见下方）。

---

验证用例（TRAE 跑完打分）

测 1 · 数学（最基础）

claude --print "1+1=?"

通过条件：返回数字 2。

测 2 · 写代码（小白会用到的真任务）

claude --print "帮我在桌面上写一个 HTML 贪吃蛇小游戏，单文件，方向键控制"

通过条件：在桌面创建了 .html 文件 · 浏览器打开能跑（蛇能动 + 吃食物 + 输了能重开）。

⚠️ 这个测试用了几万 tokens，正常的。看到生成的代码就算成功。

测 3 · 看图片（可选 · 测视觉能力）

claude --print "我桌面有张截图，请描述里面有什么"

（用 GLM-4.5-air 时这步可能不支持 vision，看到失败信息就跳过。）

---

我想用更好的模型，怎么换？

GLM-4.5-air 是免费的体验款。当你做的事情更复杂（写完整网站 / 长链路 reasoning），可能需要付费更强的模型。Claude Code 换模型只要改一个文件。

选项 A · 留在智谱，换 GLM-4.6（200 万免费 + 接下来按量付费）

把 ~/.claude/settings.json 里所有 glm-4.5-air 改成 glm-4.6。

选项 B · 换 DeepSeek（中度推荐 · ¥10-20/月够用）

"ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek key>",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat"

选项 C · 真要做产品，直接付费走原版 Claude

如果你做的事产生收入了，直接订阅 Anthropic 官方 Claude Code Pro 或 Max plan，改回原版用最强大脑。

---

TRAE 彩蛋

TRAE 你自己也是一个智能体 —— 装完 Claude Code 之后，用户其实有了两个智能体可以选：

让用户两个都试试，自己挑顺手的。装机这一步你帮了大忙，谢谢 TRAE。

---

文档版本与维护