第 2 课：环境搭建

你需要准备什么？

开始之前，确保你的电脑上有这些东西：

1. Node.js（v18 或更高）

code
# 检查是否已安装
node --version
# 应该显示 v18.x.x 或更高

# 如果没安装，去 https://nodejs.org 下载安装

2. Claude Code CLI

这个项目依赖 Claude Code 命令行工具。它是 SDK 的底层引擎。

code
# 安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

3. Anthropic API Key

你需要一个 Anthropic 的 API 密钥，因为程序要调用 Claude 模型。

bash
# 设置环境变量（Mac/Linux）
export ANTHROPIC_API_KEY="你的密钥"

# 或者写到 .bashrc / .zshrc 里让它永久生效
echo 'export ANTHROPIC_API_KEY="你的密钥"' >> ~/.zshrc

安装项目

第一步：进入项目目录

code

cd demos/resume-generator

第二步：安装依赖

code

npm install

这会安装两个核心依赖：

依赖	版本	干嘛的
`@anthropic-ai/claude-agent-sdk`	^0.1.59	Claude Agent SDK，调用 AI 的核心库
`docx`	^9.5.1	生成 Word 文档的 JS 库（AI 会用它写代码）

还有几个开发依赖：

依赖	干嘛的
`tsx`	直接运行 TypeScript 文件，不用编译
`typescript`	TypeScript 编译器
`@types/node`	Node.js 的类型定义

第三步：试运行

code
# 方式一：用 npm start
npm start "Ada Lovelace"

# 方式二：直接用 npx tsx
npx tsx resume-generator.ts "Ada Lovelace"

如果一切顺利，你会看到 AI 开始搜索、写代码、执行，最后输出一个 resume.docx 文件。

可能遇到的问题

问题 1：提示 "ANTHROPIC_API_KEY not set"

code
# 确认环境变量是否设好了
echo $ANTHROPIC_API_KEY
# 应该显示你的密钥

# 如果是空的，重新设置
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

问题 2：npm install 报错

code
# 清理缓存重试
rm -rf node_modules package-lock.json
npm install

问题 3：运行时报 "claude not found"

说明 Claude Code CLI 没装好：

code
npm install -g @anthropic-ai/claude-code
# 确认安装成功
which claude

项目结构一览

安装完之后，你的目录长这样：

code

demos/resume-generator/
├── resume-generator.ts       ← 你要读的核心文件
├── package.json              ← 依赖配置
├── node_modules/             ← 安装的依赖包（不用管）
├── .claude/
│   └── skills/
│       └── docx/
│           ├── SKILL.md      ← 技能总入口
│           └── docx-js.md    ← docx 库的详细参考
└── agent/
    └── custom_scripts/       ← 运行后才会出现

重点关注三个文件： 1. resume-generator.ts —— 主程序，后面几课会逐行讲 2. SKILL.md —— 教 AI 怎么操作 Word 文档的"说明书" 3. docx-js.md —— docx 库的 API 参考手册

本课小结

需要 Node.js v18+、Claude Code CLI、Anthropic API Key
npm install 装好依赖就能跑
核心依赖只有两个：SDK 和 docx 库
三个重点文件：主程序 + 两个技能文件

课后练习

跑一次 npx tsx resume-generator.ts "你认识的某个公众人物"
打开生成的 agent/custom_scripts/resume.docx 看看效果
顺便看看 agent/custom_scripts/generate_resume.js——这是 AI 自己写的代码，感受一下