このガイドでは、Claude Sonnet 5に固有のプロンプティングパターンについて説明します。モデルの機能とAPIの変更については、Claude Sonnet 5の新機能を参照してください。現行のすべてのClaudeモデルに適用されるテクニックについては、プロンプティングのベストプラクティスを参照してください。
Claude Sonnet 5は、コーディングとエージェント的なタスクに特に強みがあります。既存のClaude Sonnet 4.6のプロンプトでもそのまま良好に動作します。このガイドのパターンは、最も頻繁に調整が必要となる動作をカバーしています。
Claude Sonnet 5は、固定された冗長性をデフォルトとするのではなく、タスクの複雑さに応じて応答の長さを調整します。これは通常、単純な検索には短い回答を、自由度の高い分析には長い回答を意味します。
プロダクトが特定のスタイルや出力の冗長性に依存している場合は、プロンプトの調整が必要になることがあります。例として、冗長性を減らすには、次のように追加できます。
Provide concise, focused responses. Skip non-essential context, and keep examples minimal.特定の種類の冗長性(過剰な説明など)が見られる場合は、それを防ぐための追加の指示をプロンプトに加えることができます。Claudeが適切なレベルの簡潔さでコミュニケーションする方法を示すポジティブな例は、モデルに何をしてはいけないかを伝えるネガティブな例や指示よりも効果的である傾向があります。
effortパラメータを使用すると、Claudeの知能とトークン消費のバランスを調整でき、能力と引き換えに高速化と低コスト化を実現できます。Claude Sonnet 5では、effortのデフォルトはClaude Sonnet 4.6と同じhighです。最も難しいコーディングやエージェント的なタスクには、effortをxhighに上げてください。トークン使用量と知能をさらに調整するには、他のeffortレベルを試してください。
max: トークン消費に制約のない、絶対的な最大能力。xhigh: 特に高いeffortは、最も難しいコーディングおよびエージェント的なユースケースに推奨される設定です。high: デフォルト。この設定は、ほとんどのユースケースでトークン使用量と知能のバランスを取ります。medium: 知能とのトレードオフでトークン使用量を削減する必要がある、コストに敏感なユースケースに適しています。low: 短くスコープが限定されたタスクや、知能への要求が低くレイテンシに敏感なワークロード向けに確保してください。移行時のモデル間の大まかな対応関係として、Claude Sonnet 5のmediumはClaude Sonnet 4.6のhighと同等の知能であり、Claude Sonnet 5のhighはClaude Sonnet 4.6のmaxと同等です。ベンチマークを行う際は、effort名ではなく、観測された思考の長さで対応付けてください。
Claude Sonnet 5は、特に低い側でeffortレベルを厳密に守ります。lowとmediumでは、モデルは期待以上のことをするのではなく、求められたことに作業のスコープを限定します。これはレイテンシとコストには良いことですが、low effortで実行される中程度に複雑なタスクでは、思考が不足するリスクがいくらかあります。
複雑な問題で浅い推論が観察される場合は、プロンプトで回避しようとするのではなく、effortをhighまたはxhighに上げてください。レイテンシのためにeffortをlowに保つ必要がある場合は、的を絞ったガイダンスを追加してください。
This task involves multistep reasoning. Think carefully through the problem before responding.Claude Sonnet 5では、適応的思考がデフォルトで有効です。thinkingフィールドのないリクエストは適応的思考で実行されます。これは、同じリクエストが思考なしで実行されていたClaude Sonnet 4.6からの変更点です。思考を完全にオフにするには、thinking: {type: "disabled"}を渡してください。max_tokensは合計出力(思考と応答テキスト)のハードリミットであるため、Claude Sonnet 4.6で思考なしで実行していたワークロードについては見直してください。以前Claude Sonnet 4.6で思考をオフにして使用していた場合は、Claude Sonnet 5では思考をオンにして低いeffortレベルを試してみてください。
適応的思考のトリガー動作は制御可能です。大規模または複雑なシステムプロンプトで起こり得ることですが、モデルが思考ブロックを望むより頻繁に出力していると感じた場合は、それを制御するガイダンスを追加してください。いつものように、プロンプトの変更がパフォーマンスに与える影響を測定してください。例:
Thinking adds latency and should only be used when it will meaningfully improve answer quality, typically for problems that require multistep reasoning. When in doubt, respond directly.逆に、mediumで難しいワークロードを実行していて思考不足が見られる場合、最初のレバーはeffortを上げることです。より細かい制御が必要な場合は、直接プロンプトで指示してください。
手動の拡張思考(thinking: {type: "enabled", budget_tokens: N})はClaude Sonnet 5ではサポートされておらず、400エラーを返します。これはClaude Sonnet 4.6で非推奨となり、現在は削除されています。代わりにeffortパラメータを使った適応的思考を使用してください。
Claude Sonnet 5はデフォルトでClaude Sonnet 4.6よりもエージェント的であり、ツールに手を伸ばしたり、自己検証ループを実行したりすることがより積極的です。思考を無効にすると、モデルがツールに手を伸ばしたり検索を検討したりする可能性が低くなります。思考をオフにした状態でツール呼び出しに依存している場合は、システムプロンプトに明示的な促しを追加してください。effortもツール使用のレバーです。highまたはxhighのeffort設定では、エージェント的な検索やコーディングにおいてツール使用が大幅に増加します。より多くのツール使用を望むシナリオでは、ツールをいつどのように適切に使用すべきかをモデルに明示的に指示するようにプロンプトを調整することもできます。たとえば、モデルがウェブ検索ツールを使用していないことに気づいた場合は、なぜ、どのように使用すべきかを明確に説明してください。
Claude Sonnet 5は、長いエージェント的なトレースの間、定期的でより高品質な更新をユーザーに提供します。中間ステータスメッセージを強制するスキャフォールディング(「ツール呼び出し3回ごとに進捗を要約する」)を追加している場合は、それを削除してみてください。Claude Sonnet 5のユーザー向け更新の長さや内容がユースケースに適切に調整されていないと感じた場合は、これらの更新がどのようなものであるべきかをプロンプトで明示的に説明し、例を提供してください。
Claude Sonnet 5は、特に低いeffortレベルにおいて、プロンプトを文字通りかつ明示的に解釈します。ある項目への指示を別の項目に暗黙的に一般化することはなく、あなたが行っていない要求を推測することもありません。この文字通りの解釈の利点は精度であり、慎重に調整されたプロンプト、構造化された抽出、予測可能な動作を求めるパイプラインを持つAPIユースケースでは一般的により良いパフォーマンスを発揮します。Claudeに指示を広く適用させる必要がある場合は、スコープを明示的に述べてください(たとえば、「このフォーマットを最初のセクションだけでなく、すべてのセクションに適用してください」)。
新しいモデルと同様に、長文の文章における文体は変化する可能性があります。プロダクトが特定のボイスに依存している場合は、新しいベースラインに対してスタイルプロンプトを再評価してください。
たとえば、プロダクトのボイスがより温かく、より会話的である場合は、次のように追加します。
Use a warm, collaborative tone. Acknowledge the user's framing before answering.以前にスタイルの多様性のためにtemperatureに依存していた場合、Claude Sonnet 5ではtemperature、top_p、またはtop_kをデフォルト以外の値に設定すると400エラーが返されることに注意してください。この制約はSonnetクラスのモデルでは新しいものです。移行時にこれらのパラメータを削除し、代わりにシステムプロンプトの指示を使用してトーンと多様性を導いてください。
Claude Sonnet 5は、自由度の高いフロントエンドやデザインの要件に対して、一貫したデフォルトのビジュアルスタイルに落ち着くことがあります。デフォルトのハウススタイルは一部の要件には適していますが、ダッシュボード、開発ツール、フィンテック、ヘルスケア、エンタープライズアプリには合わないと感じられることがあります。
一般的な指示(「その色を使わないで」「クリーンでミニマルにして」)は、多様性を生み出すのではなく、モデルを別の固定パレットに移行させる傾向があります。確実に機能する2つのアプローチがあります。
1. 具体的な代替案を指定する。 モデルは明示的な仕様に正確に従います。
Design a desktop landing page for a supplement brand called AEFRM.
The visual direction should come from a cold monochrome atmosphere using pale silver-gray tones that gradually deepen into blue-gray and near-black, similar to a misted metallic surface.
The page should feel sharp and controlled, with a strong sense of structure and restraint.
Use this tonal system across the full page instead of introducing bright accent colors.
Use the uploaded image on the hero design in black and white.
The layout should be built with clear horizontal sections and a centered max-width container. Use 4px corner radius consistently across cards, buttons, inputs, and media frames. Margins should feel generous, with enough empty space around each section so the page breathes.
Typography should use a square, angular sans-serif with wider letter spacing than usual, especially in headings and navigation, so the text feels more engineered and less compressed. Headline text can be large and uppercase, while supporting copy remains short and sparse. The sub texts should be written with Alumni Sans SC in 4-6px like tiny little texts on corners bottom centre like that.
For the structure, start with a hero section containing a strong product statement, one short supporting paragraph, and a clean product placeholder or packshot frame. Below that, add a benefit grid with three or four blocks, then a formulation or ingredients section, and finally a cta.
Buttons should be flat and precise, with subtle hover changes using transition: all 160ms ease out where brightness and border contrast shift slightly rather than using dramatic motion.
Color palette should stay within this range:
#E9ECEC, #C9D2D4, #8C9A9E, #44545B, #11171B.2. 構築前にモデルに選択肢を提案させる。 これによりデフォルトが打破され、ユーザーに制御権が与えられます。Claude Sonnet 5ではtemperatureが受け付けられないため、このアプローチは実行ごとに意味のある異なるデザインの方向性を生み出すための推奨される方法です。プロンプトの例:
Before building, propose 4 distinct visual directions tailored to this brief (each as: bg hex / accent hex / typeface, plus a one-line rationale). Ask the user to pick one, then implement only that direction.ユーザーが「AIスロップ」の美学と呼ぶ一般的なパターンから離れるように導くには、システムプロンプトに短い指示を含めることができます。frontend-designスキルではより詳しく扱われていますが、このスニペットは前述の多様性のアプローチと併用してうまく機能します。
<frontend_aesthetics>
NEVER use generic AI-generated aesthetics like overused font families (Inter, Roboto, Arial, system fonts), cliched color schemes (particularly purple gradients on white or dark backgrounds), predictable layouts and component patterns, and cookie-cutter design that lacks context-specific character. Use unique fonts, cohesive colors and themes, and animations for effects and micro-interactions.
</frontend_aesthetics>トークン使用量と動作は、単一のユーザーターンを持つ自律的で非同期なコーディングエージェントと、複数のユーザーターンを持つインタラクティブで同期的なコーディングエージェントとで異なる場合があります。コーディングプロダクトでパフォーマンスとトークン効率の両方を最大化するには、xhighまたはhigh effortを使用し、自動モードなどの自律的な機能を追加し、ユーザーに求められる人間の介入の回数を減らしてください。
必要なユーザーの介入回数を制限する場合、最初の人間のターンでタスク、意図、関連する制約を事前に指定することが重要です。十分に仕様化され、明確で正確なタスクの説明を事前に提供することで、ユーザーターン後の余分なトークン使用を最小限に抑えながら、自律性と知能を最大化できます。対照的に、複数のユーザーターンにわたって段階的に伝えられる曖昧または仕様が不十分なプロンプトは、トークン効率を相対的に低下させ、場合によってはパフォーマンスも低下させる傾向があります。
コードレビューハーネスが以前のモデル向けに調整されている場合、Claude Sonnet 5では最初は再現率(recall)が低く見えることがあります。これはハーネスの影響である可能性が高く、能力の後退ではありません。レビュープロンプトに「重大度の高い問題のみを報告する」「保守的であること」「細かいことを指摘しない」などと書かれている場合、Claude Sonnet 5は以前のモデルよりもその指示に忠実に従う可能性があります。つまり、コードを同じように徹底的に調査し、バグを特定した上で、指定された基準を下回ると判断した発見を報告しないことがあります。これは、モデルが同じ深さの調査を行いながらも、特に重大度の低いバグについて、調査結果を報告される発見に変換する割合が少なくなるという形で現れることがあります。精度(precision)は通常上昇しますが、モデルの根本的なバグ発見能力が向上しているにもかかわらず、測定される再現率は低下することがあります。
推奨されるプロンプトの文言:
Report every issue you find, including ones you are uncertain about or consider low-severity. Do not filter for importance or confidence at this stage - a separate verification step will do that. Your goal here is coverage: it is better to surface a finding that later gets filtered out than to silently drop a real bug. For each finding, include your confidence level and an estimated severity so a downstream filter can rank them.このプロンプトは実際の第2ステップがなくても使用できますが、信頼度によるフィルタリングを発見ステップから切り離すことはしばしば有効です。ハーネスに別の検証、重複排除、またはランキングのステージがある場合は、発見ステージでのモデルの仕事はフィルタリングではなく網羅性であることを明示的に伝えてください。
単一のパスでモデルに自己フィルタリングをさせたい場合は、「重要」のような定性的な用語を使うのではなく、基準がどこにあるかを具体的に示してください。たとえば、「不正な動作、テストの失敗、または誤解を招く結果を引き起こす可能性のあるバグはすべて報告してください。純粋なスタイルや命名の好みのような些細な点のみを省略してください」のようにします。
再現率またはF1スコアの向上を検証するために、評価やテストケースのサブセットに対してプロンプトを反復的に改善してください。
Claude Sonnet 5はcomputer_20251124ツールバージョンをサポートしています。コンピュータ使用機能は、最大解像度2576px / 3.75MPまでのさまざまな解像度で動作します。社内のコンピュータ使用テストでは、1080pで画像を送信するとパフォーマンスとコストのバランスが良いことが示されています。
特にコストに敏感なワークロードの場合、720pまたは1366×768は、高いパフォーマンスを維持しながら低コストな選択肢です。ユースケースに最適な設定を見つけるために独自のテストを実施してください。effort設定を試すことも、モデルの動作の調整に役立ちます。
Was this page helpful?