跳转到主要内容
输出样式允许你将 Claude Code 用作任何类型的代理，同时保留其核心功能，例如运行本地脚本、读取/写入文件和跟踪待办事项。

​
内置输出样式

Claude Code 的默认输出样式是现有的系统提示，旨在帮助你高效完成软件工程任务。 还有两种额外的内置输出样式，专注于教你了解代码库和 Claude 的运作方式：
  • 解释性：在帮助你完成软件工程任务的同时提供教育性的”见解”。帮助你理解实现选择和代码库模式。
  • 学习：协作式的边做边学模式，Claude 不仅会在编码时分享”见解”，还会要求你自己贡献小的、战略性的代码片段。Claude Code 将在你的代码中添加 TODO(human) 标记供你实现。

​
输出样式如何工作

输出样式直接修改 Claude Code 的系统提示。
  • 非默认输出样式排除了特定于代码生成和通常内置于 Claude Code 中的高效输出的指令（例如简洁回复和用测试验证代码）。
  • 相反，这些输出样式在系统提示中添加了自己的自定义指令。

​
更改输出样式

你可以：
  • 运行 /output-style 访问菜单并选择你的输出样式（也可以从 /config 菜单访问）
  • 运行 /output-style [style]，例如 /output-style explanatory，直接切换到某个样式
这些更改应用于本地项目级别 并保存在 .claude/settings.local.json 中。

​
创建自定义输出样式

要在 Claude 的帮助下设置新的输出样式，运行 /output-style:new I want an output style that ... 默认情况下，通过 /output-style:new 创建的输出样式保存为用户级别 ~/.claude/output-styles 中的 markdown 文件，可以在项目间使用。它们具有以下结构： 
---
name: My Custom Style
description:
  A brief description of what this style does, to be displayed to the user
---

# Custom Style Instructions

You are an interactive CLI tool that helps users with software engineering
tasks. [Your custom instructions here...]

## Specific Behaviors

[Define how the assistant should behave in this style...]
你也可以创建自己的输出样式 Markdown 文件，并将其保存在用户级别 (~/.claude/output-styles) 或项目级别 (.claude/output-styles)。

​
与相关功能的比较

​
输出样式 vs. CLAUDE.md vs. —append-system-prompt

输出样式完全”关闭”Claude Code 默认系统提示中特定于软件工程的部分。CLAUDE.md 和 --append-system-prompt 都不编辑 Claude Code 的默认系统提示。CLAUDE.md 将内容作为用户消息添加到 Claude Code 默认系统提示_之后_。--append-system-prompt 将内容附加到系统提示。

​
输出样式 vs. 代理

输出样式直接影响主代理循环，仅影响系统提示。代理被调用来处理特定任务，可以包括额外的设置，如要使用的模型、可用的工具以及关于何时使用代理的一些上下文。

​
输出样式 vs. 自定义斜杠命令

你可以将输出样式视为”存储的系统提示”，将自定义斜杠命令视为”存储的提示”。