073、CLAUDE.md 与 AGENTS.md 设计：项目级指令的自定义语法与最佳实践一个让我凌晨三点还在改 prompt 的坑上周五晚上，团队在排查一个生产环境的 Redis 连接池泄漏问题。我习惯性地在项目根目录敲下claude，准备让 Claude Code 帮我分析一段诡异的连接回收代码。结果它给我返回了一堆关于“如何优化数据库索引”的建议——完全跑偏了。我盯着终端愣了三秒，然后意识到：Claude Code 根本不知道这个项目是做什么的，不知道我们用的是 Lettuce 而不是 Jedis，不知道我们内部有自定义的连接池监控注解，更不知道这个模块是核心交易链路的一部分。那一刻我明白，不是 Claude Code 不够聪明，是我没有给它正确的上下文。从那以后，我开始认真研究 CLAUDE.md 和 AGENTS.md 的设计，这两个文件直接决定了 AI 助手在你项目里的“智商”和“行为规范”。CLAUDE.md：项目的“身份证”和“操作手册”CLAUDE.md 是 Claude Code 读取的第一个项目级配置文件。它告诉 AI：你是谁、你在做什么、你希望我怎么帮你。基础结构，别写成流水账我见过太多人把 CLAUDE.md 写成 README 的复制品。别这样写。CLAUDE.md 的核心是行为约束