规范文件
Claude Code 输出风格:怎样保留编程指令
创建项目输出风格时明确 keep-coding-instructions,再检查加载位置与切换时机。
希望回复更短或先给结构图,可以配置整段会话的输出风格。它改变角色、语气和格式,选择时还要考虑是否保留软件工程指令。本文提供原创风格样例及文件检查;没有启动 Claude Code 应用风格,也不认证模型一定按格式输出。
- 核验日期
- · 未实测
- 适用于
- Claude Code 适用于本机 Claude Code;官方页面未给统一版本门槛,以 2026-11-04 核验与实际界面为准。[1]
- 涉及工具
文件位置
| 路径 | 适用范围 | 读取方式 |
|---|---|---|
./.claude/output-styles/decision-first.md | 项目输出风格;用户级可放 ~/.claude/output-styles/。 | 终端启动时读取风格文件;会话中新增或编辑后需重启以读取。[1] |
什么时候用
- 希望整段编程会话保持固定回复结构,同时保留编程行为。[1]
什么时候不用
- 需要确定性限制文件访问或命令权限。[1]
文件位置与原创样例
在项目 .claude/output-styles/ 新建 Markdown 文件。官方也支持用户级和 managed 位置,项目目录中的同名风格以离工作目录最近者为准。下面样例只定义回复顺序,frontmatter 明确保留编程指令。它是可编辑练习,不是官方提供的成品风格。[1]
---
name: Decision first
description: Start with the decision and its evidence
keep-coding-instructions: true
---
State the decision, show the evidence, and give the next action.
Keep assumptions explicit.
为什么要设置保留开关
官方说明:如果只改变交流方式、仍希望保持编程行为,设置 keep-coding-instructions: true;若角色不再做软件工程,可不设置。不要仅因文件扩展名是 Markdown,就推断软件工程指令自动保留。先写清风格是沟通偏好还是角色改变,再检查 frontmatter。[1]
切换与重新读取
终端可用 /output-style 或 /config 的 Output style 选择风格;当前版本从下一条消息开始使用,官方说明 v2.1.251 之前要 /clear 或新会话才生效。终端会话中新增或编辑风格文件,需重启 Claude Code 读取。检查选中名称、实际文件与同名目录覆盖;文件已写入和当前会话已加载是两个验收点。[1]
本地检查与使用边界
本文离线检查了样例的 frontmatter 分隔、字段和保留开关,没有写入用户配置、执行切换或发起模型请求。实际采用时用一个小型解释任务观察回复,再根据结果调风格。风格是给模型的指令,不能保证每次严格遵循,也不能代替权限设置或自动化验收。[1]
来源
以下均为官方页面,核验日期见各条;链接指向核验时的版本。