Claude Extended Thinking が止まる・タイムアウトする問題の実践的な対処法

import anthropic
 
client = anthropic.Anthropic()
 
# ❌ タイムアウトリスクが高い（非ストリーミング）
# response = client.messages.create(
#     model="claude-sonnet-4-6",
#     max_tokens=16000,
#     thinking={
#         "type": "enabled",
#         "budget_tokens": 10000
#     },
#     messages=[...]
# )
 
# ✅ ストリーミングでタイムアウトを回避
with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    messages=[
        {"role": "user", "content": "複雑な質問をここに書く"}
    ]
) as stream:
    for event in stream:
        # イベントタイプに応じて処理
        if hasattr(event, 'type'):
            if event.type == 'content_block_delta':
                pass  # テキストデルタの処理

# 問題の複雑さに応じたbudget_tokens の目安
BUDGET_PRESETS = {
    "simple": 5_000,      # 単純な数学・論理問題
    "moderate": 10_000,   # 複数ステップの推論
    "complex": 20_000,    # 複雑な分析・設計タスク
    "extreme": 50_000,    # 非常に難しい研究・哲学的問題
}

# ❌ 問題のある設定例
response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=5000,  # 思考に5000使い切ったら回答できない！
    thinking={
        "type": "enabled",
        "budget_tokens": 5000  # max_tokens と同じ値は危険
    },
    ...
)
 
# ✅ 正しい設定例
response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=20000,  # 思考トークン + 最終回答分を確保
    thinking={
        "type": "enabled",
        "budget_tokens": 15000  # max_tokens より小さく設定
    },
    ...
)

# ❌ 曖昧なプロンプト
messages = [
    {"role": "user", "content": "このビジネスプランを評価してください"}
]
 
# ✅ 構造化されたプロンプト
messages = [
    {
        "role": "user",
        "content": """
以下のビジネスプランを評価してください。
 
【評価の観点】
1. 市場規模の妥当性（日本市場、数値根拠を中心に）
2. 競合優位性（既存3社との比較）
3. 財務的実現可能性（3年間のキャッシュフロー観点から）
 
【制約】
- 評価は各観点100〜200字でまとめること
- 「可能性がある」等の曖昧な表現を避け、根拠を示すこと
- 総合評価は5段階で最後に示すこと
 
【ビジネスプラン】
{business_plan}
"""
    }
]

# 使用トークン数を必ず記録する
response = client.messages.create(...)
 
thinking_tokens = sum(
    len(block.thinking) if hasattr(block, 'thinking') else 0
    for block in response.content
    if block.type == 'thinking'
)
answer_tokens = response.usage.output_tokens - thinking_tokens
 
print(f"思考トークン: {thinking_tokens:,}")
print(f"回答トークン: {answer_tokens:,}")
print(f"合計コスト概算: ${(response.usage.input_tokens * 3 + response.usage.output_tokens * 15) / 1_000_000:.4f}")

def ask_claude(question: str, complexity: str = "auto") -> str:
    """
    複雑さに応じてExtended Thinkingを動的に切り替える
    """
    use_thinking = complexity == "high" or (
        complexity == "auto" and _is_complex_question(question)
    )
 
    kwargs = {
        "model": "claude-sonnet-4-6",
        "max_tokens": 8000,
        "messages": [{"role": "user", "content": question}]
    }
 
    if use_thinking:
        kwargs["thinking"] = {"type": "enabled", "budget_tokens": 10000}
        kwargs["max_tokens"] = 20000
 
    return client.messages.create(**kwargs)
 
def _is_complex_question(question: str) -> bool:
    """簡易的な複雑さ判定"""
    complexity_keywords = ["証明", "最適化", "なぜ", "比較", "設計", "分析"]
    return any(kw in question for kw in complexity_keywords)

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=20000,
    thinking={"type": "enabled", "budget_tokens": 15000},
    system=[
        {
            "type": "text",
            "text": "長い専門的なシステムプロンプト...",
            "cache_control": {"type": "ephemeral"}  # キャッシュ有効化
        }
    ],
    messages=[{"role": "user", "content": question}]
)