HN 日本語サマリー

← 一覧へ戻る
AI・機械学習

Prompting Claude Opus 5.5

Prompting Claude Opus 5.5 (platform.claude.com)

207 pointsby Michelangelo11225 コメント

要約

この記事は、AnthropicのClaude Opus 5.5モデルに効果的に指示を与えるためのプロンプトエンジニアリングガイドです。Opus 5.5は、Opus 5と比較して高速化、トークン効率の向上、およびエージェント的なコーディングや知識作業における能力強化が特徴です。ガイドでは、モデルの「思考」の管理、プロンプトキャッシュの活用、および視覚情報の処理能力向上に焦点を当てた具体的なプロンプトパターンについて説明しています。

全文翻訳

Claude Opus 5.5 のプロンプトエンジニアリング

Claude Opus 5 との挙動の違い、およびそれに対応するプロンプトとハーネスのパターン:努力量の調整、API統合やチャットでの思考挙動、進捗アップデート、無人タスクおよびマルチエージェントタスク、セーフガード拒否、フロントエンド設計、複雑な視覚入力、マルチアプリワークフロー、ユーザーメッセージ内の貼り付けテキスト。

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

Claude Opus 5.5 は、Claude Opus 5 よりも30%以上高速にアウトプットトークンを生成し、同じタスクをより少ないトークンで完了する傾向があります。既存のClaude Opus 5 プロンプトは変更なしで良好に機能するはずであり、Claude Opus 5 のプロンプトのパターンは引き続き妥当な出発点となります。観察された内容に一致するセクションから始めてください:

プロンプトエンジニアリングに関連する機能

プロンプトエンジニアリングで最も重要な機能は以下の通りです:

  • エージェントコーディングとコードレビュー: モデルは、実際のコードリポジトリでの複数ステップの作業、例えばテストがパスするまで大規模なコードベースに変更を適用する作業に最も強みを発揮します。Anthropicのテストでは、デフォルトのmedium努力量で、Opus 5のhigh努力量と同等以上のパフォーマンスを、より少ないステップとトークンで達成しました。また、数時間にわたる監査や大規模コードベースの移行など、並列サブエージェントを使用し、ほとんど監視なしでエンドツーエンドで実行される、長期間の自律的な作業をOpus 5よりも良好に維持します。初期テスターからは、コードレビューの精度も向上し、Opus 5よりも多くのバグを検出し、誤検知が少なくなったという報告もあり、変更点も平易な言葉で説明します。
  • ナレッジワーク: モデルは、誤った数値を述べたり、誤ったソースを引用したりする可能性が大幅に低くなりました。財務モデリングタスク(例えば、トランザクションの財務モデルと1ページ要約の構築、評価ワークブックのエラーの発見と修正など)に優れており、長い計画スレッド内の日付が間違った曜日になる、スライドデッキ内のチャートが基になる数値と一致しないなど、大きな入力で見落としがちな詳細を捉えます。生成されるスプレッドシート、スライド、ドキュメントは、共有前に編集が必要な量が少なくなります。
  • コミュニケーション: エージェント作業に関するレポート(作業中のアップデートと完了時の要約の両方)は、何を行ったか、何を発見したか、何が必要かを平易に伝えます。ユーザー向け進捗アップデートを参照してください。
  • チャート、ダイアグラム、スクリーンショット、コンピューター操作: モデルは、追加のツールなしでOpus 5よりも正確に視覚素材を読み取ります。Anthropicのテストでは、最低努力量設定でも、Opus 5の最高努力量設定よりも密なチャートの値の読み取り精度が高く、出力トークンはごくわずかでした。意味がテキストよりも位置に依存する場合(フローチャートの矢印がどのボックスに接続されているか、ダイアグラムの2つのバージョンの違い、カレンダースクリーンショットでの会議の開始・終了時刻など)や、スクリーンショットからの複数ステップにわたるアプリケーション操作(デフォルト努力量でOpus 5のより高い努力量設定でしか達成できなかった成功率に匹敵)でも、より信頼性が高くなっています。複雑な視覚入力のためのツールを参照してください。

努力量の調整

努力量は、Claude Opus 5.5 がどれだけ思考するかを制御する主要な要素であり、思考は常にオンになっているため、知能、レイテンシ、コストのトレードオフを調整する最初の設定となります。medium(Claude Opus 5.5 のデフォルト、Claude Opus 5 は high がデフォルト)から始め、明示的に設定し、Claude Opus 5 で使用した設定を引き継ぐのではなく、独自の評価基準で複数のレベルをテストしてください。努力量レベルの名前は、モデル間で同じ量の思考に対応するわけではありません。Anthropicのテストでは、Claude Opus 5.5 の medium は、コーディングとナレッジワークの評価において、Claude Opus 5 の high に匹敵するかそれを超え、いくつかのコーディング評価では low がはるかに低いコストでそれに近い結果を出しています。Claude Opus 5.5 の推奨努力量レベルを参照してください。

指定されたレベルでは、Claude Opus 5.5 は Claude Opus 5 よりも1ターンあたりの思考量が多くなる傾向があります。特に xhigh と max の場合です。Claude Opus 5 で設定していた effort 値を維持すると、より長いターンとより多くの出力トークンが予想されます。以下の3つの調整が役立ちます:

  • max_tokens を、モデルの思考トークンと応答のための十分なスペースを残すように高く設定してください。思考は、思考内容が返されない場合でも max_tokens にカウントされるため、思考オフのClaude Opus 5用にサイズ設定された制限では、応答が途中でカットされる可能性があります。エージェントコーディングが生成する長いターンでは、モデルの最大値である128,000 max_tokens がAnthropicのテストで良好に機能しています。
  • xhigh と max は、品質向上が測定された作業にのみ予約してください。
  • 思考量を減らすには、まず努力量レベルを下げてください。努力量を下げることは、プロンプト指示よりも確実に思考量、ひいてはコストとレイテンシを削減します。

リクエスト間でトップレベルの effort 値を変更すると、プロンプトキャッシュが無効になります。会話の途中でレベルを変更するには、代わりにメッセージごとの努力量変更(ベータ版)を使用してください。これによりキャッシュが維持されます。変更は、別の変更によって上書きされるまで、それ以降のすべてのターンに適用されます。

思考無効で記述されたプロンプト

Claude Opus 5 は high 努力量以下で thinking: {"type": "disabled"} を受け入れましたが、Claude Opus 5.5 は受け入れません。移行ガイド (migration guide) にリクエストの変更について記載されています。Claude Opus 5 の統合が思考無効で実行されていた場合、以下の4つの変更が伴います:

  • low 努力量から開始し、測定する。 low では、モデルは思考を短く保ちます。思考を完全にスキップする頻度はプロンプトに依存するため、独自のトラフィックでレイテンシと品質を測定し、品質が低下した場合は medium に移行してください。それでも最初のトークンまでの時間が重要な場合は、「熟考せずに直接回答してください。」のようなシステムプロンプト行が思考をさらに減らすことができます。追加する際は品質を測定してください。思考量が少ないと品質が低下する可能性があります。
  • 思考の代わりに行っていた指示を削除する。 プロンプトでモデルに応答内に推論を記述させるように指示していた場合、その指示を削除し、代わりに要約された思考ブロックから推論を読み取ってください(display: "summarized")。モデルに応答テキストに推論を再現させるプロンプトは、reasoning_extraction拒否カテゴリで拒否される可能性があります。
  • 思考無効の緩和策を再テストする。 思考無効での実行では、複合指示(ツール呼び出しの前に話す許可、ツールが適合しない場合の対処法、内部タグなし)と、思考しないように指示するルールを削除することを推奨しています。どちらも、思考が無効な場合にのみClaude Opus 5に現れるアーティファクトに対処します。思考が常にオンになっているため、その指示がまだ必要かどうかを確認し、いずれにしても思考しないルールを削除してください。
  • ブロックタイプごとに応答を読む。 最初のコンテンツブロックがテキストであると仮定せず、各ブロックのタイプを確認してください。応答は、thinking フィールドがデフォルトの display: "omitted" では空である thinking ブロックで始まる場合と始まらない場合があります。

無人エージェント実行

複数の部分からなる長いタスクでは、Claude Opus 5.5 は作業中にユーザーに進捗を通知します。これらの通知の一部は、ツール呼び出しではなくテキストでターンを終了します(stop_reason: "end_turn")。このようなターンをタスクの終了と見なす無人エージェントループは、そこで実行を停止します。いくつかのハーネスとプロンプトの変更が、実行を継続させるのに役立ちます。

テキストのみで終了したターンを、タスク完了の証拠ではなくレポートとして扱ってください。タスクの各部分を、モデルが更新するチェックリスト(ToDoツールやファイルなど)に保持してください。ターンがアイテムが未完了のまま終了し、ブロッカーが示されていない場合は、それらを名前付けした短いユーザーメッセージを送信してください。例:。また、完了条件を事前に設定し、各ターンの終了時に別の、より小さなモデルが会話をそれに対してチェックし、条件が満たされない場合にその理由を次のユーザーメッセージとして返すこともできます。いずれにしても、同じタスクで2〜3回の自動継続の後に停止してください。これにより、実際に行き詰まった実行が終了し、レビューできるようになります。

モデルが開始した何かがまだ実行中の場合(バックグラウンドコマンドやサブエージェントなど)、タスクは完了したと見なさないでください。それが完了し、その出力を次のユーザーメッセージとしてモデルに返すまで待ってください。

システムプロンプトへの追加も、これらの早期停止を少なくすることができます。Claude Opus 5.5 は、早期停止の特定の種類の回避を指示する命令に敏感です。例えば、次のステップを発表する要約でターンを終了するのではなく、そのステップを実行するように指示する場合などです。また、必要な停止を明示することも役立ちます。例えば、ユーザーの入力なしでは作業が進まない場合などです。

次の段落は、そのような追加の例であり、完全に無人で実行されるエージェント向けに書かれており、モデルにレポートのために停止するのではなく、作業を継続させたい場合に役立ちます。これを開始点として扱ってください。独自のアプリケーションに合わせて調整する必要があるかもしれません。セッションの最初の要求のシステムプロンプトの末尾に追加してください。途中で追加すると、system プロンプトが変更され、会話の以前の思考ブロックが無効になります(保存された思考を参照)。これにより、モデルはステータスメモを次のツール呼び出しと同じメッセージに入れるように指示されるため、それらのメモはツール呼び出しの間に進捗アップデートとして到着します。デフォルトの thinking.display ではそのテキストは空になります。各要約を受け取るには display: "updates" を設定してください(ユーザー向け進捗アップデートを参照)。この追加により、モデルは本来停止してチェックインしていた場所から続行するため、危険または不可逆的なアクションについては独自の確認ステップを維持し、人間参加型アプリケーションではこの追加を省略してください。タスクあたりのツール呼び出しと出力トークンが若干増加することが予想されます。

セーフガード拒否

Claude Opus 5.5 は、生物学、サイバーセキュリティ、推論抽出を含む安全分類器を実行します。

  • 生物学: 生物学のセーフガードは Claude Fable 5.1 と同じであり、Claude Opus 5 から移行した場合は新しいものです。日常的な健康や教育に関する質問には影響しません。生物学分類器が組織のライフサイエンス作業の妨げになる場合は、ライフサイエンス検証プログラムに申請してください。
  • サイバーセキュリティ: ソースコードの脆弱性の発見は許可されています。高リスクのデュアルユースサイバーセキュリティ活動は許可されていません。サイバーセキュリティ分類器が組織の正当なセキュリティ作業の妨げになる場合は、サイバー検証プログラムに申請してください。
  • 推論抽出: モデルに内部推論を応答テキストに再現させるように要求するリクエストは、reasoning_extraction カテゴリで拒否される可能性があります。プロンプトでモデルに応答内に推論を記述するように求めている場合は、その指示を削除し、display: "summarized" を設定し、代わりに思考ブロックから要約された推論を読み取ってください。思考無効で記述されたプロンプトを参照してください。回答の短い説明や実行されたアクションの要約を求めることは引き続き可能です。思考ブロック内に推論を保持を参照してください。

分類器による拒否は、stop_reason: "refusal" とカテゴリ名を指定する stop_details オブジェクトを持つ通常の応答として到着します。reasoning_extraction 拒否を除き、フォールバックモデルでリクエストを自動的に再試行させることができます。サーバーサイドフォールバックは、再試行する代わりにあなたに返します。拒否とフォールバックを参照してください。

ユーザー向け進捗アップデート

ツール呼び出しの間、Claude Opus 5.5 は短いユーザー向け進捗アップデートを作成します。何を発見し、次に何をしているかです。ユーザーが見るものを制御する4つのレバーがあります。

第一に、クライアントがそれらを受信することを確認してください。Claude Opus 5.5 では、これらのメモは text ブロックではなく、進捗アップデート thinking ブロックとして返され、デフォルトの thinking.display ではテキストが空になるため、text ブロックのみをレンダリングするクライアントは、長いエージェントターン中にサイレントに見える可能性があります。各メモの短い要約を受け取るには display: "updates"(ベータ版、thinking-display-updates-2026-08-18 ヘッダー)を設定してください。移行ガイドにレンダリング方法が示されています。

第二に、モデルが長いターンの途中でコードスニペットなど、ユーザーにそのまま渡す必要があるものを手渡す可能性がある場合は、ユーザーにメッセージを送信するための簡単なツールを提供し、そのコンテンツのためにそのツールを予約するように指示してください。セッションの最初の要求から tools でツールを宣言してください。後から tools に追加すると、会話のプレフィックスが編集され、以前の思考ブロックが無効になります(保存された思考を参照)。

第三に、より頻繁または予測可能なアップデートが必要な場合(例えば、最初のツール呼び出し前の1行の意図表明や、終了時の短い要約など)、システムプロンプトでそれを指定してください。モデルはこのような指示に敏感です。これは人間参加型の作業で最も役立ちます。

第四に、長いツール呼び出しターンがまだ長すぎる間サイレントな場合、ハーネスに進捗を要求させてください。display: "updates" を設定した場合(最初のレバー)、ユーザーに何も読ませない連続したツール呼び出しステップ(text ブロックも進捗アップデートのテキストもない)を数えてください。数回連続した後(例えば5回)、最新のツール結果の後に、ターン限定システムメッセージ(clear_at: "next_user_message"、ベータ版、mid-conversation-system-clear-at-2026-08-21 ヘッダー)として、以下のようなリマインダーを追加してください。ターンがサイレントなままであれば、それ以上送信するのではなく、2〜3回のリマインダーの後に停止してください。各リマインダーは追加され、そのまま残されるため、1回の要求で挿入され、次の要求で削除されるのではなく、プロンプトキャッシュが一致し続け、それに続く思考ブロックは有効なままです。Anthropicのエージェントコーディングタスクでのテストでは、これにより長いサイレント期間のあるタスクの割合が約半分になり、コストへの測定可能な変化はありませんでした。

マルチアプリワークフローでのコンテキスト探索

メール、ドキュメント、スプレッドシート、CRMレコードなど、複数の接続されたアプリにまたがるワークフロー自動化では、タスクが依存する情報は、リクエストで明示的に言及されていない場所にしばしば存在します。例えば、古いメールスレッドのポリシー、別のスプレッドシートタブのルール、顧客レコードのメモなどです。Claude Opus 5.5 は迅速に作業を開始する傾向があり、曖昧に指定されたタスクでは、アクションを起こす前に関連ソースを調べるように指示すると役立ちます。エージェントがこのようなタスクで複数のアプリにまたがって作業する場合、システムプロンプトに1文追加することで、何かを変更する前に周囲を調べさせることができます:

Anthropicのマルチアプリ自動化タスクでのテストでは、Claude Opus 5.5 はこの指示により、medium と max の両方の努力量で、より多くのタスクを正確に完了しました。ツール呼び出しとトークンはわずかに増加しました。モデルに発見したことに行動させるように指示するため、検索するレコードには信頼できないコンテンツを含めないでください。

マルチエージェントハーネスの時間シグナル

Claude Opus 5.5 は経過時間に関する情報に細心の注意を払います。例えば、サブエージェントに委任するリードエージェントのようなマルチエージェント設定では、より良い並列化を通じて作業を迅速化するためにそれを使用できます。タスクにかかる時間を見積もることができる場合は、モデルに時間予算を与えてください。ハーネスがモデルに送信する各メッセージの最後に、予算に対する経過時間を秒単位で示す短い行を追加してください。例:elapsed 340s / 1200s。モデルは予算内で完了するように作業ペースを調整し、通常は予算よりもかなり早く完了するため、予算は実際に費やしたい時間よりもやや高く設定し、独自のタスクのサンプルで調整してください。合理的な予算を予測できない場合は、経過時間のみを表示し、システムプロンプトに1文追加してください:

Anthropicの小規模エージェントチームによるリサーチタスクの評価では、両方のシグナルにより、それらなしで作業する単一エージェントよりも早く完了しました。予算を与えられたチームは、単一エージェントと同等の回答品質を維持しながら、大幅に早く完了しました。より厳しい予算は、低い努力量設定とは異なる効果を持ちます。努力量を下げることは作業自体を削減しますが、予算は主に複数のエージェントを並列で稼働させ続けます。予算は助言的なものであり、モデルが制限で停止することはありません。したがって、ハードストップが必要な場合は、独自のタイムアウトを維持してください。時間的プレッシャーの下では、モデルが検索と検証を少し減らす可能性があるため、独自のタスクで回答品質も確認してください。

チャットシステムプロンプトでの思考指示

チャットアプリケーションで、システムプロンプトに回答前に慎重に考えるように指示する命令が含まれている場合、Claude Opus 5.5 では削除を検討してください。モデルは思考量を決定し、努力量が主要な制御手段です。Anthropicのチャット製品でのテストでは、そのような行を削除すると応答が早く開始され、応答品質の明確な低下はありませんでした。

マルチターンチャットでは、Claude Opus 5.5 は、短いフォローアップメッセージであっても、新しいメッセージについて考えている間に以前の回答を再確認することがあり、後続のターンで思考とレイテンシが増加します。モデルに以前の回答を確定済みとして扱わせたい場合は、システムプロンプトの末尾に2文追加してください:

Anthropicのテストでは、これによりフォローアップターンの思考が減少し、品質に影響を与えることなく応答が早く開始されました。長い分析や、後続のステップで以前のステップの間違いを明らかにできるエージェントタスクのように、モデルに以前の作業を再検討させたい場合は省略してください。この指示は、モデルが自分から以前の回答の間違いを指摘する可能性を低くする可能性もあるため、アプリケーションでそれが重要であれば、採用する前にテストしてください。

ユーザーメッセージ内の貼り付けテキストのマーク付け

Claude Opus 5.5 は、ツール結果、ウェブページ、画面上またはブラウザコンテンツを通じて受信する間接的なプロンプトインジェクションに対して、以前のどのOpusモデルよりも良好に対処します。適切なコンテキストがあれば、ユーザーがメールやウェブページなどからコピーしてメッセージに貼り付けたコンテンツ内の指示に対しても堅牢です。その動作を得るには、ユーザー自身のテキストと、どこかから貼り付けられたテキストをマークしてください。各貼り付けブロックを、アプリケーションによって生成された同じ短いランダムIDを持つ開始タグと終了タグでラップし、各タグは独自の行に配置してください:

次に、システムプロンプトにこの注意書きを追加してください:

これにより、モデルは時折わずかに慎重になる可能性がありますので、独自のタスクでの影響を測定してください。タグはプレーンテキストであり、模倣される可能性があるため、これを他のプロンプトインジェクション防御策に沿ったガードレールの一つとして扱ってください。

複雑な視覚入力のためのツール

Claude Opus 5.5 は、ツールなしでClaude Opus 5よりも大幅に正確にチャート、ダイアグラム、スクリーンショットを読み取るため(プロンプトエンジニアリングに関連する機能を参照)、以前のモデル用に構築した視覚入力の足場がまだ必要かどうかを再テストしてください。最も密な入力に対しては、2つの要素が精度をさらに向上させます。高解像度の画像は、特に技術図面のような入力に役立ちます。画像処理ツールも同様です。モデルを、生の画像とPILやOpenCVなどのライブラリがインストールされたコンテナにアクセスできるエージェントとして実行し、クロップ、ズーム、測定、検証を行えるようにしてください。コンテナが過剰なオーバーヘッドである場合でも、クロップツールだけでも役立ちます。クロップツールレシピには動作定義があります。モデルはこれらのツールを、より高い努力量レベルでより効果的に使用します。ツールなしでは、努力量を上げても技術図面の読み取りは改善されますが、チャートへの影響はほとんどありません。

フロントエンド設計のデフォルト

設計の指示なしにフロントエンド作業を求められた場合、Claude Opus 5.5 はいくつかのデフォルトスタイルにフォールバックします。「一般的なAIの外観を避ける」のような一般的な指示は、ほとんどの場合、あるデフォルトを別のデフォルトに置き換えるだけです。これは、以下のような例のように、回避したい特定のパターンを名前で指定する指示によく応答します。イテレーションを繰り返してください。最初の結果が使用したスタイルを確認し、必要に応じてリストを拡張してください。