输出样式可以让 Claude Code 适配 软件工程之外的场景 ，同时保留其运行本地脚本、读写文件、跟踪待办事项等核心功能。
本质是通过修改系统提示，定制 Claude Code 的交互逻辑和响应风格。
内置输出样式
Claude Code 提供 3 种开箱即用的输出样式，满足不同使用需求：
输出样式的工作原理
输出样式的底层逻辑是 修改系统提示 ，遵循以下规则：
切换输出样式
切换样式有两种快捷方式，修改后的配置会保存在项目目录的 .claude/settings.local.json 文件中， 仅对当前项目生效 ：
/output-style explanatory
补充：也可以直接编辑不同级别的设置文件，修改 outputStyle 字段来切换样式。
创建自定义输出样式
如果内置样式不满足需求，你可以通过 Markdown 文件定义专属样式，支持 用户级别 和 项目级别 两种保存路径。
1. 文件格式
自定义样式文件由 前置元数据 和 指令正文 两部分组成：
--- name: 自定义样式名称 description: 样式功能的简短描述（会在 /output-style 菜单中显示） keep-coding-instructions: false # 是否保留默认编码相关指令，默认false --- # 自定义指令标题 这里写具体的行为规则，例如： 你是一个专注于数据分析的助手，擅长将复杂数据转化为简洁的可视化报告。 所有回复需要包含「结论+数据支撑+建议」三部分。 ## 补充行为要求 1. 优先使用 Python Pandas 处理数据 2. 生成代码时必须附带详细注释
2. 元数据参数说明
3. 保存路径
与相关功能的区别
为避免混淆，这里明确输出样式与其他类似功能的核心差异：
Claude Code 自定义输出样式模板
直接替换 [ ] 中的内容，保存为 .md 文件即可使用:
--- # 【必填】样式名称，会显示在 /output-style 菜单中 name: [你的样式名称，例如：数据分析助手] # 【选填】样式功能描述，用于菜单展示说明 description: [一句话说明这个样式的用途，例如：专注将复杂数据转为可视化报告和分析结论] # 【选填】是否保留默认的编码相关系统提示 # true = 保留编码指令 / false = 剔除编码指令（默认） keep-coding-instructions: [true/false] --- # 一、核心定位 [定义 Claude 的角色，例如：你是一个专业的数据分析助手，擅长使用 Python 处理各类结构化数据] # 二、响应规则 [规定 Claude 的回复逻辑，例如： 1. 所有分析必须包含「数据结论 + 支撑依据 + 优化建议」三部分 2. 生成代码时必须附带详细注释，且优先使用 Pandas/Matplotlib 库 3. 避免使用专业术语堆砌，用通俗语言解释复杂概念] # 三、格式要求 [指定回复的排版格式，例如： 1. 结论部分加粗显示 2. 代码块使用 ```python 标签包裹 3. 建议部分用有序列表呈现] # 四、特殊场景处理 [补充特定场景的规则，例如： 1. 遇到缺失数据时，主动提示用户补充关键信息，而非直接报错 2. 生成可视化图表时，默认输出中文标签和浅色主题]
使用步骤
