10-CLAUDE.md进阶-最佳结构一

📅 2026/8/28 2:20:26
10-CLAUDE.md进阶-最佳结构一
10 · CLAUDE.md 进阶:项目记忆的最佳结构(一)——从两行「废话」到一份 Claude 真正会用的说明书你的 CLAUDE.md 只有两行:「这是一个 React 项目,用 TypeScript 写。」于是 Claude 每次都要靠猜——构建命令猜一个、目录结构猜一个、代码风格猜一个。猜错了,你就得一遍遍纠正。问题不在它,在 CLAUDE.md 写得太薄。一、从「能用」到「好用」能用的 CLAUDE.md,随便写几句,Claude 也能读进去;好用的 CLAUDE.md,是结构化、有约束、可维护的,能让 Claude 少问、少错、少返工。写 CLAUDE.md 时记住一个原则:它是写给「未来的 Claude」和「团队里的其他人」看的,不是写给现在的自己看的。所以每条信息都要「能执行」,不要堆形容词。比如「代码要写得好」没用,「禁止使用 any,错误统一用 AppError 抛出」才有用。还有一个容易被忽略的点:CLAUDE.md 本身也占上下文,它每次会话都会整个加载进去。所以不是越长越好,宁精勿多——每条写进去的东西,都要值得它每次都读一遍。二、七个推荐分节一份「好用」的 CLAUDE.md,建议按下面七个分节组织:项目概述:一句话说清是什么、给谁用。技术栈:语言、框架、关键依赖,以及版本约束。常用命令:build / test / lint / run 及必要参数。目录结构:关键目录是干什么的。代码规范:命名、风格、必须遵守的约定