Output Styles（输出样式）让你把 Claude Code 变成任何类型的 Agent——同时保留它运行脚本、读写文件、追踪 TODO 等核心能力。
什么是 Output Styles？
Output Styles 直接修改 Claude Code 的系统提示，改变它的回应方式——格式、语气、结构、教学风格等。一旦设置，对该会话的所有交互都生效。
三种内置样式
Default（默认）
Claude Code 的原始系统提示，为高效完成软件工程任务而优化：
- 简洁回应
- 聚焦于代码实现
- 主动验证代码正确性
Explanatory（解释性）
在帮你完成任务的同时，穿插教育性的「Insight」（洞察）：
- 解释实现选择背后的原因
- 说明代码库的架构模式
- 适合想深入理解代码的开发者
bash
/output-style explanatory示例输出风格：
[实现代码]
💡 Insight: 这里使用了工厂模式，因为...
[继续实现]
Learning（学习）
协作式「边做边学」模式，不只分享 Insight，还要求你参与：
- Claude 在代码中添加
TODO(human)标记 - 要求你自己实现这些关键部分
- 在你完成后提供反馈
- 适合想通过实践提升编程技能的开发者
bash
/output-style learning切换输出样式
方法一：交互菜单
bash
/output-style
# 或从 /config 菜单访问方法二：直接指定
bash
/output-style explanatory
/output-style learning
/output-style default设置存储在 .claude/settings.local.json（项目本地级别），不影响其他项目。
创建自定义 Output Style
自定义样式是带 Frontmatter 的 Markdown 文件：
markdown
---
name: 中文技术导师
description: 用中文解释技术概念，结合代码示例和类比
keep-coding-instructions: true
---
# 中文技术导师模式
你是一位耐心的中文技术导师。帮助用户完成编程任务时：
1. **先用类比解释**：将技术概念与日常生活对比
2. **中文说明**：所有解释用中文，代码和命令保持英文
3. **分步讲解**：复杂操作拆分为清晰的步骤
4. **标注陷阱**：提醒常见错误和注意事项保存位置
bash
# 用户级（所有项目）
~/.claude/output-styles/chinese-mentor.md
# 项目级（当前项目）
.claude/output-styles/chinese-mentor.mdFrontmatter 字段
| 字段 | 说明 | 默认值 |
|---|---|---|
name | 样式名称（UI 显示） | 继承文件名 |
description | 描述（/output-style 菜单显示） | 无 |
keep-coding-instructions | 保留 Claude Code 的编码相关系统提示 | false |
keep-coding-instructions: false 时，自定义样式会完全替换编码指令（适合将 Claude Code 用作非编程 Agent）。设为 true 则在保留编码能力的同时添加自定义指令。
Output Styles vs 相关功能
vs CLAUDE.md
| Output Styles | CLAUDE.md | |
|---|---|---|
| 作用方式 | 修改系统提示 | 作为用户消息追加 |
| 是否替换默认提示 | 可以（编码部分） | 不替换，只追加 |
| 生效范围 | 会话级 | 始终加载 |
vs Subagents（子代理）
- Output Styles：影响主 Agent 循环，只修改系统提示，不影响工具和模型
- Subagents：处理特定任务，可以有独立的模型、工具权限和上下文
vs Skills
- Output Styles：持续生效，改变 Claude 的整体响应方式
- Skills：按需触发（
/skill-name或自动匹配），执行特定工作流
用 Output Styles 设置持续的格式偏好，用 Skills 处理可复用的工作流程。
典型使用场景
学习新代码库：切换 Explanatory 模式，让 Claude 在完成任务时顺带解释代码逻辑
编程教学：Learning 模式，参与者自己实现关键部分，Claude 验证和引导
领域专家 Agent：自定义样式，将 Claude Code 变成安全审计员、数据分析师或技术文档撰写者
多语言团队：自定义样式让 Claude 用指定语言解释，代码保持英文
原文：Output styles - Claude Code Docs | 来源：Anthropic 官方文档