Output Styles：定制 Claude 的回复风格

Output Styles（输出风格）让你把 Claude Code 变成各种类型的 AI 助手，同时保留其核心能力（运行脚本、读写文件、追踪 TODO 等）。

三种内置风格

Default（默认）

标准系统提示词，专为高效完成软件工程任务设计。Claude 会简洁地回复，专注于完成任务。

Explanatory（解释型）

在帮你完成编程任务的同时，穿插"Insights"（洞察），帮助你理解实现选择和代码库模式。

适合谁：想在工作中学习，理解"为什么这样写"而不只是"怎么写"的开发者。

Learning（学习型）

协作、边做边学模式。Claude 不仅分享"Insights"，还会要求你实现代码中的某些部分，在代码里留下 TODO(human) 标记让你去填。

适合谁：想通过实践加深理解、不想完全"代劳"的学习者。

如何切换输出风格

运行 /config，选择 Output style，从菜单中选择风格。选择会保存到 .claude/settings.local.json（本地项目级别）。

或者直接编辑配置文件：

{
  "outputStyle": "Explanatory"
}

输出风格在会话开始时写入系统提示词。修改后需要开启新会话才会生效（这是为了保持 prompt cache 的稳定性，降低延迟和成本）。

---

创建自定义输出风格

自定义输出风格是带 frontmatter 的 Markdown 文件：

---
name: 我的自定义风格
description: 这个风格做什么的简短说明，会在 /config 菜单中显示
---

# 自定义风格指令

你是一个帮助用户完成软件工程任务的交互式 CLI 工具。[你的自定义指令...]

## 具体行为

[定义助手在这个风格下的行为方式...]

保存位置：

• 用户级别（全局）：~/.claude/output-styles/
• 项目级别：.claude/output-styles/

Frontmatter 字段

字段	作用	默认值
name	风格名称（用于 /config 菜单显示）	文件名
description	风格描述	无
keep-coding-instructions	是否保留 Claude Code 默认系统提示词中的编程相关指令	false

重要：自定义风格会移除默认系统提示词中关于软件工程的指令（如"用测试验证代码"）。如果你只是想换个助手性格，同时保留编程能力，设置 keep-coding-instructions: true。

---

Output Styles 与其他功能的区别

vs CLAUDE.md

	Output Styles	CLAUDE.md
作用方式	替换系统提示词中的软件工程指令	在系统提示词之后追加作为用户消息
范围	影响 Claude 的整体行为模式	提供项目规范和上下文
适合	彻底改变 Claude 的"人设"和工作方式	告诉 Claude 项目的具体约定和规则

vs --append-system-prompt

--append-system-prompt 是在系统提示词末尾追加内容，不会删除任何默认指令。Output Styles 则可以完全关闭默认的软件工程指令。

vs Agents（子代理）

	Output Styles	Agents
作用范围	主 Agent 循环，始终生效	处理特定任务时调用
能力	只修改系统提示词	可指定模型、工具、上下文

vs Skills

	Output Styles	Skills
激活方式	选后始终生效	按需调用（/skill-name）或自动加载
适合	一致的格式/语气偏好	可复用的工作流和任务

---

使用场景举例

将 Claude 变成文档写作助手：

---
name: 文档助手
description: 专注于写清晰、结构化的技术文档
keep-coding-instructions: false
---

你是一个技术文档写作助手。回复时用清晰的中文，结构化展示内容。
所有代码示例必须有注释说明。优先使用示例和类比解释概念。

将 Claude 变成代码审查专家：

---
name: 代码审查员
description: 严格的代码审查风格，关注安全性和性能
keep-coding-instructions: true
---

你是一个严格的代码审查员。在帮助写代码时，总是先指出潜在的安全问题、
性能瓶颈和代码可维护性问题。每次修改后都提供改进建议。

---

相关文档

• CLAUDE.md 记忆系统 — 持久化项目指令
• Skills 自定义命令 — 可复用的工作流
• 子代理 — 独立任务执行单元
• 设置配置 — 完整配置选项