CLAUDE.md是用于Claude AI编程助手的项目级上下文配置文件,通常放置于代码仓库根目录。该文件以Markdown格式编写,用于向Claude提供项目背景、技术规范、编码约定及特定指令,使其在代码生成与辅助开发时能遵循项目特定的规则和上下文,从而提升协作效率与输出质量。
CLAUDE.md 的内容会被追加到提示词中,成为每次对话的上下文基础
项目级 CLAUDE.md 应该提交到版本控制系统中供整个团队共享使用
建议新项目开始时不要急着写 CLAUDE.md,先观察需要反复纠正的行为后再补充
过长的 CLAUDE.md 会压缩留给实际代码和对话的上下文窗口空间,降低模型的有效工作能力
可以使用 @ 符号加文件路径在 CLAUDE.md 中引用项目文档,如 @docs/architecture.md
当两个层级的 CLAUDE.md 配置同时存在时,它们会叠加生效
Claude.md中的信息不会因为/clear或/compact命令而丢失
AgentMD文件内容位于系统提示词和用户消息之间,作为开发者消息层存在,在每一次token生成时都被模型处理
开发者Forrest Cheung将Karpathy的观察系统化为四条可执行准则,写成CLAUDE.md文件
claude.md文件(或其开源等效文件agents.md)适用于Claude Code、OpenCode、Zest、Cursor、Codex等工具
40 more timeline events
CLAUDE.md作为项目文件可纳入Git版本控制体系,团队成员可以通过Pull Request来审查和迭代规约内容
95%待验证AgentMD文件内容位于系统提示词和用户消息之间,作为开发者消息层存在,在每一次token生成时都被模型处理
85%待验证开发者Forrest Cheung将Karpathy的观察系统化为四条可执行准则,写成CLAUDE.md文件
85%待验证Anthropic建议CLAUDE.md文件保持简洁,因为过长的内容会导致Claude开始忽略部分信息,这与Transformer架构中的注意力稀释现象有关
85%待验证可以使用 @ 符号加文件路径在 CLAUDE.md 中引用项目文档,如 @docs/architecture.md
85%待验证当两个层级的 CLAUDE.md 配置同时存在时,它们会叠加生效
85%待验证项目级 CLAUDE.md 应该提交到版本控制系统中供整个团队共享使用
85%待验证建议新项目开始时不要急着写 CLAUDE.md,先观察需要反复纠正的行为后再补充
80%已验证Claude Code 的 /init 指令可以扫描当前项目的文件结构并自动生成一份适合该项目的 CLAUDE.md
80%已验证Claude Code的Skills核心载体是CLAUDE.md文件,放置在项目根目录或特定目录下
80%已验证CLAUDE.md的设计灵感来源于.editorconfig、.eslintrc等项目级配置文件的理念
80%待验证CLAUDE.md中可以明确写出禁止项,AI读取后不会朝那个方向生成代码
80%已验证Claude Code通过项目根目录的CLAUDE.md配置文件实现持久化项目记忆,包括项目规范、编码风格、技术栈偏好等信息
80%已验证CLAUDE.md 的内容会被追加到提示词中,成为每次对话的上下文基础
65%待验证过长的 CLAUDE.md 会压缩留给实际代码和对话的上下文窗口空间,降低模型的有效工作能力
60%待验证CLAUDE.md本质上是Prompt Engineering在工程化场景中的落地实践,将零散的提示词固化为可版本控制的项目资产
60%待验证CLAUDE.md使用自然语言编写,AI能够理解语义层面的约束
60%待验证Hooks是程序化的硬约束,通过事件驱动机制强制执行,不依赖模型的自觉性,比CLAUDE.md的软约束方式更可靠
60%待验证CLAUDE.md是通过上下文注入方式影响大语言模型行为的软约束,模型在长对话中可能因上下文窗口限制或注意力分散而遗忘或忽略其中的指令
60%待验证Claude Code使用CLAUDE.md文件作为记忆文件,Cursor使用.cursorrules文件
60%