CLAUDE.md 与 AGENTS.md 实战指南：一套模板同时喂饱 Claude Code 与 Codex写给正在把 AI 编程助手引入团队工程流程的开发者。本文提供一套经过验证的写作框架，以及前端、后端（Java / Python）、Monorepo 四类可直接套用的模板。一、为什么需要这个文件每个 AI 编程助手接到任务后的第一件事，都是扫描你的仓库：读目录树、读 package.json、读 README。但 README 是写给人看的——它解释项目"是什么"，却不告诉 Agent"该怎么干活"：用pnpm还是npm？跑测试的完整命令和参数是什么？哪些目录能动，哪些文件（比如已合并的数据库迁移）绝对不能碰？团队那些"不成文的规矩"——事务只能标在 Service 层、组件禁止 default export——写在哪？CLAUDE.md（Claude Code 的原生记忆文件）和AGENTS.md（Codex、Cursor、Copilot 等 30+ 工具共同遵守的开放标准）就是为解决这个问题而生的：一份提交进 Git、随代码评审演进的"给 Agent 的岗位说明书"。写好它的回报非常直接：Agent 第一次就能跑对命