---
title: Claude Sonnet 5へのプロンプト
url: https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-sonnet-5
description: Claude Sonnet 5の動作上の違いとプロンプトパターンについて、effort、適応型思考のデフォルト、ツール使用を含めて説明します。
---

このガイドでは、Claude Sonnet 5に固有のプロンプトパターンについて説明します。モデルの仕様については、[Claude Sonnet 5](https://platform.claude.com/docs/ja/models/sonnet-5/overview)を参照してください。現在のすべてのClaudeモデルに適用される手法については、[プロンプトのベストプラクティス](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/claude-prompting-best-practices)を参照してください。

Claude Sonnet 5は、コーディングとエージェント型タスクに特に優れています。既存のClaude Sonnet 4.6向けプロンプトでも、そのままで良好に動作します。このガイドのパターンは、最も頻繁に調整が必要となる動作を扱っています。

## 応答の長さと冗長性

Claude Sonnet 5は、固定の「verbosity」（冗長性）をデフォルトとするのではなく、タスクの複雑さに合わせて応答の長さを調整します。これは通常、単純な調べものでは短い回答になり、自由形式の分析では長い回答になることを意味します。

製品が特定のスタイルや冗長性の出力に依存している場合は、プロンプトを調整する必要があるかもしれません。たとえば、冗長性を減らすには、次のように追加できます。

```text wrap
Provide concise, focused responses. Skip non-essential context, and keep examples minimal.
```

特定の種類の冗長性（説明しすぎなど）が見られる場合は、それを防ぐための追加の指示をプロンプトに加えることができます。Claudeが適切な簡潔さでどのようにコミュニケーションできるかを示す肯定的な例は、否定的な例やモデルに何をしてはいけないかを伝える指示よりも効果的な傾向があります。

## effortと思考の深さの調整

[effortパラメータ](https://platform.claude.com/docs/ja/build-with-claude/effort)を使用すると、Claudeの知能とトークン消費のバランスを調整でき、能力と引き換えに速度の向上とコストの削減を図ることができます。Claude Sonnet 5では、effortのデフォルトはClaude Sonnet 4.6と同じく`high`です。最も難しいコーディングおよびエージェント型タスクでは、effortを`xhigh`に上げてください。他のeffortレベルも試して、トークン使用量と知能をさらに調整してください。

* **`max`：** トークン消費に制約のない、絶対的な最大能力。
* **`xhigh`：** 非常に高いeffortは、最も難しいコーディングおよびエージェント型のユースケースに推奨される設定です。
* **`high`：** デフォルト。この設定は、ほとんどのユースケースでトークン使用量と知能のバランスを取ります。
* **`medium`：** 知能とのトレードオフでトークン使用量を削減する必要がある、コスト重視のユースケースに適しています。
* **`low`：** 知能が重視されない、短く範囲の限定されたタスクやレイテンシ重視のワークロード向けに使用してください。

移行時のおおまかなモデル間の対応として、mediumのClaude Sonnet 5は知能の面でhighのClaude Sonnet 4.6に相当し、highのClaude Sonnet 5はmaxのClaude Sonnet 4.6に相当します。ベンチマークを行う際は、effortの名前ではなく、観測された思考の長さで合わせてください。

Claude Sonnet 5は、特に低い側でeffortレベルを厳密に守ります。`low`および`medium`では、モデルはリクエストを超えるのではなく、求められた範囲に作業を限定します。これはレイテンシとコストの面では良いことですが、中程度に複雑なタスクを`low` effortで実行すると、思考不足になるリスクがあります。

複雑な問題で浅い推論が見られる場合は、プロンプトで回避しようとするのではなく、effortを`high`または`xhigh`に上げてください。レイテンシのためにeffortを`low`に保つ必要がある場合は、的を絞ったガイダンスを追加してください。

```text wrap
This task involves multistep reasoning. Think carefully through the problem before responding.
```

Claude Sonnet 5では、[adaptive thinking](https://platform.claude.com/docs/ja/build-with-claude/thinking)（適応型思考）がデフォルトで有効になっています。`thinking`フィールドのないリクエストは、適応型思考で実行されます。これはClaude Sonnet 4.6からの変更点で、Claude Sonnet 4.6では同じリクエストが思考なしで実行されていました。思考を完全にオフにするには、`thinking: {type: "disabled"}`を渡してください。`max_tokens`は出力全体（思考と応答テキストの合計）に対するハードリミットであるため、Claude Sonnet 4.6で思考なしで実行していたワークロードについては見直してください。以前Claude Sonnet 4.6で思考をオフにして使用していた場合は、Claude Sonnet 5では思考をオンにして、より低いeffortレベルを試してください。

適応型思考のトリガー動作は調整可能です。モデルが望む以上に頻繁に思考ブロックを出力している場合（大規模または複雑なシステムプロンプトで発生することがあります）、それを調整するためのガイダンスを追加してください。いつものように、プロンプトの変更がパフォーマンスに与える影響を測定してください。例：

```text wrap
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パラメータとともに適応型思考を使用してください。

<Note>
  Claude Sonnet 5を`high`、`xhigh`、または`max` effortで実行している場合は、モデルが思考とツール呼び出しを行う余地があるよう、`max_tokens`に余裕を持たせてください。長いタスクでは、適応型思考が予算の大部分を使用することがあります。予算が厳しい場合、ほぼ全体が思考で占められ、その後に切り詰められた回答と`stop_reason: "max_tokens"`が続く応答が見られることがあります。`max_tokens`を上げるか、`medium` effortに下げることで解決します。Claude Sonnet 5は同じテキストに対して約30パーセント多くのトークンを生成する新しいトークナイザーを使用しているため、Claude Sonnet 4.6向けに調整された`max_tokens`の上限では、同等の出力が切り詰められる可能性があります。正確な増加量は、コンテンツとワークロードの形態によって異なります。
</Note>

## ツール使用のトリガー

Claude Sonnet 5は、デフォルトでClaude Sonnet 4.6よりもエージェント的であり、より積極的にツールを使用し、自己検証ループを実行します。思考を無効にすると、モデルはツールを使用したり検索を検討したりする可能性が低くなります。思考をオフにした状態でツール呼び出しに依存している場合は、システムプロンプトに明示的な促しを追加してください。effortもツール使用を左右する手段です。`high`または`xhigh`のeffort設定では、エージェント型の検索やコーディングにおいてツール使用が大幅に増加します。より多くのツール使用を望むシナリオでは、ツールをいつどのように適切に使用するかをモデルに明示的に指示するようプロンプトを調整することもできます。たとえば、モデルがWeb検索ツールを使用していないことがわかった場合は、なぜ、どのように使用すべきかを明確に説明してください。

## ユーザー向けの進捗更新

Claude Sonnet 5は、長いエージェント型のトレース全体を通じて、定期的で質の高い更新をユーザーに提供します。中間ステータスメッセージを強制するための仕組み（「3回のツール呼び出しごとに進捗を要約する」など）を追加している場合は、それを削除してみてください。Claude Sonnet 5のユーザー向け更新の長さや内容がユースケースに適切に調整されていない場合は、これらの更新がどのようなものであるべきかをプロンプトで明示的に説明し、例を提供してください。

## より文字どおりの指示追従

Claude Sonnet 5は、特に低いeffortレベルにおいて、プロンプトを文字どおりかつ明示的に解釈します。ある項目に対する指示を暗黙のうちに別の項目へ一般化することはなく、あなたが行っていない要求を推測することもありません。この文字どおりの解釈の利点は精度であり、慎重に調整されたプロンプト、構造化された抽出、予測可能な動作が求められるパイプラインなどのAPIユースケースでは、一般的により良いパフォーマンスを発揮します。Claudeに指示を広く適用させる必要がある場合は、範囲を明示的に述べてください（たとえば、「最初のセクションだけでなく、すべてのセクションにこの書式を適用してください」）。

## トーンと文体

新しいモデルではいつものことですが、長文の文章における散文スタイルが変化する可能性があります。製品が特定の語り口に依存している場合は、新しいベースラインに対してスタイルのプロンプトを再評価してください。

たとえば、製品の語り口がより温かみのある、または会話的なものである場合は、次のように追加してください。

```text wrap
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. 具体的な代替案を指定する。** モデルは明示的な仕様に正確に従います。

```text wrap
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`が受け付けられないため、このアプローチは実行ごとに意味のある異なるデザインの方向性を生み出すための推奨される方法です。プロンプトの例：

```text wrap
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 slop」美学と呼ぶ一般的なパターンから離れるよう誘導するには、システムプロンプトに短い指示を含めることができます。[frontend-designスキル](https://github.com/anthropics/claude-code/blob/main/plugins/frontend-design/skills/frontend-design/SKILL.md)はより詳細な対処法を提供していますが、このスニペットは前述の多様性のアプローチと組み合わせてうまく機能します。

```text wrap
<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>
```

## インタラクティブなコーディング製品

トークン使用量と動作は、ユーザーターンが1回の自律的・非同期のコーディングエージェントと、複数のユーザーターンを伴うインタラクティブ・同期のコーディングエージェントとの間で異なる場合があります。コーディング製品でパフォーマンスとトークン効率の両方を最大化するには、`xhigh`または`high` effortを使用し、自動モードなどの自律的な機能を追加して、ユーザーに求める人間のインタラクションの回数を減らしてください。

必要なユーザーとのやり取りの回数を制限する場合は、最初の人間のターンでタスク、意図、および関連する制約を前もって指定することが重要です。明確に指定された、わかりやすく正確なタスクの説明を前もって提供することで、自律性と知能を最大化しつつ、ユーザーターン後の余分なトークン使用量を最小限に抑えることができます。対照的に、複数のユーザーターンにわたって段階的に伝えられる曖昧または指定不足のプロンプトは、トークン効率を相対的に低下させ、場合によってはパフォーマンスも低下させる傾向があります。

## コードレビューハーネス

コードレビューハーネスが以前のモデル向けに調整されていた場合、最初はClaude Sonnet 5で再現率が低下するように見えることがあります。これは能力の低下ではなく、ハーネスの影響である可能性が高いです。レビュープロンプトに「重大度の高い問題のみを報告する」「保守的に」「細かい指摘はしない」などと書かれている場合、Claude Sonnet 5は以前のモデルよりもその指示に忠実に従うことがあります。つまり、同じように徹底的にコードを調査してバグを特定したうえで、指定された基準を下回ると判断した発見事項を報告しないことがあります。これは、モデルが同じ深さの調査を行いながらも、調査を報告される発見事項に変換する数が少なくなるという形で現れることがあり、特に重大度の低いバグで顕著です。適合率は通常向上しますが、モデルの根本的なバグ発見能力が向上しているにもかかわらず、測定される再現率は低下することがあります。

推奨されるプロンプトの文言の例：

```text wrap
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_toolset_20260801`ツールセットおよび`computer_20251124`ツールバージョンを通じて「computer use」（コンピューター使用）をサポートしています。また、ウェブページ内でのタスク向けに[ブラウザ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/browser-use-tool)（`browser_toolset_20260801`）もサポートしています。[コンピューター使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool)機能はさまざまな解像度で動作し、最大解像度は2576px / 3.75MPです。社内でのコンピューター使用テストでは、1080pで画像を送信することでパフォーマンスとコストのバランスが良好になることが示されています。

特にコスト重視のワークロードでは、720pまたは1366×768が、強力なパフォーマンスを備えた低コストの選択肢となります。ユースケースに最適な設定を見つけるために独自のテストを実施してください。effort設定を試すことも、モデルの動作を調整するのに役立ちます。
