出力スタイル

ソフトウェアエンジニアリング以外の用途に合わせて Claude Code を適応させる

出力スタイルは Claude がどのように応答するかを変更し、Claude が何を知っているかは変更しません。システムプロンプトを変更してロール、トーン、出力形式を設定しながら、スクリプトの実行、ファイルの読み書き、TODO の追跡などのコア機能を保持します。毎回同じ声や形式で再度プロンプトを入力し続ける場合、または Claude がソフトウェアエンジニア以外として機能することを望む場合に使用します。

プロジェクト、規約、またはコードベースに関する指示については、代わりに CLAUDE.md を使用してください。

組み込み出力スタイル

Claude Code の Default 出力スタイルは既存のシステムプロンプトであり、ソフトウェアエンジニアリングタスクを効率的に完了するのに役立つように設計されています。

3 つの追加の組み込み出力スタイルがあります。

• Proactive: Claude は即座に実行し、日常的な決定で一時停止する代わりに合理的な仮定を立て、計画よりもアクションを優先します。これは オートモード と同じガイダンスを適用しますが、パーミッションモードは変更しないため、ツールが実行される前にパーミッションプロンプトが表示されます。

• Explanatory: ソフトウェアエンジニアリングタスクの完了を支援しながら、教育的な「Insights」を提供します。実装の選択肢とコードベースのパターンを理解するのに役立ちます。

• Learning: 協調的な学習型モードです。Claude はコーディング中に「Insights」を共有するだけでなく、小さな戦略的なコードの一部を自分で実装するよう求めます。Claude Code はコード内に TODO(human) マーカーを追加して、実装するべき箇所を示します。

出力スタイルの仕組み

出力スタイルは Claude Code のシステムプロンプトを直接変更します。

• カスタム出力スタイルは、keep-coding-instructions が true でない限り、コーディングのための指示（テストでコードを検証するなど）を除外します。
• すべての出力スタイルは、システムプロンプトの最後に独自のカスタム指示が追加されます。
• すべての出力スタイルは、会話中に出力スタイルの指示に従うよう Claude に思い出させるリマインダーをトリガーします。

トークン使用量はスタイルによって異なります。システムプロンプトに指示を追加するとインプットトークンが増加しますが、プロンプトキャッシングはセッション内の最初のリクエスト後にこのコストを削減します。組み込みの Explanatory および Learning スタイルは、設計上 Default よりも長い応答を生成するため、アウトプットトークンが増加します。カスタムスタイルの場合、アウトプットトークン使用量は、指示が Claude に生成させるものに依存します。

出力スタイルを変更する

/config を実行し、Output style を選択してメニューからスタイルを選択します。選択内容は ローカルプロジェクトレベル の .claude/settings.local.json に保存されます。

メニューなしでスタイルを設定するには、設定ファイルの outputStyle フィールドを直接編集します。

{
  "outputStyle": "Explanatory"
}

出力スタイルはセッション開始時にシステムプロンプトで設定されるため、変更は新しいセッションを開始した次回に有効になります。これにより、会話全体を通じてシステムプロンプトが安定し、プロンプトキャッシングがレイテンシとコストを削減できます。

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

カスタム出力スタイルは、frontmatter とシステムプロンプトに追加されるテキストを含む Markdown ファイルです。

---
name: My Custom Style
description:
  A brief description of what this style does, to be displayed to the user
---

# Custom Style Instructions

You are an interactive CLI tool that helps users with software engineering
tasks. [Your custom instructions here...]

## Specific Behaviors

[Define how the assistant should behave in this style...]

これらのファイルは 3 つのレベルで保存できます。

• ユーザー: ~/.claude/output-styles
• プロジェクト: .claude/output-styles
• 管理ポリシー: 管理設定ディレクトリ 内の .claude/output-styles

プラグイン は output-styles/ ディレクトリで出力スタイルを配布することもできます。

Frontmatter

出力スタイルファイルは、メタデータを指定するための frontmatter をサポートしています。

関連機能との比較

出力スタイル vs. CLAUDE.md vs. --append-system-prompt

Claude がコーディングアシスタントとしての役割を停止するか、デフォルトの役割を保持してさらに学習するかに基づいて選択してください。出力スタイルは Claude Code のシステムプロンプトのソフトウェアエンジニアリング部分を独自の役割と声に置き換えるため、Claude が執筆エディターやデータ分析アシスタントなど異なるアイデンティティを採用する必要がある場合に使用します。CLAUDE.md と --append-system-prompt はどちらも Claude Code のデフォルトアイデンティティを保持し、それに追加するため、Claude がコーディングアシスタントのままで、プロジェクト規約や追加の指示にも従う必要がある場合に使用します。

メカニズムも異なります。出力スタイルはシステムプロンプトを直接編集します。CLAUDE.md はその内容をシステムプロンプトの後のユーザーメッセージとして追加します。--append-system-prompt は何も削除せずにシステムプロンプトの末尾にコンテンツを追加します。

出力スタイル vs. Agents

メインの会話がすべてのセッションでどのように応答するかを変更するには出力スタイルを使用します。メインの会話が委譲する個別にスコープされたヘルパーが必要な場合は subagent を使用します。出力スタイルはメインエージェントループのシステムプロンプトのみに影響します。エージェントは特定のタスクを処理し、独自のモデル、ツール、およびそれらをいつ呼び出すかに関するコンテキストを持つことができます。

出力スタイル vs. Skills

出力スタイルは Claude の応答方法（フォーマット、トーン、構造）を変更し、選択されると常にアクティブです。Skills はタスク固有のプロンプトであり、/skill-name で呼び出すか、関連する場合に Claude が自動的に読み込みます。一貫したフォーマット設定の設定には出力スタイルを使用します。再利用可能なワークフローとタスクには Skills を使用します。