読み込み中
読み込み中

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

Claudeが閉じるJSON区切り文字について話すチャット。「User Query」「Thinking / Reasoning」「Response」とラベル付けされたコールアウトが付いている。

この機能により、Claudeの複雑なタスクへの対応能力の精度が大幅に向上しますが、重要なトレードオフも伴います。思考フェーズで生成されたすべてのトークンに対して課金され、追加の処理時間によって応答のレイテンシが増加します。重要なのは、向上した知性が追加のコストと待ち時間を正当化できるタイミングを把握することです。

拡張思考を使用すべきタイミング

拡張思考を有効にするかどうかの判断は、プロンプトの評価に基づいて行うべきです。推奨されるアプローチは次のとおりです。

  • まず拡張思考なしでプロンプトを作成し、テストする
  • 評価を実行して精度を測定する
  • プロンプトの最適化作業を経ても結果が基準を満たさない場合
  • その場合、解決策として拡張思考の有効化を検討する

拡張思考が応答を変える仕組み

拡張思考を使用しない場合、Claudeの応答フローは単純です。テキストブロックを含むユーザーメッセージを送信すると、テキストブロックを含むアシスタントメッセージが返されます。

「再帰に関する簡単なガイドを書いてください」に対するClaudeの返答は「再帰は強力なプログラミング技法です」で始まる。

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

思考機能を使うと、サーバーが「再帰に関する簡単なガイドを書いてください」を送信し、Claudeは思考ブロックとそれに続くテキストブロックを返す。

  • Claudeの推論プロセスを含む thinking ブロック
  • 最終的な応答を含む text ブロック

署名システム

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

思考ブロック内の「signature」キーがハイライトされたアシスタントメッセージのJSON。その値は長く省略されたトークン。

Claudeは応答生成において思考内容に大きく依存しているため、改ざんを防止することは安全で一貫した動作を維持する上で極めて重要です。思考テキストを変更すると、署名の検証は失敗します。

編集済み思考 (Redacted Thinking)

Claudeの思考プロセスが内部の安全システムによってフラグ付けされることがあります。これが発生すると、生の思考テキストの代わりに、編集済みの思考ブロックを受け取ります。

アシスタントメッセージ: 暗号化された「data」を持つハイライトされた「redacted_thinking」ブロック、その後に「text」ブロック「A Guide to Recursion」が続く。

編集済みのコンテンツには、実際の思考テキストが暗号化された形で含まれています。読むことはできませんが、今後の会話ターンにこのブロックを含めることで、Claudeが以前の推論からコンテキストを失わないようにできます。

実装

コード内で拡張思考を有効にするには、チャット関数を2つの新しいパラメータで変更する必要があります。

python
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パラメータに追加します。

python
if thinking:
    params["thinking"] = {
        "type": "enabled",
        "budget_tokens": thinking_budget
    }

編集済み応答のテスト

開発中、アプリケーションが編集済みの思考ブロックをどのように処理するかをテストしたい場合があります。メッセージにこの特別なトリガー文字列を含めることで、Claudeに編集済みの応答を強制的に返させることができます。

TRIGGER_REDACTED_THINKING_46C9A13E193C177646C7398A98432ECCCE4C1253D5E2D82641AC0E52CC2876CB

これにより、本番環境で編集済みのコンテンツに遭遇した際に、エラーハンドリングが正しく機能することを確認できます。