用途
Claude Code Project Memory 用于配置 CLAUDE.md 项目记忆文件，使 Claude Code 在多次会话之间获得稳定且带作用域的指令，覆盖项目背景、编码标准、架构决策与团队约定，同时尽量降低 token 成本。
记忆类型
技能给出四层记忆结构：
- 托管策略（Managed policy）：位置依操作系统而定（参见官方文档），用于组织级标准，如安全与合规。
- 项目记忆（Project memory）：位于 ./CLAUDE.md 或 ./.claude/CLAUDE.md，存放共享的项目上下文与约定。
- 项目规则（Project rules）：位于 ./.claude/rules/*.md，用于模块化、按主题划分的规则，例如测试、安全、风格。
- 用户记忆（User memory）：位于 ~/.claude/CLAUDE.md，存放跨项目的个人偏好。
- 项目本地记忆（Project memory local）：位于 ./CLAUDE.local.md（被 Git 忽略），仅本地、针对该项目的偏好。
加载机制（高层说明）
- 递归加载：从当前工作目录向上，直到（但不包含）文件系统根目录 /。
- 按需加载：工作目录下的嵌套 CLAUDE.md 文件，仅在 Claude 读取对应子树中的文件时才加载。
- 导入（Imports）：@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：10 万至 100 万行代码规模的策略。
- data/sources.json：官方链接。
相关技能
- claude-code-skills：技能创建模式。
- claude-code-agents：Claude Code 智能体设置。
- docs-codebase：仓库文档模式。
限制
资料未提供具体的收费、价格、平台支持范围或实际效果数据，以上均暂未提供。