Agent 开发实战课 —— 从零构建一个 Mini Claude Code（TypeScript）
视频版本：Agent到底是什么？从原理、开发到落地的一次真实分享；2026年3月14日 - 华中科技大学
完整教案：Issue #2
- 理解为什么 Agent 能"做事情"，而 ChatBot 不能
- 听得懂 ReAct 与 Agent 基本架构
- 能跑通最小 TypeScript Agent
- 带走可落地的工程经验
Agent = ReAct + Tools + UI
| 概念 | 说明 |
|---|---|
| 上下文窗口 | 维护消息历史数组，作为模型的完整输入 |
| 系统提示词 | 定义 Agent 身份、能力边界与输出规范 |
| 工具调用 | 模型生成结构化指令，触发外部能力，结果回注上下文 |
| ReAct 循环 | 观察 → 思考 → 行动，控制流从人转移到模型 |
- Agent 是怎么工作的？ — ChatBot vs Agent 的本质差异
- ReAct：让模型"边想边做" — 循环架构与控制流转移
- Agent 最小架构 —
ReAct + Tools + UI公式拆解 - 最小 Agent 实现 — 天气查询 Demo，40 行核心 Loop
- Mini Claude Code 设计 — 拆解 Claude Code，引入 Vercel AI SDK
- 工程经验 — 上下文管理、安全防护、系统提示词架构
mini-claude-code/
├── projects/
│ ├── agent-loop/ # 最小 Agent Demo：天气查询（Bun + TypeScript）
│ │ ├── main.ts # 40 行 AgentLoop 核心实现
│ │ ├── tools.ts # 工具定义（获取时间、查询天气）
│ │ └── prompt.md # ReAct 格式系统提示词
│ ├── mini-claude-code-golang/ # 教学版最小 Agent（Go 标准库）
│ │ ├── main.go # 模型调用 + loop
│ │ ├── tools.go # 文件系统工具
│ │ └── prompt.md # 最小提示词
│ ├── mini-claude-code-rust/ # 教学版最小 Agent（Rust）
│ │ ├── src/main.rs # 模型调用 + loop
│ │ ├── src/tools.rs # 文件系统工具
│ │ └── prompt.md # 最小提示词
│ └── mini-claude-code/ # Mini Claude Code 完整实现
│ ├── src/ # 核心源码
│ └── docs/ # 设计文档
└── README.md
运行最小 Agent Demo（天气查询）：
cd projects/agent-loop
bun install
bun main.ts运行 Go 版最小 Agent：
cd projects/mini-claude-code-golang
go run . "请列出当前目录，并解释这个最小 Agent 的工作流程。"运行 Rust 版最小 Agent：
cd projects/mini-claude-code-rust
cargo run -- "请列出当前目录，并解释这个最小 Agent 的工作流程。"运行 Mini Claude Code：
cd projects/mini-claude-code
bun install
bun src/index.ts需要配置
QINIU_API_KEY等对应的环境变量，详见具体项目内容。
Go 版最小 Agent 只使用标准库，默认读取
LLM_API_KEY或DEEPSEEK_API_KEY。
Rust 版最小 Agent 为了处理 HTTPS 和 JSON，使用了少量依赖。
精简到 4 个核心工具，够用不乱：
| 工具 | 说明 |
|---|---|
| Read | 读取文件内容 |
| Write / Edit | 写入与修改文件 |
| Bash | 执行 Shell 命令 |
| WebFetch | 网络请求 |
工具别贪多。每多一个，模型负担就加重。
- Runtime：Bun
- Language：TypeScript
- AI SDK：Vercel AI SDK
- 模型服务：兼容 OpenAI 协议的任意服务（演示使用七牛大模型推理）