输出样式

将 Claude Code 适配用于软件工程之外的用途

输出样式改变 Claude 的响应方式，而不是 Claude 知道什么。它们设置 Claude 的角色、语气和输出格式，用于每个响应。当你在每个回合中不断重新提示相同的语音或格式时，或者当你希望 Claude 充当软件工程师以外的角色时，请使用一个。

自定义输出样式为 Claude 提供你自己的说明，并让你选择是否保留 Claude Code 的内置软件工程说明。当你改变 Claude 的通信方式但仍在编码时（例如总是用图表回答），请保留它们。当 Claude 根本不进行软件工程时（例如写作助手或数据分析师），请省略它们。

有关你的项目、约定或代码库的说明，请改用 CLAUDE.md。

内置输出样式

Claude Code 的默认输出样式是其标准指令集，旨在帮助你高效地完成软件工程任务。

还有四种额外的内置输出样式：

• Proactive：Claude 立即执行，做出合理的假设而不是暂停进行常规决策，并倾向于行动而非规划。这提供了比自动模式更强的自主执行指导，并且无需更改你的权限模式即可工作，因此你的权限模式仍然决定什么在不询问的情况下运行。

• Concise：Claude 以结果开头，跳过前言和叙述，默认保持响应简洁，同时以与默认样式相同的彻底程度完成工程工作。当你要求解释或更多细节时，Claude 会完整回答。Claude 始终保留错误报告、安全警告和破坏性操作确认的完整内容。需要 Claude Code v2.1.237 或更高版本。

• Explanatory：在帮助你完成软件工程任务的同时提供教育性的"Insights"。帮助你理解实现选择和代码库模式。

• Learning：协作式的边学边做模式，Claude 不仅会在编码时分享"Insights"，还会要求你自己贡献小的、战略性的代码片段。Claude Code 将在你的代码中添加 TODO(human) 标记供你实现。

更改你的输出样式

通过以下方式之一选择样式：

• /output-style 命令：运行 /output-style <style> 来切换，例如 /output-style concise。不带参数时，该命令列出你可以选择的样式并标记当前样式。Claude Code 将你的选择保存到本地项目级别的 .claude/settings.local.json。

  该命令也适用于非交互模式和 Agent SDK 会话，以及来自移动应用或网页的远程控制，其中你只能列出和选择内置样式。需要 Claude Code v2.1.269 或更高版本。

• Terminal：运行 /config 并选择输出样式从菜单中选择一种样式。Claude Code 将你的选择保存到本地项目级别的 .claude/settings.local.json。

• VS Code extension：使用 / 打开命令菜单并选择输出样式来选择一种样式，包括你的自定义样式。Claude Code 将你的选择保存到 .claude/settings.local.json，这是终端菜单写入的同一个文件。需要 Claude Code v2.1.257 或更高版本。

• Desktop app：在设置文件中设置 outputStyle 字段，例如 .claude/settings.local.json，这是终端菜单写入的文件。当你在那里运行 /config 时，Claude Code 打开设置 > Claude Code而不是菜单。

要在不使用菜单的情况下设置样式，直接编辑设置文件中的 outputStyle 字段：

{
  "outputStyle": "Explanatory"
}

当你在会话中途切换样式时，Claude 从你的下一条消息开始使用新样式。关于该第一条消息在 prompt caching 中的成本，请参阅更改输出样式。在 v2.1.251 之前，新样式仅在你运行 /clear 或开始新会话后才会应用。

创建自定义输出样式

自定义输出样式是一个 Markdown 文件：frontmatter 用于元数据，然后是 Claude 的说明。

在 VS Code 扩展中，你也可以从输出样式菜单创建文件，而不是手动编写。这需要 Claude Code v2.1.261 或更高版本。

---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.

Plugins 也可以在 output-styles/ 目录中提供输出样式。

Frontmatter

输出样式文件支持这些 frontmatter 字段：

输出样式如何工作

输出样式改变了 Claude Code 给予 Claude 的指令。

• Claude Code 在每个请求中发送活跃样式的指令。
• 当你选择除 Default 以外的样式时，Claude Code 也会在对话期间提醒 Claude 该样式。
• 自定义输出样式排除了 Claude Code 的内置软件工程说明，例如如何限定更改范围、编写注释和验证工作，除非 keep-coding-instructions 设置为 true。

输出样式适用于主对话和分支，分支继承父级的完整对话和系统提示。其他子代理运行自己的系统提示，所以样式不会改变它们的响应方式。

令牌使用情况取决于样式。样式的指令会增加输入令牌，尽管 prompt caching 在会话中的第一个请求之后会降低这个成本。

内置的 Explanatory 和 Learning 样式在设计上比 Default 产生更长的响应，这会增加输出令牌。Concise 样式则相反，通过指示 Claude 默认保持响应简洁来实现。对于自定义样式，输出令牌使用情况取决于你的指令告诉 Claude 生成什么。

与相关功能的比较

多个功能自定义 Claude Code 的行为方式。输出样式改变 Claude Code 的默认说明并应用于每个响应。其他功能添加说明而不改变默认设置，或将其范围限定为特定任务。

相关资源

• Settings：outputStyle 字段所在的位置以及设置优先级的工作原理
• Permission modes：Proactive 样式与自动模式的比较方式
• Plugins：打包和分发输出样式以及 skills、hooks 和 agents
• Debug your configuration：诊断为什么输出样式没有生效