Claude Opus 5のプロンプティング

このガイドでは、Claude Opus 5に固有のプロンプティングパターンを取り上げます。モデルの機能とAPIの変更点については、Claude Opus 5の新機能を参照してください。現行のすべてのClaudeモデルに適用されるテクニックについては、プロンプティングのベストプラクティスを参照してください。

Claude Opus 5は、複雑なエージェント型コーディングとエンタープライズ業務のために構築されており、特に長期的なエージェント型タスクに強みがあります。既存のClaude Opus 4.8向けプロンプトでも、そのままで良好に動作します。以下のパターンでは、調整が必要になることが最も多い動作を取り上げます。

機能の向上

Claude Opus 4.8と比較して、プロンプティングに最も関連する改善点は次のとおりです。

• エージェント型コーディング： Claude Opus 5は、複数ファイルにまたがる機能、大規模なリファクタリング、エンドツーエンドの機能開発といった難しいコーディングタスクで最も力を発揮します。スタブやプレースホルダーを残すのではなくタスク全体を完了させ、完全なタスク仕様を最初に与えてそのまま実行させた場合に最高のパフォーマンスを発揮します。シングルターンの編集のような簡単なタスクでも良好に動作しますが、その場合は以前のモデルとの差は小さくなります。
• コードレビューとバグ発見： Claude Opus 5は高い精度（precision）と再現率（recall）でコードをレビューします。1回のパスあたり高い割合で実際のバグを発見し、追加で見つけた指摘も誤検知ではなく大半が実際の問題です。低いエフォート設定でも正確性が維持されるため、レビュー時に高速なパスを行い、後でより徹底的なパスを行うという運用が可能です。レビュー用プロンプトに「重大度の高い問題のみを報告する」や「保守的に判断する」と書かれている場合、モデルはその指示を文字どおりに守って報告を減らす可能性があります。代わりに、すべてを報告させて別のパスでフィルタリングするようにしてください。
• 低エフォートでの効率性： lowおよびmediumのエフォートは、より高い設定と比べてごく一部のトークンとレイテンシで高い品質を生み出します。デフォルト（high）から始めて、評価結果に基づいて調整してください。品質が維持される場面では、トークンコストと応答時間の主要な制御手段としてlowとmediumを積極的に使用し、要求の厳しいコーディングやエージェント型の作業ではxhighに引き上げてください。以前のモデルからエフォートのデフォルト値を引き継いでいる場合は、独自の評価でエフォートのスイープを再実行してください。推奨事項の全体については、エフォートを参照してください。
• ビジョン： Claude Opus 5は、チャート、ドキュメント、図の理解、およびUIやフロントエンドの視覚的な再現に優れています。以前のモデル向けに調整したプロンプト側のビジョン回避策は再検証してください。もはや不要になっている可能性があります。ビジョンのパフォーマンスは、モデルが作業を反復的に分析、クロップ、視覚的に検証するためのツールを持っている場合に最も高くなり、ツール使用は思考単独よりもコスト効率の高い手段です。
• 長文コンテキストでの作業： Claude Opus 5は、デフォルトかつ最大値として100万トークンのコンテキストウィンドウ（context window）を備えており、指示への追従、ツール呼び出し、推論はウィンドウ全体を通じて一貫性を保ちます。
• オフィスおよびドキュメントタスク： Claude Opus 5は、複雑な数式を含む複数シートのスプレッドシートを生成・操作でき、構成の整ったスライドデッキを作成します。従うべき特定のスタイルやテンプレートがあれば、プロンプトで指定してください。
• マルチエージェントの調整： Claude Opus 5はサブエージェントのチームをうまく調整し、効果的なライター・ベリファイアパターンを実現し、エージェント同士が互いの作業を上書きするケースはほとんどありません。コストに敏感なワークロードでは、委任に上限を設けてください。サブエージェント生成の制御を参照してください。

応答の長さと冗長性

Claude Opus 5のデフォルトのユーザー向け応答は、以前のOpusモデルよりも長くなります。エフォートパラメータは、モデルがどれだけ話すかではなく、どれだけ思考するかを制御します。エフォートを下げると思考量は減りますが、目に見える応答が確実に短くなるわけではありません。応答の長さを制御するには、明示的にプロンプトで指示してください。

簡潔さを求める短い指示が効果的です。たとえば、ユーザー向けのマルチターン製品の場合は次のようにします。

Keep responses focused, brief, and concise. Keep disclaimers and caveats short, and spend most of the response on the main answer. When asked to explain something, give a high-level summary unless an in-depth explanation is specifically requested.

長いシステムプロンプトでは、この指示に加えて、プロンプトの末尾近くに短いリマインダーを置いてください。

<tone_preference>
Keep outputs reasonably concise.
</tone_preference>

ユーザー向けの進捗報告

Claude Opus 5はエージェント型の作業中に積極的にナレーションを行います。これから行うことを告知する傾向があり、エージェント型セッションにおけるメッセージごとの出力は以前のモデルよりも長くなることがよくあります。タスク中にユーザーとどのようにコミュニケーションすべきかについて、明示的なガイダンスを与えると効果があります。ナレーションを抑えるには、望ましい頻度と形式を記述してください。

Before your first tool call, say in one sentence what you're about to do. While working, give a brief update only when you find something important or change direction. When you finish, lead with the outcome: your first sentence should answer "what happened" or "what did you find," with supporting detail after it for readers who want it.

ナレーションを増やしたり、そのスタイルを変えたりする場合も、同じ手段が逆方向に適用できます。報告がどのようなものであるべきかを明示的に記述し、例を示してください。望ましいコミュニケーションスタイルの肯定的な例は、何をすべきでないかについての指示よりも効果的な傾向があります。

文書成果物の長さ

会話上の冗長性とは別に、Claude Opus 5がディスクに書き出すファイル（レポート、Markdownドキュメント、要約）は、以前のモデルよりも長くなることがよくあります。製品にClaudeが作成するドキュメントが含まれる場合は、長さの明示的な調整指示を追加してください。

Match the length of written documents to what the task needs: cover the substance, but do not pad with filler sections, redundant summaries, or boilerplate.

タスクのスコープと過剰な検証

Claude Opus 5は、指示されなくても自身の作業を検証します。プロンプトに明示的な検証指示（「重要なタスクには必ず最終検証ステップを含める」「サブエージェントを使って検証する」など）が含まれている場合は、削除してください。このような指示はClaude Opus 5では過剰な検証を引き起こし、削除することで品質を損なうことなく無駄なトークンを削減できます。別個の検証ステップを追加する旧来のハーネスのスキャフォールディングについても同様です。

Claude Opus 5は、要求されていないステップを追加したり、タスクがどうあるべきかについて独自の判断を適用したりして、タスクのスコープを拡大することもあります。範囲の狭いタスクでは、スコープを明示的に制約してください。

Deliver what was asked, at the scope intended. Make routine judgment calls yourself, and check in only when different readings of the request would lead to materially different work. If the request seems mistaken or a better approach exists, say so in a sentence and continue with the task as asked rather than quietly narrowing, widening, or transforming it. Finish the whole task, and stop short of actions that are clearly beyond what was asked.

サブエージェント生成の制御

Claude Opus 5は、以前のモデルよりも積極的にサブエージェントに委任します。委任は、真に独立した相当規模の作業トラックでは効果を発揮しますが、小さなタスクに適用するとコストと時間が何倍にも膨らみます。ハーネスがサブエージェントをサポートしている場合は、どのようなシナリオで委任が妥当かについて明示的なガイダンスを与えるか、起動できるエージェント数に決定論的な上限を設定してください。たとえば次のようにします。

Delegate to a subagent only for large tasks that are genuinely independent and parallelizable, such as a wide multi-file investigation. Do not delegate work you can finish yourself in a handful of tool calls, and do not use subagents to verify or double-check your own work. If one subagent can complete the task, use one rather than several, and keep spawn counts low.

ハーネスがClaude CodeまたはClaude Agent SDKである場合、決定論的な上限は環境変数CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTHおよびCLAUDE_CODE_MAX_CONCURRENT_SUBAGENTSと、SDKのmax_budget_usdオプションです。これらにはClaude Code 2.1.217以降が必要なため、バージョンを固定しているSDKはClaude Opus 5に向ける前に更新してください。Claude Codeは、claude_codeシステムプロンプトプリセットを使用している場合にのみ、Claude Opus 5に対して独自の委任指示を追加します。カスタムのシステムプロンプトを使用している場合やシステムプロンプトを省略している場合は、このセクションの例のような委任指示を自分で追加してください。Agent SDKドキュメントのサブエージェントの深さ、同時実行数、支出に上限を設けるを参照してください。

自己修正

Claude Opus 5は、プロンプトで指示しなくても自身のミスをうまく発見して修正します。すでに行っている再確認を指示すること（「答えをダブルチェックする」「応答前に再検証する」など）は避けてください。検証指示と同様に、これらはモデル自身の動作と重複し、結果を改善することなくコストを増やします。

また、このモデルは以前のモデルよりも、自身の以前の発言に対する訂正をナレーションすることが多く、これはユーザー向け製品では望ましくない場合があります。訂正のナレーションを重要な訂正に限定するには、次のようにします。

Only correct an earlier statement when the error would change the user's code, conclusions, or decisions. State corrections plainly and briefly, then continue the task. For slips that change nothing for the user, make the fix and move on without noting it.

思考を無効にして実行する

Claude Opus 5はデフォルトで思考がオンの状態で実行され、思考を無効にできるのはエフォートがhigh以下の場合のみです。移行ガイドを参照してください。思考を無効にすると、モデルの目に見える出力に2種類のアーティファクトがまれに現れることがあります。どちらに対しても主な緩和策は、思考を無効にするのではなく、思考を有効にしたまま低いエフォートレベルでトークンコストを制御することです。ほとんどのタスクでは、lowエフォートで思考を有効にした方が、同程度のコストで思考を無効にした場合よりも優れたパフォーマンスを発揮します。

テキストとしてのツール呼び出し。 思考を無効にすると、モデルは構造化されたtool_useブロックを出力する代わりに、ツール呼び出しをユーザー向けテキストに書き込んでしまうことがまれにあります。ターンは正常に完了しますが呼び出しは実行されず、エージェント型ループでは漏れ出たテキストが会話履歴に残るため、後続のターンにも影響します。これは検索のようなツールを多用するワークロードで最もよく発生します。

出力内の内部XMLタグ。 思考を無効にすると、モデルが<thinking>タグやその他の内部XMLタグを目に見える応答に出力することがあります。システムプロンプトに、モデルに思考しないよう、または推論しないよう指示するルールが含まれている場合は、削除してください。そのような指示はタグの漏出を増加させます。

思考を無効にしておく必要があるインテグレーションでは、1つの統合された指示で両方のアーティファクトを緩和できます。この指示は、ツール呼び出しの前に発言する明示的な許可、適合するツールがない場合に呼び出しを強行する代わりの選択肢、および内部タグに対する一般的なルールをモデルに与えます。

When you use a tool, you may say a brief sentence first. If no tool can express what the user asked for, say so instead of guessing. Do not include internal or system XML tags in your response.

思考タグを名指しする指示は一般的な形式よりも効果が低いため、具体的に名前を挙げることは避けてください。