Guida ai nuovi parametri di Claude Opus 4.7

Questo articolo illustra due modifiche fondamentali al controllo del ragionamento in Claude Opus 4.7, insieme a istruzioni complete per l'uso sia con l'API nativa di AIHubmix sia con l'interfaccia unificata Chat. Vedi anche: annuncio ufficiale di Anthropic e registro delle modifiche del modello.

AIHubMix3 min di lettura
Guida ai nuovi parametri di Claude Opus 4.7

​1. Nuove funzionalità di controllo del ragionamento

​✦ Nuovo livello di sforzo di ragionamento xhigh

Il nuovo livello xhigh si colloca tra high e max, pensato specificamente per attività di coding e agentiche, offrendo un migliore equilibrio tra capacità ed efficienza.

low  ──  medium  ──  high  ──  xhigh ★NEW  ──  max

​✦ Contenuto del ragionamento nascosto per impostazione predefinita

Nelle risposte in streaming, il processo di ragionamento non viene più mostrato per impostazione predefinita. Per ricevere un riepilogo del ragionamento, passa esplicitamente il campo display nella richiesta:

valore di displayOpus 4.7Opus 4.6Comportamento
"omitted"PredefinitoNon predefinitoIl contenuto del blocco di ragionamento è vuoto
"summarized"Da impostare manualmentePredefinitoRestituisce il testo del riepilogo del ragionamento
"reasoning": {
  "effort": "xhigh",
  "display": "summarized"
}
Figura: Opus 4.7, nuovo livello xhigh — Confronto delle prestazioni in coding agentico (Fonte: Anthropic ufficiale)
Image

​2. Riferimento per l'API nativa di Claude

​I valori di effort per l'API nativa di Anthropic sono coerenti con la specifica ufficiale:

valore di effortModelli supportatiDescrizioneCaso d'uso consigliato
lowTutti i modelli supportatiNotevole risparmio di token con un moderato compromesso sulle capacitàAttività semplici, richieste ad alta concorrenza, sub-agenti
mediumTutti i modelli supportatiModalità bilanciata con un moderato risparmio di tokenAttività agentiche generali
highTutti i modelli supportatiPredefinito; prestazioni di capacità elevateRagionamento complesso, coding, attività agentiche
xhigh (nuovo)Solo Opus 4.7Capacità estesa tra high e max; eccelle nelle attività a lungo orizzontePunto di partenza consigliato per attività di coding e agentiche
maxSerie OpusCapacità massimaProblemi di ricerca all'avanguardia

​Esempio AIHubmix con API nativa di Claude — 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"},  # Options: low / medium / high / xhigh / max
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ]
)

print(response.content[-1].text)

​3. Supporto dello sforzo di ragionamento nell'interfaccia unificata Chat di AIHubmix

L'interfaccia unificata Chat di AIHubMix è allineata alla specifica OpenAI e controlla l'intensità del ragionamento tramite reasoning.effort. I diversi modelli Claude vengono automaticamente mappati al livello di sforzo corrispondente:

​reasoning_effort (controllo dell'intensità del ragionamento) per i modelli Claude

valore di effortOpus >=4.7 (nuovo)Opus 4.6 / 4.5Sonnet 4.6
minimallowlowlow
mediummediummediummedium
highhighhighhigh
xhighxhighmaxhigh
maxmaxmaxhigh

Nota: xhigh è supportato nativamente solo su Opus 4.7. Gli altri modelli Opus ricadono automaticamente su max, mentre la serie Sonnet ricade su high.

​Esempio di interfaccia unificata Chat — 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,  # Default is 4096; enable for longer outputs
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh"}
    }
)

print(completion.choices[0].message.content)

​4. Controllo del contenuto del ragionamento nell'interfaccia unificata Chat

Nell'interfaccia compatibile con OpenAI, reasoning supporta il campo display per controllare se vengono restituiti i riepiloghi del ragionamento.Claude Opus 4.7 non restituisce il contenuto del ragionamento per impostazione predefinita. Imposta "display": "summarized" per abilitarlo.

CampoValoreDescrizione
display(omesso)Contenuto del ragionamento non restituito (predefinito)
display"summarized"Restituisce un riepilogo del ragionamento

​Opus 4.7 — Esempio di riepilogo del ragionamento

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": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh", "display": "summarized"}
    }
)

print(completion.choices[0].message.content)

​Per maggiori dettagli, consulta la documentazione di AIHubmix oppure la documentazione ufficiale di Anthropic.

Ultimo aggiornamento: 2026-06-01