- 組み込みスタイルを使用するには、組み込み出力スタイルから 1 つを選択して、それに切り替えます。
- 独自の指示を作成するには、カスタム出力スタイルを作成します。
出力スタイルは Claude に従うべき指示を与えます。何かが常に起こることや決して起こらないことを保証するものではありません。一部のニーズは異なる機能に適しています。
- Claude がプロジェクトについて知っておくべきことについては、CLAUDE.md を使用します。
- 各編集後のフォーマットやコマンドのブロックなど、毎回必ず起こる必要があることについては、フックを使用します。
- スキル、サブエージェント、その他のオプションについては、出力スタイルと他の機能の選択を参照してください。
組み込み出力スタイル
Claude Code は Default スタイルで開始します。これはソフトウェアエンジニアリングタスクを完了するための標準的な指示です。他の 4 つの組み込みスタイルはこれらの指示を保持し、独自の指示を追加します。 このテーブルは各スタイルがセッションについて何を変更するか、そしていつそれが適切かを示しています。Default
Default は出力スタイルが選択されていないことを意味します。Claude Code はスタイル指示を追加せず、Claude は Claude Code の標準システムプロンプトから動作します。これはソフトウェアエンジニアリングタスク用に記述されています。default は他のスタイルと共に /output-style リストに表示されるため、同じ方法で選択します。
Proactive
Proactive スタイルでは、Claude はタスクを送信するとすぐに実装を開始します。日常的な決定について合理的な仮定を立て、質問するために停止することはなく、計画を求めない限り計画モードに切り替わりません。任意の時点でそれをリダイレクトできます。 スタイルの指示は、データを削除するか、共有またはプロダクションシステムを変更するアクションの前に、Claude がカンバセーション内でユーザーに確認するよう指示します。その確認は Claude が従う指示であり、権限プロンプトとは別です。 Proactive スタイルに切り替えても、権限モードは変わりません。権限モードは依然としてユーザーに尋ねずに実行するツール呼び出しを決定するため、権限プロンプトは切り替え前と同じ方法で表示されます。Concise
Concise スタイルでは、レスポンスの最初の文が何が起こったか、または答えが何かを述べています。Claude は導入部、ステップバイステップの説明、および終了時の要約を省略し、簡単な質問に 1 ~ 3 文で答えます。Default スタイルと同じくらい徹底的にエンジニアリング作業を行います。Claude Code v2.1.237 以降が必要です。 Claude は以下の場合でも完全な長さで記述します。- ユーザーが求めるもの: 説明または詳細情報を求めると、Claude は完全に答えます。
- 安全に行動するために必要なもの: エラーレポート、失敗したテスト出力、セキュリティ警告、および破壊的なアクションの確認は完全な内容を保持します。
Explanatory
Explanatory スタイルでは、Claude は Default スタイルと同じ方法でタスクを実行し、立てた選択肢の理由についての短い説明を追加します。各説明はカンバセーションに表示され、それが関連するコードの前または後に、Insight というラベルの付いたブロックに表示されます。説明はファイルにコメントとして記述されません。
Insight ブロックは、コードベースまたは Claude が記述したコードについて 2 ~ 3 つのポイントを含みます。例えば、API エンドポイントを追加した後のこのようなものです。
Learning
Learning スタイルでは、Claude は Explanatory スタイルと同じInsight ブロックを追加し、ユーザーにコードの一部を記述するよう求めます。Claude は日常的な実装を自分で処理します。エラーハンドリング、データ構造、または複数の有効なアプローチを持つビジネスロジックなど、実際の設計決定を伴う部分に到達すると、ユーザーのために数行を残します。
Claude は TODO(human) コメントでファイル内の場所をマークし、既に構築されたもの、記述するもの、および検討すべきことを述べるリクエストを送信します。
TODO(human) コメントでコードを記述し、完了したことを Claude に伝えます。Claude はユーザーのコードについて 1 つの Insight で応答し、タスクを続行します。
出力スタイルを変更する
コマンド、メニュー、または設定ファイルでスタイルを選択します。コマンドと両方のメニューは、選択内容を ローカルプロジェクトレベル の.claude/settings.local.json に保存します。
-
/output-styleコマンド:/output-style <style>を実行してスタイルを切り替えます。例えば/output-style conciseのように使用します。引数なしで実行すると、選択可能なスタイルが一覧表示され、現在のスタイルがマークされます。 このコマンドは 非対話型モード と Agent SDK セッション、およびモバイルアプリまたは Web から リモートコントロール 経由でも機能します。この場合、組み込みスタイル のみをリストして選択できます。Claude Code v2.1.269 以降が必要です。 -
Terminal メニュー:
/configを実行し、Output style を選択してメニューからスタイルを選択します。 -
VS Code extension: コマンドメニュー を
/で開き、Output styles を選択してスタイルを選択します。カスタムスタイルも含まれます。Claude Code v2.1.257 以降が必要です。 -
Desktop app: 設定ファイル(例えば
.claude/settings.local.json、ターミナルメニューが書き込むファイル)のoutputStyleフィールドを設定します。/configを実行すると、Claude Code は Settings > Claude Code を開きます。メニューではなく設定画面が開きます。
outputStyle フィールドを直接編集します。
Proactive、Concise、Explanatory、Learning と記述してください。explanatory のようにスタイル名と完全に一致しない値を指定すると、デフォルトスタイルが適用されます。/output-style コマンドは大文字と小文字を区別しません。
プロジェクト全体でスタイルをデフォルトにするには、~/.claude/settings.json で outputStyle を設定します。プロジェクト独自の設定ファイルは その値より優先されます。
セッション中にスタイルを切り替えると、Claude は次のメッセージから新しいスタイルを使用します。最初のメッセージのプロンプトキャッシングのコストについては、出力スタイルの変更 を参照してください。v2.1.251 より前は、新しいスタイルは /clear を実行するか新しいセッションを開始した後にのみ適用されました。
カスタム出力スタイルを作成する
カスタム出力スタイルは Markdown ファイルです。メタデータ用の frontmatter、その後に Claude の指示が続きます。 VS Code 拡張機能では、手書きではなく Output styles メニュー からファイルを作成することもできます。これには Claude Code v2.1.261 以降が必要です。1
Markdown ファイルを作成する
3 つのレベルのいずれかに保存します。ファイル名がスタイル名になります。frontmatter で
name を設定しない限り。- ユーザー:
~/.claude/output-styles - プロジェクト:
.claude/output-styles - 管理ポリシー: 管理設定ディレクトリ 内の
.claude/output-styles
.claude/output-styles/ から読み込まれます。これらのネストされたディレクトリの複数が同じ名前のスタイルを定義する場合、Claude Code は作業ディレクトリに最も近いものを使用します。2
Frontmatter と指示を追加する
Claude Code のソフトウェアエンジニアリング指示を保持するかどうかを決定します。Claude がコミュニケーション方法を変更しているがまだ同じ方法でコーディングしたい場合は
keep-coding-instructions: true を設定します。Claude がソフトウェアエンジニアリングを行わない場合は除外します。この例は Claude のコーディング動作を保持しながら、すべての説明を図で始めます。3
スタイルに切り替える
ターミナルで
/output-style <style> を実行するか、/config を実行して Output style でスタイルを選択します。Claude は次のメッセージから新しいスタイルを使用します。ターミナルでは、Claude Code はスタイルファイルを起動時に読み込むため、実行中のセッション中に作成または編集した場合は、Claude Code を再起動して変更を反映させてください。output-styles/ ディレクトリで出力スタイルを配布することもできます。
Frontmatter リファレンス
出力スタイルを YAML frontmatter で設定します。ファイルの上部の--- マーカーの間に記述します。すべてのフィールドはオプションであり、フィールド名はハイフンで区切られた小文字の単語を使用します。スペルが間違ったフィールドはエラーなしで無視されます。YAML が解析できない場合、スタイルはファイル名で読み込まれ、フィールドは設定されません。claude --debug を実行して解析エラーを確認してください。
出力スタイルと他の機能の選択
出力スタイルはセッション内のすべての応答に適用されます。これは Claude が従う指示であるため、何も強制しません。必要なものがすべての応答より狭い範囲である場合、または確実に発生する必要がある場合は、別の機能がより適切です。 この表は、必要なものを、それを実現する機能に対応させています。
これらの機能は組み合わせることができます。たとえば、Claude が知るべきことに CLAUDE.md を使用し、応答方法に出力スタイルを使用し、保証する必要があるものに hook を使用できます。Claude Code を拡張すると、残りの拡張機能が比較されます。
出力スタイルの仕組み
出力スタイルは Claude Code が Claude に与える指示を変更します。- Claude Code はすべてのリクエストで有効なスタイルの指示を送信します。
- カスタム出力スタイルは、
keep-coding-instructionsがtrueに設定されていない限り、変更のスコープ、コメントの書き方、作業の検証方法など、Claude Code の組み込みソフトウェアエンジニアリング指示を除外します。