CLAUDE.md 项目级指令文件（Claude Code 项目宪法）

方法定义

在项目根目录放置 CLAUDE.md，作为 Claude Code 启动会话时读取的项目级指令文件。它承载项目目标、目录结构、技术栈、命令清单、约束与限制，因此被橙皮书（claude-code-orange-book（Claude Code 橙皮书仓库））称为"项目宪法"。

适合哪些情况

• 项目跨多次会话或多人协作，需要让 Claude Code 每次都遵循同一套规则
• 项目有较复杂的目录结构、技术栈与命令约定
• 需要把"什么不能做"的限制（凭据位置、禁止命令、网络访问）显式写明
• 想避免在每次提示中重复说明项目背景

常见做法

• 在 CLAUDE.md 顶部写清项目目标、用户画像与验收标准
• 在中段固定目录结构、技术栈、构建与测试命令
• 在尾段列出限制：禁止修改的文件、禁止执行的命令、凭证存放位置、对外网访问的边界
• 保持 CLAUDE.md 与代码同步：项目结构或命令变了就更新 CLAUDE.md
• 与 Claude Code 计划模式工作流（Plan Mode） 配合：让 Agent 先读 CLAUDE.md 再进入计划模式

限制和检查点

• CLAUDE.md 不是权限控制系统，不能替代凭证管理与 Hooks 限制
• 文件过长会被上下文窗口压缩，关键规则可能被裁掉，应保持精炼并把详细内容放在子文件
• 不要在 CLAUDE.md 中写入真实凭证；凭证应放环境变量或密钥管理器
• 不应让 CLAUDE.md 越界承担任务清单或临时状态管理，那些更适合 Slash Commands 或任务文件

来源

• claude-code-orange-book（Claude Code 橙皮书仓库）
• HuaShu（花叔）
• HuaShu《Claude Code 橙皮书》教程摘要
• sources/25-08-development-automation--35-src-dev-002-claude-code-orange-book--1m81cqu