别让 Claude Code 只吐 Markdown：HTML 才是 Agent 时代的工作台

Thariq 在 X 上发了一篇长文，标题叫 Using Claude Code: The Unreasonable Effectiveness of HTML。它讲的不是一个新命令，也不是某个隐藏参数，而是一个很容易被忽略的习惯：让 Claude Code 输出 HTML。

这件事听起来很小，但对日常使用 AI 编程工具的人很要命。很多人还在让 Agent 交付 Markdown，然后自己再去读、筛、改、搬运。Thariq 的观点更直接：如果输出本来就要被人阅读、评审、点击、比较和继续编辑，那 HTML 往往比 Markdown 更接近最终工作台。

这篇文章在说什么？

一句话总结：Claude Code 不应该只被当成“代码生成器”，它也可以是一个临时产品经理、设计师、分析师和编辑器生成器。

Markdown 适合记录结论，但不擅长承载复杂工作。比如项目计划、代码审查报告、竞品分析、数据摘要、方案对比、交互原型，最后都会遇到同一个问题：信息太多，读起来累，后续操作更累。

HTML 的价值不在于“更漂亮”，而在于它天然支持结构、样式、状态和交互。一个页面可以有卡片、表格、筛选、折叠、颜色标记、进度条、按钮和局部编辑区域。这些东西一旦出现，AI 输出就不再像一段报告，而更像一个能继续工作的界面。

Markdown 的问题，是太像终点了

Markdown 最大的优点是简单，最大的问题也是简单。

当 Claude Code 输出一份 Markdown 计划时，你通常只能读它。你想比较方案，要来回滚动；想标注风险，要复制到别处；想让团队看懂，还要重新整理格式；想继续推进，又要把上下文喂回模型。

这就是很多 AI 输出“看起来有用，实际没被用起来”的原因。不是模型没写内容，而是内容没有变成一个可操作的对象。

HTML 刚好补上这块。它可以把信息变成界面，把结论变成入口，把计划变成状态板，把审查结果变成可以逐项处理的清单。

真正的转变：从“生成文本”到“生成工具”

这篇文章最有价值的地方，是把 Claude Code 的使用边界往外推了一步。

以前我们习惯问：它能不能帮我写函数？能不能修 bug？能不能解释代码？

但 HTML 输出带来的问题变成：它能不能帮我做一个临时工作台？

比如：

• 让 Claude Code 扫一遍代码库，输出一个带风险等级的代码审查页面
• 让它整理一组 issue，生成可筛选的优先级看板
• 让它分析几个方案，做成左右对比的决策页
• 让它为新功能生成一个可以点击的轻量原型
• 让它把复杂调研整理成一页能展开、能搜索、能复制的报告

这些东西不一定要进生产环境，但它们能显著降低“读 AI 输出”的成本。

说白了，HTML 让 Claude Code 的输出从“写给人看的文字”，变成“人可以直接操作的界面”。

为什么这对 Agent 很重要？

Agent 的问题从来不只是会不会干活，而是它干完以后，人怎么接手。

很多 AI 工具的交付物卡在半路：模型给了答案，但人还要判断优先级、拆任务、检查风险、同步团队、记录状态。中间这些动作如果仍然靠 Markdown 承载，就会很快变成信息垃圾场。

HTML 更像一个过渡层。它不要求你马上搭后台，也不要求你设计完整产品，却可以让一次 Agent 任务留下一个可浏览、可交互、可复用的结果。

这也是这篇文章里最值得借鉴的点：不要只优化 prompt，也要优化输出物的形态。

但 HTML 不是万能答案

这里也有代价。

HTML 比 Markdown 更重。它可能产生冗余样式，可能需要浏览器预览，也可能让简单问题变得过度包装。如果只是写几条命令、列几个步骤、总结一个链接，Markdown 仍然更快。

所以更实用的判断是：只要这个输出需要被多次阅读、多人协作、状态跟踪、筛选对比或继续编辑，就值得让 Claude Code 生成 HTML。

如果只是一次性笔记，别折腾。

可以直接照抄的用法

下次用 Claude Code 做复杂任务时，可以加一句：

请不要只输出 Markdown。请生成一个单文件 HTML 报告，包含摘要、风险分级、可折叠详情、待办清单和下一步建议，样式直接写在文件里，方便我本地打开查看。

如果是代码审查，可以更具体一点：

请把审查结果输出为一个 HTML 页面。每个问题用卡片展示，包含严重级别、文件路径、影响、建议修复方式和是否需要测试。顶部提供按严重级别筛选的导航。

这类提示词的关键不是“做得好看”，而是让 Claude Code 交付一个能被继续使用的页面。

我的结论

Thariq 这篇文章真正提醒人的地方是：AI 编程工具的竞争，不只是模型能力，也包括输出物设计。

Markdown 是报告，HTML 是界面。报告适合看完，界面适合继续干活。

如果你已经在用 Claude Code，却只让它吐一段段 Markdown，那确实有点浪费。下一次，不妨让它直接交付一个 HTML 工作台。你会更快发现：Agent 好不好用，有时不是因为它多聪明，而是因为它把结果递到你手里的方式更顺手。

参考来源：

• Thariq 的 X 原帖