有人干了件挺轴的事。

他把代码库里所有的注释全删了，一条不剩，删掉大约十六万八千行。然后拿同一个 AI agent，在带注释和不带注释两份代码上跑同一批任务，每个任务跑三遍。

结果有点扫兴：写出来的代码一样能用。lint、类型检查、原有测试全过，大任务里还有个 agent 没见过的隐藏测试，六次运行全都过了。小任务不带注释那份还省了大约百分之二十二的花费——道理很简单，少读那么多字，自然便宜。

大任务里埋了个坑。窗口置顶的状态得扛住刷新，而存会话的那个 PHP 函数会把不认识的键悄悄丢掉。漏了这一步，功能看着好好的，一刷新就没了。这种事本来最该靠注释提醒，结果带注释不带注释，六次全找着了。

我最有感觉的不是这个结果，是他特意强调的一件事：他原本打算每边只跑一次，后来庆幸没这么干。带注释那三次花了 821 万、879 万、1017 万 token；不带注释那三次是 701 万、970 万、1064 万。随便挑一次来比，你能写出两篇结论完全相反的博客——一边说删注释贵三成，一边说便宜三成。同一天，同一份代码，同一个任务。

苏轼写春江晚景，说水暖了先知道的是水里的鸭子。水温变了是事实，但哪只鸭子先叫、叫得多响，全是偶然。你只盯着一次，看到的就是那只鸭子的运气。

那十六万行注释，本来大部分还是 agent 自己写的。删掉之后，它照样干活。

AIagent 代码注释 ClaudeCode