用途:生成 CLAUDE.md 项目记忆文件,把机构性知识(项目特有的约定、坑点、命令)沉淀下来,供 Claude 在每次会话中读取。适合项目搭建、团队协作与新人上手场景。
主要能力与原则:CLAUDE.md 是建议性而非强制执行的,内容作为用户消息在系统提示后传入,Claude 会尽量遵循但不保证严格遵守。因此:常驻事实、约定、"总是做 X" 规则放 CLAUDE.md;多步骤流程放 Skills;必须每次执行、无例外的动作放 Hooks(如退出码为 2 的 shell 命令或 PreToolUse deny 才具确定性)。
内容取舍:只写 Claude 无法自行推断的信息,如 Bash 命令、与默认不同的代码风格、测试说明、仓库礼仪、架构决策、环境变量、常见坑点;排除代码可读出的内容、通用语言规范、详细 API 文档、频繁变化的信息、逐文件描述。可用删除测试判断:删掉这行是否会导致 Claude 出错。目标控制在 200 行以内,超出应改用 .claude/rules/、Skills 或 Hooks。
放置位置:项目级 ./CLAUDE.md 或 ./.claude/CLAUDE.md(提交到 git);用户级 ~/.claude/CLAUDE.md;本地 ./CLAUDE.local.md(加入 .gitignore);以及托管策略级路径。若仓库已有 AGENTS.md,可用 @AGENTS.md 导入或符号链接,再追加 Claude 专属覆盖,避免重复。
模板:提供 editorial-tool、event-website、publication、research-project、content-pipeline、digital-archive 六类新闻业模板,并附选择指南与不足 30 行的精简起步版本。用法为复制模板到项目根目录、填写占位符、删除不适用段落、按需补充坑点。
限制与注意:避免过度冗长、嵌套文件指令冲突、写入密钥(应放 CLAUDE.local.md)、手写通用规范。另注意 Claude Code v2.1.59+ 的 auto memory 机制独立于 CLAUDE.md,会自动记录 Claude 的笔记,无需手动记录其学习内容。资料未提供具体安装命令与收费信息。