Output Styles（アウトプットスタイル）とは？Claude Codeの読み方・設定・カスタマイズ方法を徹底解説

Output Stylesとは

Output Styles（アウトプットスタイル）とは、Claude Codeの応答の書き方・話し方・行動方針を、用途に合わせて切り替えるための設定機能です。エージェントモード（標準のコーディング支援）、説明モード（学習向け）、教育モード（手順を細かく示す）など複数のスタイルが用意されており、Markdownファイルを書くだけで独自スタイルも追加できます。

イメージとしては「同じClaudeに、別の上着を着替えてもらう」ようなものです。中身（モデル）は同じClaude Sonnet 4.6やOpus 4.6でも、Output Stylesを切り替えると応答のトーンや踏み込み度合いが変わります。実務では、新人向けに細かく説明させたいとき、シニア向けに簡潔に答えてほしいとき、コードレビュー専用にしたいときなど、シーンごとに使い分けます。重要なのは、モデル自体を変えずに振る舞いだけ変えられる点です。

Output Stylesの読み方

アウトプットスタイル

アウトプット・スタイル（中黒区切り表記）

アウトプットスタイルズ（複数形どおりの読み）

Output Stylesの仕組み

Output StylesはClaude Codeが内部で持つシステムプロンプトの一部を、選択中のスタイル定義で差し替えることで動作します。設定ファイル~/.claude/settings.jsonまたは.claude/settings.jsonのoutputStyleキーで現在のスタイルが指定され、/output-styleスラッシュコマンドで切り替えできます。

動作の流れ

スタイル選択から応答までの流れ

①ユーザーが
/output-style 実行

→

②settings.json更新

→

③次回プロンプト時
system promptを差し替え

→

④応答スタイル変化

ここが重要なポイントです。Output Stylesはモデル自体を変えるのではなく、システムプロンプトを置き換えることで応答を変えます。そのため、トークン消費は通常のシステムプロンプトと同程度に収まり、性能や料金にほぼ影響しません。

組み込みのOutput Style一覧

スタイル名	用途	特徴
default	通常のコーディング支援	バランス型、簡潔＋必要な説明
Explanatory	学習・理解促進	理由・背景まで詳細に解説
Learning	教育・トレーニング	ステップごとに教育的に進行

Output Stylesの使い方・実例

最も基本的な操作は、Claude Codeの中で/output-styleスラッシュコマンドを実行することです。一覧から選択するUIが出るので、矢印キーで選んでEnterするだけで即座に切り替わります。

スラッシュコマンドで切り替える

# Claude Code内で実行
/output-style

# 一覧から選んで決定
# > default
#   Explanatory
#   Learning

settings.jsonで固定する

プロジェクトごとにスタイルを固定したい場合は、リポジトリ直下の.claude/settings.jsonに書きます。

{
  "outputStyle": "Explanatory"
}

カスタムスタイルを作る

独自のスタイルは、Markdownファイルを~/.claude/output-styles/または.claude/output-styles/に置くだけで追加できます。フロントマター（YAML）でメタ情報を、本文でシステムプロンプトを書きます。

---
name: code-review
description: コードレビュー専用スタイル
---

あなたは経験豊富なシニアエンジニアです。
ユーザーから提示されたコードに対して、以下の観点でレビューを行ってください。

- 可読性
- 保守性
- セキュリティ上の懸念
- パフォーマンス上の懸念

簡潔に箇条書きで指摘し、修正案も提示してください。

このファイルを保存すれば、/output-style code-reviewとして一覧に出てきて切り替えられます。実務では、レビュー用・ドキュメント執筆用・テスト生成用など、用途別にいくつか作っておくと作業効率が上がります。

Output Stylesのメリット・デメリット

メリット

同一モデルで異なる振る舞い — モデルを切り替えずにトーン・粒度を変えられる。
チームで共有可能 — リポジトリにスタイルファイルを含めれば、新人もシニアも同じ品質基準を共有できる。
カスタマイズが容易 — Markdownを書くだけで作れる。プログラミング不要。
切り替えが即時 — モデルロード不要なので、瞬時にスタイル変更が反映される。

デメリット

命令の競合 — 既存のCLAUDE.mdやSkillと指示が衝突するとエージェントが混乱しやすい。
過剰なカスタムは管理コスト増 — チーム内でスタイルが乱立すると、どれを使えばよいか不明になる。
モデルの限界は超えられない — Output Stylesはあくまで指示。モデル自体の性能を上げるわけではない。

Output Stylesと類似機能の違い

Output Stylesは「CLAUDE.md」や「Skill」「System Prompt」と混同されやすい機能です。違いを表で整理します。

機能	スコープ	主な用途
Output Styles	セッション全体の応答スタイル	トーン・粒度・役割の切り替え
CLAUDE.md	プロジェクト固有の知識	コードベースの構造・規約
Skill	特定タスク専用	PDF/PPT作成等の手順実行
System Prompt（API）	モデル呼び出しのbase	アプリ単位の人格定義

実務では、CLAUDE.mdに「このプロジェクトの構造」を、Output Stylesに「今は学習モードにしたい」を書くと役割がきれいに分かれます。注意してください、両方に同じ指示を書くと優先度の混乱が起きます。

よくある誤解

誤解1: Output Stylesでモデルを切り替えられる

誤りです。Output Stylesはあくまで応答スタイルの切り替えであり、Sonnet/Opus/Haikuなどのモデル選択とは独立した概念です。モデル選択は別の設定（modelキーや/modelコマンド）で行います。

誤解2: スタイルファイルにツール定義を書ける

誤りです。Output Stylesはシステムプロンプトのみを定義します。新しいツールやMCPサーバーを追加したい場合は、別途MCP設定やSkillを使ってください。

誤解3: スタイルを切り替えると会話履歴が消える

消えません。Output Stylesの切り替えは現在のセッションを保ったまま行えます。ただし、新しいスタイルは次のメッセージから適用されるため、過去の応答スタイルは変わらないので注意してください。

実務での活用シーン

シーン1: 教育用途と即戦力用途の切り替え

新人エンジニアにはLearningスタイルで「なぜこのコードか」を解説してもらい、シニアにはdefaultで簡潔に答えてもらう、といった使い分けができます。チームの教育コストを下げる効果が大きいです。

シーン2: ドキュメント執筆モード

独自スタイル「doc-writer」を作り、「常に絵文字なしで、です・ます調、Markdown見出し付き」と指示しておけば、ドキュメント執筆のたびに細かく指示し直す必要がなくなります。

シーン3: コードレビュー専用

「指摘は箇条書き、修正案は別ブロック、感想ではなく事実」と決めたcode-reviewスタイルを用意しておけば、レビュー結果が安定します。実務では、PRレビューの前後でスタイルを切り替える運用が増えています。

よくある質問（FAQ）

Q1. Output Stylesはどこで切り替えますか？

Claude Code内で/output-styleを実行するか、settings.jsonのoutputStyleキーで指定します。プロジェクト設定が優先されるため、リポジトリごとに既定スタイルを変えられます。

Q2. カスタムスタイルファイルの拡張子は？

Markdown（.md）です。先頭にYAMLフロントマターでnameとdescriptionを書き、本文にシステムプロンプトを書きます。

Q3. 一度に複数のOutput Stylesを併用できますか？

できません。アクティブなスタイルは常に1つです。複数の役割を持たせたい場合は、1つのスタイル内で条件分岐するように記述してください。

Q4. CLAUDE.mdとどちらが優先ですか？

両方とも有効ですが、Output Stylesは振る舞いに、CLAUDE.mdはプロジェクト知識に責任が分かれています。重複した指示は避けるのが鉄則です。

Q5. APIから使えますか？

Output StylesはClaude Code固有の機能です。Claude API（旧Anthropic API）でアプリを作る場合は、自分でシステムプロンプトを管理してください。

Output Stylesを設計するときのコツ

独自Output Stylesを作るときには、いくつかのコツがあります。第一に、短く具体的にすること。スタイルファイルが長文化すると、本来モデルが持っている知識を上書きしすぎてしまい、応答が硬直化します。実務では「目的・対象・トーン・避けたい表現」の4点を1〜2ページで書くのが目安です。

第二に、CLAUDE.mdとの責任分担を意識すること。CLAUDE.mdには「このプロジェクトのコード規約」「ディレクトリ構成」のような不変の知識を、Output Stylesには「今、どのトーンでしゃべってほしいか」という可変の指示を書き分けると、衝突が起きにくくなります。注意してください、両方に同じことを書くと、モデルが優先順位に迷います。

第三に、運用しているうちに使われなくなったスタイルは削除すること。スタイルは増えるほどメンバーが「どれを選べばいいか」で悩むようになり、結局default以外を使わなくなる現象が起きます。実務では四半期ごとにスタイル棚卸しをするのがおすすめです。

Output Stylesと組み合わせると便利な機能

Output Styles単体でも便利ですが、Claude Codeの他機能と組み合わせるとさらに効果が大きくなります。例えば、Slash Commandと併用すれば、特定のコマンドを叩いた瞬間に専用スタイルへ切り替えてから処理を行う、といった半自動化が可能です。

Hooksと組み合わせる方法も実務的です。「特定のディレクトリに入ったときだけdoc-writerに自動切替」のような挙動を作れば、ドキュメント執筆の準備が整った状態で作業を始められます。重要なのは、Output Stylesは振る舞い、Hooksは反応、CLAUDE.mdは知識、Skillは手順という責任分担を保つ点です。これが守られていれば、設定が複雑化してもメンテナンス性が落ちにくいです。