name: claude-code-project-memory description: 配置 CLAUDE.md 项目记忆文件，用于持久化上下文、编码标准、架构决策和团队约定。参考4层记忆层次、跨平台 AGENTS.md 兼容性和快速添加命令。
Claude Code 项目记忆 (2026年1月)
配置 CLAUDE.md 项目记忆，使 Claude Code 在会话间获得稳定、有范围指导，同时保持低令牌成本。
快速参考
| 记忆类型 | 典型位置 | 目的 |
|---|---|---|
| 管理策略 | 操作系统相关（见官方文档） | 组织级标准（安全、合规） |
| 项目记忆 | ./CLAUDE.md 或 ./.claude/CLAUDE.md |
共享项目上下文和约定 |
| 项目规则 | ./.claude/rules/*.md |
模块化、主题聚焦的规则（测试、安全、样式） |
| 用户记忆 | ~/.claude/CLAUDE.md |
跨项目的个人偏好 |
| 项目记忆（本地） | ./CLAUDE.local.md（git忽略） |
仅本地、项目特定偏好 |
加载方式（高级）
- 递归加载：从当前工作目录向上到文件系统根目录（
/）但不包括。 - 按需加载：cwd下的嵌套
CLAUDE.md文件仅在 Claude 读取这些子树文件时加载。 - 导入：
@path/to/file拉入额外上下文（最大深度：5；支持~）。
工作流程（最佳实践）
- 从最小
CLAUDE.md开始（50–120行）：项目是什么、如何构建以及“不能破坏”的规则。 - 将冗长或脆弱的指导移到
.claude/rules/中（每个文件一个主题）。 - 使用
@imports作为详细文档的导航，而不是复制到记忆中。 - 像代码一样对待记忆：PR审查、所有权和定期清理（移除死规则）。
带可选路径范围的规则
创建 .claude/rules/testing.md、.claude/rules/security.md 等。如果规则仅适用于存储库的一部分，指定范围：
---
paths:
- "src/api/**/*.ts"
---
命令（Claude Code）
> /memory查看和直接编辑记忆。> /init引导项目记忆（见官方文档了解当前行为）。
跨平台策略（AGENTS.md + CLAUDE.md）
如果支持多个编码助手，保持一个规范文件并镜像：
- macOS/Linux：将一个符号链接到另一个。
- Windows：优先复制（或小型同步脚本）而非符号链接，除非启用了开发者模式。
避免在记忆文件中使用工具特定声明；保持其可移植性并严格聚焦于项目。
验证（快速检查）
- 运行捆绑的 linter：
bash frameworks/shared-skills/skills/claude-code-project-memory/scripts/lint_claude_memory.sh . - 在合并记忆更改前，手动扫描未解决的
@imports和秘密。
资源
| 资源 | 目的 |
|---|---|
| references/memory-patterns.md | 模式和反模式 |
| references/memory-examples.md | 按技术栈的完整示例 |
| references/large-codebase-strategy.md | 100K–1M LOC 策略 |
| data/sources.json | 官方链接 |
相关技能
| 技能 | 目的 |
|---|---|
| claude-code-skills | 技能创建模式 |
| claude-code-agents | Claude Code 代理设置 |
| docs-codebase | 存储库文档模式 |