チームで Claude Code を使っていると、人によって応答の粒度がバラバラになります。片方の開発者は長い解説つきの応答を受け取り、もう片方は要点だけの応答を受け取る。レビュー規約や「公開 API を変える前に影響範囲を書く」といったチームの約束事も、各自のプロンプトまかせでは守られません。出力スタイルは、この「個人差」をリポジトリにコミットできる設定へ落とし込むための仕組みです。本稿では、チーム共通のカスタム出力スタイルをゼロから作り、リポジトリに乗せ、本番の運用に組み込むまでを一本の実装として通します（2026-10-14 時点）。
組み込みスタイルと、カスタムが要る理由
Claude Code には Default のほかに 4 つの組み込みスタイルがあります。
Claude Code includes four built-in styles besides its default
Proactive・Concise・Explanatory・Learning の 4 つで、Default は「スタイル未選択」の状態を指します。Explanatory と Learning は Default より長い応答になる設計、Concise は逆に短くする設計で、出力トークン数に差が出ます（2026-10-14 時点）。Concise は Claude Code v2.1.237 以降でのみ使えます。
ただし組み込みスタイルは「話し方の方向性」を変えるだけで、チーム固有のレビュー規約は表現できません。そこでカスタム出力スタイルを使います。ここで重要なのが、カスタムスタイルの既定挙動です。カスタム出力スタイルは、keep-coding-instructions: true を明示しない限り Claude Code 側の組み込みソフトウェアエンジニアリング指示を落とします。本番コードを扱わせるなら、ほぼ常に true を付けるべきです。
カスタムスタイルの置き場所と読み込み
プロジェクトレベルのカスタムスタイルは、作業ディレクトリからリポジトリルートまでの間にある .claude/output-styles/ から読み込まれます。つまりリポジトリルートに置けば、クローンした全員に配布されます。
スタイルの選択結果は .claude/settings.local.json（ローカルプロジェクトレベル）に保存されます。/output-style コマンドは v2.1.269 以降、VS Code 拡張のメニューからの選択は v2.1.257 以降、同メニューからのファイル作成は v2.1.261 以降が必要です（2026-10-14 時点）。
全プロジェクト既定とプロジェクト既定の優先順位
全プロジェクト共通の既定は ~/.claude/settings.json の outputStyle で設定できます。そしてプロジェクト側の settings がこの値より優先されます。outputStyle の値は大文字小文字を区別するため、組み込み名は Proactive・Concise・Explanatory・Learning と正確に書く必要があります。
ここに運用上の落とし穴があります。メニューや /output-style が書き込むのは settings.local.json で、これは通常 Git 管理外です。チーム共通の既定を効かせたいなら、コミット対象の .claude/settings.json に手で書く必要があります。
応用: プラグインによる強制適用
プラグイン側の出力スタイルに force-for-plugin: true を設定すると、ユーザーの選択操作なしで自動適用されます。
apply this style automatically whenever the plugin is enabled
この設定はユーザーの outputStyle 設定を上書きします。複数の有効なプラグインがこのフィールドを設定している場合は、最初に読み込まれたものが使われます。インシデント対応など「一時的に全員を同じモードに固定したい」場面に向きます。
限界: サブエージェントとトークン
出力スタイルはメイン会話とフォークに適用されます。
Other subagents run their own system prompt
フォークは親の会話とシステムプロンプトを継承しますが、それ以外のサブエージェントは独自のシステムプロンプトで動くため、スタイルの影響を受けません。サブエージェントの振る舞いをスタイルで制御しようとしても効きません。
トークン面では、スタイルの指示は入力トークンを増やしますが、プロンプトキャッシュによりセッション内の最初のリクエスト以降のコストは下がります。Explanatory・Learning は出力を増やし、Concise は減らします。