一个开发者受够了Claude Code天书般的官方文档,自己动手做了个交互式网站,让你先看到“装好的柜子”长啥样,再决定怎么用那些“螺丝钉”。这个思路可能比90%的官方文档都有效。
学习一个新工具最劝退的瞬间是什么?
一个开发者给出了一个近乎完美的比喻:就像有人递给你一盒宜家零件,却没给你看最终那个书架成品的照片。你看着满地螺丝和木板,完全不知道它们最终要拼成什么。
这就是他学习Claude Code时的真实感受。官方文档详细解释了每个配置项:`.claude/`目录、skills、hooks、agents……但它们是孤立的。他始终无法建立一个整体认知。
于是他做了个所有人都想过但没动手的事:他自己动手,把那个“书架”给造了出来。
他创建了一个叫 exploreclaudecode.com 的网站。这网站整个就是一个可以在浏览器里探索的模拟Claude Code项目。左边是真实的文件树,右边是你点击任何文件后,它会用大白话解释这个文件是干嘛的、为什么要存在、以及你什么时候会用到它。
最妙的是,整个网站就是他用Claude Code自己写出来的。一个AI工具,在帮他搭建一个教别人如何用这个AI工具的网站。
这件事的真正启发在于,它点破了技术学习中一个被长期忽视的关键:我们缺的不是对每个零件的详尽说明,而是对整个系统“形状”的直观感知。先看到成品的模样,再回头去理解每个零件的作用,效率和体验会完全不同。
如果你也曾被某个工具的复杂配置劝退,那么你缺的可能不是又一份技术文档,而是一张能看清全貌的地图。
我们每天都在用的工具里,到底有多少也缺了这么一张“成品效果图”?
最好的产品教育,不是功能罗列,而是帮你建立心智模型。这个独立项目比很多官方文档做得都好,因为它回答了那个最重要的问题:“这个文件到底为什么会存在于这里?”,而不是“这个文件是干嘛的”。