安装前先确认环境
装 Claude Code 前，确认两件事：Node.js 够新、能装全局包。
- Node.js 18 及以上：Claude Code 基于 Node 运行。用命令检查：
node --version # 建议 >= 18
- 如果你的 Node 版本太低，先去官网装新版本（Windows 建议用 nvm-windows，macOS 用 nvm 或 Homebrew）。
贯穿项目记住我们的
todo 工具——它也是用 Node.js 写的。你现在装好的环境，就是之后做 todo 的底盘。提示别急着现在就配置 Anthropic 官方账号——本课程不依赖它，我们直接接国内模型。
安装：三个平台一致
无论 Windows、macOS 还是 Linux，安装命令都一样：
npm install -g @anthropic-ai/claude-code
装完验证：
claude --version
能看到版本号，就说明装好了。
npm 源太慢怎么办
国内直连 npm 官方源可能很慢。换成国内镜像源后再装：
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
注意改 registry 是全局的，如果之后想恢复官方源，执行
npm config set registry https://registry.npmjs.org。配置国内大模型（DeepSeek 为例）
装好工具还不够，得告诉它「用哪个模型」。Claude Code 通过两个环境变量来配置：
ANTHROPIC_BASE_URL：指向模型的「Anthropic 兼容端点」ANTHROPIC_AUTH_TOKEN：你的 API Key
为什么要「兼容端点」
Claude Code 按 Anthropic 的 API 协议去调用模型。而 DeepSeek 这类国内模型，原生提供的是 OpenAI 兼容接口。要接上 Claude Code，需要一个能把 Anthropic 请求「翻译」成 DeepSeek 请求的兼容网关——服务商通常会在文档里给出这个地址。
macOS / Linux 配置
export ANTHROPIC_BASE_URL="https://your-gateway.example.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxx"
把配置写进 ~/.zshrc（或 ~/.bashrc），下次打开终端自动生效：
echo 'export ANTHROPIC_BASE_URL="https://your-gateway.example.com/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxxx"' >> ~/.zshrc
source ~/.zshrc
Windows（PowerShell）配置
$env:ANTHROPIC_BASE_URL="https://your-gateway.example.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxx"
永久生效（写入用户环境变量）：
setx ANTHROPIC_BASE_URL "https://your-gateway.example.com/anthropic"
setx ANTHROPIC_AUTH_TOKEN "sk-xxxxxx"
设置后新开一个终端，再验证。
验证是否真的接上了
配置好后，跑一次最小测试：
claude -p "你好，请用一句话自我介绍"
-p 是「单次问答」模式，不进入交互界面，适合快速验证。能正常返回一段话，说明国内模型已经接上了。
踩坑如果报
401 / auth / 超时：端点地址填错、Key 填错或没额度、网关不可达。逐项排查，先小额度测试。本课程全程国内网络，确认不要走境外代理。落地练习：走通「装好 → 接上 → 验证」
三步检查，确认你真正准备好了：
- 跑
node --version，确认 ≥ 18 - 跑
claude --version，看到版本号 - 跑
claude -p "你好"，返回一段文字
怎么判断做对了？——三条命令都有正常输出，没有报错。第三条是「AI 真的接上」的最强信号。
卡住了怎么办？ node 命令不存在 → 先装 Node。claude 找不到 → npm 全局目录没进 PATH，或装失败了。返回报错 → 对照上文的踩坑 callout 逐项排查。
常见坑：忘记新开终端
很多新手配好环境变量后，在同一个旧终端里直接验证，结果报错，以为没配好。
其实环境变量只在「设置之后新开的终端」里生效。配置完一定要新开一个终端窗口再验证。这是最常踩的坑。
小结
- 确认 Node ≥ 18
npm install -g @anthropic-ai/claude-code安装- 设置
ANTHROPIC_BASE_URL+ANTHROPIC_AUTH_TOKEN接国内模型 claude -p "你好"验证连通- 配完记得新开终端再测
下一节，我们启动它，认识终端界面。