Luong NGUYEN
89e89d4aa3
Add Chinese (Simplified) translations for all documentation, organized under a dedicated zh/ directory that mirrors the English folder structure. Co-authored-by: tanqingkuang <tanqingkuang@users.noreply.github.com> Translations originally contributed by @tanqingkuang in #45. Restructured from *-CN.md suffix pattern into zh/ directory to prevent the EPUB builder (scripts/build_epub.py collect_folder_files) from picking up Chinese files via glob("*.md") inside module folders.
Memory 指南
概览
Memory 让 Claude Code 在不同会话之间保留上下文。你可以把团队规范、项目规则、个人偏好和目录级约束写进 CLAUDE.md，让 Claude 在合适的时候自动加载。
Memory 命令速查
| 命令 | 作用 |
|---|---|
/init |
初始化项目级 CLAUDE.md |
/memory |
打开并编辑记忆文件 |
# |
快速把当前规则写入 memory |
快速上手：初始化 Memory
使用 /init
在项目目录中运行：
/init
Claude 会根据当前项目生成一个 CLAUDE.md，通常包含类似如下结构：
# 项目配置
## 项目概览
## 开发规范
使用 # 快速更新记忆
当你想把一句规则写入 memory 时，可以直接在输入前加 #：
# 这个项目始终使用 TypeScript 严格模式
# 优先使用 async/await，而不是 promise 链
# 每次提交前都运行 npm test
# 文件名统一使用 kebab-case
这会把规则加入当前会话能感知到的记忆中。
使用 /memory
/memory 会打开记忆编辑器，让你在不同范围之间切换：
- 受管策略记忆
- 项目记忆（
./CLAUDE.md） - 用户记忆（
~/.claude/CLAUDE.md） - 本地项目记忆
适合你把长期规则、项目规范和个人偏好分层管理。
Memory 架构
Claude Code 的记忆系统通常有以下层级：
| 层级 | 作用范围 | 典型内容 |
|---|---|---|
| 受管策略 | 组织级 | 合规、安全、统一流程 |
| 项目记忆 | 单个项目 | 架构、编码标准、工作流 |
| 目录记忆 | 子目录 | 模块约束、局部规范 |
| 用户记忆 | 单个用户 | 个人偏好、默认设置 |
记忆层级
Claude 会按更接近当前上下文的规则优先使用更具体的 memory。一般来说：
- 组织级规则优先于普通偏好
- 项目规则优先于个人偏好
- 目录级规则优先于项目级通用规则
排除规则
如果某些 CLAUDE.md 不应该被自动加载，可以通过 claudeMdExcludes 之类的设置排除。
配置文件层级
项目设置、用户设置和企业托管设置会共同影响 memory 的加载方式。你可以把它理解为：
- 组织策略
- 项目设置
- 本地设置
- 临时会话输入
模块化规则系统
Memory 不一定要写成一个巨大文件。你可以把规则拆成多个目录文件，再按路径组织。
通过 YAML frontmatter 设置路径规则
---
description: API development rules
---
# API Development Rules
子目录与符号链接
你可以用子目录和 symlink 把局部规则复用到多个项目区域。
Memory 位置表
常见位置包括：
- 项目根目录的
CLAUDE.md - 用户目录的
~/.claude/CLAUDE.md - 子目录的
CLAUDE.md
Memory 更新生命周期
一般流程是：
- 创建或编辑
CLAUDE.md - Claude 重新加载
- 新规则在后续会话中生效
Auto Memory
Auto memory 让 Claude 根据当前目录自动寻找并加载合适的记忆文件。
工作方式
Claude 会根据当前工作目录、父目录和已配置路径，逐层查找相关 memory。
目录结构
project/
├── CLAUDE.md
├── src/
│ ├── CLAUDE.md
│ └── api/
│ └── CLAUDE.md
版本要求
某些 auto memory 行为依赖较新的 Claude Code 版本。
自定义 auto memory 目录
如果默认目录不适合你的项目，可以在设置中指定新的 memory 路径。
worktree 和仓库共享
在 worktree、monorepo 或多人协作场景中，auto memory 可以帮助保持规则一致。
Subagent 记忆
Subagents 也可以拥有自己的记忆范围，用于在各自职责内保持一致性。
控制 auto memory
# 当前会话禁用 auto memory
# 显式开启 auto memory
通过 --add-dir 添加额外目录
你可以用 --add-dir 把额外目录也加入 Claude 的可见范围，适合多目录协作。
实战示例
示例 1：项目记忆结构
# 项目配置
## 项目概览
## 架构
## 开发规范
### 代码风格
### 命名约定
### Git 工作流
### 测试要求
### API 规范
### 数据库
### 部署
## 常用命令
## 团队联系人
## 已知问题与解决办法
## 相关项目
示例 2：目录级记忆
# API 模块规范
## API 专属规范
### 请求校验
### 身份验证
### 响应格式
### 分页
### 限流
### 缓存
示例 3：个人记忆
# 我的开发偏好
## 关于我
## 代码偏好
### 错误处理
### 注释
### 测试
### 架构
## 调试偏好
## 沟通方式
## 项目组织
## 工具链
示例 4：会话中更新记忆
两种常见方式：
- 直接提要求，让 Claude 把规则写进 memory
- 使用
# new rule into memory这种模式追加规则
最佳实践
应该做的
- 用项目记忆保存团队标准
- 用目录记忆保存局部差异
- 先写简洁规则，再逐步补充
- 把可重复内容写进
CLAUDE.md
不应该做的
- 不要把 README 整份复制进
CLAUDE.md - 不要把明显属于代码的实现细节硬塞进 memory
- 不要让 memory 变成垃圾桶
记忆管理建议
- 优先引用已有文档，而不是重复粘贴
- 只保留真正影响 Claude 行为的信息
- 定期整理过期或冲突的规则
安装说明
设置项目记忆
方法 1：使用 /init（推荐）
/init
方法 2：手动创建
cp project-CLAUDE.md CLAUDE.md
方法 3：快速更新
# Use semantic versioning for all releases
# Always run tests before committing
# Prefer composition over inheritance
设置个人记忆
cp personal-CLAUDE.md ~/.claude/CLAUDE.md
设置目录记忆
cp directory-api-CLAUDE.md src/api/CLAUDE.md
验证安装
- 重新打开 Claude Code 会话
- 检查
CLAUDE.md是否被自动加载 - 用一条明显会受 memory 影响的提示词测试
官方文档
如果你想看更详细的行为定义、兼容性和最新限制，建议参考 Claude Code 官方 memory 文档。