CLAUDE.md
CLAUDE.md是用于Claude AI编程助手的项目级上下文配置文件，通常放置于代码仓库根目录。该文件以Markdown格式编写，用于向Claude提供项目背景、技术规范、编码约定及特定指令，使其在代码生成与辅助开发时能遵循项目特定的规则和上下文，从而提升协作效率与输出质量。
Core Facts
Timeline (last 90 days)
全局配置文件影响所有项目，项目级配置文件只影响特定代码库
agents.md和CLAUDE.md是Claude Code及类似工具所支持的配置文件，AI智能体启动时会自动读取并作为系统提示注入对话上下文
Theo花了约两天、十几个小时打磨全局agents.md、CLAUDE.md以及一系列自定义Skills
AGENTS.md 和 CLAUDE.md 会在 Agent 启动时被自动读取并注入上下文窗口，成为 Agent 行为的隐性约束
通过配置 .cursorrules 或 CLAUDE.md 规范文件明确技术栈版本、命名约定可控制 AI 输出质量
CLAUDE.MD是Claude Code的项目级系统提示文件，可包含项目架构说明、编码规范、技术栈约束、常用命令等信息，其内容会被注入到系统提示中
可以使用 @ 符号加文件路径在 CLAUDE.md 中引用项目文档，如 @docs/architecture.md
过长的 CLAUDE.md 会压缩留给实际代码和对话的上下文窗口空间，降低模型的有效工作能力
CLAUDE.md 的内容会被追加到提示词中，成为每次对话的上下文基础
项目级 CLAUDE.md 应该提交到版本控制系统中供整个团队共享使用
20 more timeline events
All Facts (20)
CLAUDE.md的设计灵感来源于.editorconfig、.eslintrc等项目级配置文件的理念
80%VerifiedClaude Code的Skills核心载体是CLAUDE.md文件，放置在项目根目录或特定目录下
80%VerifiedCLAUDE.md是Anthropic推出的Claude Code所支持的一种项目级配置文件
80%VerifiedClaude Code 的 /init 指令可以扫描当前项目的文件结构并自动生成一份适合该项目的 CLAUDE.md
80%VerifiedClaude Code通过项目根目录的CLAUDE.md配置文件实现持久化项目记忆，包括项目规范、编码风格、技术栈偏好等信息
80%VerifiedCLAUDE.md 的内容会被追加到提示词中，成为每次对话的上下文基础
65%VerifiedCLAUDE.md作为项目文件可纳入Git版本控制体系，团队成员可以通过Pull Request来审查和迭代规约内容
65%Unverified可以使用 @ 符号加文件路径在 CLAUDE.md 中引用项目文档，如 @docs/architecture.md
85%Unverified当两个层级的 CLAUDE.md 配置同时存在时，它们会叠加生效
85%Unverified项目级 CLAUDE.md 应该提交到版本控制系统中供整个团队共享使用
85%UnverifiedAgentMD文件内容位于系统提示词和用户消息之间，作为开发者消息层存在，在每一次token生成时都被模型处理
85%Unverified开发者Forrest Cheung将Karpathy的观察系统化为四条可执行准则，写成CLAUDE.md文件
85%UnverifiedAnthropic建议CLAUDE.md文件保持简洁，因为过长的内容会导致Claude开始忽略部分信息，这与Transformer架构中的注意力稀释现象有关
85%Unverified建议新项目开始时不要急着写 CLAUDE.md，先观察需要反复纠正的行为后再补充
80%UnverifiedCLAUDE.md中可以明确写出禁止项，AI读取后不会朝那个方向生成代码
80%Unverified过长的 CLAUDE.md 会压缩留给实际代码和对话的上下文窗口空间，降低模型的有效工作能力
60%UnverifiedCLAUDE.md通常包含技术栈声明、后端开发规范、前端开发规范、数据库设计规范和交互指令等核心模块
60%Unverified将已知Bug和修复方案写入CLAUDE.md可以避免AI重复生成有问题的代码
60%Unverified技术栈声明解决了大语言模型的多解歧义问题，将AI的搜索空间从指数级缩小到线性级
60%UnverifiedCLAUDE.md本质上是Prompt Engineering在工程化场景中的落地实践，将零散的提示词固化为可版本控制的项目资产
60%