第 2 课：环境搭建

这个项目需要的东西比较多

因为是桌面应用 + AI + Python，所以依赖稍多一些。别急，一步一步来。

你需要准备：

工具	版本要求	干嘛的
Node.js	v18+	跑 Electron 和前端
Python	3.9+	AI 会用 Python 生成 Excel
Claude Code CLI	最新版	SDK 的底层引擎
Anthropic API Key	—	调用 Claude 模型

可选但推荐：

工具	干嘛的
LibreOffice	公式重算验证（AI 用它检查公式是否正确）

第一步：检查基础环境

python
# Node.js
node --version    # 需要 v18+

# Python
python3 --version # 需要 3.9+

# Claude Code CLI
claude --version  # 如果没装：npm install -g @anthropic-ai/claude-code

第二步：设置 API Key

code
# Mac/Linux
export ANTHROPIC_API_KEY="sk-ant-你的密钥"

# 写进配置文件让它永久生效
echo 'export ANTHROPIC_API_KEY="sk-ant-你的密钥"' >> ~/.zshrc
source ~/.zshrc

第三步：安装前端依赖

code
cd demos/excel-demo

# 安装 Node.js 依赖
npm install

这会安装一大堆东西（Electron、React、Webpack 等），可能需要几分钟。

核心依赖说明：

依赖	干嘛的
`@anthropic-ai/claude-agent-sdk`	Claude Agent SDK
`electron`	桌面应用框架
`react` / `react-dom`	前端 UI 框架
`react-markdown`	渲染 AI 回复中的 Markdown
`tailwindcss`	CSS 样式框架
`webpack`	代码打包工具

第四步：设置 Python 环境

python
# 进入 agent 目录
cd agent

# 创建 Python 虚拟环境
python3 -m venv .venv

# 激活虚拟环境
source .venv/bin/activate   # Mac/Linux
# 或
.venv\Scripts\activate      # Windows

# 安装 Python 依赖
pip install -r requirements.txt

Python 依赖只有两个：

依赖	干嘛的
`openpyxl` (≥3.1.5)	创建和编辑 Excel 文件（AI 用它来生成 .xlsx）
`pandas` (≥2.3.3)	数据分析和处理（AI 处理 CSV、做数据分析用）

code
# 安装完记得回到项目根目录
cd ..

第五步：安装 LibreOffice（可选）

LibreOffice 用来做公式重算——AI 生成 Excel 后，用 LibreOffice 打开再保存，确保所有公式都正确计算了。

code
# Mac
brew install --cask libreoffice

# Ubuntu/Debian
sudo apt-get install libreoffice

# 验证安装
soffice --version

第六步：试运行！

code

# 确保在 demos/excel-demo/ 目录
npm start

这会同时启动 Webpack 开发服务器和 Electron 应用。第一次启动可能要等一会儿（在编译代码）。

如果一切顺利，你会看到一个桌面窗口弹出来，里面是聊天界面。

试着输入一条消息：

code

帮我创建一个简单的月度预算表，包含收入、支出、结余三列

然后看 AI 开始干活！

可能遇到的问题

问题 1：npm start 报 Electron 相关错误

code
# 重新安装 Electron
npm rebuild electron
# 或者
npm install electron --save-dev

问题 2：Python 虚拟环境没激活

AI 执行 Python 代码时可能找不到 openpyxl。确保 agent/.venv/ 目录存在且里面装了依赖：

code
cd agent
source .venv/bin/activate
pip list | grep openpyxl
# 应该看到 openpyxl 3.x.x

问题 3：Webpack 编译报错

code
# 清理重来
rm -rf node_modules .erb/dll
npm install
npm start

问题 4：API Key 没设置

code

Error: ANTHROPIC_API_KEY not found

确认环境变量已设置：

code
echo $ANTHROPIC_API_KEY
# 应该显示你的密钥

项目目录结构

安装完成后，完整目录结构：

python

demos/excel-demo/
├── node_modules/          ← Node 依赖（很大，不用管）
├── src/
│   ├── main/              ← Electron 主进程代码
│   └── renderer/          ← React 前端代码
├── agent/
│   ├── .venv/             ← Python 虚拟环境
│   ├── .claude/skills/    ← AI 技能文件
│   ├── requirements.txt   ← Python 依赖清单
│   ├── CLAUDE.MD          ← AI 系统提示词
│   └── problems/          ← 用户上传的文件会存这里
├── package.json
└── ...配置文件

本课小结

这个项目需要 Node.js + Python + Claude Code CLI 三件套
前端依赖用 npm install，Python 依赖用 pip install
npm start 启动开发模式，会弹出桌面窗口
LibreOffice 可选，用于公式验证

课后练习

成功启动应用后，输入"帮我做一个简单的待办事项表"看看效果
找到 agent/problems/ 目录，上传一个 Excel 文件后看看文件是不是存到了这里
打开 agent/.claude/skills/xlsx/SKILL.md，先浏览一遍，下一课会详细讲