当所有人都在给 Agent 加层时,这个 69.7k 星的项目反其道而行:用 Bash 从零搭一个 Claude Code 风格的 harness,让你看清"智能体外壳"到底由哪几块骨头拼起来。
项目:shareAI-lab/learn-claude-code
独特角度
Harness Engineering 这个词最近被反复提起,但大多数项目把 harness 藏在 SDK 后面。learn-claude-code 把它解剖成可见的循环:
工具调用循环 —— 读输入 → 调工具 → 把结果塞回上下文
上下文管理 —— 何时压缩、何时截断、何时换文件
权限边界 —— 哪些命令自动放行、哪些必须问
它不追求"更好用",追求"看得懂"。对于想理解 Claude Code 内部机制、再自己造一个的工程师,这是目前最直接的教材。
为什么现在重要
Agent 框架正在分化成两路:
一路是封装越来越厚的"黑箱平台",
另一路是极简、可审计、可改的"开放 harness"。
后者才是企业落地时敢用的那一类——因为出问题时你能解释清楚它做了什么。
适合谁
想从 0 写一个 coding agent 的工程师
在做 agent 评测、需要可控 harness 的人
对"loop engineering"好奇但被各种 SDK 绕晕的开发者
一句收尾
真正的 harness 复杂度不在代码量,而在你愿不愿意把循环暴露出来。

