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

> 这份文档是给 **TRAE 智能体** 看的，让它替你（人类）一键装好 Claude Code。
> 你只需要：① 打开 TRAE → ② 把这份文档粘进对话 → ③ 让 TRAE 按文档执行 → ④ 等 3-5 分钟。
>
> 装完你就能在自己的 Windows 电脑上用 Claude Code 帮你写贪吃蛇、改 Excel、做网站，**一分钱不花**。

---

## 致 TRAE 智能体的任务说明

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

请按下面的「执行步骤」从头跑到尾。
- 全程在 **PowerShell** 里跑（Windows 原生 · 不要走 WSL / Git Bash）。
- 全程**联系用户确认 API key**（用户必须自己去智谱 bigmodel.cn 注册 + 领 key，你帮不了）。
- 遇报错先按下面的「7 个常见卡点」自查，再问用户。
- 跑完一定要用「验证用例」证明真的装好了，不要装完就交差。

---

## 执行步骤（TRAE 跑这些）

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

```powershell
[Environment]::OSVersion
$PSVersionTable.PSVersion
```

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

### 第 2 步 · 改 PowerShell 执行策略

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

```powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
```

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

```powershell
$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

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

装完 PATH 不会自动刷新，**当前 PowerShell 看不到 node** 是正常的。要么：
- 让当前 PowerShell 临时认 PATH：`$env:Path += ";$env:ProgramFiles\nodejs"`
- 或者关掉 PowerShell 重开一个

### 第 5 步 · 切 npm 镜像到淘宝

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

### 第 6 步 · 装 Claude Code

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

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

### 第 7 步 · 准备 onboarding skip 文件

让 Claude Code 启动时跳过引导：

```powershell
'{"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`，把 `<USER_GLM_KEY>` 替换成用户给的 key：

```json
{
  "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 后跑）：

```powershell
$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 步 · 跑一遍验证用例

```powershell
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 · 数学（最基础）

```powershell
claude --print "1+1=?"
```
**通过条件**：返回数字 2。

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

```powershell
claude --print "帮我在桌面上写一个 HTML 贪吃蛇小游戏，单文件，方向键控制"
```
**通过条件**：在桌面创建了 `.html` 文件 · 浏览器打开能跑（蛇能动 + 吃食物 + 输了能重开）。

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

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

```powershell
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/月够用）

```json
"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**：浏览器内 / 桌面应用 · 适合做演示、做网页、跟人协作
- **Claude Code**：纯命令行 · 适合写代码、改文件、做正经工程

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

---

## 文档版本与维护

- **作者**：节点 NEXUS · 点哥
- **版本**：v1（2026-06-24）
- **来源**：基于点哥本人在 Win 上实测通过的完整链路（Node 24.17 + Claude Code 2.1.186 + GLM-4.5-air）
- **反馈**：装不上 / 看不懂 / 卡哪一步 → 加抖音粉丝群问点哥
- **后续课程**：ep04 用 Claude Code 写小游戏冲击 / ep05 扒视频 / ep06 本地部署模型