KeSi「自己做一個 Claude Code」Day 01：coding agent 的核心其實是模型、迴圈、工具與 context

Coding Agent / Learning Series

把 Claude Code 拆開看：不是魔法，是模型 + 迴圈 + 工具 + context

Allen 貼的 Google Share 連到高見龍在 iT 邦幫忙與個人 Blog 同步發表的系列首篇：Day 01 - Claude Code 其實就只是一個 while 迴圈。作者打算用 30 天手刻一個教學用 coding agent「KeSi」，名稱來自台語「家私」：工具、傢伙。

來源校正：本文是作者個人專案與教學系列；作者聲明自己是 Anthropic community ambassador，但內容不是 Anthropic 官方教學，也未經 Anthropic 審稿。適合當 agent 架構拆解教材，不應視為 Claude Code 內部實作的官方說明。

Day 01 的核心地圖

組成	文章主張	工程含義
模型	agent 本身不會思考；它把問題與背景打包成 API request，向遠端模型借腦。	成本、速度、能力與錯誤模式由模型與 token/context 設計共同決定。
迴圈	coding agent 的心臟可抽象成 `while 還沒完成 → 問模型 → 執行 → 回傳結果`。	真正差異在 loop policy：何時繼續、何時停止、何時升級模型、何時要求人工判斷。
工具	模型不是自己動手，而是「許願」要讀檔、改檔、跑測試；本機程式執行並可拒絕。	權限控制、安全審核、檔案 sandbox、command approval 都應放在工具層。
context	Messages API 是 stateless；看似記得，是因為每輪都送入需要的 context。	context 管理才是從玩具 agent 走向可用 agent 的核心功夫：摘要、裁剪、快取、子任務隔離。

KeSi 30 天系列預計做什麼

從最陽春的 API request 開始。
逐步做出可在終端機對話的 Python coding agent。
支援讀測試、讀程式碼、推敲原因、修改檔案、跑測試，再回報結果。
預計加入 task list / step planning，以及在大專案中開乾淨分身搜尋、只把結論帶回主 context。
作者說 KeSi 本體扣掉設定與測試約一、二千多行；目的不是取代 Claude Code，而是讓人看懂 agent 骨架。

關鍵 caveat：文章提到必要時會用側錄方式觀察 Claude Code 實際送出的網路請求。這對學習 protocol 很有趣，但在公司環境要注意 API key、repo 內容、prompt、工具結果與客戶資料外洩風險；如果要做，應在 sandbox 專案與測試帳號上進行。

Kate 對 Allen / Hermes / Athena 的判斷

1. 教材價值高

這篇很適合拿來做 agent 基礎教材：它把 agent 的神奇感拆成可實作的四塊，對工程師 onboarding 會比抽象講「agentic workflow」有效。

2. 跟 Hermes 架構高度一致

Hermes 現在的工具層、approval、context compaction、subagent、skill/memory，本質上都可以放進這四塊地圖裡理解。

3. Athena 可以借這個敘事

Athena 若要對外說明 agent 架構，可以用「loop + tools + context + policy」做產品語言，而不是只講模型多強。