Claude Codeの出力スタイルを徹底解説
出力スタイルはClaude Codeのシステムプロンプトを編集し、回答全体を変えます。5つの組み込みスタイルの違い、トランスクリプトへの影響、自作方法、v2.1.251以降の仕様を解説します。
Claude Code の出力スタイルとは
Claude Code の出力スタイルは、Claude Code がリクエストごとに Claude へ送信する内容に追加する指示のまとまりです。Claude の回答方法、つまり担う役割と出力の形式を変えます。コードベースについて Claude に教えるものではなく、何かを実行する権限を Claude に与えるものでもありません。
Claude Code には 5 つの組み込みスタイルがあります。選択内容は 1 つの設定キー outputStyle に保存されます。Claude Code v2.1.251 以降では、セッション中に切り替えたスタイルが次のメッセージから適用されます。v2.1.73 から v2.1.251 より前までは、切り替えが保存された後もセッションをクリアするまで無視されました。この事実が、現在も古いガイドに多く残る混乱の大半を説明します。
VPS では、これは単なる見た目の好みではありません。トランスクリプトは通常 tmux ウィンドウ内の SSH (secure shell) 接続を通じて読むため、Claude が説明する各行は、待つ対象であると同時に、サイズが固定されたスクロールバックバッファに入る行でもあります。
Output style 設定の場所
/config メニューの Output style でスタイルを選択します。Claude Code は、作業中のプロジェクトにある .claude/settings.local.json に選択内容を書き込みます。
プロンプトからは /output-style コマンドでも同じ操作ができます。/output-style concise を実行すると切り替わります。引数なしで /output-style を実行すると、スタイルの一覧と現在のスタイルを確認できます。同じ .claude/settings.local.json ファイルに保存され、大文字と小文字は区別されません。非対話モードでも使用できます。ここで説明するコマンドは Claude Code v2.1.269 で追加されました。以前の /output-style コマンドは v2.0.30 までに存在していましたが、v2.1.73 で非推奨となり、/config に置き換えられました。そのため、この2つのリリースの間のビルドでは、このページの説明どおりに動作しない可能性があります。このページの内容も含め、ガイドに従う前に実行中のバージョンを確認してください。このページのバージョンは 2026 年 10 月に確認しています。
claude --version設定ファイルを手動で編集してキーを設定することもできます。設定を保持できるファイルは4つあり、より狭い範囲の設定が、より広い範囲の設定より優先されます。
~/.claude/settings.jsonはユーザーファイルです。そのマシン上のすべてのプロジェクトに適用されます。.claude/settings.jsonはプロジェクトファイルです。git にコミットされるため、リポジトリを clone したすべてのユーザーに適用されます。.claude/settings.local.jsonはローカルプロジェクトファイルです。コミットされず、上記2つの設定より優先されます。/configメニューと/output-styleコマンドが書き込むのはこのファイルです。- Linux の
/etc/claude-code/などのシステムパスから IT チームが配布する管理対象設定は、他のすべての設定より優先されます。
キーの値にはスタイル名を指定します。
{
"outputStyle": "Concise"
}値は大文字と小文字を区別します。組み込みの名前は Proactive、Concise、Explanatory、Learning として記述してください。concise のようにスタイル名と完全一致しない値を指定すると、エラーは表示されず Default スタイルになります。
1回のセッションだけ変更する場合は、同じキーをコマンドラインで指定します。--settings フラグにはパスまたはインライン JSON 文字列を指定できます。その値は、その実行中だけユーザー、プロジェクト、ローカルの設定ファイルにある同じキーより優先されます。管理対象設定は引き続き優先されます。
claude --settings '{"outputStyle": "Concise"}'ドキュメントには、スタイルを選択する方法が4つ記載されていますが、最低バージョンが指定されているのは2つだけです。ターミナルの /config メニューには最低バージョンの条件がありません。現在の形式の /output-style コマンドには v2.1.269 が必要です。VS Code 拡張機能の Output styles メニューには v2.1.257 が必要です。Desktop アプリでは、設定ファイルの outputStyle フィールドを設定します。outputStyle キー自体には最低バージョンの条件がないため、この方法を使うのが確実です。ガイドのスクリーンショットと実際の表示が一致しない場合は、キーを直接設定し、設定ソースの一覧を表示する /status で反映を確認してください。
新しい出力スタイルが有効になるタイミング
Claude Code v2.1.251 以降では、コマンド、メニュー、設定ファイルのいずれかでセッション途中に切り替えたスタイルが、次のメッセージから適用されます。クリアする必要はありません。v2.1.73 以降 v2.1.251 未満では、実行中のセッションは開始時のスタイルを保持し、新しいスタイルは次の /clear または次回の起動時にのみ読み込まれました。
ターミナルでは、Claude Code は起動時にスタイルファイルを読み込みます。そのため、セッション中にカスタムスタイルファイルを作成または編集した場合は、選択する前に Claude Code を再起動してください。VS Code v2.1.261 以降では、Output styles メニューの Build a custom style ウォークスルーによってファイルが作成され、新しいスタイルがすぐに一覧へ追加されます。その旧バージョンの範囲でビルドした場合、またはターミナルでスタイルファイルを編集して再起動した場合は、次の 2 つのコマンドで状態をいったん整理し、読み込まれた内容を確認できます。
/clear
/context/context は、system prompt を含め、現在 context window を占有している内容をカテゴリ別に表示します。各スタイルで新しいセッションを開始して実行すると、system prompt の行を比較対象の入力側として使えます。カスタムスタイルが読み込まれたことを確認する最も速い方法でもあります。context window を埋める内容全体については、長時間の Claude Code セッションでコンテキストが埋まる仕組み を参照してください。
この切り替え動作の理由はキャッシュにあります。API は、各リクエストの先頭部分が一致する prompt cache から、繰り返しのリクエストを処理します。system prompt は先頭にあります。会話途中で system prompt を書き換えると、その後ろにあるすべての内容が無効になるため、次のターンで履歴全体を新しい入力として再処理する必要があります。v2.1.73 以降 v2.1.251 未満のビルドでは、セッション開始時にスタイルを固定してこのコストを避けていました。現在のビルドでは、新しいスタイルの指示を会話内のメッセージとして渡します。そのため、切り替え後のリクエストでも system prompt と以前の会話をキャッシュから読み取れます。どちらの場合も、スタイルの切り替えにかかるコストは小さいものです。
組み込みの各出力スタイルがトランスクリプトに与える変更
- Default は、ソフトウェアエンジニアリング作業向けに記述された、Claude Code の通常のシステムプロンプトです。
- Concise は結果を先に示します。前置きと作業手順の逐次説明を省き、詳細を求めるまで回答を短く保ちます。内部で行われるエンジニアリング作業は変わりません。エラーレポートやセキュリティ警告を短縮することはなく、破壊的な操作の前には完全な確認を求めます。このスタイルには Claude Code v2.1.237 以降が必要です。
- Explanatory は、タスクの手順の間に教育的な「Insights」を追加します。実装上の選択理由と、コードベースですでに使われているパターンを説明します。意図的にトランスクリプトは長くなります。
- Learning はさらに踏み込みます。Claude は Insights を共有した後、コードの小さな部分を自分で記述するよう求めます。ファイル内の各箇所には
TODO(human)コメントを付けます。 - Proactive は、確認を求める代わりに Claude を動作させます。定型的な判断では妥当な前提を置き、処理を止めません。
最後のスタイルは誤解されやすいため、注意して読んでください。Proactive はシステムプロンプトによる指針です。Claude が試みる処理を変更します。ただし、確認なしで実際に実行できる処理は permission mode が決定します。サーバーを無人で稼働させる場合に重要なのは、この設定です。詳細は auto mode と Claude Code の permission mode を参照してください。
出力スタイルとCLAUDE.md、hook、subagentの違い
これらはすべて Claude の動作を指示する仕組みに見えますが、適用される層が異なります。
- 出力スタイルは、Claude Code がすべてのリクエストとともに送信する指示の一部です。メインの会話におけるすべての応答に適用されます。
- CLAUDE.mdは、system prompt の後に user message として追加されます。プロジェクトの規約やコードベースに関する事実を記載する場所です。
--append-system-promptは、1 回の呼び出しに限って system prompt にテキストを追加します。既存の内容は削除しません。出力スタイルを一度だけ適用する仕組みに相当します。- hookは、イベントが発生したときに Claude Code 自身が実行する shell command です。harness によって強制されるため、Claude が実行を選ぶかどうかに関係なく動作します。Claude Code の hook でできることとできないことを参照してください。
- subagentは、独自の system prompt と独自の tool set で実行されます。
最初の 2 つは、短いテストで使い分けられます。プロジェクトに関する事実は、Claude が知る必要があるため CLAUDE.md に記載します。表現は、回答の読みやすさに関するものなので、出力スタイルに記載します。モデルの判断に関係なく毎回必ず実行する必要がある処理は、hook にします。各仕組みがどの層に属するかは、モデル自体ではなくモデルを実行するプログラムの特性です。そのため、スタイルは影響を与えることしかできず、hook は強制できます。
出力スタイルはメインの会話にのみ適用されます。subagent は独自の system prompt で独自の会話を開始するため、使用中のスタイルを継承しません。例外は、現在の会話の fork です。fork は親の system prompt をそのまま継承します。subagent の書き方が気に入らない場合は、使用中のスタイルではなく、その agent のファイルを編集してください。同じマシン上で 2 つ目の Claude Code session を起動した場合も同じ境界が適用されます。起動時にその session 自身の settings files を読み込むため、並行して実行中の別の session に作業を渡すと、返ってくる応答は使用中の session ではなく、その session が読み込んだスタイルになります。
独自の出力スタイルを作成する方法
カスタム出力スタイルは、frontmatter を含む markdown ファイルです。すべてのプロジェクトで使用する場合はホームディレクトリに保存し、コードと一緒に管理する場合はリポジトリ内に保存します。ユーザーディレクトリは ~/.claude/output-styles/、プロジェクトディレクトリは .claude/output-styles/ です。
mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---
Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.
Do not narrate what you are about to do. Report what you did.
When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOFセッションを開始し、/config を開きます。作成した説明とともに、スタイルが Output style リストに表示されます。表示されない場合、ファイルが読み込まれていません。パスを確認し、ファイルを保存した時点ですでにセッションを開始していた場合は Claude Code を再起動します。ファイル名だけが説明なしで表示される場合は、frontmatter の解析に失敗しています。claude --debug に解析エラーが表示されます。frontmatter で name を設定しない限り、ファイル名がスタイル名になります。そのため、このスタイルは terse-ops ではなく Terse ops という名前になります。
これを選択するか、同じ大文字・小文字を使って、キーにその名前を正確に設定します。
{
"outputStyle": "Terse ops"
}ファイルが調整用か置換用かは、1 つのフィールドで決まります。keep-coding-instructions のデフォルト値は false です。これは、カスタムスタイルが Claude Code 組み込みのソフトウェアエンジニアリング指示を 破棄 し、ユーザーが記述した内容だけで動作することを意味します。組み込みの指示は、変更範囲の決定方法と作業結果の検証方法を Claude に指示します。文章作成アシスタントやデータアナリストでは、通常これらは必要ないため、フィールドを省略します。コードを扱う用途では true に設定してください。設定しないと、慎重に作業していたエンジニアが突然、自分の作業を確認しなくなった理由が分からなくなります。このセクションを含むのは Claude Code の完全な system prompt だけです。そのため、短い system prompt ではこのフィールドに効果がありません。CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT 環境変数を 0 に設定すると、どのモデルでも完全な prompt が選択されます。求めているものが異なる文体ではなく、タスクにかける作業量のより厳密な定義である場合は、スタイルファイルではなくエンジニアリング指示に記述します。Ponytail スキルはその実例です。これは、動作する最小限の変更をエージェントに促す単一のルールです。
description は、/config の選択画面で名前の横に表示される行です。6 か月後に自分で作成した 2 つのスタイルから選ぶ場面を想定して記述します。
SSH では簡潔な文体が異なる理由
VPS では、ローカル端末にはない複数の層を通してトランスクリプトを読みます。各層では、冗長な出力がコストになります。
最初はスクロールバックです。tmux では、各ペインが固定行数を保持します。この行数は history-limit で設定し、デフォルトは 2000 です。説明的なトランスクリプトはこのバッファーを早く埋めるため、セッションの前半が早く削除され、後で確認したかった出力が失われます。余裕が必要なら、値を増やします。
echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.conf以後に作成するペインは、それぞれ 20000 行を保持します。ただし、ペインごとに必要なメモリは増えます。tmux 3.7 以降では、history-limit を変更すると既に開いているペインにも反映されます。旧バージョンでは、新しいペインにだけ適用されます。セッションのレイアウトをまだ構築中であれば、VPS 上の tmux 内で Claude Code を実行する方法で説明しています。
2 つ目は遅延です。応答は生成されると同時に端末へストリーミングされます。往復遅延が大きい接続では、長い前置きを読みながら、回答が表示されるまで待つことになります。
3 つ目は出力トークンです。説明的な各行が出力として課金されます。Explanatory と Learning は、意図的に長く設定されています。Concise は、デフォルトで応答を短くするよう Claude に指示するため、意図的に短く設定されています。
このページを含め、誰が示したパーセンテージもそのまま信用しないでください。差の大きさは、プロンプト、モデル、依頼する作業によって変わります。そのため、変更前と変更後を自分で測定してください。同じ実際のタスクを、新しいセッション 2 つで実行します。一方は Default、もう一方は Concise にして比較します。最も簡単な測定手段は statusline です。Claude Code は、スタイル名、直近の応答の出力トークン数、セッションの累積コスト見積もりを含む JSON オブジェクトを stdin でスクリプトに渡します。
cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.shstatusLine 設定でそのスクリプトを指定します。
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}これでセッション下部のバーに、アクティブなスタイル、直近の応答サイズ、現在までのセッションの推定コストが表示されます。out は最新の応答だけを対象とするため、各回答の長さが分かります。cost は累積値なので、各実行の終了時に表示される値を変更前と変更後で比較できます。/clear が新しいセッションを開始するとコストは $0 にリセットされるため、クリアする前に値を確認してください。また、この値は請求額ではなく見積もりとして扱ってください。スクリプトにはコマンドライン JSON パーサーである jq が必要です。先に sudo apt install -y jq でインストールしてください。バーが空のままの場合は、スクリプトを手動で実行し、JSON をパイプで渡してください。statusline が非ゼロで終了すると、何も表示も報告もしないためです。Claude Code のカスタム statuslineでは、このオブジェクトに含まれる残りのフィールドを説明しています。セッションではなく課金について確認する場合は、Claude Code のトークンが実際に使われる先とClaude Code の利用額を追跡するツールを参照してください。
実際に読み込まれている出力スタイルを確認する方法
推測せず、次の確認を行ってください。
/statusは、このセッションで有効な設定の読み込み元を一覧表示します。組織の managed settings が適用されているかどうかも確認できます。/contextは、context window の内訳で、読み込まれた system prompt をカテゴリとして表示します。claude doctorは、セッションを開始せずに shell から実行すると、インストールと設定の診断結果を表示し、無効な設定ファイルを報告します。
スタイルが適用されない原因は、ほぼ次の 2 つです。1 つ目はタイミングです。v2.1.73 以降 v2.1.251 未満のビルドでは、セッション途中の切り替えは /clear まで反映されません。ターミナルでは、セッション途中に作成または編集したスタイルファイルも、再起動まで反映されません。2 つ目は優先順位です。.claude/settings.local.json は .claude/settings.json を上書きし、どちらも ~/.claude/settings.json を上書きします。/config の picker と /output-style コマンドはローカルファイルに書き込むため、チームが .claude/settings.json にコミットしたスタイルは、誰かが一度でもいずれかを使ったマシン上で、気付かないうちに上書きされます。/status では読み込まれたファイルは分かりますが、どのファイルの設定が適用されたかは分かりません。一覧に表示された各ファイルを開き、outputStyle を探してください。
JSON の構文エラーでも同じ症状になりますが、対処方法は異なります。claude doctor は解析できなかったファイル名を表示します。より複雑な原因を調べる前に実行する価値があります。explanatory のように、大文字・小文字が異なる値は有効な JSON ですが、Default スタイルになります。大文字・小文字も確認してください。
FAQ
/output-style コマンドが動作しなくなったのはなぜですか?
現在のビルドでは、動作しなくなっていません。/output-style はスタイルを一覧表示し、/output-style concise はスタイルを切り替えます。このコマンドには履歴上の空白期間があります。v2.1.73 で /config に置き換える形で非推奨になり、v2.1.269 で現在の /output-style [name] 形式が追加されました。そのため、この 2 つのバージョンの間のビルドでは、ここで説明するようには動作しない場合があります。claude --version を実行して、使用中のバージョンを確認してください。どのビルドでも、Output style の /config からスタイルを選択できます。または、設定ファイルで outputStyle キーを設定できます。ドキュメントにはこのキーの最低バージョンが記載されていないため、設定ファイルへ直接設定する方法を自分のメモに残しておく価値があります。
出力スタイルを変更したのに何も起きません。なぜですか?
まずバージョンを確認してください。Claude Code v2.1.251 以降では、セッション途中で切り替えたスタイルが次のメッセージから適用されます。v2.1.73 以降 v2.1.251 未満では、変更は保存されますが、/clear または新しいセッションの開始後にのみ適用されました。ターミナルでは、セッション中に作成または編集したカスタムスタイルファイルを反映するために再起動が必要です。Claude Code は起動時にスタイルファイルを読み込むためです。それでも適用されない場合は、大文字・小文字を含め、値がスタイル名と完全に一致しているか確認してください。次に /status を実行して、読み込まれた設定ファイルを確認します。.claude/settings.local.json は .claude/settings.json を上書きし、どちらも ~/.claude/settings.json を上書きします。
Concise 出力スタイルで費用は安くなりますか?
デフォルトで応答を短くするよう Claude に指示するため、出力トークン数は想定どおり減る方向になります。削減量はプロンプトとモデルによって異なるため、公表されている割合は他の環境で測定された値として扱ってください。自分の環境で測定するには、各スタイルで新しいセッションを開始して /context を実行し、入力側を確認します。その後、各スタイルで同じタスクを実行し、出力トークン数と推定コストを比較してください。Concise はエラーレポートやセキュリティ警告を短縮しないため、特に読む必要がある部分は完全な形で残ります。
出力スタイルによって subagent の文章も変わりますか?
いいえ。出力スタイルはメインの会話にのみ適用されます。subagent は独自の system prompt と tool set で、独自の会話を開始するためです。例外は現在の会話の fork です。fork は親の system prompt をそのまま引き継ぎます。subagent の応答方法を変更するには、その agent 専用のファイルを編集してください。
出力スタイルによって、Claude が確認なしでコマンドを実行できるようになりますか?
いいえ。出力スタイルは system prompt 内のテキストであり、Claude が実行しようとする内容に影響を与えるだけです。Proactive スタイルは、定型的な判断で停止せず、前提を置いて行動するよう Claude に促しますが、それでもコマンドを承認することはできません。確認なしで実行される内容は permission mode で決まります。サーバー上でセッションを実行したままにする前に確認すべき設定は、これです。