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

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

一般的な原則

指示を明確にする

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

コンテキストを追加してパフォーマンスを向上させる

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

Claudeは説明から一般化するのに十分な知能があります。

例と詳細に注意を払う

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

長期的な推論と状態追跡

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

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

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に作物ツールまたはスキルを与えることです。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. 特定の機能を明示的に要求する：アニメーションとインタラクティブ要素は、望ましい場合は明示的に要求する必要があります。

検証ツールを提供する：自律的なタスクの長さが増すにつれて、Claudeは継続的な人間のフィードバックなしに正確性を検証する必要があります。Playwright MCPサーバーやUIテスト用のコンピュータ使用機能などのツールが役立ちます。