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