Claude Code outputstijlen instellen en aanpassen

Wat een outputstijl is in Claude Code

Een outputstijl in Claude Code is een blok instructies dat Claude Code toevoegt aan zijn systeemprompt. Het verandert de manier waarop Claude u antwoordt: de rol die het aanneemt en de vorm van de uitvoer. Het leert Claude niets over uw codebase en het kan Claude geen toestemming geven om acties uit te voeren.

Claude Code wordt geleverd met vijf ingebouwde stijlen. Uw keuze wordt opgeslagen in één instellingssleutel, outputStyle, en die sleutel wordt eenmalig gelezen wanneer de sessie start. Dat ene feit verklaart de meeste verwarring rondom deze functie, omdat een stijl waarnaar u halverwege een sessie overschakelt wel wordt opgeslagen, maar pas wordt toegepast nadat u de sessie opnieuw start.

Op een VPS is dit meer dan een cosmetische voorkeur. Het transcript is wat u leest via een SSH-verbinding (secure shell), meestal binnen een tmux-venster. Elke regel die Claude genereert, is een regel waar u op wacht en een regel in een scrollback-buffer met een vaste grootte.

Locatie van de outputStyle-instelling

Kies een stijl uit het /config-menu, onder Output style. Claude Code schrijft uw keuze naar .claude/settings.local.json in het project waarin u werkt.

Het zelfstandige /output-style-commando bestaat niet meer. Het werd als verouderd gemarkeerd in v2.1.73 en verwijderd in v2.1.91; op een huidige build doet het dus niets meer. Controleer welke versie u gebruikt voordat u een oudere handleiding volgt. De versies op deze pagina zijn gecontroleerd in augustus 2026.

claude --version

U kunt de sleutel ook handmatig instellen. Vier instellingenbestanden kunnen deze bevatten, waarbij de specifiekere instelling voorrang krijgt op de algemenere.

• ~/.claude/settings.json is uw gebruikersbestand. Dit is van toepassing op elk project op die machine.
• .claude/settings.json is het projectbestand. Dit wordt gecommit naar git en is dus van toepassing op iedereen die de repository kloont.
• .claude/settings.local.json is het lokale projectbestand. Dit wordt niet gecommit en overschrijft beide bovenstaande bestanden. Dit is het bestand waarnaar het /config-menu schrijft.
• Beheerde instellingen, uitgerold door een IT-team vanaf een systeempad zoals /etc/claude-code/ op Linux, overschrijven alles.

De waarde van de sleutel is de naam van de stijl:

{
  "outputStyle": "Concise"
}

Voor slechts één sessie kunt u dezelfde sleutel meegeven via de command line. De --settings-vlag accepteert een pad of een inline JSON-string, en de waarden daarvan overschrijven voor die uitvoering de overeenkomstige sleutels in de instellingenbestanden:

claude --settings '{"outputStyle": "Concise"}'

Menulabels en slash-commando's zijn in de loop van de tijd minstens één keer gewijzigd. De outputStyle-sleutel niet. Wanneer een schermafbeelding in een handleiding niet meer overeenkomt met wat u ziet, stelt u de sleutel direct in en bevestigt u dit met /status, die de actieve instellingenbronnen weergeeft.

Waarom uw nieuwe uitvoerstijl pas werkt na een clear

Claude Code bouwt de system prompt één keer op wanneer de sessie start; de uitvoerstijl maakt deel uit van deze system prompt. Het wijzigen van de instelling tijdens een actieve sessie slaat de waarde wel op, maar verandert niets aan wat u ziet, omdat de lopende sessie de prompt blijft gebruiken die bij de start is opgebouwd. De nieuwe stijl wordt geladen bij de volgende /clear of bij een nieuwe start.

/clear
/context

/context toont wat er momenteel in het contextvenster staat, onderverdeeld per categorie, inclusief de system prompt. Voer dit uit in een nieuwe sessie onder elke stijl; de regel met de system prompt is de invoerzijde van uw vergelijking. Dit is tevens de snelste manier om te verifiëren of een aangepaste stijl daadwerkelijk is geladen. Voor een breder beeld van wat het venster vult, zie hoe context zich vult tijdens een lange Claude Code-sessie.

Er is een reden waarom de instelling wacht in plaats van direct wordt toegepast. De API bedient herhaalde verzoeken vanuit een prompt cache die overeenkomt met het begin van elk verzoek, en de system prompt staat helemaal aan het begin. Het herschrijven ervan midden in een gesprek zou alles wat erachter staat ongeldig maken, waardoor de volgende beurt uw volledige geschiedenis als nieuwe invoer zou verwerken. Het vastleggen van de stijl bij de start van de sessie voorkomt die kosten. Het wisselen van stijlen is goedkoop. Het vereist alleen een clear.

Wat elke ingebouwde outputstijl aanpast aan het transcript

• Default is de standaard systeemprompt van Claude Code, geschreven voor software-engineering.
• Concise begint direct met het resultaat. Het laat de inleiding en de stapsgewijze verslaglegging weg en houdt antwoorden kort totdat u om details vraagt. Het technische werk erachter blijft ongewijzigd. Het kort nooit een foutmelding of beveiligingswaarschuwing in en vraagt nog steeds volledig om toestemming voor een destructieve actie. Deze stijl vereist Claude Code v2.1.237 of hoger.
• Explanatory voegt educatieve "Insights" toe tussen de stappen van een taak, waarin wordt uitgelegd waarom een bepaalde implementatiekeuze is gemaakt en welk patroon uw codebase al gebruikt. Het transcript wordt hierdoor bewust langer.
• Learning gaat nog een stap verder. Claude deelt die inzichten en vraagt u vervolgens om zelf kleine stukjes code te schrijven, waarbij elke plek in het bestand wordt gemarkeerd met een TODO(human)-commentaar.
• Proactive zorgt ervoor dat Claude handelt in plaats van vraagt. Het maakt redelijke aannames bij routinematige beslissingen in plaats van te stoppen voor bevestiging.

Lees die laatste zorgvuldig, want dat is de stijl die mensen vaak verkeerd begrijpen. Proactive is een richtlijn in de systeemprompt. Het verandert wat Claude probeert te doen. Uw toestemmingsmodus bepaalt nog steeds wat er daadwerkelijk wordt uitgevoerd zonder u te vragen; dit is de instelling die ertoe doet op een server die u onbeheerd achterlaat. Dit wordt behandeld in automatische modus en de toestemmingsmodi van Claude Code.

Verschil tussen een output style, CLAUDE.md, een hook en een subagent

Deze methoden lijken allemaal op het instrueren van Claude over hoe hij zich moet gedragen, maar ze werken op verschillende niveaus.

• Een output style wordt toegevoegd aan de system prompt. Deze is van toepassing op elk antwoord in het hoofdgesprek.
• CLAUDE.md wordt als gebruikersbericht toegevoegd na de system prompt. Hier horen projectconventies en feiten over de codebase thuis.
• --append-system-prompt voegt tekst toe aan de system prompt voor één enkele aanroep, zonder iets te verwijderen. Dit is de eenmalige variant van een output style.
• Een hook is een shell-commando dat Claude Code zelf uitvoert wanneer een gebeurtenis plaatsvindt. Dit wordt afgedwongen door de harness, waardoor het wordt uitgevoerd ongeacht of Claude dit zelf zou hebben gekozen. Zie wat een Claude Code hook wel en niet kan.
• Een subagent draait met zijn eigen system prompt en zijn eigen set tools.

Een korte test maakt onderscheid tussen de eerste twee. Feiten over uw project horen in CLAUDE.md, omdat Claude die moet kennen. Formuleringen horen in een uitvoerstijl, omdat die bepalen hoe het antwoord wordt gelezen. Alles wat elke keer moet gebeuren, ongeacht wat het model beslist, is een hook. De laag waarin elk oppervlak zich bevindt, is een eigenschap van het programma waarin het model wordt uitgevoerd en niet van het model zelf. Daarom kan een stijl alleen invloed uitoefenen, terwijl een hook naleving kan afdwingen.

Output styles zijn alleen van toepassing op het hoofdgesprek. Een subagent neemt uw stijl niet over, omdat deze een eigen gesprek start met een eigen system prompt. Een fork van het huidige gesprek is de uitzondering, aangezien een fork de system prompt van het oudergesprek exact overneemt. Als een subagent schrijft op een manier die u niet bevalt, pas dan het bestand van die agent aan in plaats van uw stijl. Een tweede Claude Code-sessie op dezelfde machine volgt dezelfde grens en leest bij het opstarten zelf de instellingenbestanden. Wanneer u dus werk overdraagt aan een andere sessie die naast de uwe draait, komen de antwoorden terug in de stijl die die sessie heeft geladen, niet die van u.

Hoe u uw eigen outputstijl schrijft

Een aangepaste outputstijl is een markdown-bestand met frontmatter. Sla dit op in uw thuismap om het in elk project te gebruiken, of in de repository om het bij de code te bewaren. De gebruikersmap is ~/.claude/output-styles/ en de projectmap is .claude/output-styles/.

mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---

Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.

Do not narrate what you are about to do. Report what you did.

When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOF

Start een sessie en open /config. Uw stijl verschijnt in de lijst Output style met de beschrijving die u heeft geschreven. Als de stijl ontbreekt, wordt het bestand niet gelezen: controleer het pad en controleer of het --- frontmatter-blok het eerste onderdeel in het bestand is. De bestandsnaam wordt de stijlnaam, tenzij de frontmatter name instelt; daarom heet deze stijl Terse ops en niet terse-ops.

Selecteer de stijl, of stel de sleutel in op die exacte naam en wis:

{
  "outputStyle": "Terse ops"
}

Eén veld bepaalt of uw bestand een aanpassing of een vervanging is. keep-coding-instructions staat standaard op false, wat betekent dat een aangepaste stijl de ingebouwde software-engineeringinstructies van Claude Code verwijderd en uitsluitend op uw tekst draait. Die ingebouwde instructies vertellen Claude hoe de scope van een wijziging moet worden bepaald en hoe het werk moet worden geverifieerd. Laat dit veld weg voor een schrijfassistent of data-analist, waarvoor dit niet van toepassing is. Stel het in op true voor alles wat code raakt, anders zult u zich afvragen waarom een zorgvuldige engineer plotseling stopt met het controleren van het eigen werk. Als u niet op zoek bent naar een andere toon, maar naar een striktere definitie van hoeveel werk een taak vereist, hoort dat bij de engineeringinstructies in plaats van bij het stijlbestand: de Ponytail skill is een uitgewerkt voorbeeld, een enkele regel die een agent dwingt tot de kleinst mogelijke wijziging die werkt.

description is de regel die de /config-kiezer naast de naam toont. Schrijf deze voor het moment dat u over zes maanden moet kiezen tussen twee van uw eigen stijlen.

Waarom een beknopte stijl anders is via SSH

Op een VPS leest u de transcriptie door lagen die een lokale terminal niet heeft, en elke laag brengt kosten in rekening voor breedsprakigheid.

Scrollback is de eerste. In tmux behoudt elk venster een vast aantal regels, ingesteld door history-limit, wat standaard op 2000 staat. Een verhalende transcriptie vult die buffer sneller, waardoor het eerdere deel van uw sessie eerder wordt verwijderd en de uitvoer waar u naar terug wilde scrollen verdwenen is. Verhoog dit als u meer ruimte wilt:

echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.conf

Vensters die daarna worden aangemaakt, behouden elk 20000 regels, ten koste van geheugen per venster. Reeds geopende vensters behouden de oude limiet, omdat de buffergrootte vaststaat op het moment dat het venster wordt aangemaakt. Als u nog bezig bent met het opbouwen van de sessie-indeling, behandelt Claude Code draaien binnen tmux op een VPS dit.

Latentie is de tweede. De respons stroomt uw terminal binnen terwijl deze wordt gegenereerd. Op een verbinding met een hoge round-trip time is een lange inleiding tijd die u besteedt aan het kijken naar tekst die verschijnt voordat het antwoord zichtbaar wordt.

Output-tokens zijn de derde. Elke verhalende regel wordt gefactureerd als output. Explanatory en Learning zijn ontworpen om langer te zijn. Concise is ontworpen om korter te zijn, omdat het Claude instrueert om antwoorden standaard kort te houden.

Vertrouw niemand op een percentage, deze pagina inbegrepen. De omvang van het verschil hangt af van uw prompts, uw model en het werk waar u om vraagt, dus meet uw eigen voor en na. Voer dezelfde echte taak uit in twee nieuwe sessies, één onder Default en één onder Concise, en vergelijk daarna. Een statusregel is de makkelijkste meter, omdat Claude Code uw script een JSON-object op stdin geeft dat al zowel de stijlnaam als de token-aantallen bevat:

cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.sh

Wijs de statusLine-instelling daarnaar:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

De balk onderaan de sessie toont nu de actieve stijl naast de tokens die deze heeft geproduceerd, wat precies de voor- en na-situatie is die u nodig heeft. Het script heeft jq nodig, de command-line JSON-parser, dus installeer deze eerst met sudo apt install -y jq. Als de balk leeg blijft, voer het script dan handmatig uit en pipe wat JSON erin, omdat een statusregel die met een non-zero exitcode afsluit, niets afdrukt en niets rapporteert. Een aangepaste Claude Code statusregel somt de rest van de velden in dat object op. Lees voor de facturatiekant in plaats van de sessiekant waar de tokens van Claude Code daadwerkelijk heen gaan en de tools die de uitgaven van Claude Code bijhouden.

Hoe u controleert welke outputstijl daadwerkelijk is geladen

Gebruik deze controles in plaats van te gissen.

• /status somt de instellingenbronnen op die voor deze sessie van kracht zijn, inclusief of er beheerde instellingen van een organisatie actief zijn.
• /context toont de geladen systeemprompt als een categorie in het overzicht van het contextvenster.
• claude doctor, uitgevoerd vanuit de shell zonder een sessie te starten, print installatie- en instellingsdiagnostiek en rapporteert instellingsbestanden die ongeldig zijn.

Wanneer een stijl niet wordt toegepast, is de oorzaak bijna altijd een van de volgende twee zaken. De eerste is dat u deze halverwege de sessie hebt gewijzigd; voer in dat geval /clear uit. De tweede is prioriteit: .claude/settings.local.json overschrijft .claude/settings.json, en beide overschrijven ~/.claude/settings.json. Omdat de /config-kiezer naar het lokale bestand schrijft, wordt een stijl die uw team in .claude/settings.json heeft vastgelegd, stilletjes overschreven op elke machine waar iemand ooit het menu heeft gebruikt. /status vertelt u welke bron heeft gewonnen.

Een JSON-syntactische fout heeft hetzelfde symptoom maar een andere oplossing. claude doctor benoemt het bestand dat niet kon worden geparseerd; het is de moeite waard dit uit te voeren voordat u op zoek gaat naar iets ingewikkelder.

FAQ

Waarom werkt het commando /output-style niet meer?

Dit commando is als verouderd gemarkeerd in v2.1.73 en verwijderd in v2.1.91. Op een build van medio 2026 bestaat het commando dus niet meer. Voer claude --version uit om te zien welke versie u heeft. Kies de stijl uit /config onder Output style, of stel de sleutel outputStyle in een instellingenbestand in. De sleutel is langer behouden gebleven dan het commando; het direct instellen van deze sleutel is de instructie die u het beste in uw eigen notities kunt opnemen.

Ik heb mijn output-stijl gewijzigd, maar er gebeurt niets. Hoe komt dat?

De output-stijl is onderdeel van de system prompt. Claude Code stelt de system prompt eenmalig samen wanneer de sessie start. Een wijziging die halverwege een sessie wordt doorgevoerd, wordt wel opgeslagen maar niet toegepast, omdat de actieve sessie de prompt blijft gebruiken die bij de start is opgebouwd. Voer /clear uit of start een nieuwe sessie. Als de wijziging nog steeds niet wordt toegepast, voer dan /status uit om te zien welke instellingsbron voorrang kreeg, aangezien .claude/settings.local.json de voorrang heeft op .claude/settings.json en beide voorrang hebben op ~/.claude/settings.json.

Bespaart de Concise output-stijl geld?

Het vermindert het aantal output-tokens zoals u zou verwachten, omdat het Claude instrueert om antwoorden standaard kort te houden. Hoeveel u bespaart, hangt af van uw prompts en uw model. Beschouw gepubliceerde percentages daarom als een meting van andermans werk. Meet uw eigen resultaten: voer /context uit in een nieuwe sessie voor elke stijl wat betreft de input, voer daarna dezelfde taak uit onder elke stijl en vergelijk het aantal output-tokens. Concise kort nooit een foutmelding of een beveiligingswaarschuwing in, zodat de onderdelen die u het meest nodig heeft, volledig intact blijven.

Verandert een output-stijl de manier waarop mijn subagents schrijven?

Nee. Output-stijlen zijn alleen van toepassing op het hoofdgesprek, omdat een subagent een eigen gesprek start met een eigen system prompt en een eigen set tools. Een fork van het huidige gesprek vormt de uitzondering, aangezien een fork de system prompt van het bovenliggende gesprek exact overneemt. Om de manier waarop een subagent reageert te wijzigen, moet u het eigen bestand van die agent bewerken.

Kan een output-stijl Claude toestaan om commando's uit te voeren zonder te vragen?

Nee. Een output-stijl is tekst in de system prompt en kan dus alleen beïnvloeden wat Claude probeert te doen. De Proactive-stijl zorgt ervoor dat Claude aannames doet en handelt in plaats van te pauzeren bij routinematige beslissingen, maar Claude kan nog steeds geen commando goedkeuren. Uw toestemmingsmodus bepaalt wat er zonder prompt wordt uitgevoerd; controleer die instelling voordat u een sessie op een server onbeheerd achterlaat.