关键字 · FLOORPLAN
Floorplan:让 Claude 或 Codex 读完你的代码,画出一张能点开、能提问的应用地图
开源插件 Floorplan:Claude Code 或 Codex 读完代码库,画出一张可交互的应用地图,每个部分都用大白话命名,还能提问和做安全体检。
你用 AI 做了一个应用,它能跑。可是如果有人问「用户结账时到底发生了什么」或者「改这里会不会坏掉别的」,老实说你可能答不上来。Floorplan 就是为这个问题做的:让 Claude Code 或 Codex 读一遍你的代码,几分钟后给你一张能探索、能提问、还能随着你改代码一起更新的地图。
它是开源的(MIT 许可),作者是 haydenschmitty,在 GitHub 上大约有 4,700 颗星。
01它是什么,你能得到什么
Floorplan 是 Claude Code 和 Codex 的插件。它会扫描你的代码,把每个部分、每个文件、每个网络请求都起一个大白话的名字,并把它们之间的连接都画出来。主要功能:
- 多层缩放的地图:从整个应用开始,双击进入某个部分、一组文件、单个文件和它的接口,每一层都显示谁在用它、它又用了谁;
- 处处大白话:写的是「在结账时收银行卡付款」,而不是「Stripe API 封装」,专业词汇鼠标悬停有解释,一个开关就能切到开发者视图;
- 真实的连接,跨仓库也行:它会追踪 import,并把前端的每个请求对应到回应它的后端接口,即使前后端在不同仓库;
- 从一个页面开始:选一个你熟悉的页面,看它背后的一切,包括组件、请求、服务器代码、数据和外部服务;
- 向地图提问:比如「退款是怎么回到客户卡上的?」,会得到答案和一张只含相关部分的小地图,加上一步步的讲解;
- 安全体检:找出 AI 做的应用里常见的问题,比如代码里写死的密钥、谁都能读的 Supabase 表、开放的 Firebase 规则、可被伪造的 Stripe webhook、不用登录的接口,每一项都附可直接粘贴的修复提示。它是检查,不是审计;
- 最近改动:AI 刚改过的卡片会亮绿色,并说明这个改动和你的要求有什么关系。
还没写代码?它也能根据 PRD、需求文档或一段描述画出一张「蓝图」,列出你需要做的每个部分、文件、接口和页面,蓝图里的卡片是虚线,表示这只是计划。
02你需要准备什么
- Node.js 18 或以上;
- Claude Code 或 Codex 其中之一;
- 不需要 API key,用的是你已有的 Claude 或 ChatGPT 套餐额度。
03怎么安装
Claude Code(桌面版的 Code 页面或命令行都可以),依次运行:
- claude plugin marketplace add haydenschmitty/floorplan
- claude plugin install floorplan@floorplan
然后开一个新会话就能用了。即使你用的是桌面版,作者也建议装上 Claude Code 命令行,因为地图上的提问栏要靠它读取你真实的代码。
Codex(用 ChatGPT 登录,不需要终端):在 Codex 应用里打开 Plugins,选 Add a marketplace,Source 填 haydenschmitty/floorplan,点 Add marketplace,找到 Floorplan 点 + 安装。也可以在终端运行:
- codex plugin marketplace add haydenschmitty/floorplan
- codex plugin add floorplan@floorplan
04怎么用
- 第 1 步:在 Claude Code 或 Codex 里打开你的项目。如果前端和后端是两个仓库,就打开装着它们两个的上层文件夹;
- 第 2 步:输入 Make me a floorplan of this app.(在 Codex 里也可以直接输入 $floorplan);
- 第 3 步:开始探索。地图会自己打开,先带你走一个简短的导览;
- 第 4 步:之后做了更多改动,就说 Update the floorplan.,它只会重新读改过的部分,你刚做的工作会出现在「Recent work」里。
05要知道的事
- 会加什么到你的项目:一个 floorplan/ 文件夹放地图;在 Claude Code 里如果你同意,还会在 CLAUDE.local.md 里加一小段说明。这两样都不会被提交到 git;
- 隐私:扫描、地图和它的小型本地服务器都在你的电脑上运行,服务器只接受本机连接;没有统计和追踪;体检只显示密钥在哪,不会存储或显示密钥本身;
- 安全:没有 hooks、没有 MCP 服务器、没有依赖,不下载任何东西;唯一的对外请求是你自愿加入的候补名单;
- 时间和费用:小应用第一次画图要几分钟,大项目更久,因为每个文件和接口都要描述;用的是你自己 Claude 或 ChatGPT 套餐的额度;
- 支持的语言很多,包括 TypeScript、JavaScript、Python、Go、Rust、Java、Swift、C#、PHP 等;
- 许可:MIT,免费开源。
06相关链接
下一个好用的工具是什么?
每条视频都有一篇完整详情。关注 @serrini666,第一时间看到新分享。