核心功能

Memory 支持

Z Code 可以通过项目 Memory 文件记住项目约定、代码规范和工作流,让每次对话都能遵循统一的标准。


何时使用

在以下场景中,项目 Memory 可以让 Claude 持续按照项目标准工作:

  • 当团队成员需要统一代码风格时:在项目 Memory 中定义缩进、命名、注释等规范,所有人共享同一套标准
  • 当项目有特定的架构约定时:记录项目目录结构、模块组织方式、常用 API 调用模式,让 Claude 理解项目结构
  • 当新成员加入项目时:通过 Memory 文件快速传递项目约定,无需口头反复说明

工作方式

项目 Memory 是保存在项目根目录的 CLAUDE.md 文件,Z Code 启动时自动加载到对话上下文中。

Memory 主界面

触发方式

方式说明
自动加载启动 Z Code 时自动读取项目中的 CLAUDE.md
团队共享通过代码仓库自动分享给所有团队成员

Memory 文件示例

# 项目说明

参见 @README.md 了解项目概况
测试命令见 @package.json

能力边界

Memory 会做的Memory 不会做的
提供项目上下文和规范指导不会自动执行操作
自动加载到每次对话不会强制修改代码
支持导入项目中的其他文档不会影响你未使用 Memory 的对话

快速上手

创建项目 Memory

  1. 在 Z Code 中打开项目
  2. 在对话中输入 /init 命令
  3. Z Code 会调用 agent 自动帮你创建 CLAUDE.md 文件

编辑现有 Memory

  1. 在 Z Code 中打开 Memory 配置界面
  2. 找到项目 Memory(CLAUDE.md
  3. 点击编辑按钮,修改内容
  4. 保存后,更新立即在下次对话中生效

添加记忆


典型示例

示例 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 语法,支持标题、列表、代码块、表格等。