Claude Sonnet 5 gebruiken: veilige migratie en eerste workflow (2026)

Claude Sonnet 5 is een actuele Sonnet-generatie van Anthropic voor snel, veelzijdig werk met tekst, afbeeldingen, code en tools. Stap je over vanaf Sonnet 4.6, vervang dan niet alleen de model-ID: test opnieuw je tokenbudget, thinking, samplingparameters en foutpaden voordat je productiegebruik wijzigt.

Wil je eerst bepalen of Sonnet 5 bij de taak past, lees dan de gerichte vergelijking van Claude Opus 5 en Sonnet 5. Voor een bredere keuze tussen modellen en leveranciers helpt de AI-modellenkeuzehulp.

In het kort

• Anthropic kondigde Claude Sonnet 5 aan op 30 juni 2026.
• Gebruik in de API de vaste model-ID claude-sonnet-5.
• Sonnet 5 is volgens Anthropic een directe upgrade van Sonnet 4.6, maar heeft relevante API-gedragswijzigingen.
• Adaptive thinking staat standaard aan; de oude handmatige budget_tokens-route werkt niet meer.
• Niet-standaardwaarden voor temperature, top_p en top_k geven HTTP 400.
• De nieuwe tokenizer telt dezelfde tekst anders dan Sonnet 4.6. Meet prompts en uitvoerlimieten opnieuw.
• Een cybersecurity-weigering kan HTTP 200 met stop_reason: "refusal" teruggeven.

Wanneer gebruik je Claude Sonnet 5?

Sonnet 5 is een praktische eerste keuze voor terugkerend werk dat snelheid én een sterke algemene kwaliteit vraagt. Anthropic positioneert het model voor code, agentische taken en kenniswerk. Gebruik die positionering als startpunt, niet als bewijs dat het voor iedere taak de beste uitkomst levert.

Kies één concrete workflow die je al kent, bijvoorbeeld een foutanalyse, documentcontrole of classificatie van binnenkomende verzoeken. Definieer vooraf het gewenste resultaat, toegestane hulpmiddelen en de controles die een mens uitvoert. Voor een eerste gebruik zonder eigen integratie start je met Claude voor beginners; voor repositorywerk is de Claude Code-handleiding de betere route.

Bij een grote, onduidelijke of langdurige agenttaak kan een andere Claude-klasse beter passen. Vergelijk dan op dezelfde testset in plaats van alleen op een modelnaam. De actuele modeldocumentatie van Anthropic noemt Sonnet 5 snel, met een contextvenster van 1 miljoen tokens en maximaal 128.000 uitvoertokens voor een synchroon Messages API-verzoek.

Wat verandert er ten opzichte van Sonnet 4.6?

Anthropic beschrijft Sonnet 5 als een directe upgrade van Sonnet 4.6. De request- en responsevorm blijft in grote lijnen gelijk, maar vier veranderingen verdienen een expliciete releasecheck.

De details staan in Anthropic's actuele Sonnet 5-documentatie. Test niet met echte klantgegevens als je alleen de technische overgang wilt beoordelen. Maak eerst een representatieve, geanonimiseerde set.

Stappenplan: Claude Sonnet 5 gecontroleerd gebruiken

Stap 1: kies één meetbare taak

Pak geen volledige bedrijfsworkflow tegelijk aan. Kies bijvoorbeeld vijf veelvoorkomende supportvragen, drie bekende codefouten of een vaste documentcontrole. Leg per voorbeeld vast:

1. welke invoer nodig is;
2. welke output bruikbaar is;
3. welke tools wel en niet mogen worden gebruikt;
4. welke fouten onacceptabel zijn;
5. wie het resultaat beoordeelt.

Gebruik voor prompts een vaste opbouw met doel, context, gewenste vorm en controlecriterium. De gids goede prompts maken helpt je dat kort en toetsbaar vast te leggen.

Stap 2: maak de API-configuratie Sonnet-5-geschikt

Vervang de model-ID alleen in centrale configuratie, zodat je de test gemakkelijk kunt herhalen. Gebruik claude-sonnet-5 als model-ID. Anthropic legt uit dat dateloze model-ID's vanaf deze generatie vaste snapshots zijn, zodat je niet zonder eigen wijziging op een latere modelrelease belandt.

Verwijder vervolgens niet-standaardwaarden voor temperature, top_p en top_k. Migreer oude thinking: {"type": "enabled", "budget_tokens": ...}-configuratie naar adaptive thinking en bepaal een passend effort-niveau. Bij de eerste test laat je de overige prompt-, tool- en contextinstellingen gelijk, zodat een verschil verklaarbaar blijft.

Heb je nog geen basisrequest of secretbeheer ingericht, begin dan met Claude API voor beginners. Zet een API-key uitsluitend in een secret store of omgevingsvariabele, nooit in broncode of een promptlog.

Stap 3: meet tokens en begrens de uitvoer opnieuw

De nieuwe tokenizer betekent dat een eerder veilige limiet anders kan uitpakken. Anthropic meldt dat dezelfde tekst gemiddeld ongeveer 30% meer tokens kan opleveren dan bij Sonnet 4.6, afhankelijk van de inhoud. Dat beïnvloedt tokenmeting, de hoeveelheid tekst die in het contextvenster past en limieten die dicht bij de gewenste uitvoerlengte zitten.

Test daarom per voorbeeld:

1. het aantal invoer- en uitvoertokens;
2. of max_tokens voldoende ruimte laat voor thinking én zichtbare uitvoer;
3. of een antwoord onverwacht wordt afgekapt;
4. of je kosten- en capaciteitsmonitoring nog de juiste grenzen hanteert.

Het contextvenster is groot, maar stuur niet automatisch een volledig archief mee. Selecteer alleen actuele, leidende bronnen en laat het model benoemen welke informatie ontbreekt of tegenstrijdig is.

Stap 4: maak weigeringen en fouten zichtbaar

Behandel iedere response als een eigen toestand. Sonnet 5 kan voor verboden of risicovolle cybersecurityonderwerpen een HTTP 200-response met stop_reason: "refusal" teruggeven. Dat is technisch geen netwerkfout, maar ook geen bruikbare normale taakuitvoer.

Controleer minimaal:

1. HTTP-status;
2. stop_reason;
3. het actieve model;
4. gebruikte tools en hun resultaten;
5. volledigheid van de zichtbare uitvoer;
6. eventuele menselijke vervolgactie.

Maak een weigering zichtbaar voor de gebruiker en stop de workflow wanneer de taak buiten het afgesproken beleid valt. Een keten die daarna steeds automatisch een ander model probeert, ondermijnt juist de controle die je wilde inbouwen.

Stap 5: beoordeel de hele workflow

Vergelijk niet alleen het eerste antwoord. Noteer ook hoeveel herstelwerk, extra vragen en menselijke controle nodig waren om tot een goedgekeurd resultaat te komen. Herhaal dezelfde set na een prompt- of configuratiewijziging en verander per ronde één factor.

Gebruik je Sonnet 5 voor een automatisering met meerdere systemen, ontwerp eerst de procesgrenzen, eigenaar en terugval naar handmatig werk. Voor de technische kant van die keten vind je op Hulpbij Hub een route voor automatisering. Voor een werkende AI-aanpak die past bij jouw processen kun je de situatie bespreken via AI-consult.

Een klein API-voorbeeld

Dit voorbeeld laat alleen de modelkeuze zien. Bewaar de sleutel buiten de code en voeg in een echte toepassing foutafhandeling, logging zonder gevoelige promptinhoud en duidelijke acceptatiecontroles toe.

from anthropic import Anthropic

client = Anthropic()

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="Antwoord in het Nederlands. Benoem onzekerheden expliciet.",
    messages=[
        {
            "role": "user",
            "content": "Vat deze gecontroleerde notitie samen in drie punten.",
        }
    ],
)

print(message.stop_reason)

Het voorbeeld is geen uitnodiging om ongecontroleerde bedrijfsdata te versturen. Gebruik een beperkte testset en controleer voordat je output opslaat, deelt of een vervolgactie laat uitvoeren.

Veelgemaakte fouten

Alleen de model-ID vervangen

Sonnet 5 is een directe upgrade, maar tokenmeting, thinking en foutgedrag zijn niet identiek aan Sonnet 4.6. Test de volledige requestketen voordat je een productieconfiguratie wijzigt.

Oude samplingparameters laten staan

Niet-standaardwaarden voor temperature, top_p en top_k geven bij Sonnet 5 HTTP 400. Zoek naar deze instellingen in gedeelde helpers, niet alleen in het eerste API-request.

Thinkingruimte buiten max_tokens rekenen

Bij adaptive thinking omvat max_tokens de totale uitvoer. Een limiet die voor Sonnet 4.6 zonder thinking voldoende was, kan nu zichtbare tekst afkappen.

HTTP 200 als automatisch succes behandelen

Een cybersecurity-weigering kan HTTP 200 met stop_reason: "refusal" teruggeven. Maak die toestand apart zichtbaar en zet geen onbeperkte fallbacklus aan.

Een groot contextvenster volstoppen

1 miljoen tokens is geen reden om alle bestanden, oude versies en dubbele bronnen mee te sturen. Selectie en duidelijke bronprioriteit blijven nodig voor controleerbaar werk.

Veelgestelde vragen

Wat is Claude Sonnet 5?

Claude Sonnet 5 is de actuele Sonnet-generatie van Anthropic. Het model is bedoeld als sterke combinatie van snelheid en intelligentie voor onder meer code, toolgebruik en professioneel kenniswerk.

Welke model-ID gebruik ik voor Claude Sonnet 5?

Gebruik in de Claude API de model-ID claude-sonnet-5. Anthropic documenteert deze dateloze ID als een vast modelmoment, niet als een alias die ongemerkt naar een volgende release wijst.

Kan ik Claude Sonnet 4.6 direct vervangen door Sonnet 5?

Ja, Anthropic beschrijft Sonnet 5 als een directe upgrade van Sonnet 4.6. Test wel opnieuw je tokenbudget, thinking-instellingen, samplingparameters, foutafhandeling en toolworkflow voordat je de wijziging in productie zet.

Waarom kan mijn Sonnet 5-request HTTP 400 geven na een migratie?

Sonnet 5 accepteert geen niet-standaardwaarden voor temperature, top_p en top_k. Ook de oude handmatige extended-thinking-instelling met budget_tokens geeft HTTP 400. Gebruik adaptive thinking en effort, of verwijder de niet-ondersteunde instelling.

Heeft Claude Sonnet 5 een ander contextvenster?

Claude Sonnet 5 ondersteunt standaard een contextvenster van 1 miljoen tokens en maximaal 128.000 uitvoertokens via de synchrone Messages API. Door de nieuwe tokenizer past dezelfde tekst niet automatisch in evenveel tokens als bij Sonnet 4.6.

Hoe behandel ik een weigering van Claude Sonnet 5?

Een verzoek over verboden of risicovolle cybersecurityonderwerpen kan HTTP 200 teruggeven met stop_reason refusal. Behandel dat als een zichtbare weigering, niet als normale taakuitvoer, en start geen onbeperkte automatische fallback.

Bronnen

• Anthropic: introductie van Claude Sonnet 5
• Claude Platform: wat is nieuw in Claude Sonnet 5
• Claude Platform: actueel modeloverzicht
• Claude Platform: model-ID's en versies