メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

出力スタイルは Claude がどのように応答するかを変更し、Claude が何を知っているかは変更しません。システムプロンプトを変更してロール、トーン、出力形式を設定します。毎回同じ声や形式で再度プロンプトを入力し続ける場合、または Claude がソフトウェアエンジニア以外として機能することを望む場合に使用します。 カスタム出力スタイルはシステムプロンプトに指示を追加し、Claude Code の組み込みソフトウェアエンジニアリング指示を保持するかどうかを選択できます。Claude がコミュニケーション方法を変更しているがまだコーディングしている場合(常に図で答えるなど)は保持します。Claude がソフトウェアエンジニアリングをまったく行っていない場合(執筆アシスタントやデータアナリストなど)は除外します。 プロジェクト、規約、またはコードベースに関する指示については、代わりに CLAUDE.md を使用してください。

組み込み出力スタイル

Claude Code の Default 出力スタイルは既存のシステムプロンプトであり、ソフトウェアエンジニアリングタスクを効率的に完了するのに役立つように設計されています。 3 つの追加の組み込み出力スタイルがあります。
  • Proactive: Claude は即座に実行し、日常的な決定で一時停止する代わりに合理的な仮定を立て、計画よりもアクションを優先します。これは オートモード と同じガイダンスを適用しますが、パーミッションモードは変更しないため、ツールが実行される前にパーミッションプロンプトが表示されます。
  • Explanatory: ソフトウェアエンジニアリングタスクの完了を支援しながら、教育的な「Insights」を提供します。実装の選択肢とコードベースのパターンを理解するのに役立ちます。
  • Learning: 協調的な学習型モードです。Claude はコーディング中に「Insights」を共有するだけでなく、小さな戦略的なコードの一部を自分で実装するよう求めます。Claude Code はコード内に TODO(human) マーカーを追加して、実装するべき箇所を示します。

出力スタイルを変更する

/config を実行し、Output style を選択してメニューからスタイルを選択します。選択内容は ローカルプロジェクトレベル.claude/settings.local.json に保存されます。 メニューなしでスタイルを設定するには、設定ファイルの outputStyle フィールドを直接編集します。
{
  "outputStyle": "Explanatory"
}
出力スタイルはセッション開始時にシステムプロンプトで設定されるため、変更は新しいセッションを開始した次回に有効になります。これにより、会話全体を通じてシステムプロンプトが安定し、プロンプトキャッシングがレイテンシとコストを削減できます。

カスタム出力スタイルを作成する

カスタム出力スタイルは Markdown ファイルです。メタデータ用の frontmatter、その後にシステムプロンプトに追加する指示が続きます。
1

Markdown ファイルを作成する

3 つのレベルのいずれかに保存します。ファイル名がスタイル名になります。frontmatter で name を設定しない限り。
  • ユーザー: ~/.claude/output-styles
  • プロジェクト: .claude/output-styles
  • 管理ポリシー: 管理設定ディレクトリ 内の .claude/output-styles
2

Frontmatter と指示を追加する

Claude Code のソフトウェアエンジニアリング指示を保持するかどうかを決定します。Claude がコミュニケーション方法を変更しているがまだ同じ方法でコーディングしたい場合は keep-coding-instructions: true を設定します。Claude がソフトウェアエンジニアリングを行わない場合は除外します。この例は Claude のコーディング動作を保持しながら、すべての説明を図で始めます。
---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.
3

スタイルに切り替える

/config を実行し、Output style でスタイルを選択します。次のセッションを開始したときに有効になります。
プラグインoutput-styles/ ディレクトリで出力スタイルを配布することもできます。

Frontmatter

出力スタイルファイルは、これらの frontmatter フィールドをサポートしています。
Frontmatter目的デフォルト
name出力スタイルの名前(ファイル名でない場合)ファイル名から継承
description/config ピッカーに表示される出力スタイルの説明なし
keep-coding-instructionsClaude Code の組み込みソフトウェアエンジニアリング指示を保持するfalse
force-for-pluginプラグイン出力スタイルのみ: プラグインが有効になるたびに、ユーザーが選択する必要なく、このスタイルを自動的に適用します。ユーザーの outputStyle 設定をオーバーライドします。複数の有効なプラグインがこれを設定する場合、Claude Code は最初に読み込まれたものを使用します。false

出力スタイルの仕組み

出力スタイルは Claude Code のシステムプロンプトを直接変更します。
  • すべての出力スタイルは、システムプロンプトの最後に独自のカスタム指示が追加されます。
  • すべての出力スタイルは、会話中に出力スタイルの指示に従うよう Claude に思い出させるリマインダーをトリガーします。
  • カスタム出力スタイルは、keep-coding-instructionstrue に設定されていない限り、スコープ変更の方法、コメントの書き方、作業の検証方法など、Claude Code の組み込みソフトウェアエンジニアリング指示を除外します。
トークン使用量はスタイルによって異なります。システムプロンプトに指示を追加するとインプットトークンが増加しますが、プロンプトキャッシングはセッション内の最初のリクエスト後にこのコストを削減します。組み込みの Explanatory および Learning スタイルは、設計上 Default よりも長い応答を生成するため、アウトプットトークンが増加します。カスタムスタイルの場合、アウトプットトークン使用量は、指示が Claude に生成させるものに依存します。

関連機能との比較

Claude Code の動作をカスタマイズするいくつかの機能があります。出力スタイルはシステムプロンプトを直接変更し、すべての応答に適用されます。その他は、デフォルトシステムプロンプトを変更せずに指示を追加するか、特定のタスクにスコープします。
機能仕組み使用する場合
出力スタイルシステムプロンプトを変更する毎回異なるロール、トーン、またはデフォルト応答形式が必要な場合
CLAUDE.mdシステムプロンプトの後にユーザーメッセージを追加するClaude がプロジェクト規約とコードベースコンテキストを常に知っている必要がある場合
--append-system-prompt何も削除せずにシステムプロンプトに追加する単一の呼び出しのための 1 回限りの追加が必要な場合
エージェント独自のシステムプロンプト、モデル、ツールを持つサブエージェントを実行するフォーカスされたタスク用に個別にスコープされたヘルパーが必要な場合
スキル呼び出されたときまたは関連する場合にタスク固有の指示を読み込む再利用可能なワークフローがある場合

関連リソース

  • 設定: outputStyle フィールドが存在する場所と設定の優先順位の仕組み
  • パーミッションモード: Proactive スタイルはパーミッションモードを変更せずにオートモードをミラーリングします
  • プラグイン: スキル、フック、エージェントと一緒に出力スタイルをパッケージ化して配布します
  • 設定をデバッグする: 出力スタイルが有効にならない理由を診断します