AI-Wiki

定义

CLAUDE_MEM_MODE 是 claude-mem 提供的一个配置项，用于同时控制两件事：

工作流的行为模式（workflow behavior）
系统生成 observations 时使用的语言

它不是单纯的“语言开关”，也不是只影响提示词表面文案的选项，而是把“工作方式”和“输出语言”合并到同一个模式标识里管理。因此，文档明确说明它用于支持多种 workflow modes 和 languages，并且该选项同时控制工作流行为与 generated observations 的语言。

在本文档中的语境

在 claude-mem 的配置说明里，CLAUDE_MEM_MODE 出现在“Mode & Language Configuration”部分，被定义为模式与语言配置的核心入口。该语境下，系统默认并不只区分英文或中文，而是把不同工作流风格与不同语言组合成一个可选模式值。

文档给出的直接说明是：Claude-Mem supports multiple workflow modes and languages via the CLAUDE_MEM_MODE setting。这意味着用户通过这一个设置项，就可以切换不同 workflow mode，并决定生成 observations 的语言。

关键机制

一个设置项控制两个维度

CLAUDE_MEM_MODE 的关键机制是：同一个值同时编码行为模式和语言信息。

文档明确写到，这个选项控制：

workflow behavior，例如 code、chill、investigation
generated observations 所使用的语言

也就是说，当用户修改模式时，变化的不只是界面显示语言或回答措辞，还会连带影响 Claude-Mem 所采用的工作流行为风格。

模式值可以直接表达语言

文档给出的典型模式采用 模式--语言 的形式，例如：

code
code--zh
code--ja

其中语言特定模式遵循 code--[lang] 模式，[lang] 使用 ISO 639-1 语言代码。例如：

zh 表示中文
ja 表示日文
es 表示西班牙文

这说明语言不是另一个独立字段，而是被编码进 CLAUDE_MEM_MODE 的值中。

本地模式来源

文档说明模式定义位于 plugin/modes/。如果要在本地查看可用模式，可以执行：

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

这表示 CLAUDE_MEM_MODE 并不是任意自由文本；它实际对应插件中预定义的一组 mode 实现。

配置方式

配置文件位置

CLAUDE_MEM_MODE 的示例配置写在 ~/.claude-mem/settings.json 中。该设置文件在首次运行时会自动创建默认值，属于 claude-mem 的集中配置入口之一。

文档给出的示例是：

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

这个例子表示把模式设置为中文代码工作流，即既采用 code 这一工作流行为，也把 generated observations 的语言切换为简体中文。

生效方式

修改 CLAUDE_MEM_MODE 后不会立即热更新。文档明确要求：修改模式后需要重启 Claude Code 才会生效。

这是一条重要边界：如果用户已经编辑了 ~/.claude-mem/settings.json，但没有重启 Claude Code，那么新模式通常不会被当前运行实例采用。

可见模式与示例

文档在可用模式表中列出了以下示例：

模式	说明
`code`	默认英文模式
`code--zh`	简体中文模式
`code--ja`	日文模式

此外，文档前文在解释 workflow behavior 时还举出过 code、chill、investigation 这些行为示例。这说明工作流层面至少存在多种行为风格，而不仅仅是 code 一种。

需要注意的是，分块中的“Available Modes”表只直接展示了 code 系列的语言化示例；chill、investigation 被作为工作流行为示例出现，说明该设置项的设计目标是支持多种 workflow modes 和 languages，而不是只支持语言变体。

细节与边界

它控制的是 observations 的生成语言

文档强调的是 generated observations 所使用的语言，而不是笼统地说“整个系统语言”。因此在本文语境中，CLAUDE_MEM_MODE 的语言影响范围至少明确覆盖观察记录的生成输出。

`code--zh` 已内置

文档特别注明：code--zh（简体中文）已经内置，不需要额外安装，也不需要额外更新插件。

这意味着对于中文用户来说，切换到 code--zh 并不依赖额外扩展步骤，只需在配置文件中设置并重启 Claude Code。

不应误解为单一“语言设置”

如果只把 CLAUDE_MEM_MODE 理解成语言项，会漏掉文档中的核心事实：它同时控制 workflow behavior 与 observations 语言。也就是说，code--zh 与 code 的差异不只是中英文差异，还体现为某个具体 workflow mode 的语言化版本。

不是运行时搜索工具本身

CLAUDE_MEM_MODE 属于配置层，不是像 search 或 get_observations 那样的 MCP 工具。后者用于 memory 检索与明细提取；前者用于定义 Claude-Mem 在工作流中的行为方式与观察语言。两者处于不同层次。

与其他机制的关系

在 claude-mem 整体架构里，CLAUDE_MEM_MODE 属于 settings 配置的一部分，而系统还包含诸如本地 worker service、SQLite 数据库存储、向量检索以及 MCP 搜索工具等机制。

例如，文档同一部分还介绍了 3 层搜索工作流：

先用 search 获取紧凑索引
再用时间线工具查看上下文
最后用 get_observations 按 ID 批量获取完整细节

与这些“如何检索记忆”的工具不同，CLAUDE_MEM_MODE 回答的是“以什么工作流风格运行、以什么语言生成观察”这个配置问题。

CLAUDE_MEM_MODE

定义