思考とは何か?
タスクの中には、即答だけでは済まないものがあります。Claudeは応答する前に問題を段階的に検討できます ——これが拡張思考と呼ばれる機能です。このレッスンでは、思考とは何か、どのように機能するのか、 そして実際にどのような場面で役立つのかを見ていきます。
ここで避けたい失敗パターンを紹介します。モデルに複数ステップの質問をして即座に答えさせると、自信満々に間違った答えを返すことがあります。

拡張思考とは何か?
拡張思考により、Claudeは最終的な応答を生成する前に段階的に推論できるようになります。これが有効になっている場合、Claudeは内部的な推論トークン——しばしば思考の連鎖(chain of thought)と呼ばれるもの——を生成し、その後に答えを提示します。Claude Opus 5では、リクエストのthinking設定に、以下の例のように"display": "summarized"が含まれていない限り、思考テキストは非表示のままです。含まれている場合は、Claudeの推論の要約が最終テキストとともに応答に返されます。
Claude Opus 5におけるアダプティブ思考
Opus 5では、思考はアダプティブ(adaptive)であり、デフォルトで有効になっています。選択すべきトークン予算はありません。Claudeがいつ、どの程度思考するかを動的に判断します。
Claudeがどの程度思考するかを制御するには、effortパラメータを使用します。一つ注意点があります。これはthinkingブロックの隣ではなく、output_configの中に配置します。レベルは以下の通りです。
lowmediumhigh(デフォルト)xhigh(エクストラハイ)max
いつ使うべきか(そしていつ省略すべきか)
拡張思考は以下のような場合に役立ちます。
- 数学や複数ステップの論理
- コードのデバッグ
- 規制分析
- トレードオフの検討や選択肢の比較を伴うあらゆるもの

単純な分類、抽出、定型的な処理には使用を控えましょう。そうしたタスクでは、結果を実際に改善することなく、レイテンシとコストが増えるだけです。
実際に動かしてみる
実際に動かしてみましょう。ここに天気ツールを一つ備えたエージェントループがあり、Claudeにサンフランシスコを出発点としたロードトリップの計画——2か所の立ち寄り先を、天気と移動時間を比較検討しながら——を立ててもらいます。これは本物のトレードオフであり、思考がその価値を発揮する種類の問いです。
import anthropic
client = anthropic.Anthropic()
weather_tool = {
"name": "get_weather",
"description": "Get the current weather for a city.",
"input_schema": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "City name"}
},
"required": ["city"],
},
}
response = client.messages.create(
model="claude-opus-5",
max_tokens=16000,
thinking={"type": "adaptive", "display": "summarized"}, # summarized = return the reasoning text
output_config={"effort": "high"}, # low | medium | high | xhigh | max
tools=[weather_tool],
messages=[
{
"role": "user",
"content": "Plan a road trip out of San Francisco with two stops, "
"weighing weather and drive time.",
}
],
)これを実行すると、出力はいつもより興味深いものになります。Claudeがトレードオフを検討する思考ブロックが表示され、続いて各都市を確認するツール呼び出しが行われ、最後に実際の推奨事項を含むテキストブロックが表示されます。
推論が可視化されている——それこそがこの機能の要点です。
本番環境でこれが重要な理由
本番アプリにおいて、これは問題を一つずつ見つけるエージェントと、問題同士を結びつけるエージェントとの違いを生みます。コンプライアンスレビューアプリを例に取りましょう。自動レビュー呼び出しでアダプティブ思考を切り替えることで、エージェントはレポートのセクションを横断して推論できるようになり——たとえば、第3セクションの風荷重仕様が、文書の別の箇所にある材料仕様と矛盾しているといった問題を発見できます。

まとめ
- 拡張思考は、Claudeが答える前に推論するための余地を与えます。Opus 5では、要求した場合にのみ、応答にその推論の要約が含まれます。
- Opus 5では、アダプティブ思考がデフォルトで有効になっています——トークン予算は不要です。応答内で推論を確認するには
"display": "summarized"を追加してください。 output_config内のeffortパラメータで深さを調整します:low、medium、high(デフォルト)、xhigh、max。- トレードオフの多い難しい問題には使用し、単純な問題には使用を控えましょう——そこでは単にレイテンシとトークンのコストがかかるだけです。