输出样式

通过内置输出样式（如简洁或解释性）或自定义样式来改变 Claude Code 的角色、语气和响应格式。

输出样式是一组指令，为会话中的每个响应设置 Claude 的角色、语气和响应格式。Claude Code 包括四种内置样式（除了默认样式），你也可以编写自己的样式。

使用输出样式来改变 Claude 在整个会话中的响应和工作方式，这样你就不需要在每个提示中重复请求。例如，内置样式可以使响应更短、为每个更改添加解释，或让 Claude 在不提出常规问题的情况下开始工作。自定义样式也可以将 Claude 转变为软件工程师以外的角色，例如写作助手或数据分析师。

• 要使用内置样式，请从内置输出样式中选择一个，然后切换到它。
• 要编写自己的指令，请创建自定义输出样式。

内置输出样式

Claude Code 从默认样式开始，这是其完成软件工程任务的标准指令。其他四种内置样式保留这些指令并添加各自的特定内容。

此表显示每种样式改变了什么以及何时适合使用：

默认

默认意味着未选择任何输出样式。Claude Code 不添加样式指令，Claude 从 Claude Code 的标准系统提示工作，该提示是为软件工程任务编写的。

default 出现在 /output-style 列表中与其他样式一起，所以你以相同的方式选择它。

Proactive

在 Proactive 样式中，Claude 在你发送任务后立即开始实现。它对常规决策做出合理的假设，而不是停下来询问，除非你要求制定计划，否则不会切换到计划模式。你可以在任何时刻重定向它。

该样式的指令还告诉 Claude 在删除数据或更改共享或生产系统的操作之前在对话中与你核实。该核实是 Claude 遵循的指令，与权限提示分开。

切换到 Proactive 样式不会改变你的权限模式。你的权限模式仍然决定哪些工具调用在不询问你的情况下运行，所以权限提示的显示方式与你切换之前相同。

Concise

在 Concise 样式中，响应的第一句陈述发生了什么或答案是什么。Claude 省略了引言、逐步叙述和结尾总结，并用一到三句话回答简单问题。它以与默认样式相同的彻底程度完成工程工作。需要 Claude Code v2.1.237 或更高版本。

Claude 在以下情况下仍然会完整编写：

• 你要求的任何内容：当你要求解释或更多细节时，Claude 会完整回答。
• 你安全行动所需的任何内容：错误报告、失败的测试输出、安全警告和破坏性操作的确认保留其完整内容。

Explanatory

在 Explanatory 样式中，Claude 以与默认样式相同的方式完成任务，并添加关于其做出选择原因的简短解释。每个解释出现在对话中，在其相关代码之前或之后，在标记为 Insight 的块中。这些解释不会作为注释写入你的文件中。

Insight 块包含关于你的代码库或 Claude 编写的代码的两到三个要点，例如添加 API 端点后的这个：

★ Insight ─────────────────────────────────────
- Every route in this repo goes through the withAuth wrapper, so the new endpoint gets session checks without its own middleware.
- Rate limits are set per route in limits.ts, which is why this change adds an entry there rather than a global default.
─────────────────────────────────────────────────

Learning

在 Learning 样式中，Claude 添加与 Explanatory 样式相同的 Insight 块，并且还要求你编写一些代码。Claude 自己处理常规实现。当它到达具有真实设计决策的部分时，例如错误处理、数据结构或具有多个有效方法的业务逻辑，它会为你留下几行代码。

Claude 用文件中的 TODO(human) 注释标记该位置，然后发送一个请求，说明已经构建的内容、要编写的内容以及要权衡的内容：

● Learn by Doing

Context: The upload form is in place and calls validateFile() before accepting a file. Size and type checks work for images, but the switch statement has no handling for documents yet.

Your Task: In upload.js, implement the case "document" branch inside validateFile(). Look for TODO(human).

Guidance: Decide on a size limit for documents and whether the file extension has to match the MIME type. Return {valid: boolean, error?: string}.

Claude 然后停止并等待。在 TODO(human) 注释处编写你的代码，并告诉 Claude 你已完成。Claude 用一个关于你的代码的 Insight 进行响应并继续该任务。

更改你的输出样式

通过命令、菜单或设置文件选择样式。命令和两个菜单都会将你的选择保存到本地项目级别的 .claude/settings.local.json。

• /output-style 命令：运行 /output-style <style> 来切换，例如 /output-style concise。不带参数时，该命令列出你可以选择的样式并标记当前样式。

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

• Terminal 菜单：运行 /config 并选择输出样式从菜单中选择一种样式。

• VS Code extension：使用 / 打开命令菜单并选择输出样式来选择一种样式，包括你的自定义样式。需要 Claude Code v2.1.257 或更高版本。

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

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

{
  "outputStyle": "Explanatory"
}

该值区分大小写，因此请将内置名称写为 Proactive、Concise、Explanatory 和 Learning。与样式名称不完全匹配的值（例如 explanatory）会给你默认样式。/output-style 命令忽略大小写。

要在项目间将样式设置为默认值，请在 ~/.claude/settings.json 中设置 outputStyle。项目自己的设置文件优先于该值。

当你在会话中途切换样式时，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 参考

使用位于文件顶部 --- 标记之间的 YAML frontmatter 配置输出样式。所有字段都是可选的，字段名称使用由连字符分隔的小写单词。拼写错误的字段会被忽略而不会出现错误。如果 YAML 无法解析，样式仍会以其文件名加载，且不设置任何字段；运行 claude --debug 以查看解析错误。