Adaptive Thinking 設定ガイド

Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5 の自適応思考メカニズム：thinking + effort パラメータの使い方、旧 budget_tokens との違い、効果とコストのトレードオフ

Adaptive Thinking 設定ガイド¶

Adaptive Thinking（自適応思考） は Claude 4.6/4.7 シリーズの新世代推論モードです：モデル自身がいつ推論に投入するか、どれだけの tokens を推論に使うかを決定し、開発者が固定予算を事前に設定する必要はありません。effort パラメータと組み合わせて思考の深さを粗粒度で制御できます。本ガイドは、これに関する API の使い方、モデルサポートマトリクス、効果とコストのトレードオフをまとめたものです。

旧 Extended Thinking との主な違い¶

簡潔なルール：4.6 / 4.7 シリーズのモデルはすべて adaptive を使用、4.5 以前のみ budget_tokens を使用します。

サポートモデルマトリクス¶

QCode.cc 経由でアクセスする際、上記すべてのモデルが利用可能です（実証済み）。

effort パラメータ：思考の深さの粗調整ノブ¶

effort は adaptive thinking の総合的な強度（思考 tokens、ツール呼び出し回数、回答の詳細度を含む）を制御します。

経験則：high はほとんどの対話的コーディングタスクのスイートスポット；xhigh は長い agent ループ（複数ステップのコードレビュー、深掘り調査など）で最もコストパフォーマンスが良い；max は正確性がコストよりはるかに重要な場合のみ有効化（本番コード生成、重要なアーキテクチャ決定など）。

API 呼び出し例¶

Python（anthropic SDK）¶

import anthropic

client = anthropic.Anthropic(
    base_url="http://103.236.53.153/api",
    api_key="cr_xxxxxxxx",
)

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "xhigh"},
    messages=[{"role": "user", "content": "重构 user service 模块的认证逻辑..."}],
)

for block in response.content:
    if block.type == "thinking":
        print(f"[思考] {block.thinking}")
    elif block.type == "text":
        print(f"[回答] {block.text}")

TypeScript（@anthropic-ai/sdk）¶

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "http://103.236.53.153/api",
  apiKey: "cr_xxxxxxxx",
});

const response = await client.messages.create({
  model: "claude-opus-4-7",
  max_tokens: 16000,
  thinking: { type: "adaptive" },
  output_config: { effort: "xhigh" },
  messages: [{ role: "user", content: "重构 user service..." }],
});

Claude Code CLI¶

CLI では effort をショートカットキー Tab で切り替えます。現在の effort はステータスバーに表示されます。Opus 4.7 はデフォルトで xhigh ですが、手動で medium まで下げて tokens を節約できます。

思考内容のレンダリング¶

Opus 4.7 はデフォルトで思考テキストを表示しません（thinking.display: "omitted"）、内部推論のみです。UI で思考過程を表示したい場合：

thinking={"type": "adaptive", "display": "summarized"}

display: "summarized" はモデルに思考サマリ（可視の thinking blocks）を出力させます；omitted は思考 tokens をカウントするのみでテキストは出力しません。Sonnet 4.6 / Haiku 4.5 はデフォルトで summarized です。

Task Budgets（Opus 4.7 Beta）¶

agent ループを実行し、ターン全体（思考 + ツール + 最終出力を含む）に対してグローバルな上限を設けたい場合は task_budget を使用します：

response = client.beta.messages.create(
    betas=["task-budgets-2026-03-13"],
    model="claude-opus-4-7",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={
        "effort": "high",
        "task_budget": {"type": "tokens", "total": 128000},
    },
    messages=[...],
)

モデルは残り予算のカウントダウンを見ながら、超過しないように自己調整します。total の最小値は 20,000 です。

コスト観測の推奨事項¶

adaptive thinking を有効化すると入力 / 出力 token が増加するため、監視が必要です：

print(response.usage)
# 注目：input_tokens、output_tokens、cache_read_input_tokens
# Adaptive thinking は thinking tokens を個別に課金しません——output_tokens に含まれます

QCode.cc ユーザーの場合、リクエストは probe.qcode.cc にレポートされます（深圳ダイレクトノード 103.236.53.153/api のみ）——そこで各リクエストの input / output / 思考の比率を確認できます。

よくある質問¶

budget_tokens から adaptive thinking への移行はどう換算しますか？¶

線形の換算関係はありません。budget_tokens=8000 は特定の effort レベルと等価ではありません。effort: "medium" から始めてテストし、回答品質と token 使用量に応じて調整することを推奨します。ハードリミットが必須の場合は task_budget を使用できます（上記参照）。

Opus 4.7 でリクエストが 400 エラーになり budget_tokens が許可されないと表示される¶

thinking={"type": "enabled", "budget_tokens": N} をすべて thinking={"type": "adaptive"} に変更してください。budget_tokens フィールドは Opus 4.7 で完全に削除されています（任意の値で 400）。

Sonnet 4.6 で budget_tokens を使い続けるべきですか？¶

推奨しません。新しいコードはすべて adaptive thinking を使用してください。budget_tokens は 4.6 でも動作しますが deprecated パスであり、将来のいずれかのバージョンで削除されます。

Claude Code CLI で effort をどう変更しますか？¶

CLI ステータスバーに表示される effort は Tab で切り替えます。永続化されたデフォルト値は ~/.claude/settings.json 内の "effort" フィールドにあります。

次のステップ¶

• モデル選択ガイド — 各モデルの料金、能力比較
• ベストプラクティス — 大規模コンテキスト、agent ワークフローの prompt テクニック
• 接続点と API 形式 — QCode.cc 接続ドメイン全表
• Claude Code 完全チュートリアル — CLI の全機能の使い方