Output styles (出力スタイル)

Claude Code には既定 (Default) のほかに 4 種類の組み込みスタイルがあり、独自のスタイルを書くこともできます。カスタムスタイルでは、Claude をソフトウェアエンジニア以外の役割、たとえば文章作成のアシスタントやデータアナリストとして振る舞わせることもできます。

• Default: 出力スタイルが選ばれていない状態です。スタイルの指示は加わらず、Claude はソフトウェアエンジニアリングの作業向けに書かれた Claude Code の標準のシステムプロンプトで動きます。
• Proactive: タスクを送るとすぐに実装を始め、日常的な判断は手を止めて質問するのではなく妥当な前提を置いて進めます。計画を求めない限り plan mode には切り替わりません。このスタイルに切り替えても permission mode は変わらず、許可の確認はこれまでと同じように表示されます。
• Concise: 応答の最初の文で、何が起きたか、または答えが何かを示します。前置き、手順ごとの説明、最後のまとめを省き、簡単な質問には 1〜3 文で答えます。エラーの報告、失敗したテストの出力、セキュリティの警告、破壊的な操作の確認は、内容を省かずにそのまま示します。
• Explanatory: Claude が自分の選択について短い説明を加えます。説明は会話の中で、対象のコードの前後に Insight と表示されたブロックとして示され、ファイルにコメントとして書き込まれることはありません。
• Learning: Explanatory と同じ Insight ブロックを加えたうえで、コードの一部をユーザーに書くよう求め、その箇所に TODO(human) コメントで印を付けます。

出力スタイルは Claude が従う指示であり、ある動作が必ず起きる、または決して起きないことを保証するものではありません。

カスタムスタイルは Markdown ファイルとして作成し、次の 3 つのいずれかの場所に保存します。

• ~/.claude/output-styles (ユーザー単位)
• .claude/output-styles (プロジェクト単位)
• managed settings ディレクトリ内の .claude/output-styles

ファイル名がスタイル名になります。フロントマターで name を設定した場合はその名前が使われます。ファイルにはフロントマターと指示を書きます。Claude の伝え方だけを変えて、コーディングの進め方は従来どおりにしたい場合は keep-coding-instructions: true を設定します。Claude にソフトウェアエンジニアリングをさせない場合は、この項目を書きません。カスタムスタイルは、keep-coding-instructions が true でない限り、変更範囲の決め方・コメントの書き方・作業の検証方法といった Claude Code 組み込みのソフトウェアエンジニアリングの指示をシステムプロンプトから外します。

作成したスタイルは、ターミナルで /output-style <style> を実行するか、/config の Output style (出力スタイル) で選びます。実行中のセッションでスタイルファイルを作成・編集した場合は、Claude Code を再起動すると変更が反映されます。VS Code の Output styles メニューには、カスタムスタイルのファイルを書き出してすぐに一覧に表示する「Build a custom style」ウォークスルーがあります。

プラグインは output-styles/ ディレクトリに出力スタイルを同梱できます。プラグインの出力スタイルでは keep-coding-instructions フロントマターフィールドを使えます。また、force-for-plugin を true にすると、プラグインが有効なあいだはユーザーが選ばなくてもそのスタイルが自動で適用され、ユーザーの outputStyle 設定より優先されます。

• /output-style コマンドと 2 つのメニューで選んだスタイルは、ローカルのプロジェクト単位の設定として .claude/settings.local.json に保存されます。
• ~/.claude/settings.json に outputStyle を設定すると、プロジェクトをまたいだ既定のスタイルになります。ただし、プロジェクト自身の設定ファイルが優先されます。
• 設定ファイルの outputStyle の値がスタイル名と完全に一致しない場合 (例: explanatory)、Default スタイルになります。/output-style コマンドは大文字と小文字を区別しません。
• 入れ子になった .claude/ ディレクトリで名前が衝突した場合は、作業ディレクトリに最も近い output-style が優先されます。
• プラグインの出力スタイルで force-for-plugin が true の場合、ユーザーの outputStyle 設定より優先されます。
• 出力スタイルはメインの会話と fork に適用されます。独自のシステムプロンプトで動くその他の subagent には適用されません。
• セッションの途中でスタイルを切り替えると、次のメッセージから新しいスタイルが使われます。
• 提供プランについては、公式のリリースノートには記載がありません。

スタイルの切り替えは、次のいずれかの方法で行います。

1. /output-style <style> を実行して切り替えます (例: /output-style concise)。引数なしで実行すると、選べるスタイルの一覧が表示され、現在のスタイルに印が付きます。
2. メニューから選ぶ場合は /config を実行し、Output style (出力スタイル) を選んでスタイルを指定します。
3. VS Code 拡張では、/ でコマンドメニューを開き、Output styles (出力スタイル) を選んでスタイルを指定します。カスタムスタイルもここから選べます。
4. メニューを使わずに設定する場合は、設定ファイルの outputStyle フィールドを直接編集します。この値は大文字と小文字を区別します。