Loading...
    • Guida per sviluppatori
    • Riferimento API
    • MCP
    • Risorse
    • Note sulla versione
    Search...
    ⌘K
    Primi passi
    Introduzione a ClaudeAvvio rapido
    Modelli e prezzi
    Panoramica dei modelliScelta di un modelloNovità in Claude 4.6Guida alla migrazioneDeprecazione dei modelliPrezzi
    Sviluppa con Claude
    Panoramica delle funzionalitàUtilizzo dell'API MessagesGestione dei motivi di arrestoBest practice per i prompt
    Gestione del contesto
    Finestre di contestoCompattazioneModifica del contesto
    Capacità
    Caching dei promptExtended thinkingAdaptive thinkingSforzoStreaming dei messaggiElaborazione in batchCitazioniSupporto multilingueConteggio dei tokenEmbeddingsVisioneSupporto PDFAPI FilesRisultati di ricercaOutput strutturati
    Strumenti
    PanoramicaCome implementare l'uso degli strumentiStreaming granulare degli strumentiStrumento BashStrumento di esecuzione del codiceChiamata programmatica degli strumentiStrumento Computer useStrumento Editor di testoStrumento Web fetchStrumento Web searchStrumento MemoryStrumento Tool search
    Agent Skills
    PanoramicaAvvio rapidoBest practiceSkills per l'aziendaUtilizzo di Skills con l'API
    Agent SDK
    PanoramicaAvvio rapidoTypeScript SDKTypeScript V2 (anteprima)Python SDKGuida alla migrazione
    MCP nell'API
    Connettore MCPServer MCP remoti
    Claude su piattaforme di terze parti
    Amazon BedrockMicrosoft FoundryVertex AI
    Prompt engineering
    PanoramicaGeneratore di promptUsa modelli di promptMiglioratore di promptSii chiaro e direttoUsa esempi (multishot prompting)Lascia che Claude pensi (CoT)Usa tag XMLDai a Claude un ruolo (prompt di sistema)Concatena prompt complessiSuggerimenti per il contesto lungoSuggerimenti per extended thinking
    Test e valutazione
    Definisci i criteri di successoSviluppa casi di testUtilizzo dello strumento di valutazioneRiduzione della latenza
    Rafforza i guardrail
    Riduci le allucinazioniAumenta la coerenza dell'outputMitigare i jailbreakStreaming dei rifiutiRiduci la perdita di promptMantieni Claude in carattere
    Amministrazione e monitoraggio
    Panoramica dell'API AdminResidenza dei datiWorkspaceAPI di utilizzo e costiAPI Claude Code AnalyticsZero Data Retention
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Modelli e prezzi

    Guida alla migrazione

    Guida per la migrazione ai modelli Claude 4.6 dalle versioni precedenti di Claude

    Migrazione a Claude 4.6

    Claude Opus 4.6 è un sostituto quasi drop-in per Claude 4.5, con alcuni cambiamenti significativi di cui essere consapevoli. Per un elenco completo delle nuove funzionalità, vedi Novità in Claude 4.6.

    Aggiorna il nome del tuo modello

    # Migrazione Opus
    model="claude-opus-4-5"     # Prima
    model="claude-opus-4-6"       # Dopo

    Cambiamenti significativi

    1. Rimozione del prefill: Il prefill dei messaggi dell'assistente restituisce un errore 400 sui modelli Claude 4.6. Utilizza output strutturati, istruzioni nel prompt di sistema, o output_config.format invece.

    2. Quotazione dei parametri dello strumento: I modelli Claude 4.6 possono produrre un escaping JSON leggermente diverso delle stringhe negli argomenti delle chiamate di strumento (ad es., gestione diversa degli escape Unicode o dell'escaping della barra). Se analizzi l'input della chiamata di strumento come una stringa grezza anziché utilizzare un parser JSON, verifica la tua logica di parsing. I parser JSON standard (come json.loads() o JSON.parse()) gestiscono automaticamente queste differenze.

    Modifiche consigliate

    Questi non sono obbligatori ma miglioreranno la tua esperienza:

    1. Migra al pensiero adattivo: thinking: {type: "enabled", budget_tokens: N} è deprecato sui modelli Claude 4.6 e verrà rimosso in una futura versione del modello. Passa a thinking: {type: "adaptive"} e utilizza il parametro effort per controllare la profondità del pensiero. Vedi Pensiero adattivo.

      response = client.beta.messages.create(
          model="claude-opus-4-5",
          max_tokens=16000,
          thinking={
              "type": "enabled",
              "budget_tokens": 32000
          },
          betas=["interleaved-thinking-2025-05-14"],
          messages=[...]
      )

      Nota che la migrazione passa anche da client.beta.messages.create a client.messages.create — il pensiero adattivo e l'effort sono funzionalità GA e non richiedono lo spazio dei nomi beta SDK o alcun header beta.

    2. Rimuovi l'header beta effort: Il parametro effort è ora GA. Rimuovi betas=["effort-2025-11-24"] dalle tue richieste.

    3. Rimuovi l'header beta del fine-grained tool streaming: Il fine-grained tool streaming è ora GA. Rimuovi betas=["fine-grained-tool-streaming-2025-05-14"] dalle tue richieste.

    4. Rimuovi l'header beta del pensiero interleaved: Il pensiero adattivo abilita automaticamente il pensiero interleaved. Rimuovi betas=["interleaved-thinking-2025-05-14"] dalle tue richieste.

    5. Migra a output_config.format: Se utilizzi output strutturati, aggiorna output_format={...} a output_config={"format": {...}}. Il vecchio parametro rimane funzionale ma è deprecato e verrà rimosso in una futura versione del modello.

    Migrazione da Claude 4.1 o versioni precedenti a Claude 4.6

    Se stai migrando da Opus 4.1, Sonnet 4, o modelli precedenti direttamente a Claude 4.6, applica i cambiamenti significativi di Claude 4.6 sopra più i cambiamenti aggiuntivi in questa sezione.

    # Da Opus 4.1
    model="claude-opus-4-1-20250805"    # Prima
    model="claude-opus-4-6"               # Dopo
    
    # Da Sonnet 4
    model="claude-sonnet-4-20250514"    # Prima
    model="claude-opus-4-6"              # Dopo
    
    # Da Sonnet 3.7
    model="claude-3-7-sonnet-20250219"  # Prima
    model="claude-opus-4-6"              # Dopo

    Cambiamenti significativi aggiuntivi

    1. Parametri di campionamento

      Questo è un cambiamento significativo dai modelli Claude 3.x.

      Utilizza solo temperature O top_p, non entrambi:

      # Prima - Questo genererà un errore nei modelli Claude 4+
      response = client.messages.create(
          model="claude-3-7-sonnet-20250219",
          temperature=0.7,
          top_p=0.9,  # Non puoi usare entrambi
          ...
      )
      
      # Dopo
      response = client.messages.create(
          model="claude-opus-4-6",
          temperature=0.7,  # Usa temperature O top_p, non entrambi
          ...
      )
    2. Versioni degli strumenti

      Questo è un cambiamento significativo dai modelli Claude 3.x.

      Aggiorna alle versioni più recenti degli strumenti. Rimuovi qualsiasi codice che utilizza il comando undo_edit.

      # Prima
      tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
      
      # Dopo
      tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
      • Editor di testo: Utilizza text_editor_20250728 e str_replace_based_edit_tool. Vedi Documentazione dello strumento editor di testo per i dettagli.
      • Esecuzione del codice: Aggiorna a code_execution_20250825. Vedi Documentazione dello strumento di esecuzione del codice per le istruzioni di migrazione.
    3. Gestisci il motivo di arresto refusal

      Aggiorna la tua applicazione per gestire i motivi di arresto refusal:

      response = client.messages.create(...)
      
      if response.stop_reason == "refusal":
          # Gestisci il rifiuto in modo appropriato
          pass
    4. Gestisci il motivo di arresto model_context_window_exceeded

      I modelli Claude 4.5+ restituiscono un motivo di arresto model_context_window_exceeded quando la generazione si interrompe a causa del raggiungimento del limite della finestra di contesto, anziché il limite max_tokens richiesto. Aggiorna la tua applicazione per gestire questo nuovo motivo di arresto:

      response = client.messages.create(...)
      
      if response.stop_reason == "model_context_window_exceeded":
          # Gestisci il limite della finestra di contesto in modo appropriato
          pass
    5. Gestione dei parametri dello strumento (newline finali)

      I modelli Claude 4.5+ preservano le newline finali nei parametri di stringa della chiamata di strumento che erano precedentemente rimosse. Se i tuoi strumenti si basano su corrispondenze di stringhe esatte rispetto ai parametri della chiamata di strumento, verifica che la tua logica gestisca correttamente le newline finali.

    6. Aggiorna i tuoi prompt per i cambiamenti comportamentali

      I modelli Claude 4+ hanno uno stile di comunicazione più conciso e diretto e richiedono indicazioni esplicite. Rivedi le best practice di prompting per la guida all'ottimizzazione.

    Modifiche consigliate aggiuntive

    • Rimuovi gli header beta legacy: Rimuovi token-efficient-tools-2025-02-19 e output-128k-2025-02-19 — tutti i modelli Claude 4+ hanno l'utilizzo di strumenti efficienti in termini di token integrato e questi header non hanno alcun effetto.

    Checklist di migrazione Claude 4.6

    • Aggiorna l'ID del modello a claude-opus-4-6
    • SIGNIFICATIVO: Rimuovi i prefill dei messaggi dell'assistente (restituisce errore 400); utilizza output strutturati o output_config.format invece
    • Consigliato: Migra da thinking: {type: "enabled", budget_tokens: N} a thinking: {type: "adaptive"} con il parametro effort (budget_tokens è deprecato e verrà rimosso in una futura versione)
    • Verifica che il parsing JSON delle chiamate di strumento utilizzi un parser JSON standard
    • Rimuovi l'header beta effort-2025-11-24 (effort è ora GA)
    • Rimuovi l'header beta fine-grained-tool-streaming-2025-05-14
    • Rimuovi l'header beta interleaved-thinking-2025-05-14
    • Migra output_format a output_config.format (se applicabile)
    • Se stai migrando da Claude 4.1 o versioni precedenti: aggiorna i parametri di campionamento per utilizzare solo temperature O top_p
    • Se stai migrando da Claude 4.1 o versioni precedenti: aggiorna le versioni degli strumenti (text_editor_20250728, code_execution_20250825)
    • Se stai migrando da Claude 4.1 o versioni precedenti: gestisci il motivo di arresto refusal
    • Se stai migrando da Claude 4.1 o versioni precedenti: gestisci il motivo di arresto model_context_window_exceeded
    • Se stai migrando da Claude 4.1 o versioni precedenti: verifica la gestione dei parametri di stringa dello strumento per le newline finali
    • Se stai migrando da Claude 4.1 o versioni precedenti: rimuovi gli header beta legacy (token-efficient-tools-2025-02-19, output-128k-2025-02-19)
    • Rivedi e aggiorna i prompt seguendo le best practice di prompting
    • Testa nell'ambiente di sviluppo prima della distribuzione in produzione

    Migrazione a Claude Sonnet 4.5

    Claude Sonnet 4.5 combina un'intelligenza forte con prestazioni veloci, rendendolo ideale per compiti di codifica, analisi e contenuti quotidiani.

    Per una panoramica completa delle capacità, vedi la panoramica dei modelli.

    I prezzi di Sonnet 4.5 sono $3 per milione di token di input, $15 per milione di token di output. Vedi Prezzi di Claude per i dettagli.

    Aggiorna il nome del tuo modello:

    # Da Sonnet 4
    model="claude-sonnet-4-20250514"        # Prima
    model="claude-sonnet-4-5-20250929"      # Dopo
    
    # Da Sonnet 3.7
    model="claude-3-7-sonnet-20250219"      # Prima
    model="claude-sonnet-4-5-20250929"      # Dopo

    Considera di abilitare il pensiero esteso per miglioramenti significativi delle prestazioni su compiti di codifica e ragionamento (disabilitato per impostazione predefinita):

    response = client.messages.create(
        model="claude-sonnet-4-5-20250929",
        max_tokens=16000,
        thinking={"type": "enabled", "budget_tokens": 10000},
        messages=[...]
    )

    Cambiamenti significativi

    Questi cambiamenti significativi si applicano quando si esegue la migrazione dai modelli Claude 3.x Sonnet.

    1. Parametri di campionamento

      Questo è un cambiamento significativo dai modelli Claude 3.x.

      Utilizza solo temperature O top_p, non entrambi.

    2. Versioni degli strumenti

      Questo è un cambiamento significativo dai modelli Claude 3.x.

      Aggiorna alle versioni più recenti degli strumenti (text_editor_20250728, code_execution_20250825). Rimuovi qualsiasi codice che utilizza il comando undo_edit.

    3. Gestisci il motivo di arresto refusal

      Aggiorna la tua applicazione per gestire i motivi di arresto refusal.

    4. Aggiorna i tuoi prompt per i cambiamenti comportamentali

      I modelli Claude 4 hanno uno stile di comunicazione più conciso e diretto. Rivedi le best practice di prompting per la guida all'ottimizzazione.

    Checklist di migrazione Sonnet 4.5

    • Aggiorna l'ID del modello a claude-sonnet-4-5-20250929
    • SIGNIFICATIVO: Aggiorna le versioni degli strumenti alle più recenti (text_editor_20250728, code_execution_20250825) — le versioni legacy non sono supportate (se stai migrando da 3.x)
    • SIGNIFICATIVO: Rimuovi qualsiasi codice che utilizza il comando undo_edit (se applicabile)
    • SIGNIFICATIVO: Aggiorna i parametri di campionamento per utilizzare solo temperature O top_p, non entrambi (se stai migrando da 3.x)
    • Gestisci il nuovo motivo di arresto refusal nella tua applicazione
    • Rivedi e aggiorna i prompt seguendo le best practice di prompting
    • Considera di abilitare il pensiero esteso per compiti di ragionamento complesso
    • Testa nell'ambiente di sviluppo prima della distribuzione in produzione

    Migrazione a Claude Haiku 4.5

    Claude Haiku 4.5 è il nostro modello Haiku più veloce e intelligente con prestazioni quasi frontier, fornendo qualità del modello premium per applicazioni interattive e elaborazione ad alto volume.

    Per una panoramica completa delle capacità, vedi la panoramica dei modelli.

    I prezzi di Haiku 4.5 sono $1 per milione di token di input, $5 per milione di token di output. Vedi Prezzi di Claude per i dettagli.

    Aggiorna il nome del tuo modello:

    # Da Haiku 3.5
    model="claude-3-5-haiku-20241022"      # Prima
    model="claude-haiku-4-5-20251001"      # Dopo

    Rivedi i nuovi limiti di velocità: Haiku 4.5 ha limiti di velocità separati da Haiku 3.5. Vedi Documentazione dei limiti di velocità per i dettagli.

    Considera di abilitare il pensiero esteso per miglioramenti significativi delle prestazioni su compiti di codifica e ragionamento (disabilitato per impostazione predefinita):

    response = client.messages.create(
        model="claude-haiku-4-5-20251001",
        max_tokens=16000,
        thinking={"type": "enabled", "budget_tokens": 5000},
        messages=[...]
    )

    Il pensiero esteso influisce sull'efficienza della memorizzazione nella cache dei prompt.

    Esplora le nuove capacità: Vedi la panoramica dei modelli per i dettagli sulla consapevolezza del contesto, capacità di output aumentata (64K token), intelligenza superiore e velocità migliorata.

    Cambiamenti significativi

    Questi cambiamenti significativi si applicano quando si esegue la migrazione dai modelli Claude 3.x Haiku.

    1. Parametri di campionamento

      Questo è un cambiamento significativo dai modelli Claude 3.x.

      Utilizza solo temperature O top_p, non entrambi.

    2. Versioni degli strumenti

      Questo è un cambiamento significativo dai modelli Claude 3.x.

      Aggiorna alle versioni più recenti degli strumenti (text_editor_20250728, code_execution_20250825). Rimuovi qualsiasi codice che utilizza il comando undo_edit.

    3. Gestisci il motivo di arresto refusal

      Aggiorna la tua applicazione per gestire i motivi di arresto refusal.

    4. Aggiorna i tuoi prompt per i cambiamenti comportamentali

      I modelli Claude 4 hanno uno stile di comunicazione più conciso e diretto. Rivedi le best practice di prompting per la guida all'ottimizzazione.

    Checklist di migrazione Haiku 4.5

    • Aggiorna l'ID del modello a claude-haiku-4-5-20251001
    • SIGNIFICATIVO: Aggiorna le versioni degli strumenti alle più recenti (text_editor_20250728, code_execution_20250825) — le versioni legacy non sono supportate
    • SIGNIFICATIVO: Rimuovi qualsiasi codice che utilizza il comando undo_edit (se applicabile)
    • SIGNIFICATIVO: Aggiorna i parametri di campionamento per utilizzare solo temperature O top_p, non entrambi
    • Gestisci il nuovo motivo di arresto refusal nella tua applicazione
    • Rivedi e regola per i nuovi limiti di velocità (separati da Haiku 3.5)
    • Rivedi e aggiorna i prompt seguendo le best practice di prompting
    • Considera di abilitare il pensiero esteso per compiti di ragionamento complesso
    • Testa nell'ambiente di sviluppo prima della distribuzione in produzione

    Hai bisogno di aiuto?

    • Controlla la nostra documentazione API per le specifiche dettagliate
    • Rivedi le capacità del modello per i confronti delle prestazioni
    • Rivedi le note di rilascio dell'API per gli aggiornamenti dell'API
    • Contatta il supporto se riscontri problemi durante la migrazione

    Was this page helpful?

    • Migrazione a Claude 4.6
    • Aggiorna il nome del tuo modello
    • Cambiamenti significativi
    • Modifiche consigliate
    • Migrazione da Claude 4.1 o versioni precedenti a Claude 4.6
    • Checklist di migrazione Claude 4.6
    • Migrazione a Claude Sonnet 4.5
    • Cambiamenti significativi
    • Checklist di migrazione Sonnet 4.5
    • Migrazione a Claude Haiku 4.5
    • Cambiamenti significativi
    • Checklist di migrazione Haiku 4.5
    • Hai bisogno di aiuto?