Claude Opus 5.5 プロンプトガイド：effort、エージェント、拒否、テンプレート

Claude Opus 5.5 にうまくプロンプトを書くには、Claude Opus 5 で使っていたプロンプトはそのまま残し、文言を変える前に effort レベルを設定し、そのうえで変えたい挙動ごとにシステムプロンプトへ的を絞った一文を加えます。Anthropic のガイドは、既存の Claude Opus 5 のプロンプトは「変更なしで良好に機能するはず」とし、effort は「知能、レイテンシ、コストのトレードオフで最初に調整すべき設定」だと述べています。新しいアドバイスの多くはエージェント向けです。無人での実行を止めないこと、長いターンから進捗報告を引き出すこと、複数エージェントのチームのペース配分です。以下はすべて Anthropic の「Prompting Claude Opus 5.5」ガイドとこのモデルの API リファレンスに基づくもので、2026 年 10 月 3 日に確認しました。

Claude Fable 5.1 と共通するリクエストのルール、たとえばアシスタントターンの事前記入（prefill）や temperature の独自設定ができないことは、Claude Fable 5.1 プロンプトガイドで解説しています。この記事では Claude Opus 5.5 固有の内容を扱います。

Claude Opus 5 のプロンプトは Claude Opus 5.5 でも使える？

使えます。Anthropic は「変更なしで良好に機能するはず」とし、Claude Opus 5 のプロンプトの書き方は「今も妥当な出発点」だとしています。変わったのは、モデルが思考にどう力を割くかです。Claude Opus 5.5 は Claude Opus 5 より 30% 以上速く出力トークンを生成し、同じタスクをより少ないトークンで終える傾向があります。

Anthropic はモデルが向上した 4 つの領域を挙げており、このガイドのどの部分があなたに関係するかはそれで決まります。

• エージェント型のコーディングとコードレビュー。 実際のリポジトリでの多段階の作業、サブエージェントを使った長時間の自律実行、そしてより多くのバグを見つけ誤検知の少ないコードレビュー。
• ナレッジワーク。 誤った数値を述べたり出典を間違えたりする可能性が大きく下がり、曜日が合わない日付のような大量の入力に紛れた小さな矛盾にも気づきます。
• コミュニケーション。 進捗報告と最終レポートで、何をしたか、何を見つけたか、あなたに何が必要かをはっきり伝えます。
• グラフ、図、スクリーンショット、コンピューター操作。 視覚的な資料を Claude Opus 5 より正確に読み取ります。最も低い effort でもそうです。

プロンプトが主にチャット用なら、effort とチャットの節を読めば十分です。エージェントを動かしているなら、新しいアドバイスはエージェントの節にあります。

Claude Opus 5.5 ではどの effort を使うべき？

medium から始めます。これが Claude Opus 5.5 のデフォルトです（Claude Opus 5 のデフォルトは high）。明示的に設定し、Claude Opus 5 で使っていた値を引き継ぐのではなく、自分のタスクで複数のレベルを試してください。effort の名前はモデルが違えば同じ思考量を意味しません。Anthropic のテストでは、medium の Claude Opus 5.5 は「コーディングとナレッジワークの評価で high の Claude Opus 5 に並ぶか上回り」、いくつかのコーディング評価では low でもそれに迫り、コストははるかに低く済みました。

medium を明示的に設定するのは、effort を省略するのとまったく同じ動作です。

同じレベルでも、Claude Opus 5.5 は 1 ターンあたり Claude Opus 5 より多く考える傾向があり、xhigh と max では特にそうです。次の 3 点に注意してください。

• max_tokens に余裕を持たせる。 思考の内容が見えなくても思考は max_tokens に含まれるため、Claude Opus 5 で思考を無効にしていたときの上限では返答が途中で切れることがあります。長いエージェント型コーディングのターンでは、モデルの上限である 128,000 に max_tokens を設定するとうまくいったと Anthropic は報告しています。
• 「あまり考えないで」と書く前に effort を下げる。 effort を下げるほうが、プロンプトでの指示よりも確実に思考、コスト、レイテンシを減らせます。
• プロンプトキャッシュに頼るなら effort を固定する。 リクエストごとにトップレベルの effort の値を変えると、プロンプトキャッシュが無効になります。

effort は output_config で設定します。

{
  "model": "claude-opus-5-5",
  "max_tokens": 128000,
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Review this pull request for bugs and explain each one."}]
}

Claude Opus 5.5 で思考をオフにできる？

できません。Claude Opus 5 は high 以下の effort で "thinking": {"type": "disabled"} を受け付けましたが、Claude Opus 5.5 は受け付けず、そのリクエストは 400 エラーになります。思考はアダプティブで常にオンです。思考を無効にして使っていたなら、Anthropic は 4 つの変更を勧めています。

1. low の effort から始めて測定する。 low ではモデルの思考は短くなります。それでも最初のトークンまでの時間が重要なら、システムプロンプトに「Answer directly without deliberating.」のような一文を加えると思考をさらに減らせますが、加えたら品質を確認してください。
2. 思考の代わりにしていた指示を削除する。 プロンプトで推論を返答に書き出すよう求めていたなら、その一文を消し、推論は要約された思考から読み取ります。推論を返答で再現させようとするプロンプトは、拒否される場合があります（後述の拒否の節を参照）。
3. 以前の回避策を再テストする。 思考なしで動かしたときの不具合を避けるために加えたルールは、もう不要かもしれません。モデルに考えないよう指示するルールは削除してください。
4. ブロックの種類でレスポンスを読む。 レスポンスは thinking ブロックで始まることも始まらないこともあるため、最初のブロックがテキストだと決めつけず、ブロックごとに種類を確認します。

推論を見たい場合は、要約された思考を要求します。

{
  "model": "claude-opus-5-5",
  "max_tokens": 16000,
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "low"},
  "messages": [{"role": "user", "content": "Which of these three invoices has a total that does not match its line items?"}]
}

無人の Claude Opus 5.5 エージェントが途中で止まるのを防ぐには？

長いタスクでは、Claude Opus 5.5 は作業しながらユーザーに状況を伝え、その一部はツール呼び出しではなくテキストでターンを終えます（stop_reason: "end_turn"）。そうしたターンをすべて「タスク完了」と扱うエージェントループは、途中で止まってしまいます。Anthropic の対策は、ハーネス側とプロンプト側の 2 つです。

ハーネスでは、テキストだけで終わったターンを作業完了の証拠ではなく報告として扱います。タスクの各部分を、ToDo ツールやファイルなど、モデルが更新するチェックリストで管理します。未完了の項目が残っていて、妨げになっている理由も示されていないままターンが終わったら、それらを挙げた短いユーザーメッセージを送ります。

Your task list still has open items: migrate the remaining two endpoints and update their tests. Continue with them. If one is blocked, say what is blocking it.

同じタスクで自動の続行を 2〜3 回行ったら止め、本当に行き詰まった実行は終わらせて確認できるようにします。バックグラウンドのコマンドやサブエージェントがまだ動いているなら、終わるのを待ち、その出力を次のユーザーメッセージとして返します。

システムプロンプトでは、避けたい早期停止の種類を名指しします。Anthropic の例は完全に無人で動くエージェント向けに書かれており、セッションの最初のリクエストからシステムプロンプトの末尾に置きます。途中で加えるとシステムプロンプトが変わり、会話内のそれまでの思考ブロックが無効になります。

A standing instruction from the user, the person you are working for. It is about how your turns end. A message with no tool call in it ends your turn, and the work stops there until you are asked to continue. The user has seen you end turns in four ways while work they asked for was still owed, and does not want any of them. One: a long summary of what was done that closes by announcing the next step and has no tool call, so the next thing never starts. Two: an offer to carry on with something unless the user would prefer otherwise, which stops to wait for an answer the user was not going to give. Three: a list of decisions for the user when, by your own account, none of them blocks the rest of the work. Four: deciding that this is a good place to report, because the turn has been long or a milestone is done. Status notes are welcome, and so are your recommendations on open decisions, but put them in the same message as your next tool call and carry on with whatever does not depend on the user's answer. If you notice yourself inviting the user to redirect you or offering to wait, delete it and do the next thing. The stops the user does want are the ones where nothing can move without them, or where the thing blocking you is deliberately protected from you. This does not override the need for confirmation on risky or destructive actions.

人が応答できる human-in-the-loop のアプリケーションにはこの一節を入れず、危険な操作や取り消せない操作には自分の確認手順を残してください。タスクあたりのツール呼び出しと出力トークンはやや増えます。

長時間動く Claude Opus 5.5 エージェントから進捗報告を得るには？

ツール呼び出しの合間に、Claude Opus 5.5 は短い進捗メモを書きます。いま何を見つけ、次に何をするかです。このモデルでは、そのメモは text ブロックではなく thinking ブロックとして返り、デフォルトでは中身が空です。そのため text ブロックだけを表示するクライアントは、長いターンの間なにも起きていないように見えます。Anthropic は各メモの要約を返すベータの表示モードを公開しています。エンドポイントのドキュメントに記載された thinking.display の値は Claude Opus 5.5 API リファレンスにあります。

特別な設定なしで使える、プロンプトとハーネスの手段が 3 つあります。

• 原文のまま渡すためのツールを用意する。 ターンの途中でコード片などを正確にユーザーへ渡す必要がありそうなら、簡単な「ユーザーにメッセージを送る」ツールを与え、その用途に限るよう伝えます。ツールは最初のリクエストから宣言してください。あとから加えると、それまでの思考ブロックが無効になります。
• 決まったタイミングでの報告を頼む。 たとえば最初のツール呼び出しの前に意図を一文で述べ、最後に短くまとめる、といった形です。モデルはこうした指示によく従い、人が見守っている場面で特に役立ちます。
• 静かなターンをハーネスから促す。 ユーザーが読めるものを何も返さないツール呼び出しのステップが何回続いたかを数えます。数回、たとえば 5 回続いたら、最新のツール結果のあとにリマインダーを追加し、2〜3 回で打ち切ります。Anthropic の文言は次のとおりです。

The user hasn't heard from you in a while — say in a few words what you're doing, then continue.

エージェント型コーディングのタスクでの Anthropic のテストでは、このリマインダーで長い沈黙が生じるタスクの割合がほぼ半分になり、コストに測定できる変化はありませんでした。

Claude Opus 5.5 エージェントに、動く前に文脈を確認させるには？

Claude Opus 5.5 はすぐに作業へ取りかかる傾向があります。メール、ドキュメント、スプレッドシート、CRM のレコードをまたぐ自動化では、タスクが依存する情報がリクエストに書かれていない場所にあることがよくあります。古いメールスレッドの中のポリシーや、別のスプレッドシートのタブにあるルールなどです。システムプロンプトに一文加えるだけで、モデルは先に周りを確認するようになります。

Before taking any action, explore broadly with tool calls: list and open the emails, documents, spreadsheet tabs and records across the available apps that could be relevant to this task, including ones the task does not explicitly mention, and use what you find.

複数アプリにまたがるタスクでの Anthropic のテストでは、この一文によってモデルが正しく完了したタスクが目に見えて増え、medium と max のどちらの effort でもそうでした。代わりにツール呼び出しはやや増えます。この一文は見つけたものに基づいて行動するよう指示するため、信頼できない内容は検索対象のレコードに入れないでください。

複数の Claude Opus 5.5 エージェントのチームを早く終わらせるには？

Claude Opus 5.5 は経過時間に敏感です。リードエージェントがサブエージェントに仕事を渡す構成では、時間の予算を与えます。ハーネスがモデルへ返す各メッセージの末尾に、elapsed 340s / 1200s のような短い一行を加えるのです。モデルは予算内に終わるようにペースを調整し、たいていは予算よりかなり早く終えるので、実際にかけたい時間より少し長めに予算を設定してください。予算を見積もれない場合は経過時間だけを示し、システムプロンプトに次の一文を加えます。

Time matters here: do not spend time that can be avoided, and the earlier a correct result is obtained, the better.

予算はあくまで目安で、上限に達してもモデルは止まらないため、確実に止めたいなら自分のタイムアウトを残してください。予算を厳しくすることと effort を下げることは別物です。effort を下げると作業そのものが減り、予算は主により多くのエージェントを並行して動かします。時間に追われると、モデルの検索や検証がやや減ることがあるので、自分のタスクで回答の品質を確認してください。

チャットのシステムプロンプトで Claude Opus 5.5 に「よく考えて」と書くべき？

いいえ。Anthropic は、チャットのシステムプロンプトから「think carefully before answering」（答える前によく考えて）のような一文を削除するよう勧めています。どれだけ考えるかはモデル自身が決め、調整手段は effort です。チャット製品での Anthropic のテストでは、そうした一文を削ると返答が早く始まり、品質の明確な低下はありませんでした。

チャット向けにはほかに 2 つの一文を知っておくと役立ちます。1 つは以前の回答を確定したものとして扱わせ、続くターンを早く始めさせるもの。もう 1 つはユーザーが貼り付けたテキストに印を付け、メールやウェブページに隠れた指示にモデルが従わないようにするものです。どちらの原文も Fable 5.1 プロンプトガイドの Claude Opus 5.5 の節に載っています。長い分析やエージェントタスクでは、後の手順で前の誤りが見つかることがあるため、「回答は確定」の一文は入れないでください。

グラフ、図、スクリーンショットについてより良い回答を得るには？

まず再テストしてください。追加のツールなしでも、Claude Opus 5.5 は密度の高いグラフ、フローチャート、カレンダーのスクリーンショットを Claude Opus 5 よりはるかに正確に読み取ります。Anthropic のテストでは、最も低い effort でも、密度の高いグラフから値を読み取る精度が最も高い effort の Claude Opus 5 を上回りました。以前のモデル向けに組んだ補助の仕組みは、もう不要かもしれません。

特に密度の高い入力では、次の 2 つが今も役立ちます。

• より高解像度の画像。 技術図面で特に効果があります。
• 画像処理ツール。 元画像を置き、PIL や OpenCV を入れたコンテナを持たせてエージェントとして動かすと、モデルは切り抜き、拡大、計測ができます。それが重すぎるなら、切り抜きツールだけでも効果があります。effort が高いほど、モデルはこれらのツールをうまく使います。

ツールなしの場合、effort を上げると技術図面の読み取りは改善しますが、グラフにはあまり効きません。画像はユーザーターンに URL ソースの image ブロックとして入れます。形式は API リファレンスを参照してください。

Claude Opus 5.5 のフロントエンド出力がありきたりにならないようにするには？

避けたいパターンを名指しします。デザインの方向性がないと、Claude Opus 5.5 はいくつかのデフォルトのスタイルに戻り、「AI っぽいありきたりな見た目を避けて」といった一般的な一文では、あるデフォルトが別のデフォルトに入れ替わるだけになりがちです。Anthropic の例は、避けるべき具体的な要素を並べています。

Output a vanilla HTML/CSS personal website with placeholder data. Do not use a cream or off-white background, italic accent words in headlines, numbered "01/02/03" section labels, monospace labels, or pill-shaped buttons.

繰り返し調整してください。最初の結果が代わりにどのスタイルを使ったかを確認し、それをリストに加えます。

Claude Opus 5.5 が stop_reason "refusal" を返すのはなぜ？

安全性の分類器がリクエストを断ったためです。Claude Opus 5.5 は生物学、サイバーセキュリティ、推論の抽出についての分類器を動かしており、拒否は stop_reason: "refusal" を含む通常のレスポンスとして返り、stop_details オブジェクトにカテゴリーが記されます。

無害なリクエストが拒否される一般的なケースについては、Fable 5.1 ガイドのClaude が無害なリクエストを拒否する理由を参照してください。

よくある質問

Claude Opus 5.5 の公式プロンプトガイドはある？

あります。Anthropic は開発者向けドキュメントで「Prompting Claude Opus 5.5」を公開しており、現行のすべての Claude モデルに共通するプロンプトのベストプラクティスのページもあります。この記事は 2026 年 10 月 3 日時点の Opus 5.5 ガイドをまとめたもので、テンプレートは原文どおりに引用しています。

Claude Opus 5.5 のデフォルトの effort は？

medium です。Claude Opus 5 のデフォルトは high です。レベルは low、medium、high、xhigh、max で、output_config.effort で設定します。

Claude Opus 5.5 は何トークンまで出力できる？

1 リクエストあたり最大 128,000 トークンで、この上限には思考も含まれます。コンテキストウィンドウは 1M トークンです。

Claude Opus 5.5 の回答を事前記入したり、temperature を設定したりできる？

できません。アシスタントターンの事前記入と、デフォルト以外の temperature はどれも 400 エラーになり、特定のツールを強制することもサポートされていません。代わりに、ほしい形式をプロンプトで説明してください。それぞれ何で代替するかは Fable 5.1 プロンプトガイドで説明しています。

エージェントには Claude Opus 5.5 と Claude Fable 5.1 のどちらが向いている？

タスクと予算によります。選び方は Claude モデルの比較で解説しています。プロンプトのアドバイスの違いは主にデフォルト値で、Claude Opus 5.5 は medium、Claude Fable 5.1 は high の effort から始まります。

プロンプトを試す

SeedRouter のキー 1 つで、Anthropic SDK、または OpenAI の Chat Completions と Responses の形式を使い、Claude Opus 5.5 でこれらのテンプレートを実行できます。Claude Opus 5.5 API リファレンスにすべてのパラメーターが載っており、モデルページには現在のトークン単価が表示されます。SeedRouter は従量課金です。一度チャージすればクレジットに有効期限はなく、失敗したリクエストには課金されません。