来源信息

  • 文档类型：阅读笔记 · 整理日期 2026-10-07
  • 原文：《Using Claude Code: the unreasonable effectiveness of HTML》 · 作者 Thariq Shihipar · 发布于 claude.dev · 发布日期 2026-05-20
  • 原文地址：https://claude.dev/blog/using-claude-code-the-unreasonable-effectiveness-of-html/
  • 本文为阅读整理，观点与数据以原文为准；原文不提供的事实均已标注为整理者说明。

阅读范围

  • 全文，覆盖五项优势、起步、五类用途、问答和保持参与的结语。

为什么选择 HTML

作者认为长 Markdown 限制了自己阅读复杂计划的意愿。HTML 可结合表格、CSS、SVG、图像及交互，利用导航和响应布局提高可读性；托管后便于链接分享。滑块与选项还能把人的调整导出成提示，缩短反馈循环。Claude Code 可获取多种授权资料，但资料入口不代表自动获得读取许可。

起步只需说明产物用途与期望，不一定先建技能。关键是让人更容易检查模型的选择，并非追求页面更漂亮。

五类用途与闭环

  • 规格、规划与探索：并排比较方案，逐步形成原型和实现计划，再供实现与验证参考。
  • 代码审查与理解：显示实际差异、旁注和流程，帮助读者定位问题。
  • 设计与原型：呈现样式参数、组件和动画，即使最终平台不是网页也可先讨论。
  • 报告、研究与学习：通过导航、图示和代码出处组织复杂解释。
  • 临时编辑界面：为当前数据提供排序、选择或调参界面，最终导出 JSON、差异或提示，交回工作流程。

作者问答承认 HTML 通常需要更多 token，其偏好明显偏向 HTML；多个文件可以记录规划的不同阶段。结语强调的是继续参与决策。文中的特定模型窗口规模不应当作所有模型的参数。

适用限制

这是个人经验，未证明 HTML 普遍优于 Markdown。页面布局可能让遗漏不易察觉，图表与交互也可能错误。可执行脚本、外部资源、托管访问和导出兼容性需要按具体用途检查。本文仍按知识库规范保存 Markdown，未生成页面、部署或分享外部产物。

游戏开发应用建议

以下为整理者建议，非原文实测，也不表示已经实施。

要塞 NPC 玩法探索可在同一视图比较巡逻、生产和支援方案，列出玩家收益、资源需求与打断规则；选定方向后保留选择依据。动画调参可使用滑块展示时长和缓动，但需导出单位、参数名和适用状态，防止预览与引擎实现含义不一致。

资源争用报告可把状态流、失败案例和日志出处放在一起，允许按 NPC 或资源查看；可视化只帮助定位，正确性仍靠复现与断言。导出动作宜先给可审阅的变更数据，再由获授权流程写入，避免拖动控件直接改动项目文件。

对长期维护的规则，保留简洁文字和原始数据更容易检索；对一次性比较或难以口述的体验，交互页面可能更有帮助。可先用一个小问题检验是否减少误解、是否能准确回传选择，不必因文章偏好迁移全部笔记。

小结

HTML 的潜在价值是让复杂信息可看、可试、可反馈；导出闭环与可核查内容比格式本身更重要。

参考来源

相关笔记