指南●●○3 分钟 · +40 XP
CLAUDE.md / AGENTS.md:给你的 agent 一份记忆和规则
CLAUDE.md 文件就像一张小抄,你的编码 agent 在每次任务开始时都会自动读取它。
没有记忆时的问题
AI agent 每次新会话都是从零开始。它不知道你们团队的编码规范,不知道用什么命令跑测试,也不知道你们从不直接推到 main 分支——除非你每次都重新告诉它。
解决办法:一份规则文件
CLAUDE.md(有些工具叫 AGENTS.md)是放在项目根目录下的一个普通 markdown 文件。Agent 会在每次会话开始时自动读取它,并把里面的内容当作固定指令——像一份跨越单次对话、持续存在的记忆。
里面应该写什么?
- 项目背景(“这是一个 React 前端 + Express 后端的项目”)
- 命令(“用
npm test跑测试”) - 规则(“永远不要直接推到 main”、“提交前一定要跑测试”)
- 代码风格要求
- 项目里已知的坑
为什么有效
没有这份文件,你每次新会话都得重复同样的规则。有了它,基本规则始终在场——agent 的行为会更一致,也会少犯一些本可避免的错误。
示例
# CLAUDE.md - 测试:`npm test` - 永远不要 force-push 到 main - Commit message 用英文,简短,用祈使句
小测验
编码 agent 通常什么时候读取 CLAUDE.md 文件?
来源
- Anthropic 文档:管理 Claude 的记忆 ↗ docs.anthropic.com
- agents.md:AGENTS.md 标准 ↗ agents.md
- Anthropic:Claude Code Best Practices ↗ www.anthropic.com