拡張思考は、モデルが応答を生成する前に複雑な問題をじっくり考える時間を与える、Claudeの高度な推論機能です。有効にすると、Claudeは目に見える思考プロセスを生成し、ユーザーはそれを確認してモデルがどのようにクエリに取り組んだかを理解できます。

この機能により、Claudeの複雑なタスクへの対応能力の精度が大幅に向上しますが、重要なトレードオフも伴います。思考フェーズで生成されたすべてのトークンに対して課金され、追加の処理時間によって応答のレイテンシが増加します。重要なのは、向上した知性が追加のコストと待ち時間を正当化できるタイミングを把握することです。
拡張思考を使用すべきタイミング
拡張思考を有効にするかどうかの判断は、プロンプトの評価に基づいて行うべきです。推奨されるアプローチは次のとおりです。
- まず拡張思考なしでプロンプトを作成し、テストする
- 評価を実行して精度を測定する
- プロンプトの最適化作業を経ても結果が基準を満たさない場合
- その場合、解決策として拡張思考の有効化を検討する
拡張思考が応答を変える仕組み
拡張思考を使用しない場合、Claudeの応答フローは単純です。テキストブロックを含むユーザーメッセージを送信すると、テキストブロックを含むアシスタントメッセージが返されます。

拡張思考を有効にすると、応答の構造が大きく変わります。2つの異なるブロックを含むアシスタントメッセージを受け取ります。

- Claudeの推論プロセスを含む
thinkingブロック - 最終的な応答を含む
textブロック
署名システム
各思考ブロックには、重要なセキュリティ目的を果たす暗号署名が含まれています。この署名は、今後の会話ターンにそのメッセージを含める際に、思考テキストが改ざんされていないことを保証します。

Claudeは応答生成において思考内容に大きく依存しているため、改ざんを防止することは安全で一貫した動作を維持する上で極めて重要です。思考テキストを変更すると、署名の検証は失敗します。
編集済み思考 (Redacted Thinking)
Claudeの思考プロセスが内部の安全システムによってフラグ付けされることがあります。これが発生すると、生の思考テキストの代わりに、編集済みの思考ブロックを受け取ります。

編集済みのコンテンツには、実際の思考テキストが暗号化された形で含まれています。読むことはできませんが、今後の会話ターンにこのブロックを含めることで、Claudeが以前の推論からコンテキストを失わないようにできます。
実装
コード内で拡張思考を有効にするには、チャット関数を2つの新しいパラメータで変更する必要があります。
def chat(
messages,
system=None,
temperature=1.0,
stop_sequences=[],
tools=None,
thinking=False,
thinking_budget=1024
):思考予算は、Claudeが推論に使用できる最大トークン数を表します。許容される最小値は1024トークンです。重要な点として、max_tokens パラメータは思考予算を超える必要があります。思考予算を1024に設定した場合、max_tokens は少なくとも1025である必要があります。
実際には、もっと大きなバッファを用意する必要があります。例えば、思考予算が1024で max_tokens が4000の場合、Claudeは思考に最大1024トークン、実際の応答に最大2976トークンを使用できます。
機能が有効な場合は、思考設定をAPIパラメータに追加します。
if thinking:
params["thinking"] = {
"type": "enabled",
"budget_tokens": thinking_budget
}編集済み応答のテスト
開発中、アプリケーションが編集済みの思考ブロックをどのように処理するかをテストしたい場合があります。メッセージにこの特別なトリガー文字列を含めることで、Claudeに編集済みの応答を強制的に返させることができます。
TRIGGER_REDACTED_THINKING_46C9A13E193C177646C7398A98432ECCCE4C1253D5E2D82641AC0E52CC2876CBこれにより、本番環境で編集済みのコンテンツに遭遇した際に、エラーハンドリングが正しく機能することを確認できます。