Claude Code 出力スタイルガイド：5 つの組み込みとカスタムスタイル（図解）
モデルは賢くなったのに回答が読みにくくなったら、モデルを変えずにスタイルを変えましょう。このウォークスルーは 5 つの組み込み出力スタイル、~/.claude/output-styles フォルダ、keep-coding-instructions、ロール別チームスタイルを、1 枚ずつのスクリーンショットで解説します。
TL;DR —— 出力スタイル早わかり
- 出力スタイルはセッションのすべての応答における Claude Code の伝え方 —— ロール、トーン、形式 —— を作り変えます。変わるのはシステムプロンプトであって、モデルではありません。
- 組み込みは 5 つ：Default、Proactive、Concise、Explanatory、Learning。/output-style または /config → Output style で切り替えます。
- カスタムスタイルは markdown ファイルで、~/.claude/output-styles（ユーザー）または .claude/output-styles（プロジェクト）に置きます。デフォルトでは組み込みのコーディング指示を置き換えるので、残したいなら keep-coding-instructions: true を。
- 動画からの上級テク：ASD-STE100 ルール —— 1 語 1 意味、短い文 —— でオーディエンス別にスタイルを設計すれば、PM、翻訳者、エンジニアがそれぞれ読める回答を得られます。
Claude Code Output Styles Made Opus 5 Readable Again
チャンネル:Eric Tech15:40
Opus 5 Is Exhausting. Anthropic Reveals The Fix.
チャンネル:Ray Amjad5:56
You Think Claude Got Dumber? You Are Actually Just Missing This Setting
チャンネル:Gary Chen11:41
Output styles — Claude Code documentation
ドキュメント:code.claude.com
フレームは Eric Tech の出力スタイル徹底解説から。ウォークスルーの文章は独立して執筆され、公式出力スタイルドキュメント（組み込みスタイル一覧と keep-coding-instructions の挙動を含む）と照合して検証しています。
スクリーンショットの著作権は作成者に帰属し、視覚的ドキュメントとしてクレジット付きで使用しています。各ステップから元動画の該当瞬間へ深リンクできます。
Claude の語り方を段階的に変える
1 · 問題と解決策
- 1
問題を認識する：賢いのに読めない
動画はコミュニティの不満を 1 枚のスケッチで切り出します：モデルは機能する —— タスクは完了する —— けれど回答はジャーゴンの壁になった。Matt Pocock も Opus 5 を試して何を言っているのか分からなかったと公言しています。あなたの今週も同じなら、解決策は別のモデルではありません。
「動く。でも読めない。」—— 出力スタイルが存在する理由。0:20 に視聴 - 2
解決策は Anthropic のエンジニアから
Lydia Hallie の投稿は仕組みのすべてを 2 行で示します：スタイル指示を ~/.claude/output-styles に置き、/config を実行してスタイルを選ぶ。彼女は仕事後の閲覧用のお気に入り —— 「5 歳児に説明するつもりで」スタイル —— も共有しており、次のステップで全文読みます。
元投稿：指示は ~/.claude/output-styles へ、そして /config → Output style。2:00 に視聴 - 3
本物のスタイルファイルを端から端まで読む
スタイルファイルは markdown です：name、description、keep-coding-instructions: true を含む frontmatter —— このフラグで置き換えではなくコーディング指示の保持になる —— に続き、素朴な指示が並びます。これは疲れ果てた読者との契約です：小さい言葉、短い文、決断が必要なら選択肢は最大 2 つ、パスとコマンドは正確に、「残りの脳細胞は他に使えないので」。
ELI5 スタイル：frontmatter と、疲れていても実行できるルール。2:20 に視聴
2 · 組み込みと最初のカスタムスタイル
- 4
5 つの組み込みスタイルを知る
/config → Output style を開くと、Claude Code が同梱するスタイルと各契約を一覧します：Default は簡潔な応答で効率的にタスク完了。Proactive は即実行、中断を最小化。Concise は結果を先に簡潔に応答。Explanatory は実装の選択とコードベースのパターンを解説。Learning は一時停止して、手を動かす練習として小さなコード断片をあなたに書かせます。
preferred-output-style メニュー —— 各組み込みに 1 行説明付き。5:20 に視聴 - 5
Claude に手伝わせてカスタムスタイルを起草する
ゼロから書く必要はありません。動画のワークフロー：出力に不満があれば、同じ答えの 3〜4 パターンのバリエーションを Claude に生成させ、一番読みやすいものを選び、その勝者を再利用可能な出力スタイルとしてマシンに保存させます。
レシピ：出力 → 3〜4 バリエーション → 最良のものをスタイルとして保存。4:20 に視聴 - 6
カスタムスタイルがどこにあるか見る
実例をどうぞ：「Map First」—— すべての説明をアーキテクチャ図で始めるスタイル。ファイルはプロジェクトの .claude/output-styles フォルダにあり、~/.claude/output-styles にシンボリックリンクされて全プロジェクトで使えます —— リポジトリ経由でチームとスタイルを共有する美しいパターンです。
Map First：プロジェクトフォルダが正、ユーザーディレクトリにシンボリックリンク。5:00 に視聴 - 7
選択し、定着させる
/config で「output」と絞り込めば Output style 設定が目の前に —— Map First に切り替わっています。一度設定すれば再起動後も生き続けます：新しいセッションは最初からそのスタイルで話します。/output-style <名前> でその場で切り替えたり、settings に「outputStyle」フィールドを書いてプロジェクト横断のデフォルトにもできます。
Output style: Map First —— 一度設定すれば、その後の全セッションで有効。5:48 に視聴
3 · プロのようにスタイルを設計する
- 8
スタイルとスキルの違いを知る
Matt Pocock の /wait-what スキルは、エージェントに直前のメッセージを平易な英語で繰り返させるもの —— 呼び出したときに、オンデマンドで動きます。出力スタイルは逆の契約です：すべての応答の最初のトークンから有効で、頼まれなくてもトーンと形式を形作ります。スキルは必要に応じて拾う道具、スタイルは話し続ける声です。
/wait-what —— スキルは呼ばれたら動く、スタイルは常時オン。6:09 に視聴 - 9
1980 年代の航空標準をスタイルに盗む
動画で一番良いスタイル執筆の助言は ASD-STE100、Simplified Technical English から来ています —— 航空機の整備士が整備手順を絶対に誤読しないように書かれた言語です。そのルール：1 語にはちょうど 1 つの意味しかない、同義語は使わない（「開始」の承認語を 1 つ決めたら貫く）、指示文は 20 語未満、1 文 1 動作。良い出力スタイルが必要とする契約そのものです。
STE100：1 語 1 意味、同義語なし、指示文は 20 語以内。6:20 に視聴 - 10
ロール別にスタイルを展開する
作者のチームはペルソナごとにスタイルを用意していて、メニューにそのまま現れます：API・フロントエンド・バックエンド・データベースは分かるがコードは書かない技術プロジェクトマネージャー向け TPM —— 前提を明示し、意思決定は推奨付きのトレードオフとして提示。ゼロ技術の読者向け Technical Translator —— 毎回 1 つの日常的なアナロジー、危険操作はチェックポイント越し。余計な説明を削りたいエンジニア向け SDE。
メニューが育つ：TPM、Technical Translator、SDE —— ロールごとに 1 つの声。6:00 に視聴 - 11
モードを切り替えるようにスタイルを切り替える
Output style: TPM —— /config で選択され、次の hello から有効です。動画によれば見返りはこう：スタイルを仕事に合わせる（コードベース学習中は Explanatory、夜間実行は Proactive、結果だけ欲しいときは Concise）と、チーム全員が読める回答が得られる —— しかも多くの場合 token は少なく済みます。スタイルが無駄話を禁じているからです。
Output style: TPM —— コードを書かない仲間に専用の声を。11:04 に視聴
5 つの組み込みスタイル、正確に
公式ドキュメントによれば、Claude Code には 5 つのスタイルが同梱されます —— Default と 4 つの追加です：
- 1Default —— スタイル指示を追加しません。Claude は標準のソフトウェアエンジニアリング システムプロンプトを使います。効率的なタスク完了、簡潔な応答。
- 2Proactive —— すぐに仕事を始め、ルーチンの決断について質問する代わりに妥当な仮定を置きます。破壊的または本番に影響する操作の前には引き続き確認します。
- 3Concise —— 応答は結果から始め、前置き・ナレーション・おさらいを省きます。Claude Code v2.1.237 以降が必要。
- 4Explanatory —— 作業中に設計選択を説明する短い Insight ブロックを挿入します（チャットに残るだけで、あなたのファイルには書き込みません）。
- 5Learning —— 同じ Insight ブロックに加え、TODO(human) コメントでマークされた小さなコード断片をあなたに残して完了を待ちます。
いつでも切り替えられます：/output-style <名前>（引数なしで一覧）、/config → Output style、VS Code の / メニュー、または settings に "outputStyle" フィールドを書いて恒久化。ドキュメントの注意が 1 点：サブエージェントは各自のシステムプロンプトで動くため、スタイルが形作るのはメインの会話であって、サブエージェントの出力ではありません。