6 6
7> ソフトウェアエンジニアリング以外の用途に合わせて Claude Code を適応させる7> ソフトウェアエンジニアリング以外の用途に合わせて Claude Code を適応させる
8 8
9出力スタイルは Claude がどのように応答するかを変更し、Claude が何を知っているかは変更しません。システムプロンプトを変更してロール、トーン、出力形式を設定しながら、スクリプトの実行、ファイルの読み書き、TODO の追跡などのコア機能を保持します。毎回同じ声や形式で再度プロンプトを入力し続ける場合、または Claude がソフトウェアエンジニア以外として機能することを望む場合に使用します。9出力スタイルは Claude がどのように応答するかを変更し、Claude が何を知っているかは変更しません。システムプロンプトを変更してロール、トーン、出力形式を設定します。毎回同じ声や形式で再度プロンプトを入力し続ける場合、または Claude がソフトウェアエンジニア以外として機能することを望む場合に使用します。
10
11カスタム出力スタイルはシステムプロンプトに指示を追加し、Claude Code の組み込みソフトウェアエンジニアリング指示を保持するかどうかを選択できます。Claude がコミュニケーション方法を変更しているがまだコーディングしている場合（常に図で答えるなど）は保持します。Claude がソフトウェアエンジニアリングをまったく行っていない場合（執筆アシスタントやデータアナリストなど）は除外します。
10 12
11プロジェクト、規約、またはコードベースに関する指示については、代わりに [CLAUDE.md](/ja/memory) を使用してください。13プロジェクト、規約、またはコードベースに関する指示については、代わりに [CLAUDE.md](/ja/memory) を使用してください。
12 14
22 24
23* **Learning**: 協調的な学習型モードです。Claude はコーディング中に「Insights」を共有するだけでなく、小さな戦略的なコードの一部を自分で実装するよう求めます。Claude Code はコード内に `TODO(human)` マーカーを追加して、実装するべき箇所を示します。25* **Learning**: 協調的な学習型モードです。Claude はコーディング中に「Insights」を共有するだけでなく、小さな戦略的なコードの一部を自分で実装するよう求めます。Claude Code はコード内に `TODO(human)` マーカーを追加して、実装するべき箇所を示します。
24 26
25## 出力スタイルの仕組み
26
27出力スタイルは Claude Code のシステムプロンプトを直接変更します。
28
29* カスタム出力スタイルは、`keep-coding-instructions` が true でない限り、コーディングのための指示（テストでコードを検証するなど）を除外します。
30* すべての出力スタイルは、システムプロンプトの最後に独自のカスタム指示が追加されます。
31* すべての出力スタイルは、会話中に出力スタイルの指示に従うよう Claude に思い出させるリマインダーをトリガーします。
32
33トークン使用量はスタイルによって異なります。システムプロンプトに指示を追加するとインプットトークンが増加しますが、プロンプトキャッシングはセッション内の最初のリクエスト後にこのコストを削減します。組み込みの Explanatory および Learning スタイルは、設計上 Default よりも長い応答を生成するため、アウトプットトークンが増加します。カスタムスタイルの場合、アウトプットトークン使用量は、指示が Claude に生成させるものに依存します。
34
35## 出力スタイルを変更する27## 出力スタイルを変更する
36 28
37`/config` を実行し、**Output style** を選択してメニューからスタイルを選択します。選択内容は [ローカルプロジェクトレベル](/ja/settings) の `.claude/settings.local.json` に保存されます。29`/config` を実行し、**Output style** を選択してメニューからスタイルを選択します。選択内容は [ローカルプロジェクトレベル](/ja/settings) の `.claude/settings.local.json` に保存されます。
48 40
49## カスタム出力スタイルを作成する41## カスタム出力スタイルを作成する
50 42
51カスタム出力スタイルは、frontmatter とシステムプロンプトに追加されるテキストを含む Markdown ファイルです。43カスタム出力スタイルは Markdown ファイルです。メタデータ用の frontmatter、その後にシステムプロンプトに追加する指示が続きます。
52 44
53```markdown theme={null}45<Steps>
54name: My Custom Style46 <Step title="Markdown ファイルを作成する">
55description:47 3 つのレベルのいずれかに保存します。ファイル名がスタイル名になります。frontmatter で `name` を設定しない限り。
56 A brief description of what this style does, to be displayed to the user
57 48
58# Custom Style Instructions49 * ユーザー: `~/.claude/output-styles`
50 * プロジェクト: `.claude/output-styles`
51 * 管理ポリシー: [管理設定ディレクトリ](/ja/settings#settings-files) 内の `.claude/output-styles`
52 </Step>
59 53
60You are an interactive CLI tool that helps users with software engineering54 <Step title="Frontmatter と指示を追加する">
61tasks. [Your custom instructions here...]55 Claude Code のソフトウェアエンジニアリング指示を保持するかどうかを決定します。Claude がコミュニケーション方法を変更しているがまだ同じ方法でコーディングしたい場合は `keep-coding-instructions: true` を設定します。Claude がソフトウェアエンジニアリングを行わない場合は除外します。
62 56
63## Specific Behaviors57 この例は Claude のコーディング動作を保持しながら、すべての説明を図で始めます。
64 58
65[Define how the assistant should behave in this style...]59 ```markdown theme={null}
66```60 ---
61 name: Diagrams first
62 description: Lead every explanation with a diagram
63 keep-coding-instructions: true
64 ---
67 65
68これらのファイルは 3 つのレベルで保存できます。66 When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.
69 67
70* ユーザー: `~/.claude/output-styles`68 ## Diagram conventions
71* プロジェクト: `.claude/output-styles`69
72* 管理ポリシー: [管理設定ディレクトリ](/ja/settings#settings-files) 内の `.claude/output-styles`70 Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.
71 ```
72 </Step>
73
74 <Step title="スタイルに切り替える">
75 `/config` を実行し、**Output style** でスタイルを選択します。次のセッションを開始したときに有効になります。
76 </Step>
77</Steps>
73 78
74[プラグイン](/ja/plugins-reference) は `output-styles/` ディレクトリで出力スタイルを配布することもできます。79[プラグイン](/ja/plugins-reference) は `output-styles/` ディレクトリで出力スタイルを配布することもできます。
75 80
76### Frontmatter81### Frontmatter
77 82
78出力スタイルファイルは、メタデータを指定するための frontmatter をサポートしています。83出力スタイルファイルは、これらの frontmatter フィールドをサポートしています。
79 84
80| Frontmatter | 目的 | デフォルト |85| Frontmatter | 目的 | デフォルト |
81| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- | :-------- |86| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | :-------- |
82| `name` | 出力スタイルの名前（ファイル名でない場合） | ファイル名から継承 |87| `name` | 出力スタイルの名前（ファイル名でない場合） | ファイル名から継承 |
83| `description` | `/config` ピッカーに表示される出力スタイルの説明 | なし |88| `description` | `/config` ピッカーに表示される出力スタイルの説明 | なし |
84| `keep-coding-instructions` | Claude Code のシステムプロンプトのコーディング関連の部分を保持するかどうか | false |89| `keep-coding-instructions` | Claude Code の組み込みソフトウェアエンジニアリング指示を保持する | `false` |
85| `force-for-plugin` | プラグイン出力スタイルのみ: プラグインが有効になるたびに、ユーザーが選択する必要なく、このスタイルを自動的に適用します。ユーザーの `outputStyle` 設定をオーバーライドします。複数の有効なプラグインがこれを設定する場合、最初に読み込まれたものが優先されます。 | false |90| `force-for-plugin` | プラグイン出力スタイルのみ: プラグインが有効になるたびに、ユーザーが選択する必要なく、このスタイルを自動的に適用します。ユーザーの `outputStyle` 設定をオーバーライドします。複数の有効なプラグインがこれを設定する場合、Claude Code は最初に読み込まれたものを使用します。 | `false` |
86 91
87## 関連機能との比較92## 出力スタイルの仕組み
93
94出力スタイルは Claude Code のシステムプロンプトを直接変更します。
88 95
89### 出力スタイル vs. CLAUDE.md vs. --append-system-prompt96* すべての出力スタイルは、システムプロンプトの最後に独自のカスタム指示が追加されます。
97* すべての出力スタイルは、会話中に出力スタイルの指示に従うよう Claude に思い出させるリマインダーをトリガーします。
98* カスタム出力スタイルは、`keep-coding-instructions` が `true` に設定されていない限り、スコープ変更の方法、コメントの書き方、作業の検証方法など、Claude Code の組み込みソフトウェアエンジニアリング指示を除外します。
90 99
91Claude がコーディングアシスタントとしての役割を停止するか、デフォルトの役割を保持してさらに学習するかに基づいて選択してください。出力スタイルは Claude Code のシステムプロンプトのソフトウェアエンジニアリング部分を独自の役割と声に置き換えるため、Claude が執筆エディターやデータ分析アシスタントなど異なるアイデンティティを採用する必要がある場合に使用します。CLAUDE.md と `--append-system-prompt` はどちらも Claude Code のデフォルトアイデンティティを保持し、それに追加するため、Claude がコーディングアシスタントのままで、プロジェクト規約や追加の指示にも従う必要がある場合に使用します。100トークン使用量はスタイルによって異なります。システムプロンプトに指示を追加するとインプットトークンが増加しますが、プロンプトキャッシングはセッション内の最初のリクエスト後にこのコストを削減します。組み込みの Explanatory および Learning スタイルは、設計上 Default よりも長い応答を生成するため、アウトプットトークンが増加します。カスタムスタイルの場合、アウトプットトークン使用量は、指示が Claude に生成させるものに依存します。
92 101
93メカニズムも異なります。出力スタイルはシステムプロンプトを直接編集します。CLAUDE.md はその内容をシステムプロンプトの後のユーザーメッセージとして追加します。`--append-system-prompt` は何も削除せずにシステムプロンプトの末尾にコンテンツを追加します。102## 関連機能との比較
94 103
95### 出力スタイル vs. [Agents](/ja/sub-agents)104Claude Code の動作をカスタマイズするいくつかの機能があります。出力スタイルはシステムプロンプトを直接変更し、すべての応答に適用されます。その他は、デフォルトシステムプロンプトを変更せずに指示を追加するか、特定のタスクにスコープします。
96 105
97メインの会話がすべてのセッションでどのように応答するかを変更するには出力スタイルを使用します。メインの会話が委譲する個別にスコープされたヘルパーが必要な場合は [subagent](/ja/sub-agents) を使用します。出力スタイルはメインエージェントループのシステムプロンプトのみに影響します。エージェントは特定のタスクを処理し、独自のモデル、ツール、およびそれらをいつ呼び出すかに関するコンテキストを持つことができます。106| 機能 | 仕組み | 使用する場合 |
107| :----------------------- | :----------------------------------- | :------------------------------------------- |
108| 出力スタイル | システムプロンプトを変更する | 毎回異なるロール、トーン、またはデフォルト応答形式が必要な場合 |
109| [CLAUDE.md](/ja/memory) | システムプロンプトの後にユーザーメッセージを追加する | Claude がプロジェクト規約とコードベースコンテキストを常に知っている必要がある場合 |
110| `--append-system-prompt` | 何も削除せずにシステムプロンプトに追加する | 単一の呼び出しのための 1 回限りの追加が必要な場合 |
111| [エージェント](/ja/sub-agents) | 独自のシステムプロンプト、モデル、ツールを持つサブエージェントを実行する | フォーカスされたタスク用に個別にスコープされたヘルパーが必要な場合 |
112| [スキル](/ja/skills) | 呼び出されたときまたは関連する場合にタスク固有の指示を読み込む | 再利用可能なワークフローがある場合 |
98 113
99### 出力スタイル vs. [Skills](/ja/skills)114## 関連リソース
100 115
101出力スタイルは Claude の応答方法（フォーマット、トーン、構造）を変更し、選択されると常にアクティブです。Skills はタスク固有のプロンプトであり、`/skill-name` で呼び出すか、関連する場合に Claude が自動的に読み込みます。一貫したフォーマット設定の設定には出力スタイルを使用します。再利用可能なワークフローとタスクには Skills を使用します。116* [設定](/ja/settings): `outputStyle` フィールドが存在する場所と設定の優先順位の仕組み
117* [パーミッションモード](/ja/permission-modes): Proactive スタイルはパーミッションモードを変更せずにオートモードをミラーリングします
118* [プラグイン](/ja/plugins): スキル、フック、エージェントと一緒に出力スタイルをパッケージ化して配布します
119* [設定をデバッグする](/ja/debug-your-config): 出力スタイルが有効にならない理由を診断します
