记忆文件说明

记忆文件用来告诉 Claude Code 或 Codex：这个项目是什么、要遵守什么规则、常用命令是什么。它能减少你每次重新解释项目背景的次数。

适合谁看

• 经常在同一个项目里使用 Claude Code 或 Codex。
• 希望 AI 自动记住项目规范。
• 长对话压缩后，希望关键背景仍然稳定存在。

Claude Code：CLAUDE.md

Claude Code 使用 CLAUDE.md。

层级	路径	作用
全局	~/.claude/CLAUDE.md	所有项目都生效
项目	<项目根目录>/CLAUDE.md	当前项目生效
子目录	<项目子目录>/CLAUDE.md	当前子目录范围生效

多个层级会一起生效。越靠近当前文件的规则，越应该写得具体。

Codex：AGENTS.md

Codex 使用 AGENTS.md。

层级	路径	作用
全局	~/.codex/AGENTS.md	所有项目都生效
项目	<项目根目录>/AGENTS.md	当前项目生效
子目录	<项目子目录>/AGENTS.md	当前子目录范围生效

如果同一个项目同时用 Claude Code 和 Codex，可以维护两份内容相近的文件：CLAUDE.md 给 Claude Code，AGENTS.md 给 Codex。

建议写什么

适合写：

• 项目技术栈。
• 代码目录说明。
• 常用开发、构建、测试命令。
• 重要业务约束。
• 代码风格和提交规范。

不适合写：

• API Key、Cookie、Token。
• 大段历史聊天记录。
• 已经过期的临时问题。
• 和项目无关的个人偏好。

示例

# 项目说明

这是一个 VitePress 文档站，用来维护 c-api 使用文档。

## 常用命令

- 安装依赖：npm install
- 本地开发：npm run dev
- 构建检查：npm run build

## 写作规则

- 面向小白用户，先给操作步骤，再解释原因。
- 不把 API Key、Cookie、Token 写进文档。
- 截图统一放在 docs/public/screenshots/。

和上下文压缩的关系

记忆文件会在工具启动或读取项目时重新进入上下文。即使聊天被压缩，记忆文件里的长期规则也更容易保留下来。

记忆文件也会占上下文

只写稳定、必要、能长期复用的信息。不要把它写成几十页项目文档。