
两天内,通过 Claude Code 提交了 32,784 行代码。这一数字随后被发布在社交平台上,并附注:“代码行数是一个薄弱的指标。”这并非谦辞,而是该项目中最无用的事实。本文旨在探讨那些真正重要的变化。
这两天的工作成果包括:基于 Next.js 16 对网站进行全面重建;依据真实关键词数据重写 228 篇博客文章;543 项测试全部通过,且实现零错误链接。两年前,类似项目需耗时数周,而此次打字与写作均非瓶颈。最耗时的环节在于决定构建什么,以及放弃什么。
核心转变:生成成本趋零,决策成本不变
使用 AI 代理编写代码的成本已降至接近零,但决定哪些代码应当存在的成本并未改变。日常工作重心从敲代码和调试语法,转向明确约束条件、审查差异(diffs)、拒绝需求及验证输出。开发者角色转变为审查者与编辑,AI 代理则成为快速且严格按字面执行的构建者。
关键经验总结:
- 在编写提示词前先行写下约束条件,否则代理可能破坏未提及的规则。
- 将测试视为契约,而非事后补充。
- 最具价值的交付物往往是一次删除。
32,784 行代码的实际构成
“32,784 行”本身缺乏实质信息,其实际工作内容分解如下:
- 基于 Next.js 16 的重建:网站原于 2025 年 12 月作为 Astro 项目启动。新版本运行在带有 Cache Components 的 Next.js 16 上,包含设计改版、共享组件及主要页面集重写。几乎所有路由均需重建,同时保持旧站点所有路由可用。
- 228 篇文章重写:基于真实查询数据重新制作每篇文章的标题、元描述及引言,而非依赖直觉。
- 543 项测试通过:覆盖元数据规则、结构化数据、站点地图、llms.txt 输出等,确保快速合并代码的安全性。
- 零错误链接:所有在线 URL 必须返回状态码 200 并展示真实内容,避免改版导致索引资产损失。
上述工作最终形成约 100 次提交和 11 个合并的拉取请求(PR),时间跨度为 10 月 21 日深夜至 10 月 23 日上午。
为何摒弃代码行数指标
代码行数长期以来是衡量产出的糟糕指标,AI 的普及加剧了这一问题,因为生成代码几乎免费。真正的瓶颈已从编写转移到验证和集成。在这 32,784 行代码中,包含了大量生成后又被删除的代码。若以行数衡量,删除行为被视为负面,但实际上这是项目中最佳的决策之一。
更有效的追踪指标包括:
- 测试是否通过且真正检查了行为?
- 所有以前被索引的 URL 是否仍返回 200?
- 变更是否减少了需要维护的表面面积(更少的路由、概念和出错点)?
- 能否解释差异中的每一个决策?
METR 研究显示,经验丰富的开发者在使用 AI 工具时,在仓库上花费的时间反而增加了 19%。产出感像是进步,但通常并非如此。通过测量难以造假的指标,才能逃脱这一陷阱。
Claude Code 最佳实践工作流
有效的工作流并非依赖魔法提示词,而是围绕代理建立的工作习惯:
1. 在第一个提示词之前写下约束条件
代理仅能基于上下文行动。对于本次重建,约束条件包括:不破坏任何在线 URL、保持标题稳定、禁用特定短语等。这些规则被保存在代理会话开始时读取的指令中,并在发现违规时追加新约束。
2. 将测试作为契约
当代码生成速度极快时,测试成为自动审查机制。若标题违反规则或路由消失,相应测试即失败。规则是:发现代理错误后,不仅修复它,更要添加捕获该错误的测试,防止后续会话重犯。
3. 确保每次合并足够小以便于审查
通过 100 次提交和 11 个 PR 分片合并,避免巨大差异隐藏 Bug。在每批工作完成后进行审查,确保持续可控。生成速度不是限制因素,审查能力才是。
4. 将审计作为循环,而非最后一步
建立“代理审计-阅读结果-人工决策-修复-再审计”的循环。代理擅长生成列表,但不擅长判断价值,因此必须由人工决定哪些发现值得投入时间。
5. 并行委托仅限清晰可分离的任务
仅在任务不触及相同文件时使用子代理或并行会话。并行性会成倍增加审查负担,需确保审查仍然容易。
案例:最有价值的交付是一次删除
10 月 23 日上午,作者删除了一个刚完成版本控制、文档齐全且经过测试的公开 JSON API。原因在于:该网站作为作品集,API 未带来 SEO 或 AI 发现价值,反而生成了约 500 个额外静态页面。移除后,静态页面数量从 1,093 个减少到 596 个。
当构建成本高昂时,成本迫使人们筛选;当构建几乎免费时,筛选器消失,易交付大量精良但无人需要的功能。问题已从“我能构建它吗?”转变为“它应该存在吗?”。
数据胜过直觉:228 篇文章的重写逻辑
通过 DataForSEO API(调用 313 次,花费 4.37 美元)获取关键词数据,指导文章重写。发现包括:
- 具体的工具对比(如“cursor vs claude code”)难度较低,值得争取;头部词汇不值得追逐。
- 招聘意图查询比品牌词更重要。
- 现有文章往往内容正确但标题不佳,需重写标题而非新建文章。
此外,作者拒绝了一个月搜索量约 720 次但听感不佳的短语,体现了“品味”在 AI 时代的重要性。代理无法决定网站希望呈现的自我形象。
Claude Code 的局限与错误
代理并非完美无缺:
- 破坏受保护 URL:初期曾将分页和隐藏项目重定向或变为 404,后经修复并确立永久规则。
- 遵循自身逻辑而非意图:代理倾向于优化结构,需明确告知保留已有功能的目标。
- 构建通过不等于正确:编译和测试通过仅保证内部一致性,内容表达的正确性仍需人工查看。
这些错误通过测试和小批量合并被低成本捕捉,工作流程的目的正是让代理的错误变得廉价。
新瓶颈:判断力、品味与分发
随着执行力不再稀缺,新的瓶颈显现:
- 判断力:决定哪些问题值得解决。例如,是否应构建 JSON API。
- 品味:识别何时算“够好”,何时文案像人而非模板。代理产生的合格输出往往是问题所在。
- 分发:确保搜索引擎和 AI 工具能正确读取网站,如优化 llms.txt 和关键词。
工程技能并未变得无关紧要,反而更为重要。信任输出需要知道什么是好的,写出有用约束需要理解潜在错误,快速审查需要深厚经验。对于早期职业开发者,批判性阅读代码、理解系统及培养构建观点的能力,是工具无法赋予的核心技能。
常见问题与建议
Claude Code 能重建整个网站吗?可以,但需在监督和约束下进行。它快速重建结构,但也可能破坏索引 URL 或构建无用功能。
AI 编码中最大的瓶颈是什么?对团队而言是审查,对独立构建者而言是决定是否有必要构建。
你仍然需要懂编程吗?是的,甚至更需要。作为高速审查者,需快速识别坏代码、脆弱设计和静默回归。
若重来一次,作者会在第一天就编写 URL 保留测试,更早明确网站用途以避免无用构建,并将更多时间花在发布选择和推广上,而非代码本身。