本页目录8
- Output styles 直接修改系统提示，改变 Claude 每次回复的角色与格式，而非其知识库
- 内置四种风格：Default（默认）、Proactive（主动执行）、Explanatory（附洞见）、Learning（协作学习，含 TODO(human) 标注）
- 通过 `/config` 选择风格，保存至 `.claude/settings.local.json`；修改后需 `/clear` 或重开会话生效
- 自定义风格为 Markdown 文件，存于 `~/.claude/output-styles/` 或 `.claude/output-styles/`，frontmatter 控制元数据
- `keep-coding-instructions: true` 可在自定义风格中保留内置软件工程指令，适合仅改沟通方式不改编码行为的场景
- Output styles 是唯一直接替换系统提示的机制，与 CLAUDE.md、--append-system-prompt、Agents、Skills 各有分工
本文是对官方文档「Output styles」的中文要点摘要，完整内容以原文为准：https://code.claude.com/docs/en/output-styles
Output styles（输出风格）功能让你调整 Claude Code 每次回复的角色、语气和格式，无需每轮对话重复提示词。它直接修改系统提示（system prompt），一经设置对整个会话生效。
什么是 Output Style
Output style 改变的是「Claude 如何回应」，而不是「Claude 知道什么」。与 CLAUDE.md 不同——后者用于告知项目约定和代码库上下文，output style 专注于回复格式与角色定位。当你发现自己每轮对话都要重复相同的格式要求时，正是使用 output style 的时机。
四种内置风格
| 风格名 | 特点 |
|---|---|
| Default | 默认风格，专为高效完成软件工程任务设计 |
| Proactive | 立即执行、合理假设、行动优先；比 auto 模式更强的自主执行引导，但仍会弹出权限提示 |
| Explanatory | 在协助编码时插入「洞见（Insights）」，帮助理解实现选择和代码库模式 |
| Learning | 协作学习模式：Claude 分享洞见之余还会在代码里标注 TODO(human)，请你亲自实现关键片段 |
如何切换风格
运行 /config，选择 Output style 后从菜单选取即可，配置保存至项目级别的 .claude/settings.local.json。
也可直接编辑配置文件中的 outputStyle 字段：
{
"outputStyle": "Explanatory"
}
注意：Output style 在会话启动时读入系统提示，修改后需执行 /clear 或重新开启会话才生效。旧版独立命令 /output-style 已于 v2.1.91 起完全移除，请统一使用 /config。
自定义输出风格
自定义风格是一个 Markdown 文件：frontmatter 写元数据，正文写需要加入系统提示的指令。
存放路径（三个层级）：
- 用户级：
~/.claude/output-styles/ - 项目级：
.claude/output-styles/ - 托管策略级：managed settings 目录下的
.claude/output-styles/
文件名即风格名（除非 frontmatter 中另设 name 字段）。v2.1.178 起，若多层嵌套目录存在同名风格，优先使用离当前工作目录最近的那个。
frontmatter 字段说明
| 字段 | 用途 | 默认值 |
|---|---|---|
name | 风格显示名称 | 继承文件名 |
description | 在 /config 菜单中显示的说明 | 无 |
keep-coding-instructions | 是否保留 Claude Code 内置的软件工程指令 | false |
force-for-plugin | 插件专用：启用插件时自动应用此风格，覆盖用户设置 | false |
关键决策：如果你只是改变 Claude 的沟通方式但仍需要它正常编码，设置 keep-coding-instructions: true；如果用于写作助手、数据分析等非工程场景，则省略此字段（默认为 false，会移除内置工程指令）。
示例：始终先画架构图再解释
---
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.
Use `flowchart TD` for control flow and `sequenceDiagram` for request
paths. Keep diagrams under 15 nodes.
插件（Plugins）也可在其 output-styles/ 目录中打包自定义风格一起分发，并通过 force-for-plugin: true 实现插件启用时自动切换。
与相关功能对比
| 功能 | 作用机制 | 适用场景 |
|---|---|---|
| Output styles | 直接修改系统提示 | 每次回复都需要特定角色/语气/格式 |
CLAUDE.md | 在系统提示后附加用户消息 | 让 Claude 始终了解项目约定与代码库上下文 |
--append-system-prompt | 追加到系统提示但不移除原有内容 | 单次调用的一次性补充 |
| Agents（子智能体） | 以独立系统提示、模型和工具运行 | 需要独立作用域的专注型子任务 |
| Skills（技能） | 按需加载特定任务指令 | 可复用的工作流程 |
Token 用量说明
在系统提示中加入指令会增加输入 token，但 prompt caching 会在同会话的后续请求中摊薄这部分成本。Explanatory 和 Learning 风格因设计上产出更长回复，输出 token 也会相应增加。自定义风格的 token 用量取决于你的指令内容。