关于CLAUDE.md_claude code使用日志

Claude Code 使用心得：用 CLAUDE.md 管理项目记忆与上下文

背景

在使用 Claude Code 开发的过程中，我遇到了一些影响效率的问题：

• 上下文污染与重复劳动：为了防止上下文过多或污染，我会新开一个会话。但新会话中下达需求时，Claude 需要重新看代码、找代码，效率较慢，也增加了 token 消耗。
• 语言漂移：聊着聊着，Claude 会突然用英文或韩文回复我。我猜测可能是 skill 造成的污染，没有细究。

带着这些问题，我开始寻找解决方案。

解决方案：使用 CLAUDE.md 作为人为干预的记忆

我采用的方案是使用 CLAUDE.md 来制定约束和指令，把它当作人为干预的记忆。它既可以设定全局记忆，也可以设定项目级记忆。

CLAUDE.md 与 MEMORY.md 的区别

我搜寻到的结果是：

• MEMORY.md：是 Claude 自动创建的记忆索引文件。当它认为某些内容值得被记住时，会进行创建。它存放在全局目录下的项目专属文件夹中（~/.claude/projects/.../memory/MEMORY.md），每次会话只自动加载前 200 行或 25KB。
• CLAUDE.md：由我手动编写和维护，内容稳定可控，每次会话启动时完整加载。

CLAUDE.md 与 AGENTS.md 的区别

我搜寻到的结果是：

• AGENTS.md：是面向所有 AI 编码代理的“跨工具开放标准”，由 Agentic AI Foundation 托管，已被 30 多种工具支持。
• CLAUDE.md：是 Claude Code 的原生专用配置，仅面向 Claude Code。

我的具体实践

针对前面遇到的问题，我做了三件事：

1. 在全局的 CLAUDE.md 中指定：“回答需要使用中文”。这样可以稳定输出语言，避免中英文混杂。
2. 在项目级的 CLAUDE.md 中写入本项目的架构图，作为导航。这样新开会话时，Claude 能快速了解项目结构，提高效率，减少 token 消耗。
3. 使用 /memory 命令快速管理记忆：在 Claude Code 中使用 /memory 命令，可以快速查看、创建并编辑全局或项目级的 CLAUDE.md，也可以直接让 Agent 帮我编辑和维护这些记忆文件，省去手动编辑的麻烦。(/init可以自动生成CLAUDE.md，在vscode的插件版中，/memory是管理MEMORY.md的)

关于在 CLAUDE.md 中写架构图的注意事项

1. 架构图不能写得太细。因为在修修改改的过程中架构会变化，把它当作一个大致导航即可。
2. 定期维护更新。对于架构图的变化，可以定期更新 CLAUDE.md，并给内容加上最后一次维护的时间，同时注明不保证是最新的最准确的地图。

关于多 Agent 的思考

此外，我也在考虑是否要使用多 agent。有限探索一番后，我了解了 subagent 和 agent team，感觉目前的开发任务并没有很需要这些，反而会有点小题大做。

单 agent + CLAUDE.md 也能完成日常开发任务，所以多 agent 以后用到再说吧。

小结

• CLAUDE.md 是我主动编写的“项目说明书”，分全局和项目级，能有效减少重复沟通和 token 消耗。
• MEMORY.md 是 Claude 自动积累的笔记，加载有上限，适合辅助。
• AGENTS.md 是跨工具标准，Claude Code 也支持读取。
• 多 agent 虽好，但日常开发中单 agent + 良好的 CLAUDE.md 已经足够。