Type: entity
Confidence: 0.90
Created: 2026-04-25
Updated: 2026-04-25
Tags: configurationarchitectureconstraintsAI工程

CLAUDE.md

概述

CLAUDE.md 是概率性 AI 系统的"宪法"——跨会话持久化的项目记忆与架构约束体系,提供多层级配置管理。

关键内容

  1. 三级层级结构
  2. 全局层(~/.claude/CLAUDE.md):个人代码风格偏好、常用工具链配置
  3. 项目层(./CLAUDE.md):团队共享的技术栈、架构规则、禁止事项
  4. 子目录层(./src/api/CLAUDE.md):特定目录的覆盖规则

  5. 架构约束实现

  6. 结合 Hooks 强制执行硬性约束(如代码检查、数据库变更规则)
  7. 与行为建议不同,通过技术手段确保规则执行

  8. 上下文管理系统

  9. 自动上下文压缩Compressor wU2)在窗口达到92%阈值时触发
  10. 保留关键代码片段和用户显式请求的内容
  11. CLAUDE.md 规则跨会话持久,不受压缩影响

  12. Skills 按需加载机制

  13. 会话启动时加载所有 Skill 描述(轻量)
  14. Claude 识别需要哪个 Skill按需加载完整内容
  15. Skill 用完可从上下文卸载,保持上下文开销最小

  16. 三层记忆架构

  17. 层 1:CLAUDE.md(稳定规则,每月变化)- 架构约束、技术栈声明、禁止事项
  18. 层 2:记忆文件(累积上下文,每周变化)- 已尝试方案、调试决策记录、重要发现备忘
  19. 层 3:Skills(复用指令集,按需演化)- 调试模式、代码审查模式等

来源

相关

指令