首页 / 第 0 课

环境准备：只做四件事

后面九个教程里，真正需要「先装好」的前置条件只有四项：一个终端、Node.js、能连上官方服务器的网络、一个模型 API Key。这四样齐了，九个工具里大部分都是复制一行命令的事。

约 20 分钟 Windows / macOS 双版命令全部免费

如果你是纯图形界面用户

这一课可以先跳过。豆包、WorkBuddy、ZCode、Grok Bot 都是下载即用的桌面程序，不需要 Node.js。等你准备装 Codex、Claude Code、OpenClaw、Hermes 时再回来。

01认识终端：你要输入命令的那个窗口

终端就是一块纯文字窗口，你敲一行东西、按回车，电脑执行，然后把结果显示出来。所有命令行工具都在这里跑。

Windows 怎么开

按 Win 键，输入 PowerShell，回车。窗口标题栏会显示「Windows PowerShell」。
Win11 也可以搜「终端」，打开的是同一个东西的新外壳。
看行首：显示 PS C:\Users\你的名字> 就对了。PS 这两个字母很重要——它说明你在 PowerShell 里，而不是在 CMD 里。

macOS 怎么开

按 Command + 空格，输入终端（或 Terminal），回车。
行首显示 你的名字@Mac ~ % 就对。

Windows 用户最容易踩的坑：PowerShell ≠ CMD

两者外观相似，但语法不同。在 PowerShell 里敲 && 会报 The token '&&' is not a valid statement separator；在 CMD 里敲 irm 会报「不是内部或外部命令」。看到这两类报错，先确认自己开的是哪个窗口——看行首有没有 PS。

五个够用的基础命令

作用	Windows PowerShell	macOS / Linux
看当前在哪	`pwd`	`pwd`
列出当前目录的文件	`ls` 或 `dir`	`ls`
切换目录（进文件夹）	`cd D:\项目`	`cd ~/项目`
新建目录	`mkdir 测试`	`mkdir 测试`
清屏	`cls`	`clear`

路径里有空格就必须加引号，例如 cd "D:\我的项目"。中文路径一般没问题，但个别工具会不认，遇到怪问题先换成英文目录试试。

02装 Node.js

为什么需要它：Codex、Claude Code、OpenClaw 都有 npm 安装方式，npm 是 Node.js 自带的包管理器。装了 Node.js 就等于同时装了 npm。ZCode、WorkBuddy、豆包、Grok Bot 不需要它。

版本要求（很重要，装错版本会直接失败）

工具	Node 要求	说明
OpenClaw	24.15+（推荐）	也兼容 22 LTS 的 `22.22.3+`、或 25.9+。版本不对时会明确报错，不会静默出错。
Claude Code	18+	只是 npm 安装方式的要求；它装的是原生二进制，装上之后不依赖 Node 运行。
Codex	较新版本即可	建议统一装 24 LTS，省得来回切版本。
Muse Code	不需要	官方装的是原生二进制。

结论：直接装 Node 24 LTS，能同时满足上面全部要求。

安装方式一：官网安装包（推荐给第一次装的人）

打开 nodejs.org，页面上有两个绿色按钮：LTS（长期支持版）和 Current（最新版）。选 LTS。
下载对应系统的安装包（Windows 是 .msi，macOS 是 .pkg），双击，一路「下一步」。
Windows 安装过程中有一个「Tools for Native Modules」的勾选框，不用勾，会额外下载几百 MB 的编译工具，用不上。
装完关掉现有的终端窗口，重新开一个。这一步不能省，否则新命令找不到。

安装方式二：命令行装

Windows PowerShell需要管理员权限时可先右键「以管理员身份运行」

winget install OpenJS.NodeJS.LTS

macOS先装 Homebrew，见下

brew install node@24

macOS 没装 Homebrew 的话

macOS TerminalHomebrew 官方安装脚本

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

装完按终端最后输出的两行提示，把 brew 加进 PATH（通常是 eval "$(/opt/homebrew/bin/brew shellenv)"）。不加的话后面所有 brew 命令都会提示找不到。

验证

两个系统都一样能打印出版本号就成功

node -v
npm -v

正常输出类似 v24.9.0 和 11.6.0。如果你看到 'node' 不是内部或外部命令，八成是装完没重开终端，或者安装时没勾「Add to PATH」——重装一次、勾上即可。

03国内网络：两件不同的事

很多人把它们混成一件，结果白折腾。要分开看：

问题	现象	解法
npm 下载慢或超时	`npm install` 卡住、`ETIMEDOUT`、几十 KB/s	换国内镜像源，一条命令搞定，见下。
登录和安装脚本连不上	`claude.ai`、`chatgpt.com`、`dev.meta.ai`、`x.ai` 打不开或超时	换镜像源没用，这些是境外服务，需要你自己的网络代理。这是客观情况，不是配置错误。

换 npm 国内镜像

两个系统都一样阿里云维护的 npmmirror，国内常用

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

# 以后想换回官方源
npm config set registry https://registry.npmjs.org

验证：npm config get registry，应输出 https://registry.npmmirror.com/。

注意：镜像只解决「下载 npm 包」这一件事。工具装好之后要登录账号或调用境外模型 API，那部分还是走你自己的网络，镜像帮不上。

先做一次连通性自检

Windows PowerShell看目标域名 443 端口通不通

Test-NetConnection claude.ai -Port 443
Test-NetConnection chatgpt.com -Port 443

macOS Terminal看有没有正常 HTTP 响应

curl -I https://claude.ai/install.sh
curl -I https://chatgpt.com/codex/install.sh

Windows 上注意：PowerShell 里的 curl 是 Invoke-WebRequest 的别名，不认 -I 参数。要用真的 curl 就写 curl.exe。

装到一半卡住的判断方法

命令输出停在 Resolving... 或一直 npm WARN 转圈，多数是网络而不是命令写错。先按上面的自检跑一遍，能省掉大量「以为是安装步骤错了」的时间。

04API Key：它是什么、放哪里

Key 就是一串很长的密码，格式通常以 sk- 开头。它代表「这次调用算在这个账号上、记这个账号的钱」，所以不要发到群里、不要提交到 GitHub。

两种用法，工具都支持：

登录账号（推荐给新手）：工具会打开浏览器让你登录，把凭据存在本地。Codex、Claude Code、Muse Code 都支持。好处是不用管 key 泄露，额度按订阅走。
填 API Key：适合你只有一个 key、或者用的是第三方中转。设置成环境变量，工具会自动读取。

把 Key 设成环境变量

Windows PowerShell · 当前窗口临时生效关掉窗口就没了，适合先试

$env:OPENAI_API_KEY = "sk-你的key"
$env:ANTHROPIC_API_KEY = "sk-ant-你的key"

Windows · 永久生效设完必须重开终端

setx OPENAI_API_KEY "sk-你的key"

macOS · 当前窗口临时生效写进 ~/.zshrc 才能永久

export OPENAI_API_KEY="sk-你的key"

# 永久：追加到配置文件后重开终端
echo 'export OPENAI_API_KEY="sk-你的key"' >> ~/.zshrc
source ~/.zshrc

验证：Windows 用 echo $env:OPENAI_API_KEY，macOS 用 echo $OPENAI_API_KEY。能打印出你的 key 就说明生效了。

三个关于钱的提醒

订阅制（ChatGPT Plus、Claude Pro）和 API 是两套计费。订阅了 ChatGPT 不等于 API 免费，反之也一样。
API 按 token 计费，agent 一次任务可能调用几十次模型，账单涨得比你想象快。第一次用先把额度上限设低。
第三方「中转 key」便宜但会看到你的全部对话内容。涉及公司资料、客户信息时不要用。

05建议顺手装的两样

Git（强烈建议）

不是为了写代码，是为了能回滚。agent 改错文件时，一条 git checkout . 就能全部还原。这是给 agent 上保险最便宜的办法。

Windows PowerShell或用 Git for Windows 官网安装包

winget install Git.Git

macOS装完 Xcode 命令行工具也会带上 git

brew install git

验证 git --version。用法只有三步：进到项目目录，git init，git add -A && git commit -m "开工前"。之后就随便让 agent 折腾了。

Windows 上还有一个额外理由：Claude Code 在原生 Windows 下如果没有 Git Bash，会退而用 PowerShell 执行命令，某些场景行为不同。装了 Git for Windows 体验更稳。

VS Code（可选）

它自带一个终端面板，省得在两个窗口间切；也能直接看到 agent 改了哪个文件、改了什么（左侧源代码管理面板里的红绿 diff）。装不装都行。

06开跑前的自检清单

#	检查项	命令 / 判断标准
1	终端能打开	窗口里能敲命令、回车有反应
2	Node 版本够	`node -v` 输出 v24.x（装 OpenClaw 必须）
3	npm 能装包	`npm -v` 有输出，且已换国内镜像
4	目标站点能连	自检命令不通 → 先解决网络，别急着装
5	有一个能用的账号或 key	决定好用「登录」还是「填 key」
6	有一个空文件夹用来试验	`mkdir ai-test`，别拿真实项目开刀

六项都打勾，就可以从豆包开始，或者直接跳到你想装的那个工具的页面。

命令来源：Node.js 官方、npm 官方、Homebrew 官方、Git 官方。镜像地址为阿里云 npmmirror（npmmirror.com）。
网络自检只能告诉你「通不通」，通不通取决于你所在网络环境，本站不做任何网络方案推荐。