32 · Output Styles 输出样式指南

输出样式的作用、内置样式、自定义文件结构、切换方式和适用场景，解释它如何改变回答形式而不替换核心能力。

Output Styles 是 Claude Code 里一个「润色层」：它改变的是「回答的形式」，而不是「干活的能力」。这一篇讲清楚。

「作用」：同样是完成一个任务，它可以用不同的「风格」来呈现结果——更简洁、更详细、更偏向某种格式。适合不同人的阅读偏好。

「内置样式」：Claude 提供了几种预设的输出风格，你可以直接选一个用。

「自定义文件结构」：如果你对输出形式有更高要求，可以自己定义一套样式文件，精细控制它怎么说话、怎么排版、怎么组织结果。

「切换方式」通常是改一下配置或下个命令，随时可换。

「适用场景」：比如你希望它回答尽量简短（省时间）、或者希望它用特定结构输出（方便你复制）、或者希望它更「唠叨」一点（要详细解释）。不同场景，换不同样式。

「关键理解」：Output Styles 只是「换皮」，不会让它变聪明或变笨。它不替换核心能力，只影响「包装」。所以别指望靠换样式解决能力问题。

这一篇属于「锦上添花」型配置，不是必学。等你用熟了、对「它怎么说话」有偏好了，再来调它。

常见误区：很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」，理解了动机，规则就自然内化了，不用死记硬背。

动手试一下：你可以花 5 分钟做一个最小验证——找一个真实的代码任务，让 Codex 跑一遍，看它的行为是不是和这一篇描述的一致。理论与实践对照，才知道「懂」和「会用」是两件事。

与其他篇的关系：这一篇是本组的基础。如果你跳过了前面几篇，建议先回去看，否则这里有些概念可能看着突兀。如果都看过了，那你可以直接进入更后面的实战环节，把这里学到的东西用上。

判断决策树：用三个问题判断该不该用——① 这件事值不值得用 Codex 做？② 用的话该用哪个入口？③ 风险高不高需不需要审批？三个问题的答案一出来，怎么做就清楚了。