第 14 期：高级配置 — 定制你的记忆系统 — Claude-Mem 完全实战指南

本期场景：Claude-Mem 已经稳定运行了。现在你想把 Observation 笔记改成中文、保护数据库连接字符串不被记录、控制每次会话注入多少历史上下文。

14.1 配置文件全解

所有配置都在 ~/.claude-mem/settings.json，首次运行时自动创建默认值。

{
  "CLAUDE_MEM_MODE": "code",
  "WORKER_PORT": 37777,
  "LOG_LEVEL": "info",
  "CONTEXT_OBSERVATION_LIMIT": 50,
  "CONTEXT_SESSION_LIMIT": 10,
  "DATA_DIR": "~/.claude-mem"
}

字段	默认值	说明
`CLAUDE_MEM_MODE`	`"code"`	工作模式 + 语言
`WORKER_PORT`	`37777`	Worker 监听端口
`LOG_LEVEL`	`"info"`	日志级别（debug/info/warn/error）
`CONTEXT_OBSERVATION_LIMIT`	`50`	SessionStart 时最多注入多少条 Observation
`CONTEXT_SESSION_LIMIT`	`10`	SessionStart 时回溯多少个历史会话
`DATA_DIR`	`"~/.claude-mem"`	数据存储目录

14.2 多语言模式

切换到中文模式

编辑 settings.json：

{
  "CLAUDE_MEM_MODE": "code--zh"
}

效果：Worker 在压缩 Observations 时会使用中文生成 narrative 和 facts。

修改前（英文模式）：

title: "Fix JWT refresh logic"
narrative: "The developer discovered that the refreshToken function..."

修改后（中文模式）：

title: "修复 JWT 刷新逻辑"
narrative: "开发者发现 refreshToken 函数缺少过期检查..."

可用的语言模式

模式命名规则：code--[ISO 639-1 语言代码]

模式	语言
`code`	英文（默认）
`code--zh`	中文
`code--ja`	日文
`code--ko`	韩文
`code--es`	西班牙文
`code--fr`	法文
`code--de`	德文

完整列表可通过命令查看：

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

其他工作流模式

除了 code 之外，还有特殊的工作流模式：

模式	适用场景
`code`	常规编码（默认）
`chill`	轻松对话，减少记录频率
`investigation`	深度调查，增加记录详细度

14.3 隐私控制：`<private>` 标签

有些内容你不想被 Claude-Mem 记录（API 密钥、数据库密码、内部服务器地址）。使用 <private> 标签包裹：

你：我的数据库连接字符串是 <private>postgresql://admin:[email protected]:5432/blog</private>
    帮我配置 Prisma 的连接。

Worker 的处理逻辑：

graph TD
    A["接收到用户输入"] --> B{"检测到 private 标签？"}
    B -->|"是"| C["剥离标签内的内容"]
    C --> D["只保存脱敏后的文本"]
    B -->|"否"| E["正常处理"]

    D --> F["存入 DB 的内容:
'用户配置了 Prisma
数据库连接'"]

    style C fill:#f59e0b,color:#000
    style F fill:#10b981,color:#fff

存入数据库的 Observation：

title: "配置 Prisma 数据库连接"
narrative: "开发者配置了 Prisma 的数据库连接字符串"
facts: ["使用了 PostgreSQL 数据库"]
// ✅ 不包含任何密码或连接地址

14.4 上下文注入控制

控制注入量

如果你觉得 SessionStart 时注入太多历史信息（导致 Token 消耗大），可以调小：

{
  "CONTEXT_OBSERVATION_LIMIT": 20,   // 从默认 50 降到 20
  "CONTEXT_SESSION_LIMIT": 5         // 从默认 10 降到 5
}

如果你觉得 Claude 记住的太少，可以调大：

{
  "CONTEXT_OBSERVATION_LIMIT": 100,
  "CONTEXT_SESSION_LIMIT": 20
}

建议值

项目规模	OBSERVATION_LIMIT	SESSION_LIMIT
小项目（1-2 周）	30	5
中项目（1-3 个月）	50	10
大项目（3 个月+）	80	15

14.5 Folder Context Files

Claude-Mem 会在你的项目目录中自动生成 CLAUDE.md 文件，包含该项目的活动时间线。

my-blog/
├── CLAUDE.md          ← 自动生成
├── src/
├── prisma/
└── package.json

CLAUDE.md 的内容示例：

# Project: my-blog
## Recent Activity
- 2026-04-20: 实现评论通知系统
- 2026-04-18: 修复认证 JWT 刷新 Bug
- 2026-04-15: 添加文章标签系统
## Key Decisions
- 使用 Prisma 作为 ORM
- 使用 JWT 认证

好处：

新开发者 clone 项目后，Claude Code 自动读取 CLAUDE.md 获得背景
支持 Git worktree：Claude-Mem 能从父仓库获取上下文
不需要额外配置，完全自动

14.6 数据导出与导入

导出

# 导出所有记忆数据
npx claude-mem export --output my-memories.json

导入

# 在另一台机器上导入
npx claude-mem import --input my-memories.json

使用场景：

换电脑时迁移开发记忆
备份重要项目的记忆
与团队成员共享项目上下文（注意隐私！）

实操练习

切换到中文模式 → 在博客项目中工作一会 → 检查 Observations 是否变成中文
用 <private> 标签保护一个敏感信息 → 在 Web UI 中验证数据已脱敏
调整 CONTEXT_OBSERVATION_LIMIT → 观察下次会话启动时注入的上下文量变化
查看项目目录中是否生成了 CLAUDE.md
尝试导出并重新导入记忆数据

下期预告

最后一期！我们来总结排障指南、最佳实践，并用博客项目的完整开发历程做一次回顾。如果你能走到这里，你已经是 Claude-Mem 的高级用户了。

➡️ 第 15 期：排障指南 + 最佳实践 + 总结

第 14 期：高级配置 — 定制你的记忆系统