Claude Codeのoutput stylesで回答形式を変える設定手順

output stylesとは — Claudeの「話し方」を変えて回答形式を切り替える仕組み

output styles（出力スタイル）は、Claude Codeの応答の仕方を変える機能です。トーン・役割・形式は切り替えられますが、Claudeの知識そのものは変わりません。実体はシステムプロンプト（Claudeへの土台となる指示文）の末尾に、スタイル固有の指示を追記する仕組みです。

プロジェクトの規約やコードベースの前提を毎回伝えたいなら、こちらではなくCLAUDE.mdの役割です。output stylesは「常に図で答えてほしい」「執筆アシスタントとして振る舞ってほしい」など、応答の型そのものを変えたいときに使います。

Default・Proactive・Explanatory・Learningの4つの組み込みスタイルと使い分け

組み込みは4種類。用途が分かれているので、迷ったら次を目安にします。

• Default：標準のソフトウェアエンジニアリング向けプロンプト。
• Proactive：確認で止まらず、妥当な仮定を置いて即実行寄りに動く。ただし権限モードは変わらないので、ツール実行前の権限プロンプトは従来どおり出る。
• Explanatory：作業しつつ「Insights」で実装判断を解説する。
• Learning：解説に加え、コード内にTODO(human)を挿入して一部を自分で書かせる。

ExplanatoryとLearningは設計上Defaultより応答が長く、その分出力トークンが増えます。運用コストとして頭に入れておくと安心です。

/configから出力スタイルを設定し、独自の回答形式を作る手順

設定は/configを実行してOutput styleから選ぶだけ。選んだ内容はプロジェクトの.claude/settings.local.jsonに保存されます。メニューを使わず、設定ファイルのoutputStyleフィールドを直接書いても構いません。

{
  "outputStyle": "Explanatory"
}

Markdownでカスタム出力スタイルを作る（keep-coding-instructionsの判断基準）

独自スタイルはMarkdownファイルで作ります。frontmatter（先頭のメタ情報）の後ろに、システムプロンプトへ追記する指示を書くだけ。保存先はユーザー（~/.claude/output-styles）、プロジェクト（.claude/output-styles）、管理ポリシーの3階層で、ファイル名がそのままスタイル名になります。

肝はkeep-coding-instructionsです。「図で答えるが実装は従来どおり」ならDefaultのエンジニアリング指示を残すtrueを、執筆やデータ分析などコーディングを一切させないなら省略（既定のfalse）を選びます。ここを誤ると、コードを書かせたいのに検証やコメントの作法が抜け落ちる、という食い違いが起きます。

スタイルが反映されないとき

まず疑うのは反映のタイミングです。出力スタイルはセッション開始時に一度だけ読み込まれるため、変更後は/clearを打つか新しいセッションを開始しないと効きません。「編集したのに変わらない」の大半はこれです。

次にコマンドの廃止。単体の/output-styleコマンドはv2.1.73で非推奨、v2.1.91で削除されました。古い記事を見て叩いても動きません。現在は/configか設定ファイルの直接編集が正解です。

それでも反映されないなら、frontmatter付きのスタイルがシステムプロンプトへ注入されない既知の不具合（#47482）を疑います。確認はサブエージェントではなくメイン会話で行うこと。スタイルはメイン会話にしか適用されず、サブエージェントは自前のシステムプロンプトで動くためです。切り分けても直らなければ、本体を最新へ更新し、同issueの状況を確認するのが早道です。