Questo articolo tratta due cambiamenti chiave nel controllo del ragionamento in Claude Opus 4.7, insieme a istruzioni complete per l'uso sia dell'API nativa di AIHubmix che dell'interfaccia unificata di Chat. Vedi anche: annuncio ufficiale di Anthropic e registro delle modifiche del modello.
1. Nuove Funzionalità di Controllo del Ragionamento
✦ Nuovo Livello di Sforzo di Ragionamento xhigh
Il nuovo xhigh si colloca tra high e max, progettato specificamente per compiti di codifica e agentici, trovando un migliore equilibrio tra capacità ed efficienza.
low ── medium ── high ── xhigh ★NEW ── max
✦ Contenuto di Pensiero Nascosto per Default
Nei risultati in streaming, il processo di pensiero è non più mostrato per default. Per ricevere un riepilogo del ragionamento, passa esplicitamente il campo display nella tua richiesta:
| valore di display | Opus 4.7 | Opus 4.6 | Comportamento |
|---|---|---|---|
| ”omesso” | Default | Non-default | Il contenuto del blocco di pensiero è vuoto |
| ”riassunto” | Deve essere impostato manualmente | Default | Restituisce il testo del riepilogo del pensiero |
"reasoning": {
"effort": "xhigh",
"display": "summarized"
}
Figura: Nuovo livello xhigh di Opus 4.7 — Confronto delle prestazioni di codifica agentica (Fonte: ufficiale di Anthropic)
2. Riferimento all'API Nativa di Claude
I valori di sforzo per l'API nativa di Anthropic sono coerenti con la specifica ufficiale:
| valore di sforzo | Modelli Supportati | Descrizione | Caso d'uso raccomandato |
|---|---|---|---|
| low | Tutti i modelli supportati | Risparmi significativi di token con un compromesso moderato di capacità | Compiti semplici, richieste ad alta concorrenza, sub-agenti |
| medium | Tutti i modelli supportati | Modalità bilanciata con risparmi moderati di token | Compiti agentici generali |
| high | Tutti i modelli supportati | Default; prestazioni di alta capacità | Ragionamento complesso, codifica, compiti agentici |
| xhigh (nuovo) | Solo Opus 4.7 | Capacità estesa tra high e max; eccelle in compiti a lungo termine | Punto di partenza raccomandato per compiti di codifica e agentici |
| max | Serie Opus | Massima capacità | Problemi di ricerca avanzata |
API Nativa AIHubmix Claude — Esempio Opus 4.7
from anthropic import Anthropic
client = Anthropic(
api_key="<AIHUBMIX_API_KEY>",
base_url="https://aihubmix.com"
)
response = client.messages.create(
model="claude-opus-4-7",
max_tokens=16000,
thinking={"type": "adaptive"},
output_config={"effort": "xhigh"}, # Opzioni: low / medium / high / xhigh / max
messages=[
{
"role": "user",
"content": "Una lumaca si trova in fondo a un pozzo di 10 metri. Ogni giorno sale di 3 metri, ma ogni notte scivola indietro di 2 metri. Quanti giorni ci vogliono per raggiungere la cima?"
}
]
)
print(response.content[-1].text)
3. Supporto per lo Sforzo di Ragionamento nell'Interfaccia Unificata di Chat AIHubmix
L'interfaccia unificata di AIHubMix Chat è allineata con la specifica OpenAI e controlla l'intensità del ragionamento tramite reasoning.effort. I diversi modelli Claude sono automaticamente mappati al corrispondente livello di sforzo:
reasoning_effort (Controllo dell'Intensità del Ragionamento) per i Modelli Claude
| valore di sforzo | Opus >=4.7 (nuovo) | Opus 4.6 / 4.5 | Sonnet 4.6 |
|---|---|---|---|
| minimal | low | low | low |
| medium | medium | medium | medium |
| high | high | high | high |
| xhigh | xhigh | max | high |
| max | max | max | high |
Nota: xhigh è supportato nativamente solo su Opus 4.7. Altri modelli Opus tornano automaticamente a max, e la serie Sonnet torna a high.
Interfaccia Unificata di Chat — Esempio Opus 4.7
from openai import OpenAI
client = OpenAI(
base_url="https://aihubmix.com/v1",
api_key="<AIHUBMIX_API_KEY>",
)
completion = client.chat.completions.create(
model="claude-opus-4-7",
# max_tokens=10000, # Il default è 4096; abilitare per output più lunghi
messages=[
{
"role": "user",
"content": "Una lumaca si trova in fondo a un pozzo di 10 metri. Ogni giorno sale di 3 metri, ma ogni notte scivola indietro di 2 metri. Quanti giorni ci vogliono per raggiungere la cima?"
}
],
extra_body={
"reasoning": {"effort": "xhigh"}
}
)
print(completion.choices[0].message.content)
4. Controllare il Contenuto di Pensiero nell'Interfaccia Unificata di Chat
Nell'interfaccia compatibile con OpenAI, reasoning supporta un campo display per controllare se i riepiloghi di pensiero vengono restituiti.Claude Opus 4.7 non restituisce contenuto di pensiero per default. Imposta "display": "summarized" per abilitarlo.
| Campo | Valore | Descrizione |
|---|---|---|
display | (omesso) | Contenuto di pensiero non restituito (default) |
display | "summarized" | Restituisce un riepilogo del pensiero |
Opus 4.7 — Esempio di Riepilogo di Pensiero
from openai import OpenAI
client = OpenAI(
base_url="https://aihubmix.com/v1",
api_key="<AIHUBMIX_API_KEY>",
)
completion = client.chat.completions.create(
model="claude-opus-4-7",
messages=[
{
"role": "user",
"content": "Una lumaca si trova in fondo a un pozzo di 10 metri. Ogni giorno sale di 3 metri, ma ogni notte scivola indietro di 2 metri. Quanti giorni ci vogliono per raggiungere la cima?"
}
],
extra_body={
"reasoning": {"effort": "xhigh", "display": "summarized"}
}
)
print(completion.choices[0].message.content)
Per ulteriori dettagli, fare riferimento alla documentazione di AIHubmix o alla documentazione ufficiale di Anthropic.
Ultimo aggiornamento: 2026-06-01