Extended Thinking

Extended Thinking (拡張思考)

Claude Opus / Sonnet 4 系 には、回答前に長い思考連鎖を行う Extended Thinking モードがあります。 難問に対する正答率が向上しますが、トークンとレイテンシが増えます。

有効化

res = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=8000,
    thinking={
        "type": "enabled",
        "budget_tokens": 4000,   # 思考に使えるトークン上限
    },
    messages=[{"role": "user", "content": "次の問題を解いて..."}],
)

思考内容を読む

content に thinking ブロックが返ります。

for block in res.content:
    if block.type == "thinking":
        print("[内部思考]", block.thinking)
    elif block.type == "text":
        print("[最終回答]", block.text)

いつ使うか

✅ 使うべき: - 数学・パズル・複雑な推論 - バグの根本原因分析 - マルチステップの計画立案 - 安全性の高い判断 (拒否すべきか吟味) - 多変数の最適化問題

❌ 使うべきでない: - 単純な Q&A や生成 - レイテンシが厳しい UI - 大量バッチで合計コストを抑えたいとき

通常 CoT との違い

注意

• budget_tokens は max_tokens の中でカウントされる ので、出力枠も別途必要。
• 思考内容を そのままユーザーに見せるかは設計次第。生で見せると長すぎる/誤解を招くこともある。
• 安全性: 内部思考は最終回答ほど整っていないため、UI に出すなら注意書きを添える。

Tool Use と組み合わせる

Extended Thinking 中に ツールを呼ぶ計画 を立てさせることも可能です。 複雑なエージェントワークフローでは強力な組み合わせ。

試す

簡単な推論問題で見比べましょう。