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 集：四十行、真的記得住話的 REPL
    動手做系列的開端——我們用 TypeScript 從零打造一個能跑的 coding agent。第一集先把最小可運作的迴圈跑起來：stdin、串流輸出，以及一段能跨回合活下來的對話。
    14 min
    →
  2. EP 02
    Mini Claude Code · 第 02 集：教會 Agent 使用工具
    第 2 集為我們的 REPL 加上前三個工具——read_file、list_dir、run_bash——並帶你走過使用 Anthropic SDK 的 tool use 迴圈。我們會處理 stop reason、工具錯誤，以及那個出乎意料棘手的部分：到底要把什麼東西塞回對話裡。
    16 min
    →
  3. EP 03
    Mini Claude Code · 第 03 集：改動檔案而不搞爛整個 repo
    第 3 集加入 apply_patch 工具——大多數 agent 就是在這一步默默毀掉你的心血。我們打造一支嚴格的 unified diff 套用器，配上 dry-run 預覽、工作區護欄，以及一道就算 Claude 心情不好也頂得住的確認關卡。
    17 min
    →
  4. EP 04
    Mini Claude Code · 第 04 集：讓代理人有目的地遺忘
    第 4 集正面迎戰 token 帳單。我們實作 observation masking（JetBrains 團隊示範的技巧，在成本與品質上都勝過 LLM summarization），並加上一條 auto-continue 路徑，讓 max_tokens 截斷不再默默地破壞工具序列。
    16 min
    →
  5. EP 05
    Mini Claude Code · 第 05 集：孵化擁有獨立上下文視窗的子代理人
    第 5 集把代理人一分為二。我們加入一個 spawn_subagent 工具，把有範圍的任務派給一個全新的 Claude，讓它擁有自己的工具集與自己的上下文視窗，最後回傳一段精簡的摘要。這正是 Anthropic 那句「token 使用量能解釋 80% 成果品質變異」背後的模式，用約 90 行程式碼實現。
    17 min
    →
  6. EP 06
    Mini Claude Code · 第 06 集：一套終於能告訴你「是不是變糟了」的評測迴圈
    本季完結。我們建一套 15 個任務的 SWE-lite 測試骨架，讓代理人端到端地跑過一組可驗證的程式碼任務，並接上 prompt caching 讓迭代變得便宜。通過率、平均回合數、每個任務的成本——釘成一份你可以回歸比較的 baseline。
    18 min
    →

三條指令跑起來

clone、install、start，然後開始對話。

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 題 + 固定 baseline，方便你回歸。想加任務歡迎發 PR。

到 GitHub 取原始碼 ↗所有集數 →