600行TypeScript手撕一个AI agent,这个开源项目把Claude Code拆明白了

最近翻 GitHub 的时候刷到一个让人眼前一亮的东西——有人把当下最热的 AI coding agent 之一 pi 拆了个底朝天，再用 600 行 TypeScript 手撕了一个迷你版出来，整个过程可以一边读一边看着代码在右侧实时补全。这个项目叫 pi-from-scratch，作者 SaladDay，做的事情简单粗暴：把 pi 的工程细节全部删掉，只保留核心思想。

它到底在解决什么问题

现在讲 Claude Code、Cursor、Codex 的视频一抓一大把，但大部分都停留在”提示词怎么写”层面。真正想搞懂一个 coding agent 内部怎么转的人，会发现资料稀缺到难受——要么直接啃几千行 TypeScript 的源码，要么看 API 文档一脸懵。

pi-from-scratch 干的就是把这层窗户纸捅破：它沿着 pi 的数据流，一步一步告诉你”为什么需要这个模块”、”它怎么和别的模块通信”。每读一段，右侧编辑器就把对应的代码补出来；看完文章，nano-pi 这个迷你 agent 的完整代码也长在屏幕上了。作者还做了 Trace 调试视图，可以打点逐行跟执行流，比静态看代码直观得多。

更难得的是，作者明确说”保留古法手敲，尽可能没有 ai 味”。意思就是这篇文章不是 ChatGPT 一键生成的，是真的有人坐下来一行一行敲代码、一段一段讲清楚。这在 2026 年的”AI 味”写作满天飞的环境下，反而显得稀缺。

怎么用、用起来什么感觉

环境要求很轻：

• Node.js 22+
• 一个 OpenAI 兼容 API（默认 https://api.openai.com/v1）

npm install
export NANOPI_API_KEY=your-api-key
npm run dev

跑起来后，你能看到一个 nano-pi：能读文件、改代码、执行命令，跟一个迷你版的 Claude Code 没两样。但代码量只有 600 行，每一行你都能在文章里找到对应讲解。

适合谁

• 想搞懂 coding agent 内部原理的人：与其看一堆”如何写 prompt”的教程，不如直接读一遍 600 行干净代码
• 想自己撸一个 agent 的人：读完这个项目，再去 fork 一份改改，半天就能搭出自己专属的 agent
• 教学场景：把它当成 AI agent 入门课，比直接读 Anthropic 官方文档友好得多

一点吐槽

美中不足的是，文章目前只有中文版（英文 README 还在路上），star 数也才 1000 多——属于那种”开发者圈子口口相传，还没破圈”的项目。但这种”代码 + 文章 + 可视化 Trace”三件套的形式，本身就值得借鉴：讲一个复杂系统，最好能让人一边读一边看到它怎么动起来。

如果你最近在学怎么写 agent，或者想给团队培训 coding agent 的工作原理，这个项目几乎是 2026 年最有诚意的入门材料之一。

GitHub 仓库：SaladDay/pi-from-scratch（MIT，1153 ⭐，TypeScript，2026-08 创建）

GitHub: https://github.com/SaladDay/pi-from-scratch