核心功能
Memory 支持
Z Code 可以通过项目 Memory 文件记住项目约定、代码规范和工作流,让每次对话都能遵循统一的标准。
何时使用
在以下场景中,项目 Memory 可以让 Claude 持续按照项目标准工作:
- 当团队成员需要统一代码风格时:在项目 Memory 中定义缩进、命名、注释等规范,所有人共享同一套标准
- 当项目有特定的架构约定时:记录项目目录结构、模块组织方式、常用 API 调用模式,让 Claude 理解项目结构
- 当新成员加入项目时:通过 Memory 文件快速传递项目约定,无需口头反复说明
工作方式
项目 Memory 是保存在项目根目录的 CLAUDE.md 文件,Z Code 启动时自动加载到对话上下文中。

触发方式
| 方式 | 说明 |
|---|---|
| 自动加载 | 启动 Z Code 时自动读取项目中的 CLAUDE.md |
| 团队共享 | 通过代码仓库自动分享给所有团队成员 |
Memory 文件示例
# 项目说明
参见 @README.md 了解项目概况
测试命令见 @package.json
能力边界
| Memory 会做的 | Memory 不会做的 |
|---|---|
| 提供项目上下文和规范指导 | 不会自动执行操作 |
| 自动加载到每次对话 | 不会强制修改代码 |
| 支持导入项目中的其他文档 | 不会影响你未使用 Memory 的对话 |
快速上手
创建项目 Memory
- 在 Z Code 中打开项目
- 在对话中输入
/init命令 - Z Code 会调用 agent 自动帮你创建
CLAUDE.md文件
编辑现有 Memory
- 在 Z Code 中打开 Memory 配置界面
- 找到项目 Memory(
CLAUDE.md) - 点击编辑按钮,修改内容
- 保存后,更新立即在下次对话中生效

典型示例
示例 1:项目架构说明
# 项目架构
本项目采用分层架构:
- `src/api/`:API 路由定义
- `src/services/`:业务逻辑层
- `src/models/`:数据模型
- `src/utils/`:工具函数
## 开发约定
- API 路由使用 RESTful 风格
- 所有数据库操作通过 services 层
- 错误处理统一使用 errorHandler 工具
## 常见任务
添加新 API:
1. 在 `src/api/` 创建路由文件
2. 在 `src/services/` 添加对应的 service
3. 在 `src/models/` 定义数据模型
效果:当你要求「添加用户管理 API」时,Claude 会按照这个架构创建文件。
示例 2:代码风格规范
# 代码风格
## 命名规范
- 变量使用驼峰命名:`userName`
- 常量使用全大写:`MAX_RETRIES`
- 文件名使用短横线:`user-service.ts`
## 格式规范
- 使用 2 空格缩进
- 对象和数组最后一项保留尾逗号
- 使用单引号
## 注释规范
- 所有公开函数必须有 JSDoc 注释
- 复杂逻辑必须添加说明注释
- TODO 标记格式:`// TODO: [作者] 描述`
效果:Claude 生成或修改代码时会自动遵循这些规范。
常见问题
Memory 文件应该写多长?
保持简洁。优先级高的信息放前面,使用标题和列表组织。建议不超过 200 行。
Memory 会影响性能吗?
Memory 文件通常只有几 KB,不会影响性能。
团队成员能看到我的 Memory 吗?
项目 Memory(CLAUDE.md)通过代码仓库共享,所有团队成员都能看到。确保不要在 Memory 中包含敏感信息(如密码、密钥)。
如何验证 Memory 是否生效?
在对话中问 Claude:「你看到了哪些项目规范?」,Claude 会列出 Memory 中的内容。你也可以观察 Claude 的代码生成是否遵循你定义的规范。
Memory 文件必须命名为 CLAUDE.md 吗?
推荐使用 CLAUDE.md(项目根目录)或 .claude/CLAUDE.md。这两个位置 Z Code 都会自动识别。
可以在 Memory 中使用图片或链接吗?
支持 Markdown 语法。
Memory 支持哪些格式?
只支持 Markdown 格式(.md 文件)。使用标准 Markdown 语法,支持标题、列表、代码块、表格等。