记忆（Memory）指南

记忆使 Claude 能够跨会话和对话保留上下文。它以两种形式存在：claude.ai 中的自动综合，以及 Claude Code 中基于文件系统的 CLAUDE.md。

概述

Claude Code 中的记忆提供了跨多个会话和对话的持久化上下文。与临时的上下文窗口（Context Window）不同，记忆文件允许你：

• 在团队中共享项目标准
• 存储个人开发偏好
• 维护特定目录的规则和配置
• 导入外部文档
• 将记忆作为项目的一部分进行版本控制

记忆系统在多个层级运作，从全局个人偏好到特定子目录，允许对 Claude 记住什么以及如何应用这些知识进行细粒度控制。

记忆命令快速参考

命令	用途	用法	使用时机
/init	初始化项目记忆	/init	开始新项目，首次设置 CLAUDE.md
/memory	在编辑器中编辑记忆文件	/memory	大量更新、重组、审查内容
# 前缀	快速添加单行记忆	# Your rule here	在对话中快速添加规则
# new rule into memory	显式添加记忆	# new rule into memory<br/>Your detailed rule	添加复杂的多行规则
# remember this	自然语言记忆	# remember this<br/>Your instruction	对话式记忆更新
@path/to/file	导入外部内容	@README.md 或 @docs/api.md	在 CLAUDE.md 中引用现有文档

快速入门：初始化记忆

/init 命令

/init 命令是在 Claude Code 中设置项目记忆的最快方式。它使用基础项目文档初始化一个 CLAUDE.md 文件。

用法：

/init

它做了什么：

• 在项目中创建新的 CLAUDE.md 文件（通常在 ./CLAUDE.md 或 ./.claude/CLAUDE.md）
• 建立项目约定和准则
• 为跨会话的上下文持久化奠定基础
• 提供用于记录项目标准的模板结构

增强交互模式： 设置 CLAUDE_CODE_NEW_INIT=true 启用多阶段交互式流程，逐步引导你完成项目设置：

CLAUDE_CODE_NEW_INIT=true claude
/init

使用 /init 的时机：

• 开始使用 Claude Code 的新项目
• 建立团队编码标准和约定
• 创建代码库结构文档
• 为协作开发设置记忆层级

示例工作流：

# 在项目目录中
/init

# Claude 创建包含以下结构的 CLAUDE.md：
# Project Configuration
## Project Overview
- Name: Your Project
- Tech Stack: [Your technologies]
- Team Size: [Number of developers]

## Development Standards
- Code style preferences
- Testing requirements
- Git workflow conventions

使用 # 快速更新记忆

你可以在任何对话中以 # 开头的消息来快速添加信息到记忆中：

语法：

# Your memory rule or instruction here

示例：

# Always use TypeScript strict mode in this project

# Prefer async/await over promise chains

# Run npm test before every commit

# Use kebab-case for file names

工作原理：

1. 消息以 # 开头，后跟你的规则
2. Claude 将其识别为记忆更新请求
3. Claude 询问更新哪个记忆文件（项目或个人）
4. 规则被添加到相应的 CLAUDE.md 文件
5. 未来的会话自动加载此上下文

替代模式：

# new rule into memory
Always validate user input with Zod schemas

# remember this
Use semantic versioning for all releases

# add to memory
Database migrations must be reversible