# Claude Code + Codex 的项目内存（2026 年 1 月）配置项目内存，以便 Claude Code 和 Codex 跨会话获得稳定的、有范围的指令，同时保持较低的令牌成本。使用单一事实来源：将“AGENTS.md”保留为主要来源，并将符号链接“CLAUDE.md”。 ## 快速参考内存类型 |典型位置 |目的 ---|---|--- 管理政策|依赖于操作系统（参见官方文档）|组织范围的标准（安全性、合规性）项目记忆| `./AGENTS.md`（主要）+ `./CLAUDE.md`（符号链接 → AGENTS.md）|共享项目背景和约定项目规则| `./.claude/rules/*.md` |模块化、以主题为中心的规则（测试、安全性、风格）用户记忆| `~/.claude/CLAUDE.md` |跨项目的个人偏好项目内存（本地）| `./CLAUDE.local.md`（git 忽略）|仅限本地、特定于项目的首选项 ### 加载如何工作（高级） **克劳德代码（CLAUDE.md 符号链接）**： * **递归加载** ：从当前工作目录到（但不包括）文件系统根目录（`/`）。 * **按需加载** ：仅当 Claude 读取这些子树中的文件时，才会加载 cwd 下的嵌套 `CLAUDE.md` 文件。 * **导入**：`@path/to/file` 引入额外的上下文（最大深度：5；支持 `~`）。 **法典（AGENTS.md 主要）**： * 读取存储库根目录或工作目录中的“AGENTS.md”。 * 保持简洁；当支持这两种工具时，镜像与“CLAUDE.md”相同的内容。 ## 工作流程（最佳实践） 1. 从最小的主内存文件（AGENTS.md，50-120 行）开始：项目是什么，它是如何形成的，以及“不得违反”规则。 2. 将冗长或脆弱的指导移至“.claude/rules/”（每个文件一个主题）。 3. 使用“@imports”作为详细文档的导航，而不是将它们复制到内存中。 4. 像对待代码一样对待内存：PR 审查、所有权和定期清理（删除死规则）。 5. 对于UI更改，请在开始实施之前确认具体值（颜色、价格、文本），以避免返工。 6. 对于功能交付，首选每个功能一个工作树，运行项目质量关卡，然后打开一个重点 PR。 ## 执行工作流程（工作树+门+PR）当存储库包含工作流脚本（例如 `scripts/git/feature-workflow.sh`）时，对于 AI 编码会话更喜欢以下顺序： # 1) 创建独立的分支/工作树 ./scripts/git/feature-workflow.sh start cd .worktrees/<功能-slug> # 2) 实施+提交 git添加-A git commit -m“壮举：<摘要>” # 3) 运行项目质量门（示例） ../../scripts/git/feature-workflow.sh 门 # 4) 打开 PR (gate 可能会再次运行) ../../scripts/git/feature-workflow.sh pr --title “壮举：<摘要>” 如果不存在帮助程序脚本，请使用本机 git 工作树并应用相同的策略： * 每个工作树一个功能 * 每个功能一个重点公关 * 在创建 PR 之前运行特定于存储库的门 ## 具有可选路径范围的规则创建 `.claude/rules/testing.md`、`.claude/rules/security.md` 等。如果规则仅适用于存储库的一部分，请将其范围限定为： --- 路径： -“src/api/**/*.ts” --- ## 命令（克劳德代码） * `> /memory` 查看并直接编辑记忆。 * `> /init` 引导项目内存（有关当前行为，请参阅官方文档）。 ## 命令（法典） * 直接编辑`AGENTS.md`；不需要特殊的内存命令。 ## 跨平台策略（AGENTS.md + CLAUDE.md）如果您支持多个编码助手，请保留一个规范文件并对其进行镜像： * macOS/Linux：“CLAUDE.md”应该是“AGENTS.md”的符号链接。 * Windows：除非启用了开发人员模式，否则更喜欢复制（或小型同步脚本）而不是符号链接。避免在内存文件中声明特定于工具的声明；保持其便携性并严格以项目为中心。 ## 项目内存的代币预算概况当会话重复包含非常大的内存有效负载时，请应用此紧凑配置文件。 ### 紧凑型配置文件规则 1. 保持 `AGENTS.md` 简短（目标 50-120 行）。 2. 将长目录/清单移至技能文档并按路径引用它们。 3. 每个主题保留一份规范的政策声明；链接而不是重复。 4. 更喜欢“按需阅读”说明，而不是在每个会话中嵌入完整的清单。 5. 在需要时保留较短的运行时内存和更完整的参考文档。 ### 建议分割 * `AGENTS.md`（运行时）：项目目标、硬约束、工作流程规则、关键安全约束。 * `docs/*` 或技能参考：长列表、示例、可选剧本、大量清单。 ### 质量门如果启动内存超出实际上下文预算，请在添加新规则之前进行修剪。 ## 验证（快速检查） * 运行捆绑的 linter：`bash Frameworks/shared-skills/skills/agents-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]() |官方链接 ## 相关技能技能|目的 ---|--- [agents-skills]() |技能创造模式 [agents-subagents]() |代理/子代理设置 [文档代码库]() |回购文档模式

特工项目记忆

包含技能