プロンプトのベストプラクティス

このガイドは、Claude 4.xモデル向けの具体的なプロンプトエンジニアリング技術を提供します。Sonnet 4.5、Haiku 4.5、Opus 4.5に関する具体的なガイダンスが含まれています。これらのモデルは、以前のClaudeモデルの世代よりも、より正確な指示追従のために訓練されています。

一般的な原則

指示を明確にする

Claude 4.xモデルは、明確で明示的な指示に良く反応します。望ましい出力について具体的であることは、結果を向上させるのに役立ちます。以前のClaudeモデルから「期待以上」の動作を望む顧客は、新しいモデルでこれらの動作をより明示的に要求する必要があるかもしれません。

パフォーマンスを向上させるためにコンテキストを追加する

指示の背後にあるコンテキストまたは動機を提供することで、例えばClaudeにそのような動作がなぜ重要なのかを説明することで、Claude 4.xモデルがあなたの目標をより良く理解し、より的を絞った応答を提供するのに役立ちます。

Claudeは説明から一般化するのに十分なほど賢いです。

例と詳細に注意を払う

Claude 4.xモデルは、正確な指示追従機能の一部として、詳細と例に細心の注意を払います。例が奨励したい動作と一致していることを確認し、回避したい動作を最小化してください。

長期的な推論と状態追跡

Claude 4.5モデルは、例外的な状態追跡機能を備えた長期的な推論タスクに優れています。段階的な進捗に焦点を当てることで、拡張セッション全体で方向性を維持します。一度にすべてを試みるのではなく、少数のことで着実に進歩を遂行します。この機能は、複雑なタスクに取り組み、状態を保存し、新しいコンテキストウィンドウで続行できる複数のコンテキストウィンドウまたはタスク反復にわたって特に現れます。

コンテキスト認識とマルチウィンドウワークフロー

Claude 4.5モデルはコンテキスト認識機能を備えており、モデルが会話全体を通じて残りのコンテキストウィンドウ（つまり「トークン予算」）を追跡できます。これにより、Claudeは作業するスペースがどのくらいあるかを理解することで、タスクを実行し、コンテキストをより効果的に管理できます。

コンテキスト制限の管理：

コンテキストをコンパクト化したり、外部ファイルにコンテキストを保存したりするエージェントハーネスでClaudeを使用している場合（Claude Codeのように）、Claudeがそれに応じて動作できるようにこの情報をプロンプトに追加することをお勧めします。そうしないと、Claudeはコンテキスト制限に近づくにつれて、自然に作業をまとめようとすることがあります。以下は例のプロンプトです：

あなたのコンテキストウィンドウは、その制限に近づくにつれて自動的にコンパクト化され、中断したところから無期限に作業を続けることができます。したがって、トークン予算の懸念のために早期にタスクを停止しないでください。トークン予算の制限に近づくにつれて、コンテキストウィンドウが更新される前に、現在の進捗と状態をメモリに保存してください。常に可能な限り永続的で自律的であり、残りのコンテキストに関係なく、タスクを完全に完了してください。コンテキストの残りに関係なく、タスクを早期に人為的に停止しないでください。

メモリツールは、シームレスなコンテキスト遷移のためにコンテキスト認識と自然に組み合わせられます。

マルチコンテキストウィンドウワークフロー

複数のコンテキストウィンドウにまたがるタスクの場合：

1. 最初のコンテキストウィンドウに異なるプロンプトを使用する：最初のコンテキストウィンドウを使用してフレームワークを設定し（テストを作成し、セットアップスクリプトを作成）、将来のコンテキストウィンドウを使用してTODOリストを反復処理します。

2. モデルに構造化形式でテストを作成させる：Claudeに作業を開始する前にテストを作成するよう依頼し、構造化形式（例：tests.json）で追跡させます。これにより、長期的な反復能力が向上します。Claudeにテストの重要性を思い出させてください：「テストを削除または編集することは受け入れられません。これは機能の欠落またはバグにつながる可能性があるためです。」

3. 生活の質ツールを設定する：Claudeにセットアップスクリプト（例：init.sh）を作成するよう促し、サーバーを優雅に起動し、テストスイートとリンターを実行します。これにより、新しいコンテキストウィンドウから続行する際の繰り返し作業を防ぎます。

4. 新規開始対コンパクション：コンテキストウィンドウがクリアされるとき、コンパクションを使用するのではなく、まったく新しいコンテキストウィンドウで開始することを検討してください。Claude 4.5モデルは、ローカルファイルシステムから状態を発見するのに非常に効果的です。場合によっては、コンパクションよりもこれを活用したい場合があります。開始方法について指定してください：

   • 「pwdを呼び出してください。このディレクトリ内のファイルのみを読み書きできます。」
   • 「progress.txt、tests.json、およびgitログを確認してください。」
   • 「新しい機能の実装に進む前に、基本的な統合テストを手動で実行してください。」

これは非常に長いタスクなので、作業を明確に計画することが有益な場合があります。タスクに取り組むために出力コンテキスト全体を費やすことが推奨されます。ただし、重大なコミットされていない作業でコンテキストを使い果たさないようにしてください。このタスクを完了するまで体系的に作業を続けてください。

状態管理のベストプラクティス

• 状態データに構造化形式を使用する：構造化情報（テスト結果やタスクステータスなど）を追跡する場合、JSONまたは他の構造化形式を使用して、Claudeがスキーマ要件を理解するのに役立ちます
• 進捗メモに非構造化テキストを使用する：自由形式の進捗メモは、一般的な進捗とコンテキストを追跡するのに適しています
• 状態追跡にgitを使用する：Gitは何が行われたかのログとチェックポイントを提供し、復元できます。Claude 4.5モデルは、複数のセッション間で状態を追跡するためにgitを使用するのに特に優れています。
• 段階的な進捗を強調する：Claudeに進捗を追跡し、段階的な作業に焦点を当てるよう明示的に依頼します

コミュニケーションスタイル

Claude 4.5モデルは、以前のモデルと比較して、より簡潔で自然なコミュニケーションスタイルを持っています：

• より直接的で根拠のある：自己祝賀的な更新ではなく、事実ベースの進捗レポートを提供します
• より会話的：やや流暢で口語的で、機械的ではありません
• より簡潔：特に要求されない限り、詳細な要約をスキップする場合があります

このコミュニケーションスタイルは、不要な詳細説明なしに達成されたことを正確に反映しています。

特定の状況に関するガイダンス

冗長性のバランスを取る

Claude 4.5モデルは効率に向かう傾向があり、ツール呼び出し後の口頭での要約をスキップし、次のアクションに直接ジャンプする場合があります。これはストリーミングラインされたワークフローを作成しますが、推論プロセスへのより多くの可視性を好む場合があります。

Claudeが作業中に更新を提供したい場合：

ツール使用を含むタスクを完了した後、実行した作業の簡単な要約を提供してください。

ツール使用パターン

Claude 4.5モデルは正確な指示追従のために訓練されており、特定のツールを使用するための明示的な指示から利益を得ます。「いくつかの変更を提案できますか」と言う場合、変更を実装するのではなく、提案を提供することがあります。変更を加えることが意図されているかもしれません。

Claudeが行動を起こすために、より明示的にしてください：

Claudeをデフォルトでアクションを取るようにより積極的にするために、これをシステムプロンプトに追加できます：

<default_to_action>
デフォルトでは、提案のみではなく変更を実装してください。ユーザーの意図が不明な場合は、最も有用な可能性のあるアクションを推測し、ツールを使用して欠落している詳細を発見する代わりに、推測する代わりに進めてください。ツール呼び出し（ファイル編集や読み取りなど）が意図されているかどうかについてのユーザーの意図を推測し、それに応じて行動してください。
</default_to_action>

一方、モデルがデフォルトでより躊躇し、実装に直接ジャンプするのに不安定で、要求された場合にのみアクションを取りたい場合は、以下のようなプロンプトでこの動作を操作できます：

<do_not_act_before_instructions>
明確に変更を加えるよう指示されない限り、実装またはファイルの変更に飛び込まないでください。ユーザーの意図が曖昧な場合は、アクションを取るのではなく、情報を提供し、調査を行い、推奨事項を提供することをデフォルトにしてください。ユーザーが明示的に編集、変更、または実装を要求した場合にのみ、編集、変更、または実装を進めてください。
</do_not_act_before_instructions>

ツール使用とトリガー

Claude Opus 4.5は以前のモデルよりもシステムプロンプトに反応しやすいです。ツールやスキルの過度なトリガーを減らすために設計されたプロンプトがある場合、Claude Opus 4.5は過度にトリガーする可能性があります。修正は、積極的な言語を控えることです。「重要：このツールを使用する必要があります...」と言った場合、「このツールを使用してください...」のようなより通常のプロンプトを使用できます。

応答の形式を制御する

Claude 4.xモデルで出力フォーマットを操作するのに特に効果的であることが判明した方法がいくつかあります：

1. Claudeに何をしないかではなく、何をするかを伝える

   • 代わりに：「応答でマークダウンを使用しないでください」
   • 試してください：「あなたの応答は、スムーズに流れるプロセスの段落で構成されるべきです。」

2. XML形式インジケーターを使用する

   • 試してください：「応答の散文セクションを<smoothly_flowing_prose_paragraphs>タグで書いてください。」

3. プロンプトスタイルを目的の出力と一致させる

   プロンプトで使用されるフォーマットスタイルは、Claudeの応答スタイルに影響を与える可能性があります。出力フォーマットの操作性に問題が引き続き発生している場合は、可能な限りプロンプトスタイルを目的の出力スタイルと一致させることをお勧めします。例えば、プロンプトからマークダウンを削除すると、出力のマークダウンの量を減らすことができます。

4. マークダウンとフォーマット使用の詳細なプロンプトを使用する

   マークダウンとフォーマット使用をより制御するために、明示的なガイダンスを提供します：

<avoid_excessive_markdown_and_bullet_points>
レポート、ドキュメント、技術的説明、分析、または長文コンテンツを作成する場合は、完全な段落と文を使用した明確で流れるような散文で書いてください。組織化のために標準的な段落区切りを使用し、マークダウンを主に`インラインコード`、コードブロック（```...```）、および単純な見出し（###、および###）に予約してください。**太字**と*斜体*の使用を避けてください。

順序付きリスト（1. ...）または順序なしリスト（*）を使用しないでください。ただし：a）リスト形式が最良の選択肢である真に離散的なアイテムを提示している場合、または b）ユーザーが明示的にリストまたはランキングを要求した場合

リストアイテムを箇条書きまたは番号で列挙する代わりに、それらを文に自然に組み込んでください。このガイダンスは特に技術的な執筆に適用されます。散文を過度なフォーマットの代わりに使用すると、ユーザーの満足度が向上します。過度に短い箇条書きのシリーズを出力しないでください。

あなたの目標は、情報を孤立したポイントに断片化するのではなく、読者を自然にアイデアを通じて導く読みやすく流れるテキストです。
</avoid_excessive_markdown_and_bullet_points>

研究と情報収集

Claude 4.5モデルは、例外的なエージェント検索機能を示し、複数のソースから情報を効果的に見つけて統合できます。最適な研究結果のために：

1. 明確な成功基準を提供する：研究質問への成功した回答が何を構成するかを定義します

2. 情報源の検証を促す：Claudeに複数のソースにわたって情報を検証するよう依頼します

3. 複雑な研究タスクの場合、構造化されたアプローチを使用する：

この情報を構造化された方法で検索してください。データを収集するにつれて、複数の競合する仮説を開発してください。進捗メモで信頼レベルを追跡して、キャリブレーションを改善してください。定期的に自分のアプローチを自己批判し、計画してください。仮説ツリーまたは研究メモファイルを更新して、情報を永続化し、透明性を提供してください。この複雑な研究タスクを体系的に分解してください。

この構造化されたアプローチにより、Claudeはコーパスのサイズに関係なく、ほぼすべての情報を見つけて統合し、その結果を反復的に批判することができます。

サブエージェントオーケストレーション

Claude 4.5モデルは、大幅に改善されたネイティブサブエージェントオーケストレーション機能を示しています。これらのモデルは、タスクが専門化されたサブエージェントへの委任から利益を得るときを認識し、明示的な指示なしに積極的にそうすることができます。

この動作を活用するために：

1. 明確に定義されたサブエージェントツールを確保する：サブエージェントツールが利用可能で、ツール定義で説明されていることを確認します
2. Claudeに自然にオーケストレーションさせる：Claudeは明示的な指示なしに適切に委任します
3. 必要に応じて保守性を調整する：

タスクが新しいコンテキストウィンドウを持つ別のエージェントから明らかに利益を得る場合にのみ、サブエージェントに委任してください。

モデル自己認識

Claudeがアプリケーションで自分自身を正しく識別したり、特定のAPI文字列を使用したりしたい場合：

アシスタントはAnthropicによって作成されたClaudeです。現在のモデルはClaude Sonnet 4.5です。

LLMを指定する必要があるLLMを搭載したアプリの場合：

LLMが必要な場合は、ユーザーが別の方法を要求しない限り、Claude Sonnet 4.5をデフォルトにしてください。Claude Sonnet 4.5の正確なモデル文字列はclaude-sonnet-4-5-20250929です。

思考感度

拡張思考が無効になっている場合、Claude Opus 4.5は「think」という単語とその変種に特に敏感です。「think」を「consider」、「believe」、「evaluate」などの同様の意味を伝える代替単語に置き換えることをお勧めします。

思考と相互に関連する思考機能を活用する

Claude 4.xモデルは、ツール使用後の反射や複雑なマルチステップ推論を含むタスクに特に役立つ思考機能を提供します。より良い結果のために、その初期または相互に関連する思考を導くことができます。

ツール結果を受け取った後、その品質を慎重に反映し、進める前に最適な次のステップを決定してください。この新しい情報に基づいて計画および反復するために思考を使用し、最適な次のアクションを実行してください。

ドキュメント作成

Claude 4.5モデルは、プレゼンテーション、アニメーション、ビジュアルドキュメントの作成に優れています。これらのモデルは、このドメインでClaude Opus 4.1と同等またはそれを超え、印象的な創造的なセンスと強い指示追従を備えています。モデルは、ほとんどの場合、最初の試行で洗練された、使用可能な出力を生成します。

ドキュメント作成で最良の結果を得るために：

[トピック]に関する専門的なプレゼンテーションを作成してください。思慮深いデザイン要素、ビジュアルハイアラーキー、および適切な場所で魅力的なアニメーションを含めてください。

改善されたビジョン機能

Claude Opus 4.5は、以前のClaudeモデルと比較して、改善されたビジョン機能を備えています。特に複数の画像がコンテキストに存在する場合、画像処理とデータ抽出タスクでより良いパフォーマンスを発揮します。これらの改善は、モデルがスクリーンショットとUIエレメントをより確実に解釈できるコンピュータ使用に引き継がれます。また、Claude Opus 4.5を使用して、ビデオをフレームに分割することでビデオを分析することもできます。

パフォーマンスをさらに向上させるために効果的であることが判明した1つの技術は、Claude Opus 4.5にクロップツールまたはスキルを与えることです。Claude が画像の関連領域に「ズーム」できる場合、画像評価で一貫した上昇が見られています。クロップツール用のクックブックをまとめましたここ。

並列ツール呼び出しを最適化する

Claude 4.xモデルは並列ツール実行に優れており、Sonnet 4.5は複数の操作を同時に実行するのに特に積極的です。Claude 4.xモデルは：

• 研究中に複数の推測検索を実行します
• コンテキストをより速く構築するために複数のファイルを一度に読み取ります
• bashコマンドを並列で実行します（システムパフォーマンスをボトルネックにすることもできます）

この動作は簡単に操作できます。モデルはプロンプトなしで並列ツール呼び出しで高い成功率を持っていますが、これを〜100％に上げるか、積極性レベルを調整できます：

<use_parallel_tool_calls>
複数のツールを呼び出す予定があり、ツール呼び出し間に依存関係がない場合は、すべての独立したツール呼び出しを並列で実行してください。ツール呼び出しを同時に行うことができる場合は常に、順序付けられた呼び出しではなく、ツールを同時に呼び出すことを優先してください。例えば、3つのファイルを読み取る場合、3つのツール呼び出しを並列で実行して、3つのファイルをすべて同時にコンテキストに読み込んでください。可能な限り並列ツール呼び出しの使用を最大化して、速度と効率を向上させてください。ただし、一部のツール呼び出しが前の呼び出しに依存して、パラメーターなどの依存値を通知する場合は、これらのツールを並列で呼び出さず、代わりに順序付けて呼び出してください。ツール呼び出しでプレースホルダーを使用したり、欠落しているパラメーターを推測したりしないでください。
</use_parallel_tool_calls>

各ステップ間に短い一時停止を伴う順序付けられた操作を実行して、安定性を確保してください。

エージェント的なコーディングでのファイル作成を減らす

Claude 4.xモデルは、特にコードを操作する場合、テストと反復の目的で新しいファイルを作成することがあります。このアプローチにより、Claudeはファイル、特にPythonスクリプトを、最終出力を保存する前の「一時的なスクラッチパッド」として使用できます。一時ファイルを使用すると、特にエージェント的なコーディングユースケースの結果を改善できます。

ネット新規ファイル作成を最小化したい場合は、Claudeに自分自身をクリーンアップするよう指示できます：

反復のために一時的な新しいファイル、スクリプト、またはヘルパーファイルを作成する場合は、タスクの終了時にこれらのファイルを削除して削除してください。

過度な熱心さとファイル作成

Claude Opus 4.5は、追加ファイルを作成し、不要な抽象化を追加したり、要求されていない柔軟性を構築したりすることで、過度に設計する傾向があります。この望ましくない動作が見られている場合は、ソリューションを最小限に保つよう明示的なプロンプトを追加してください。

例えば：

過度なエンジニアリングを避けてください。直接要求されたか、明らかに必要な変更のみを加えてください。ソリューションをシンプルで焦点を絞ったものに保ってください。

要求されていない機能を追加したり、コードをリファクタリングしたり、「改善」を加えたりしないでください。バグ修正は周囲のコードをクリーンアップする必要はありません。シンプルな機能は追加の構成可能性を必要としません。

発生できないシナリオのエラー処理、フォールバック、または検証を追加しないでください。内部コードとフレームワークの保証を信頼してください。システム境界（ユーザー入力、外部API）でのみ検証してください。単にコードを変更できるときに後方互換性シムを使用しないでください。

1回限りの操作のためのヘルパー、ユーティリティ、または抽象化を作成しないでください。仮説的な将来の要件のために設計しないでください。複雑さの正しい量は、現在のタスクに必要な最小値です。可能な場合は既存の抽象化を再利用し、DRY原則に従ってください。

フロントエンドデザイン

Claude 4.xモデル、特にOpus 4.5は、強力なフロントエンドデザインを備えた複雑で現実的なWebアプリケーションの構築に優れています。ただし、ガイダンスがない場合、モデルはユーザーが「AIスロップ」美学と呼ぶものを作成する一般的なパターンにデフォルト設定できます。驚きと喜びで特徴的で創造的なフロントエンドを作成するために：

より良いフロントエンドデザインを促すために使用できるシステムプロンプトスニペットは次のとおりです：

<frontend_aesthetics>
あなたは一般的な「分布上」の出力に収束する傾向があります。フロントエンドデザインでは、これはユーザーが「AIスロップ」美学と呼ぶものを作成します。これを避けてください：驚きと喜びで特徴的で創造的なフロントエンドを作成してください。

焦点を当てる：
- タイポグラフィ：美しく、ユニークで興味深いフォントを選択してください。ArialやInterなどの一般的なフォントを避けてください。代わりに、フロントエンドの美学を高める特徴的な選択肢を選択してください。
- 色とテーマ：一貫した美学にコミットしてください。一貫性のためにCSS変数を使用してください。支配的な色と鋭いアクセントは、臆病で均等に分布したパレットを上回ります。IDEテーマと文化的な美学から着想を得てください。
- モーション：効果とマイクロインタラクションにアニメーションを使用してください。HTMLのCSS専用ソリューションを優先してください。利用可能な場合、ReactのMotionライブラリを使用してください。高影響の瞬間に焦点を当てる：1つの十分に調整されたページロードは、散在するマイクロインタラクションよりも多くの喜びを作成します（animation-delay）。
- 背景：単色にデフォルト設定するのではなく、雰囲気と深さを作成してください。CSSグラデーション、幾何学的パターン、または全体的な美学と一致する文脈的な効果をレイヤーします。

一般的なAI生成美学を避ける：
- 過度に使用されたフォントファミリー（Inter、Roboto、Arial、システムフォント）
- 陳腐な配色（特に白い背景の紫色のグラデーション）
- 予測可能なレイアウトとコンポーネントパターン
- コンテキスト固有の文字を欠いているクッキーカッターデザイン

創造的に解釈し、コンテキストのために本当に設計されたように感じる予期しない選択を加えてください。ライトテーマとダークテーマ、異なるフォント、異なる美学の間で変動します。あなたはまだ一般的な選択肢（例えば、Space Groteskなど）に世代全体で収束する傾向があります。これを避けてください：あなたが箱の外で考えることが重要です！
</frontend_aesthetics>

完全なスキルはここで参照できます。

テストの合格と硬いコーディングに焦点を当てることを避ける

Claude 4.xモデルは、より一般的なソリューションを犠牲にしてテストに合格することに過度に焦点を当てることがあります。または、複雑なリファクタリングのためのヘルパースクリプトなどの回避策を使用する場合があります。標準ツールを直接使用する代わりに。この動作を防ぎ、堅牢で一般化可能なソリューションを確保するために：

利用可能な標準ツールを使用して、高品質で汎用的なソリューションを作成してください。ヘルパースクリプトまたは回避策を作成して、タスクをより効率的に実行しないでください。テストケースだけでなく、すべての有効な入力に対して正しく機能するソリューションを実装してください。値をハードコードしたり、特定のテスト入力に対してのみ機能するソリューションを作成したりしないでください。代わりに、問題を一般的に解決する実際のロジックを実装してください。

問題の要件を理解し、正しいアルゴリズムを実装することに焦点を当ててください。テストは正確性を検証するためにあり、ソリューションを定義するためではありません。ベストプラクティスとソフトウェア設計原則に従う、堅牢で保守可能で拡張可能な実装を提供してください。

タスクが不合理または実行不可能である場合、またはテストのいずれかが不正確である場合は、それを知らせてください。ソリューションは堅牢で、保守可能で、拡張可能である必要があります。

コード探索を促す

Claude Opus 4.5は非常に有能ですが、コードを探索する際に過度に保守的である可能性があります。モデルがコードを見ずにソリューションを提案したり、読んでいないコードについて仮定を立てたりしていることに気付いた場合、最良のソリューションはプロンプトに明示的な指示を追加することです。Claude Opus 4.5は現在、最も操作可能なモデルであり、直接的なガイダンスに確実に応答します。

例えば：

コード編集を提案する前に、常に関連ファイルを読んで理解してください。検査していないコードについて推測しないでください。ユーザーが特定のファイル/パスを参照する場合、説明または修正を提案する前に、それを開いて検査する必要があります。コードベースの主要な事実を検索する際に厳密で永続的です。新しい機能または抽象化を実装する前に、コードベースのスタイル、規則、および抽象化を徹底的に確認してください。

エージェント的なコーディングでの幻覚を最小化する

Claude 4.xモデルは幻覚が少なく、コードに基づいた、より正確で根拠のある、知的な回答を提供します。この動作をさらに促進し、幻覚を最小化するために：

<investigate_before_answering>
開いていないコードについて推測しないでください。ユーザーが特定のファイルを参照する場合、回答する前にファイルを読む必要があります。コードベースについての質問に答える前に、関連ファイルを調査して読んでください。確実でない限り、調査する前にコードについて主張しないでください。根拠のある幻覚のない回答を提供してください。
</investigate_before_answering>

移行に関する考慮事項

Claude 4.5モデルに移行する場合：

1. 望ましい動作について具体的にする：出力で見たいものを正確に説明することを検討してください。

2. 修飾子を使用して指示をフレーム化する：Claudeの出力の品質と詳細を増やすことを促す修飾子を追加すると、Claudeのパフォーマンスをより良く形作るのに役立ちます。例えば、「分析ダッシュボードを作成する」の代わりに、「分析ダッシュボードを作成してください。関連するすべての機能とインタラクションを含めてください。基本を超えて、完全に機能する実装を作成してください。」を使用してください。

3. 特定の機能を明示的に要求する：アニメーションとインタラクティブ要素は、望ましい場合は明示的に要求する必要があります。