跳转到主要内容
输出样式已弃用。在 2025 年 11 月 5 日或之后，我们将自动将您的用户级输出样式文件转换为插件，并停止支持输出样式功能。请改用插件。(内置 Explanatory 输出样式的示例插件)

​
弃用时间表

从 2025 年 11 月 5 日起，Claude Code 将：
  • 自动将用户级输出样式文件 (~/.claude/output-styles) 转换为插件
  • 停止支持输出样式功能
  • 移除 /output-style 命令和相关功能
您需要做的事情：
  • 在 2025 年 11 月 5 日之前迁移到插件，以实现更平稳的过渡
  • 查看下面的迁移指南，了解您的选项

​
替代方案：改用插件

插件提供了更强大和灵活的方式来自定义 Claude Code 的行为。explanatory-output-style 插件重新创建了已弃用的 Explanatory 输出样式功能。

​
示例：Explanatory 输出样式插件

explanatory-output-style 插件使用 SessionStart 钩子来注入额外的上下文，鼓励 Claude 提供教育性见解。它的功能如下：
  • 提供关于实现选择的教育性见解
  • 解释代码库模式和决策
  • 平衡任务完成与学习机会

​
安装插件

要安装像 explanatory-output-style 这样的插件：
添加市场（如果尚未添加）
/plugin marketplace add anthropics/claude-code
安装插件
/plugin install explanatory-output-style@claude-code-plugins
重启 Claude Code 以激活插件
/exit
禁用插件
/plugin manage explanatory-output-style@claude-code-plugins

1. 当您看到 claude-code-marketplace 时按 Enter
2. 当您看到 explanatory-output-style 时按空格以切换启用状态
3. 按下箭头到"应用更改"，然后按 Enter
    您应该看到"已禁用 1 个插件。重启 Claude Code 以应用更改。"

/exit
有关插件的更多详细信息，请参阅插件文档。

​
迁移指南

输出样式直接修改了 Claude Code 的系统提示。以下是如何通过钩子和子代理实现类似效果的方法，两者都可通过 Claude Code 插件获得：

​
使用 SessionStart 钩子进行上下文注入

如果您使用输出样式在会话开始时添加上下文，请改用 SessionStart 钩子。 钩子的输出（stdout）被添加到对话上下文中。您还可以：
  • 运行动态生成上下文的脚本
  • 加载项目特定的信息
SessionStart 钩子与 CLAUDE.md 一样，不会改变系统提示。

​
使用子代理进行不同的系统提示

如果您使用输出样式为特定任务改变 Claude 的行为，请改用子代理。 子代理是专门的 AI 助手，具有：
  • 自定义系统提示（必须在与主循环分离的单独上下文窗口中）
  • 特定的工具访问权限
  • 可选的模型使用，如果不是主循环模型

​
参考：原始输出样式文档

下面的内容仅供参考。输出样式已弃用，将在 2025 年 11 月 5 日被移除。请迁移到插件、钩子或子代理。
输出样式允许您将 Claude Code 用作任何类型的代理，同时保留其核心功能，例如运行本地脚本、读取/写入文件和跟踪 TODO。

​
内置输出样式

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

​
输出样式的工作原理

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

​
更改您的输出样式

您可以：
  • 运行 /output-style 以访问菜单并选择您的输出样式（这也可以从 /config 菜单访问）
  • 运行 /output-style [style]，例如 /output-style explanatory，直接切换到某个样式
这些更改适用于本地项目级别，并保存在 .claude/settings.local.json 中。 您还可以创建自己的输出样式 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. 自定义斜杠命令

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