Miniclaudecode Typescript

miniclaudecode_typescript

Claude Code 500,000+ 行 TypeScript 蒸馏为 12 个渐进式阶段 — 从一个 while 循环到多 Agent 团队

[](https://www.typescriptlang.org) [](LICENSE) []()

**📖 [在线阅读文档](https://bcefghj.github.io/miniclaudecode_typescript/)** | **📥 [HTML离线版](https://bcefghj.github.io/miniclaudecode_typescript/downloads/miniclaudecode_complete.html)** | **📄 [PDF版](https://bcefghj.github.io/miniclaudecode_typescript/downloads/miniclaudecode_complete.pdf)**

这是什么？

这是目前**唯一直接从 Claude Code 真实 TypeScript 源码蒸馏**的教学项目。不是行为推断，不是 Python 翻译，而是拿着 51 万行源码一行行提取核心模式，浓缩为 ~4,250 行可运行的 TypeScript。

Claude Code (512,664 行 TS) ──蒸馏──> miniclaudecode (4,250 行 TS)
                                     压缩比 ≈ 120:1

什么是"蒸馏"？

就像把一本 500 页的教科书浓缩成 12 页的笔记——保留核心思想，去掉冗余细节。每一行蒸馏代码都可以追溯到原版 Claude Code 的具体文件和行号。

什么是 AI Agent？

普通的聊天机器人只能"你问我答"。AI Agent 多了一个能力：**它可以使用工具**（执行命令、读写文件、搜索代码等），在一个循环中反复调用工具直到完成任务。Claude Code、Cursor、GitHub Copilot 底层都是这个模式。

快速开始

# 克隆
git clone https://github.com/bcefghj/miniclaudecode_typescript.git
cd miniclaudecode_typescript

# 安装依赖
npm install

# 设置 API Key（到 https://console.anthropic.com/ 申请）
export ANTHROPIC_API_KEY="your-key-here"

# 从最简单的开始！
npx tsx src/s01_agent_loop.ts

输入 `帮我看看当前目录有什么文件`，你的第一个 AI Agent 就在工作了！

12 个阶段一览

🟢 入门篇（s01-s03）— 理解核心循环

阶段	主题	运行命令	漫画
s01	核心循环 — while(true) + Bash	npm run s01
s02	工具系统 — 分发表 + Read/Write/Edit	npm run s02
s03	先计划再执行 — TodoWrite	npm run s03

🟡 进阶篇（s04-s06）— 智能扩展

| 阶段 | 主题 | 运行命令 | 漫画 | |--