Extended Thinking Claude : Raisonnement Approfondi en Pratique

Qu'est-ce que l'Extended Thinking ?

L'Extended Thinking est une fonctionnalité qui permet à Claude de réfléchir en profondeur avant de répondre. Au lieu de générer immédiatement une réponse, Claude :

1. →Explore différentes approches au problème
2. →Vérifie son raisonnement étape par étape
3. →Corrige ses erreurs en cours de route
4. →Formule une réponse finale plus fiable

C'est l'équivalent de demander à un expert de prendre le temps de réfléchir plutôt que de répondre instantanément.

Sans vs Avec Extended Thinking

Activer l'Extended Thinking via l'API

Implémentation de Base

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000  # Budget max pour la réflexion
    },
    messages=[{
        "role": "user",
        "content": "Résous ce problème de programmation dynamique : étant donné un tableau d'entiers, trouve la sous-séquence croissante la plus longue."
    }]
)

# Parcourir les blocs de réponse
for block in response.content:
    if block.type == "thinking":
        print("🧠 Réflexion :")
        print(block.thinking)
        print("---")
    elif block.type == "text":
        print("💬 Réponse :")
        print(block.text)

Thinking Adaptatif (Claude 4.6)

Le thinking adaptatif de Claude 4.6 ajuste automatiquement l'effort de réflexion selon la complexité :

response = client.messages.create(
    model="claude-opus-4-20250918",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000  # Budget MAXIMUM, pas fixe
    },
    messages=[{
        "role": "user",
        "content": "Quelle est la capitale de la France ?"
    }]
)
# → Thinking minimal (~50 tokens) car la question est simple

response2 = client.messages.create(
    model="claude-opus-4-20250918",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    messages=[{
        "role": "user",
        "content": "Prouve que la racine carrée de 2 est irrationnelle."
    }]
)
# → Thinking étendu (~5000 tokens) car le problème est complexe

Budget Tokens : Optimiser le Coût

Le budget_tokens définit le nombre maximum de tokens que Claude peut utiliser pour réfléchir.

Stratégie d'Allocation

def get_thinking_budget(task_type):
    """Retourne un budget thinking adapté au type de tâche."""
    budgets = {
        "simple_qa": 1000,
        "code_review": 5000,
        "bug_fix": 8000,
        "algorithm_design": 12000,
        "math_proof": 20000,
        "architecture": 15000,
    }
    return budgets.get(task_type, 5000)

# Utilisation
budget = get_thinking_budget("bug_fix")
response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": budget},
    messages=[{"role": "user", "content": "..."}]
)

Contraintes Importantes

• →Minimum : budget_tokens doit être ≥ 1024
• →Maximum : budget_tokens + max_tokens ne doit pas dépasser la limite du modèle
• →Facturation : Les thinking tokens sont facturés au tarif des tokens de sortie
• →Pas de cache : Les thinking tokens ne sont pas éligibles au prompt caching

Quand Utiliser l'Extended Thinking ?

✅ À Utiliser

❌ À Éviter

• →Questions factuelles simples : "Quelle est la capitale de la France ?" → Pas besoin
• →Tâches créatives libres : "Écris un poème" → Le thinking n'améliore pas la créativité
• →chatbots à faible latence : Le thinking ajoute de la latence
• →Budget serré : Les thinking tokens sont facturés et s'additionnent vite

Streaming avec Extended Thinking

with client.messages.stream(
    model="claude-sonnet-4-20250514",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 8000},
    messages=[{"role": "user", "content": "Conçois une base de données pour un réseau social."}]
) as stream:
    current_type = None
    for event in stream:
        if hasattr(event, 'type'):
            if event.type == "content_block_start":
                block_type = event.content_block.type
                if block_type == "thinking":
                    print("\n🧠 Réflexion en cours...")
                    current_type = "thinking"
                elif block_type == "text":
                    print("\n💬 Réponse :")
                    current_type = "text"
            elif event.type == "content_block_delta":
                if current_type == "thinking" and hasattr(event.delta, 'thinking'):
                    print(event.delta.thinking, end="")
                elif current_type == "text" and hasattr(event.delta, 'text'):
                    print(event.delta.text, end="")

Ordre des Blocs en Streaming

1. message_start
2. content_block_start (type: "thinking")
3. content_block_delta (thinking content...)  ← blocs de réflexion
4. content_block_stop
5. content_block_start (type: "text")
6. content_block_delta (text content...)     ← réponse finale
7. content_block_stop
8. message_stop

Benchmarks de Performance

L'Extended Thinking améliore significativement les performances sur les benchmarks de raisonnement :

Patterns Avancés

Conversation Multi-tours avec Thinking

messages = []

def chat_with_thinking(user_msg, budget=5000):
    messages.append({"role": "user", "content": user_msg})
    
    response = client.messages.create(
        model="claude-sonnet-4-20250514",
        max_tokens=16000,
        thinking={"type": "enabled", "budget_tokens": budget},
        messages=messages
    )
    
    # Ajouter la réponse complète (sans les thinking blocks)
    assistant_content = [
        block for block in response.content
        if block.type == "text"
    ]
    messages.append({"role": "assistant", "content": assistant_content})
    
    return response

# Utilisation
chat_with_thinking("Conçois un algorithme de recommandation.", budget=10000)
chat_with_thinking("Optimise-le pour la scalabilité.", budget=8000)

Budget Dynamique selon la Complexité

def estimate_complexity(message):
    """Estime la complexité d'une question pour ajuster le budget."""
    complexity_indicators = {
        "prouve": 3, "démontre": 3, "optimise": 2,
        "algorithme": 2, "architecture": 2, "compare": 1,
        "conçois": 2, "debug": 2, "pourquoi": 1,
        "analyse": 1, "explique": 0.5
    }
    
    score = sum(
        weight for keyword, weight in complexity_indicators.items()
        if keyword in message.lower()
    )
    
    if score <= 1:
        return 2000
    elif score <= 3:
        return 6000
    elif score <= 5:
        return 12000
    else:
        return 20000

budget = estimate_complexity("Prouve et démontre que cet algorithme est optimal.")
# → 20000 tokens (complexité élevée)

Erreurs Courantes