输出风格

Output style 改变 Claude Code 的回答方式。它修改 system prompt,用于固定角色、语气、输出格式或教学方式。项目规则、代码约定和长期上下文仍应该放在 记忆与规则,不是放进 output style。

#内置风格

Proactive 不是权限模式。它会更主动,但工具执行仍受 permissions 约束。

#切换方式

推荐用 /config:

/config

然后选择 Output style。选择结果通常写入 .claude/settings.local.json:

{
  "outputStyle": "Explanatory"
}

outputStyle 会影响 system prompt,当前会话中途改了不立即替换已经加载的系统提示。用 /clear 或新开会话后生效。

#自定义 output style

自定义风格是一个 Markdown 文件。文件名默认就是风格名,也可以用 frontmatter 的 name 覆盖。

示例:

---
name: Diagrams first
description: 解释代码时先给 Mermaid 图
keep-coding-instructions: true
---

解释代码、架构或数据流时,先给一个 Mermaid 图,再用短段落说明。
图保持在 15 个节点以内。

如果只是改变表达方式,但仍然希望 Claude 按软件工程 agent 行为做事,设置 keep-coding-instructions: true。如果你要把 Claude 变成写作助手、数据分析助手或非编码角色,可以不保留。

#Frontmatter

插件也可以在 output-styles/ 目录里分发风格。启用插件后,用户可以在 /config 中选择。

#和其他机制的边界

#成本和缓存

建议按任务开始前确定 output style。中途为了“换口吻”频繁切换,通常不划算。

#Passion8 使用建议

接入 Passion8 不改变 output style 机制。模型可用性、计费和缓存表现仍以当前 Claude Code 请求和 Passion8 网关行为为准。

#官方参考

• Output styles
• Settings
• Prompt caching
• Plugins