开源Claude Harness防止AI代写代码让开发者停留在初级水平

一套免费、开源的 Claude Code 配置方案，它阻止 AI 替你编写你尚在学习编写的代码，让你即使有 AI 在一旁协助，也能自己学会编程。它面向学生，也面向职场中不想因为 AI 包揽一切而停留在初级水平的初级开发者。

这套 harness 了解你每项技能的掌握程度，并据此调整 AI 提供的帮助。你还在学习的内容，由你自己动手完成，只给提示、不给答案。你已经掌握的内容，AI 可以直接代劳，而你会不时在工作中再次亲手做一遍，以保持熟练。

只需一条命令，就能把 harness 装进你自己的项目文件夹。

等级、提示阶梯、守卫机制、用自己的话复述解释以及代码审查。

按（微）技能记录进度，附真实数据和演示。

课程参考内容：类、继承、UML、设计模式。

在随机对照试验中测试这套 harness：假设、分组与结果。

在第一次不允许使用 AI 的测试中，我卡住了。我不想让这种情况再次发生。于是我研究了 Claude 是否损害了我的学习，结论是部分确实如此。科学文献也表明这是一个真实的风险：如果你在练习时让 AI 替你思考，之后离开 AI 你能做的就会更少。像 Claude Code 这样的 AI agent 让这种“外包思考”变得非常容易（见风险评估）。这就是我构建这套 harness 的原因。

同样的风险并不会随着毕业而消失。一个让 agent 包揽所有工作的初级开发者能把活干完，却跳过了让你成长为中级或高级开发者的练习：自己写代码、调试和设计。这样的初级开发者可能一直停留在初级。对初级和高级开发者的访谈描述了这种模式，从业者在演讲和博客文章中也提到过（见 §2.12）。这是这套 harness 的第二个目标。

简而言之，这套 harness 给你的帮助足以让你不卡住，但又让事情保持足够的难度，使你真正学到东西。在仪表盘上，你可以跟踪自己技能的发展。

每个部分都遵循一条原则，并有来自学习科学和自动化研究的实证支持：见研究部分，出处列在研究笔记中。这些原则组合起来是否有效，尚未经过测试。因此，我们邀请研究人员在随机对照试验中检验它（面向研究人员）。

你是否可以使用 AI，由你的课程决定，而不是由这套 harness 决定。harness 确保 AI 不替你做练习：在 L1–L3 等级，一个 hook 会阻止它编写、构建或测试你的代码，你允许的每一次例外都会被记录。请查看你课程的 AI 政策。

是的。这正是守卫 hook 的作用：按技能、在 L1–L3 等级，它阻止 Claude 编写、删除、构建或测试你的代码。你仍可以通过自己设置的 override 临时允许它，而这会被记录。见工作原理。

可以，借助针对你课程的技能地图：技能、关键词和备注放在 harness/maps/<id>/ 中。内置的地图有面向学生的 C# 面向对象设计，以及一个面向 C#/.NET 初级开发者的示例。对于其他语言，你需要设置哪些文件是代码、哪些命令用于构建；测试运行器 check.mjs 目前只支持 dotnet test。见配置。

会。一个在自己还不会做之前就把工作交给 agent 的初级开发者能把活干完，但可能无法建立成为中级开发者所需的技能：调试、阅读代码、设计判断力以及核查 AI 输出。在一项小规模随机试验中，借助 AI 学习新库的工程师随后在测验中得分 50%，而对照组为 67%（Shen & Tamkin, 2026）。使用这套 harness，你亲手构建自己正在学习的内容，其余的交出去。见面向初级开发者。

所有内容都保存在你自己的电脑上，位于项目文件夹中的 .learning/ 目录，安装程序会确保它不被纳入 git。这些 hook 不建立任何网络连接。只有当你选择发布仪表盘时，一份经过筛选的导出才会离开该文件夹，其中带有字段白名单以及对姓名、路径和电子邮件地址的过滤。见配置与隐私。

可以。代码以 AGPL-3.0 开源，文本、文档和数据以 CC BY-NC 4.0 授权。你确实需要拥有 Claude Code 的访问权限，通过 Claude 订阅计划或 API。

这套学习 harness、仪表盘和本文档是在 Claude（Anthropic）的帮助下完成的。学习数据和仪表盘中的反思属于学习者本人。见 AI 声明。