何のためのものか
システムプロンプトを書き換えて、Claude の役割・トーン・出力形式を変える仕組み。
使いどころははっきりしている。毎ターン同じ言い回しや形式を指示し直している場合、またはソフトウェアエンジニア以外の役割をさせたい場合。プロジェクトの規約やコードベースの説明は CLAUDE.md の担当。
触る
/configを実行して Output style から選ぶ。選択は.claude/settings.local.jsonに保存される/clear後または新しいセッションから有効になる（output style はシステムプロンプトの一部で、セッション開始時に一度だけ読まれる）
| 名前 | 内容 |
|---|---|
| Default | 既定。ソフトウェアエンジニアリング作業向け |
| Proactive | 即座に実行し、日常的な判断では止まらない。permission mode は変えないので permission prompt は出る |
| Explanatory | 作業の合間に教育的な "Insights" を提示する |
| Learning | コードの一部をユーザー自身に書かせる。TODO(human) マーカーを追加する |
入れる
カスタムを作る。Markdown ファイル 1 枚（frontmatter + システムプロンプトに追加する指示）で済む。
| 置き場所 | 範囲 |
|---|---|
~/.claude/output-styles | 自分の全プロジェクト |
.claude/output-styles | そのプロジェクト |
nameを書かなければファイル名がスタイル名になる。descriptionは/configのピッカーに出る- 既定ではコーディング用の組み込み指示が外れる。 変更範囲の切り方・コメントの書き方・検証方法などを残したいなら
keep-coding-instructions: true
効かせる
似た機能との違いで選ぶ。
| 使いたい場面 | 使うもの |
|---|---|
| 毎ターン別の役割・トーン・応答形式にしたい | output style（システムプロンプトを変更する） |
| プロジェクトの規約や文脈を常に知らせたい | CLAUDE.md（システムプロンプトの後にユーザーメッセージとして入る） |
| 1 回の起動限りで足したい | --append-system-prompt |
| 再利用するワークフローがある | skill（呼び出し時に読み込まれる） |
- output style はメインの会話にのみ適用される。 subagent は独自のシステムプロンプトで動くため影響を受けない（fork は親のシステムプロンプト全体を継承するので例外）
- すべての output style は、会話中に指示を守らせるためのリマインダーを発生させる
落とし穴
- 切り替えても現在のセッションには効かない。
/clearか新しいセッションが要る - 組み込みの Explanatory と Learning は設計上 Default より長い応答を出す。 output token が増える
- スタンドアロンの
/output-styleコマンドは削除済み。/configを使う - plugin の output style は
force-for-pluginでユーザーの選択なしに自動適用されうる（複数あれば最初に読み込まれたもの）