CLAUDE.md 完全指南❗️一次写好长期复用～

为什么你的 Claude 总不按要求干活？ 大概率是 CLAUDE.md 没写对。这篇讲透怎么写、放哪、怎么维护,建议先收藏👇 1️⃣ CLAUDE.md 是什么 放在项目里的一个 Markdown 配置文件,相当于给 AI 的「项目说明书」。Claude 每次新会话自动读取,获得持续的项目背景。 ⚠️ 最重要的认知：它是"行为引导",不是强制规则。想一定禁止某个操作,光写一句不够,得靠 hook 或权限。 2️⃣ 该写哪五块 项目背景（一句话讲清定位与目标）、技术栈与工具、项目约定（规范与流程）、沟通偏好（回复语言、格式）、希望规避的操作。 3️⃣ 怎么写遵守度才高 量化具体："回复简洁"→"控制在 3 段以内"； 措辞明确："尽量不用 emoji"→"绝对不要用 emoji"； 控制长度：单文件尽量 <200 行,越长越容易被忽略。 4️⃣ 放在哪一层 ①组织级（全机器生效） ②用户级 ~/.claude/CLAUDE.md（个人偏好） ③项目级 CLAUDE.md（团队共享随库走） ④本地级 CLAUDE.local.md（只对你+当前项目,记得加 .gitignore）。 5️⃣ 怎么长期维护 /init 扫描项目自动生成； AI 没按预期就立刻把要求补进去； 定期删“过时/重复”指令保持精简； 大项目用 .claude/rules/ 按路径加载,省上下文。 6️⃣ 自动记忆（新功能） Claude 现在能自己记笔记,根据你的纠正和偏好,把常用命令、调试经验、代码风格跨会话保留。默认开启,用 /memory 查看管理。 7️⃣ 跨工具适配 Claude Code 读 CLAUDE.md,Codex/Kimi 等读 AGENTS.md。可以在 CLAUDE.md 里导入 AGENTS.md,两套工具共用一份,不必写两遍。 划重点：CLAUDE.md 是行为引导,不是硬约束。凡是"必须执行/必须禁止"的规则,用 hook 或权限强制,比写在文件里靠谱得多🔑 #ClaudeCode #Claude #AI工具 #效率提升 #AI教程 #干货笔记 #零基础学AI #AI人工智能 #vibecoding