claudecommunity
加入等待名单

// 系列

Mini Claude
Code。

从零构建的 Coding Agent，一共约 500 行 TypeScript。六集、一个可运行仓库。没有框架，没有隐藏层——每个文件都能一次读完。

去 GitHub 拿代码 ↗从第 01 集开始 →

MIT · 需 Node 20+ · 只依赖 Anthropic SDK

数据

约 500
代码行数
4
源文件
1
运行时依赖
6
集数

六集目录

每一集是一个章节，每一章都对应一份现在就能打开的文件。

  1. EP 01
    Mini Claude Code · 第 01 集：一个真的能记住上下文的 40 行 REPL
    一个动手系列的开篇——我们用 TypeScript 从零搭一个能跑的 coding agent。第 1 集先把最小闭环跑起来：stdin、streaming，以及一段能跨越多轮的对话。
    14 min
    →
  2. EP 02
    Mini Claude Code · 第 02 集：教 Agent 使用工具
    第 2 集给我们的 REPL 装上前三个工具——read_file、list_dir、run_bash——并完整走一遍 Anthropic SDK 的 tool use 循环。我们会处理 stop_reason、tool 错误，以及那件出人意料棘手的事：到底该把什么塞回对话里。
    16 min
    →
  3. EP 03
    Mini Claude Code · 第 03 集：改文件而不砸掉整个仓库
    第 3 集加入 apply_patch tool——多数自建 agent 都是死在这一步，悄无声息地毁掉你的代码。我们构建一个严格的 unified diff 应用器，配上 dry-run 预览、workspace 护栏，以及一道能扛住 Claude 犯浑的确认闸门。
    17 min
    →
  4. EP 04
    Mini Claude Code · 第 04 集：让 Agent 有目的地遗忘
    第 4 集正面硬刚 token 账单。我们实现 observation masking（JetBrains 那套在成本和质量上都胜过 LLM summarization 的技巧），并加一条 auto-continue 通道，让 max_tokens 截断不再悄悄弄坏工具调用序列。
    16 min
    →
  5. EP 05
    Mini Claude Code · 第 05 集：让 sub-agent 拥有自己的上下文
    第 5 集把 agent 一分为二。我们加入一个 spawn_subagent 工具，把带作用域的任务分派给一个全新的 Claude——它有自己的一套工具、自己的上下文窗口，最后回吐一份紧凑的摘要。这就是 Anthropic 那句『token 用量解释了 80% 的结果质量方差』背后的模式，用大约 90 行代码搞定。
    17 min
    →
  6. EP 06
    Mini Claude Code · 第 06 集：终于能告诉你是不是改砸了的 eval 循环
    第一季收官。我们造一套 15 个任务的 SWE-lite 测试架，把 agent 端到端地跑在可验证的代码任务上，再接上 prompt caching 让迭代变便宜。通过率、平均轮数、单任务成本——钉成一个 baseline，之后每次回归都拿它来对比。
    18 min
    →

三条命令跑起来

克隆、安装、启动，然后开始对话。

git clone https://github.com/claude-community/mini-claude-code
cd mini-claude-code
cp .env.example .env    # add ANTHROPIC_API_KEY
npm install
npm start

为真实仓库准备的安全模型

接下来

评测集首发 3 题，后续会推进到 SWE-lite 15 题 + 固定基线，方便你回归。有想加的任务欢迎发 PR。

去 GitHub 拿代码 ↗所有集数 →