MemoryLake
返回全部文章
Tutorial2026 年 11 月 16 日·10 分钟阅读

Claude Code 中的输出风格是如何工作的?自定义风格替换了系统提示词中的什么,为什么 CLAUDE.md 仍然加载,以及哪些子智能体不遵循它 (2026)

你为 Claude Code 编写了一个自定义输出风格,目的是让它更多地解释其推理过程并缩短总结。在语气方面它确实起作用了。但你好奇底层是否还发生了其他变化,因为 Claude 处理编辑的方式似乎变得不同了。与此同时,你委派进行审查的子智能体仍然以旧格式回答,就好像该风格不存在一样。

这两者在 Anthropic 的文档中都有解释。默认情况下,自定义风格会省略 Claude Code 内置编码指令的一部分。而且,“其他子智能体运行它们自己的系统提示词,因此风格不会改变它们的响应方式。”

输出风格易于设置,但也容易被误读。本指南涵盖了什么是输出风格、内置风格、如何切换、如何编写自己的风格、自定义风格从系统提示词中删除了什么以及如何保留它、风格与 CLAUDE.md 的关系、哪些子智能体遵循风格,以及在什么情况下风格不是正确的工具。

什么是输出风格

Anthropic 的文档定义如下:“输出风格是一组指令,用于为会话中的每个响应设置 Claude 的角色、语气和响应格式。”

其目的是停止重复劳动。你无需在每个提示词中都要求更短的回答,只需设置一次风格,它就会应用于整个会话。自定义风格还可以赋予 Claude 不同的角色,例如写作助手或数据分析师。

Anthropic 特别强调了风格不是什么:“输出风格为 Claude 提供遵循的指令。它并不保证某件事总是发生或永不发生。”

如果你看到过暗示输出风格即将取消的旧帖子,目前的文档将其描述为一项受支持的功能,包含四种内置风格并支持自定义风格。

内置风格

“除了默认风格外,Claude Code 还包含四种内置风格,你也可以编写自己的风格。”默认(Default)本身并不是一种风格:“默认意味着没有选择任何输出风格。”此时 Claude 根据 Claude Code 的标准系统提示词工作,该提示词是为软件工程编写的。

四种内置风格各自保留了这些标准指令并添加了自己的内容:

  • Proactive (主动型)。 Claude 会立即开始工作,并对常规决策做出合理的假设,而不是询问。除非你要求提供计划,否则它不会切换到计划模式。Anthropic 指出,“切换到 Proactive 风格不会改变你的权限模式。”
  • Concise (简洁型)。 响应以结果开头,省略开场白、叙述和回顾。“它执行工程工作的彻底程度与 Default 风格相同。”当你要求详细信息,以及处理错误报告、失败的测试、安全警告和破坏性操作的确认时,Claude 仍然会完整书写。
  • Explanatory (解释型)。 Claude 会添加简短的 Insight(洞察)区块来解释其选择。“这些解释不会作为注释写入你的文件中。”
  • Learning (学习型)。 Claude 会添加相同的解释,并留出小段代码让你编写,标记为 TODO(human) 注释,然后等待你。

因为这些风格保留了标准指令,选择内置风格只会改变 Claude 与你交流和工作的方式,而不会改变底层的工程指导。

如何切换风格

运行 /output-style <style>,例如 /output-style concise。如果不带参数,该命令会列出所有风格并标记当前风格。你也可以运行 /config 并选择 Output style,或者使用 VS Code 扩展中的 Output styles 菜单。

如果你跨项目工作,选择保存的位置很重要。“该命令和两个菜单都会将你的选择保存到本地项目级别的 .claude/settings.local.json 中。”要使某种风格成为全局默认风格,请在 ~/.claude/settings.json 中设置 outputStyle,不过项目自身的设置具有优先权。

有两个细节需要注意。“该值是区分大小写的”,因此设置需要准确的名称,例如 Explanatory。“与风格名称不完全匹配的值(如 explanatory)会让你进入 Default 风格。”相比之下,/output-style 命令会忽略大小写。

关于时效性:“当你在会话中途切换风格时,Claude 将从你的下一条消息开始使用新风格。”

如何编写自定义风格

自定义风格是一个带有 frontmatter(前置元数据)和指令的 Markdown 文件。你可以将其保存在以下三个位置之一:

  • 用户级: ~/.claude/output-styles
  • 项目级: .claude/output-styles
  • 托管策略: 托管设置目录内的 .claude/output-styles

“除非你在 frontmatter 中设置了 name,否则文件名将成为风格名称。”项目风格会从工作目录到存储库根目录之间的每个 .claude/output-styles/ 文件夹中加载,当名称冲突时,最接近的文件夹获胜。

有两点需要注意。“拼写错误的字段会被忽略且不报错。”在终端中,Claude Code 在启动时读取风格文件,因此如果你在会话期间创建或编辑了风格文件,请重启 Claude Code 以应用更改。

插件也可以提供风格。插件风格可以设置 force-for-plugin,这会在启用插件时自动应用该风格。参考文档指出,这会“覆盖用户的 outputStyle 设置”。

自定义风格从系统提示词中移除了什么

这是在开篇示例之后需要检查的设置。

Anthropic 的解释是:“在完整的系统提示词中,自定义输出风格会省略 Claude Code 的内置软件工程指令部分,例如如何确定更改范围、编写注释和验证工作,除非将 keep-coding-instructions 设置为 true。”

因此,一个仅改变语气的自定义风格默认情况下也会移除关于确定更改范围和验证工作的指导。内置风格不会这样做,因为它们保留了标准指令。自定义风格则会移除,除非你选择保留。

保留的方法是在 frontmatter 中添加一行。Anthropic 的建议是:“如果你正在改变 Claude 的交流方式,但仍希望它以同样的方式编写代码,请设置 keep-coding-instructions: true。”只有在 Claude 不进行软件工程工作时才省略它。

还有一个细节。“较短的系统提示词不包含该部分,因此该字段在那里没有效果。”在较短的系统提示词中,编码部分本来就不存在。Anthropic 表示,要依赖该字段,你可以将 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT 设置为 0,这会在任何模型上选择完整提示词。

为什么 CLAUDE.md 仍然加载

风格改变了 Claude 的响应方式。它不会改变 Claude 对你项目的了解。Anthropic 的对比表这样描述 CLAUDE.md:“它保存了 Claude 应该了解的关于代码库的信息,无论你选择哪种风格,它都会保持加载状态”。

这是正确的分工:

  • CLAUDE.md 保存约定、命令和项目结构。
  • 输出风格 保存声音、长度、格式和角色。

切换风格不会卸载你的项目指令,将项目规则写入风格也没有意义,因为风格会应用于你使用它的每个项目。对于仅应应用于代码库某些部分的规则,Claude Code 还有规则文件,我们在什么是 Claude Code 规则指南中介绍过。

哪些子智能体遵循该风格

风格适用于主对话,但并非适用于所有工作发生的地方。

“输出风格适用于主对话和派生对话(fork),派生对话会继承父级的整个对话和系统提示词。”

对于所有其他子智能体:“其他子智能体运行它们自己的系统提示词,因此风格不会改变它们的响应方式。”

这解释了开篇示例中的审查器问题。如果你希望子智能体以特定格式回答,请将其放入子智能体自身的定义中。派生对话是一个例外,因为它继承了父级的系统提示词和对话。

当风格不是正确的工具时

Anthropic 自己的指导建议:“输出风格适用于会话中的每个响应。它是 Claude 遵循的一条指令,因此没有任何强制执行机制。”其对比表指向了针对更窄或更严格需求的其他功能:

  • 必须始终发生的事情, 例如每次编辑后的格式化或阻止某个命令:使用钩子(hook),由 Claude Code 自身运行。
  • 针对一类任务的指令, 例如发布检查清单:使用技能(skill),仅在相关时加载。
  • 具有自己指令和工具的助手: 使用子智能体(subagent)。
  • 在不移除任何内容的情况下添加指令: 在启动 Claude Code 时使用 --append-system-prompt。

对于 Claude 应该了解的关于你项目的信息,请使用 CLAUDE.md。

Token 使用是一个次要因素。风格的指令会增加输入 token,不过在会话的第一次请求之后,提示词缓存(prompt caching)会减少这部分开销。Explanatory 和 Learning 风格在设计上会产生较长的响应,而 Concise 则产生较短的响应。

人们首先尝试的操作

编写自定义风格并意外丢弃了编码指导。 请添加 keep-coding-instructions: true。

将项目规则放入风格中。 这些规则属于 CLAUDE.md,无论你选择哪种风格,它都会加载。

期望子智能体遵循风格。 只有主对话和派生对话会遵循。

在设置中以小写形式输入风格名称。 设置值是区分大小写的。

在会话中途编辑风格。 在终端中重启 Claude Code 以应用更改。

依靠风格来处理必须始终发生的事情。 请使用钩子。

解决方案:将每条指令放在其所属的位置

第 1 步:在自定义风格中保留编码指令

在任何用于软件工作的自定义风格中添加 keep-coding-instructions: true。

第 2 步:将项目知识移至 CLAUDE.md

约定、命令和结构应放入 CLAUDE.md,而不是风格中。

第 3 步:为子智能体提供它们自己的格式规则

如果子智能体的输出格式很重要,请在该子智能体的定义中进行设置。

第 4 步:记录风格背后的偏好

记录你选择某种格式的原因以及你依赖哪些项目规则,以便它们在单一工具的设置之外也能使用。

在 MemoryLake 中设置

输出风格是针对每个工具的设置,而 CLAUDE.md 是针对每个项目的。它们背后的偏好和项目决策(例如你喜欢如何解释更改或哪些约定最重要)在你使用的每个助手中都很有用。

MemoryLake 是此类工作上下文(如偏好、约定和项目决策)的记忆层,保存在一个由你维护的地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。

你可以用自己的语言亲自编写条目。不会从你的输出风格文件、设置文件、CLAUDE.md、子智能体定义、会话或任何供应商的存储中读取、写入或删除任何内容。输出风格和 CLAUDE.md 的工作方式与 Anthropic 描述的一致。

第 1 步:创建 API 密钥

登录并从控制面板生成密钥。像对待任何其他凭据一样,将其存储在存储库之外。

MemoryLake 控制台显示 API 密钥屏幕,在此处创建并复制新密钥以供智能体使用
MemoryLake 控制台显示 API 密钥屏幕,在此处创建并复制新密钥以供智能体使用

第 2 步:上传你的第一批记忆

从你在解决方案第 4 步中写下的内容开始:你的格式偏好、背后的原因以及你依赖的项目约定。每个条目对应一个偏好或约定。

MemoryLake 工作区显示已上传的第一批文档,列出了每个文件变为可搜索记忆的过程
MemoryLake 工作区显示已上传的第一批文档,列出了每个文件变为可搜索记忆的过程

第 3 步:连接你的 AI 和智能体

连接 Claude Code、Codex、ChatGPT 或你使用的其他助手。每个助手都可以利用相同的偏好,同时每个工具保留自己的风格设置。

MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和智能体框架
MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和智能体框架

这在实践中改变了什么

第一个区别是跨工具的一致性。你喜欢如何解释工作只需写下一次,而无需在每个助手中进行不同的配置。

第二个区别是更简洁的风格。风格可以专注于声音和格式,而约定则保存在其他地方。

第三个区别是更容易上手。团队成员可以阅读你设置背后的原因,而不是对风格文件进行逆向工程。

Claude Code 输出风格的最佳实践

从内置风格开始。 它们保留了 Claude Code 的标准指令。

在自定义风格中添加 keep-coding-instructions。 否则在完整系统提示词中会省略编码部分。

在设置中使用准确的名称。 设置值是区分大小写的。

编辑风格文件后重启。 终端在启动时读取风格文件。

将项目知识保留在 CLAUDE.md 中。 无论你选择哪种风格,它都会保持加载状态。

在子智能体定义中设置其格式。 风格仅触及主对话和派生对话。

使用钩子来保证执行。 风格是一条指令,没有任何强制执行机制。

结论

输出风格是一组指令,用于在会话中设置 Claude 的角色、语气和格式。Claude Code 有四种内置风格:Proactive、Concise、Explanatory 和 Learning,它们都保留了其标准的工程指令。自定义风格是 Markdown 文件,在完整系统提示词中,除非你设置 keep-coding-instructions: true,否则它们会省略 Claude Code 的软件工程部分。

风格不会取代 CLAUDE.md,无论你选择哪种风格,CLAUDE.md 都会保持加载状态,并且它仅触及主对话和派生对话,而不触及其他子智能体。将其用于 Claude 的响应方式,并将 Claude 应该知道的内容以及每次必须发生的事情保留在为此构建的功能中。

常见问题

什么是 Claude Code 中的输出风格?

用于为会话中的每个响应设置 Claude 的角色、语气和响应格式的指令。有四种内置风格以及自定义风格。

为什么我的自定义风格改变了 Claude 处理代码的方式?

在完整系统提示词中,自定义风格会省略 Claude Code 的软件工程指令,除非将 keep-coding-instructions 设置为 true。

输出风格会取代 CLAUDE.md 吗?

不会。Anthropic 表示,无论你选择哪种风格,CLAUDE.md 都会保持加载状态。

子智能体会使用我的输出风格吗?

只有派生对话(fork)会使用,因为它们继承了父级的系统提示词。其他子智能体运行它们自己的系统提示词。

如何更改我的输出风格?

运行 /output-style <style>,或在 /config 中选择 Output style。选择会保存到 .claude/settings.local.json。

为什么我的风格设置不起作用?

outputStyle 的值是区分大小写的。与风格名称不完全匹配的值会让你进入 Default 风格。

输出风格是强制执行的吗?

不是。Anthropic 将风格描述为 Claude 遵循的指令,因此没有任何强制执行机制。对于必须始终发生的事情,请使用钩子。