出力スタイル
ソフトウェアエンジニアリング以外の用途に合わせて Claude Code を適応させる
出力スタイルは 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"
}
出力スタイルはシステムプロンプトの一部であり、Claude Code はセッション開始時に 1 回読み込みます。変更は /clear または新しいセッション後に有効になります。出力スタイルの変更がキャッシュに与える影響については、Claude Code がプロンプトキャッシングを使用する方法 を参照してください。
カスタム出力スタイルを作成する
カスタム出力スタイルは Markdown ファイルです。メタデータ用の frontmatter、その後にシステムプロンプトに追加する指示が続きます。
Markdown ファイルを作成する
3 つのレベルのいずれかに保存します。ファイル名がスタイル名になります。frontmatter で name を設定しない限り。
- ユーザー:
~/.claude/output-styles - プロジェクト:
.claude/output-styles - 管理ポリシー: 管理設定ディレクトリ 内の
.claude/output-styles
プロジェクト出力スタイルは、作業ディレクトリとリポジトリルートの間のすべての .claude/output-styles/ から読み込まれます。{/* min-version: 2.1.178 */}v2.1.178 以降、これらのネストされたディレクトリの複数が同じ名前のスタイルを定義する場合、Claude Code は作業ディレクトリに最も近いものを使用します。
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.
スタイルに切り替える
/config を実行し、Output style でスタイルを選択します。/clear の後、または次のセッションを開始したときに有効になります。
プラグイン は output-styles/ ディレクトリで出力スタイルを配布することもできます。
Frontmatter
出力スタイルファイルは、これらの frontmatter フィールドをサポートしています。
| Frontmatter | 目的 | デフォルト |
|---|---|---|
name |
出力スタイルの名前（ファイル名でない場合） | ファイル名から継承 |
description |
/config ピッカーに表示される出力スタイルの説明 |
なし |
keep-coding-instructions |
Claude Code の組み込みソフトウェアエンジニアリング指示を保持する | false |
force-for-plugin |
プラグイン出力スタイルのみ: プラグインが有効になるたびに、ユーザーが選択する必要なく、このスタイルを自動的に適用します。ユーザーの outputStyle 設定をオーバーライドします。複数の有効なプラグインがこれを設定する場合、Claude Code は最初に読み込まれたものを使用します。 |
false |
出力スタイルの仕組み
出力スタイルは Claude Code のシステムプロンプトを直接変更します。
- すべての出力スタイルは、システムプロンプトの最後に独自のカスタム指示が追加されます。
- すべての出力スタイルは、会話中に出力スタイルの指示に従うよう Claude に思い出させるリマインダーをトリガーします。
- カスタム出力スタイルは、
keep-coding-instructionsがtrueに設定されていない限り、スコープ変更の方法、コメントの書き方、作業の検証方法など、Claude Code の組み込みソフトウェアエンジニアリング指示を除外します。
トークン使用量はスタイルによって異なります。システムプロンプトに指示を追加するとインプットトークンが増加しますが、プロンプトキャッシングはセッション内の最初のリクエスト後にこのコストを削減します。組み込みの Explanatory および Learning スタイルは、設計上 Default よりも長い応答を生成するため、アウトプットトークンが増加します。カスタムスタイルの場合、アウトプットトークン使用量は、指示が Claude に生成させるものに依存します。
関連機能との比較
Claude Code の動作をカスタマイズするいくつかの機能があります。出力スタイルはシステムプロンプトを直接変更し、すべての応答に適用されます。その他は、デフォルトシステムプロンプトを変更せずに指示を追加するか、特定のタスクにスコープします。
| 機能 | 仕組み | 使用する場合 |
|---|---|---|
| 出力スタイル | システムプロンプトを変更する | 毎回異なるロール、トーン、またはデフォルト応答形式が必要な場合 |
| CLAUDE.md | システムプロンプトの後にユーザーメッセージを追加する | Claude がプロジェクト規約とコードベースコンテキストを常に知っている必要がある場合 |
--append-system-prompt |
何も削除せずにシステムプロンプトに追加する | 単一の呼び出しのための 1 回限りの追加が必要な場合 |
| エージェント | 独自のシステムプロンプト、モデル、ツールを持つサブエージェントを実行する | フォーカスされたタスク用に個別にスコープされたヘルパーが必要な場合 |
| スキル | 呼び出されたときまたは関連する場合にタスク固有の指示を読み込む | 再利用可能なワークフローがある場合 |