Claude Code回答太长怎么调？Concise、Explanatory与自定义输出风格

Claude Code改动很小却解释很长，或你想边读代码边了解原因，不必每轮都重复风格要求。Output styles为整段会话设置角色、语气与回复格式。本文先试内置Concise与Explanatory，再创建一个固定汇报格式，重点检查作用范围和生效方式，不把短回答理解成可以少做必要验证。

第一步：区分风格、项目规则与权限

输出风格属于给模型的指令，不是强制执行器。项目结构、命令和约定适合CLAUDE.md；某类任务的流程适合Skill；必须每次发生的机械操作要用合适Hook。调整风格不会更改权限模式，不能借此绕过工具确认或组织策略。

先更新到支持所需功能的版本。官方标注Concise需要Claude Code 2.1.237或以上，其他入口也有各自版本条件；不在旧版本看不到菜单时直接重写全部配置。使用前备份已有本地设置，尤其不要用一个示例JSON覆盖整个文件。

第二步：先切换内置风格做对照

/output-style concise

Concise先讲结果，省去铺垫与复述，简单问题通常更短；你明确要求的详细说明、错误与必要安全信息仍应完整。想理解代码选择时切换Explanatory，它添加Insight说明，不会把那些说明直接写成项目注释。Learning则会留部分TODO(human)让你练习，可能停下来等你，不适合要求全部自动完成的任务。

请只读解释练习项目中一个已有函数。先说明它做什么，再指出一个需要注意的边界条件。不要修改文件，不运行安装或测试。

用同一类小问题比较风格，而不是用两个难度完全不同的任务判断优劣。默认风格可通过/output-style default恢复。Proactive偏向主动推进常规决策，但仍不是无条件执行破坏性或生产操作的授权。

第三步：检查保存位置和生效时间

/output-style及菜单通常将选择写入项目本地.claude/settings.local.json；全项目默认可按需求设置到用户级~/.claude/settings.json，项目配置优先。直接写outputStyle字段时内置值大小写敏感，例如Concise与Explanatory；命令本身不区分大小写。

{"outputStyle":"Explanatory"}

这只是要合并的字段示意，不是替换已有文件。当前版本中途切换从下一条消息起生效；2.1.251之前可能要新会话或/clear。先核对版本与当前选择，不在进行中的重要任务里随意清空会话来测试风格。

第四步：建立保留编码能力的自定义风格

在练习项目.claude/output-styles/创建review-brief.md，使用Markdown frontmatter描述风格。若只是改变表达、仍希望正常完成工程任务，加入keep-coding-instructions: true；省略时自定义角色可能不保留完整的软件工程指令，效果与只想“简短一点”不同。

---
name: Review brief
description: 用固定顺序汇报代码任务
keep-coding-instructions: true
---
每次完成代码任务后，按“结果、依据、待处理”顺序简短汇报。
只列实际执行的检查，不把计划写成完成。
失败和未验证项明确保留；用户要求细节时完整解释。
不要为了格式虚构测试结果或修改无关文件。

终端在启动时读取风格文件，运行中创建或编辑后需重启Claude Code再选择。保存正在进行的任务上下文后，在练习会话选择/output-style Review brief。文件名与frontmatter名称可能不同，列表里以实际显示名为准。

第五步：用成功和失败两类问题验收

先用只读解释检查格式，再询问一个明确缺少证据的结论，看它是否仍保留未知项。短格式如果省掉失败原因或未执行验证，就需要修正指令，而非把简短本身当成成功。查看文件差异确认只新增预期配置，没有误改项目代码。

自定义风格不是保证每次严格输出JSON的协议，也不能替代程序校验。完成标准是回答更符合你的阅读习惯，必要信息仍在，权限和项目规则保持正确。任务换成教学或深入排错时，直接要求详细解释或切换风格即可。

官方资料

资料核对日期：2026年11月7日。

• Anthropic：Output styles