Free Preview
先试读：VS Code + Claude Code 初始化：CLAUDE.md、自动记忆与项目规则
/init 用来生成或完善 CLAUDE.md，不是要你手动创建一套自定义记忆文件；项目指导、本地偏好、自动记忆和路径规则应该分开管理。
这篇会帮你解决什么
- 纠正 /init 与记忆文件的旧理解。
- 分清管理策略、用户指导、项目指导和本地偏好。
- 知道什么应该进 CLAUDE.md，什么应该进 Skill 或 Hook。
可以先照着试的一句话
请先只读分析这个代码库，列出构建、测试、开发命令、核心目录与高风险区域；再起草一份简短 CLAUDE.md 供我审核，不要自动写文件。
完整文章会继续展开机制、工作流、验收标准和风险边界。
/init 的核心是生成可审核的 CLAUDE.md，不是把所有背景强行塞进记忆
当前官方机制是：Claude Code 分析代码库，生成一份包含构建、测试、代码规范和项目约定的 CLAUDE.md 起点。如果文件已存在，/init 应该提出改进，而不是直接覆盖。
实际使用时，先确认 Git 状态和项目范围，再运行 /init。完成后要人工删掉 Claude 可以自己发现的废话，补上它无法推断的业务约束、验收要求与禁区。
CLAUDE.md 不是一份“万能记忆”，不同位置有不同作用域
| 位置 | 用途 | 是否共享 |
|---|---|---|
| 组织管理路径 | IT/DevOps 强制的公司级标准 | 组织管理 |
~/.claude/CLAUDE.md | 个人跨项目偏好 | 仅当前用户 |
./CLAUDE.md 或 ./.claude/CLAUDE.md | 项目命令、架构、规范和审查要求 | 可跟代码共享 |
./CLAUDE.local.md | 个人项目偏好、本地测试地址 | 应加入 .gitignore |
目录树上方的 CLAUDE.md 会在启动时读取，子目录中的文件可在 Claude 读取相关路径时按需加载。指导要具体：“运行 npm test -- auth”比“测试写好一点”更容易执行。
自动记忆由 Claude Code 在项目级记忆目录管理，不需要人工发明固定文件清单
官方当前的自动记忆位于 ~/.claude/projects/<project>/memory/。其中 MEMORY.md 是简短索引，详细主题可以拆成其他 Markdown 文件。它是机器本地记忆，并不会自动跟代码仓库或云端环境共享。
用 /memory 查看当前加载的指导文件、开关自动记忆并审查它保存的内容。项目必须持续遵守的团队规则写进 CLAUDE.md；调试经验、常用命令等可能随工作累积的信息，才适合自动记忆。
按路径的规则、可复用流程和强制检查要分别放置
- 某类文件才适用的规则，放进路径限定的项目规则。
- 含步骤、参考资料和脚本的重复任务，做成 Skill。
- 每次编辑后必须运行的 lint、结束时必须检查的门禁，用 Hook 强制执行。
- 外部数据库、GitHub 或业务系统，通过 MCP 连接并限制权限。
常见错误是把客户数据、密钥、个人信息和长篇历史都写进 CLAUDE.md。这不但浪费上下文，也增加泄露和冲突概率。要保持短小、可审核，只放真正影响每次工作的内容。
初始化完成的标准，是 Claude 能按项目规则读懂并验证，不是文件数量多
- 在项目根目录启动，先查 Git 状态，不覆盖已有文件。
- 运行
/init或手动起草，审核后才写入 CLAUDE.md。 - 用
/memory确认哪些指导和自动记忆被加载。 - 让 Claude 只读输出项目入口、构建、测试、风险区域和第一个低风险任务。
- 完成一处小改动，检查它是否使用了正确命令、遵守路径规则并交付可审 diff。
- CLAUDE.md 不包含密钥、真实客户数据或与每次任务无关的历史。
- 个人项目偏好进 CLAUDE.local.md 并忽略提交。
- 流程做成 Skill，强制动作交给 Hook，不用大文件代替机制。
产品能力会变，学会回到官方资料
本文依据官方资料核验于 2026-07-15。功能名称、入口、套餐、地区可用性和实验性标记仍可能变化，使用时以官方文档与产品内实际显示为准。