CLAUDE.md

定义

给 Claude Code 写的"项目说明书"和"行为规范"，内容会被注入到 System Prompt 中，作为对话的第一条消息，用 标签包裹，优先级很高。

四种路径

1. 个人通用偏好类

• 位置：~/.claude/CLAUDE.md
• 用途：定义开发者个人的"全局人设"
• 特点：跨项目生效，属于用户维度的静态配置
• 示例："始终用中文回复"、"我喜欢简洁的代码风格"等

2. 项目共享规范

• 位置：项目根目录下的 CLAUDE.md
• 用途：团队协作的基石
• 特点：必须提交到 Git 版本管理中
• 内容：项目架构说明、统一的编码规范、构建命令等公共知识
• 价值：确保团队内所有成员对项目的理解是一致的，避免因信息不对称导致的幻觉或错误实现

3. 个人私有指令

• 位置：CLAUDE.local.md
• 用途：存储"不该公开"但又是当前开发者必需的上下文
• 特点：明确不应提交到 Git
• 示例："我负责 payment 模块"、"我的测试账号是 xxx"等敏感或个性化信息

4. 按文件类型分类的规则

• 位置：.claude/rules/*.md 目录
• 用途：按文件类型或业务领域进行拆分
• 特点：利用 Frontmatter 来限定某些规则仅在特定文件路径下生效
• 示例：前端规则、后端规则、测试规则等
• 价值：让 Claude Code 在处理具体任务时，能够动态加载最精准的上下文

与其他概念的关系

• 对比 OpenClaw：Claude Code 需要的是"项目要求"，而 OpenClaw 是一个私人 AI 助理 Agent，有 AGENT.md（Agent 总纲）、SOUL.md（灵魂）、IDENTITY.md（身份信息）、USER.md（主人档案）、TOOLS.md（工具清单）、HEARTBEAT.md（心跳任务）、MEMORY.md（长期记忆）等
• 从这里可以看出，两者都是基于 Markdown 的文件系统来驱动的任务，但是所设计的 .md 文件的类型又有所不同，这也跟两者的定位关系贴合的比较紧密

来源

• 深度解析Claude Code在Prompt_Context_Harness的设计与实践