SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

Claude Code outputstijlen instellen en gebruiken

Ontdek hoe outputstijlen de antwoorden van Claude Code beïnvloeden. Leer het verschil tussen ingebouwde stijlen en hoe u vanaf versie 2.1.251 correct schakelt tussen modi.

Wat een outputstijl is in Claude Code

Een outputstijl in Claude Code is een blok instructies dat Claude Code toevoegt aan elk verzoek dat het naar Claude verstuurt. 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 instelling, outputStyle. Vanaf Claude Code v2.1.251 of later is een stijl waarnaar u tijdens een sessie overschakelt van toepassing vanaf uw volgende bericht. Van v2.1.73 tot v2.1.251 werd de wijziging wel opgeslagen, maar genegeerd totdat u deze wist; dit feit verklaart het merendeel van de verwarring die u nog in oudere handleidingen over deze functie zult tegenkomen.

Op een VPS is dit meer dan een cosmetische voorkeur. Het transcript is wat u leest via een SSH (secure shell)-verbinding, 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.

Waar de instelling outputStyle zich bevindt

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 commando /output-style voert dezelfde taak uit vanaf de prompt. Voer /output-style concise uit om te wisselen, of /output-style zonder argument om de stijlen weer te geven en te zien welke momenteel actief is. Het slaat op naar hetzelfde .claude/settings.local.json-bestand, is hoofdletterongevoelig en werkt ook in de niet-interactieve modus. Het commando zoals hier beschreven is geïntroduceerd in Claude Code v2.1.269. Een ouder /output-style-commando bestond vanaf v2.0.30 en werd in v2.1.73 als verouderd gemarkeerd ten gunste van /config; een build tussen die twee releases gedraagt zich mogelijk anders dan op deze pagina beschreven. Controleer welke versie u gebruikt voordat u een handleiding volgt, inclusief deze. De versies op deze pagina zijn gecontroleerd in oktober 2026.

claude --version

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

  • ~/.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 en het /output-style-commando schrijven.
  • Beheerde instellingen, uitgerold door een IT-team vanaf een systeempad zoals /etc/claude-code/ op Linux, overschrijven al het andere.

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

{
  "outputStyle": "Concise"
}

De waarde is hoofdlettergevoelig. Schrijf de ingebouwde namen als Proactive, Concise, Explanatory en Learning. Een waarde die niet exact overeenkomt met een stijlnaam, zoals concise, resulteert geruisloos in de Default-stijl.

Voor slechts één sessie kunt u dezelfde sleutel meegeven via de opdrachtregel. De vlag --settings accepteert een pad of een inline JSON-string, en de waarden daarvan overschrijven voor die run dezelfde sleutels in uw gebruikers-, project- en lokale instellingenbestanden. Beheerde instellingen krijgen hier nog steeds voorrang op:

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

De documentatie noemt vier manieren om een stijl te kiezen, en slechts twee daarvan vereisen een minimumversie. Het /config-menu in de terminal heeft er geen. Het /output-style-commando in zijn huidige vorm vereist v2.1.269, en het Output styles-menu in de VS Code-extensie vereist v2.1.257. In de Desktop-app stelt u het veld outputStyle in een instellingenbestand in. De sleutel outputStyle zelf heeft geen minimumversie en is daarom de meest betrouwbare optie. Wanneer een schermafbeelding in een handleiding niet langer overeenkomt met wat u ziet, stelt u de sleutel direct in en bevestigt u dit met /status, die de actieve instellingenbronnen weergeeft.

Wanneer een nieuwe uitvoerstijl van kracht wordt

Op Claude Code v2.1.251 of later wordt een stijl waarnaar u halverwege een sessie overschakelt – via het commando, het menu of het instellingenbestand – toegepast vanaf uw volgende bericht. U hoeft de sessie niet te wissen. Van v2.1.73 tot v2.1.251 behield de actieve sessie de stijl waarmee deze was gestart, en werd de nieuwe stijl pas geladen bij de volgende /clear of bij de volgende start.

In de terminal leest Claude Code stijlbestanden bij het opstarten. Als u dus een aangepast stijlbestand aanmaakt of bewerkt terwijl een sessie actief is, start Claude Code dan opnieuw op voordat u de stijl selecteert. In VS Code v2.1.261 of later maakt de Build a custom style-handleiding in het Output styles-menu het bestand aan en wordt de nieuwe stijl direct weergegeven. Bij een build in het oudere bereik, of na een herstart voor het bewerken van een terminal-stijlbestand, zorgen deze twee commando's voor een schone lei en tonen ze wat er is geladen:

/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 dan de invoerzijde voor uw vergelijking. Het is tevens de snelste manier om te verifiëren of een aangepaste stijl überhaupt is geladen. Voor een breder beeld van wat dat venster vult, zie hoe context zich vult tijdens een lange Claude Code-sessie.

Caching is de reden waarom het wisselen op deze manier werkt. 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. Builds van v2.1.73 tot v2.1.251 vermeden die kosten door de stijl vast te leggen bij de start van de sessie. Huidige builds leveren de instructies van de nieuwe stijl in plaats daarvan als een bericht in het gesprek, zodat het verzoek na een wissel nog steeds de system prompt en het eerdere gesprek uit de cache leest. Het wisselen van stijlen is in beide gevallen efficiënt.

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 maakt deel uit van de instructies die Claude Code bij elk verzoek meestuurt. Dit 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 een enkele aanroep, zonder iets te verwijderen. Dit is de eenmalige versie 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 helpt bij de keuze tussen de eerste twee. Feiten over uw project horen in CLAUDE.md, omdat Claude deze moet kennen. Formuleringen horen in een output style, omdat dit gaat over hoe het antwoord wordt gelezen. Alles wat elke keer moet gebeuren, ongeacht wat het model beslist, is een hook. In welke laag elk onderdeel zich bevindt, is een eigenschap van het programma dat het model aanstuurt en niet van het model zelf; daarom kan een style alleen beïnvloeden, terwijl een hook kan afdwingen.

Output styles zijn alleen van toepassing op het hoofdgesprek. Een subagent neemt uw style 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 ouderproces exact overneemt. Als een subagent schrijft op een manier die u niet bevalt, bewerk dan het bestand van die agent in plaats van uw style. 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 style 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 houden. 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 herstart Claude Code als de sessie al actief was toen u het bestand opsloeg. Als het bestand onder de bestandsnaam verschijnt zonder beschrijving, is de frontmatter niet geparseerd en toont claude --debug de parseerfout. De bestandsnaam wordt de stijlnaam, tenzij de frontmatter name instelt; daarom heet deze Terse ops en niet terse-ops.

Selecteer de stijl of stel de sleutel in op die exacte naam, met dezelfde hoofdletters:

{
  "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 alleen 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, waar 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. Alleen de volledige systeemprompt van Claude Code bevat die sectie, dus bij de kortere systeemprompt heeft het veld geen effect. Het instellen van de omgevingsvariabele CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT op 0 selecteert de volledige prompt op elk model. Als u niet op zoek bent naar een andere toon, maar naar een strakkere definitie van hoeveel werk een taak vereist, dan 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, dat 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. Op tmux 3.7 of later werkt het wijzigen van history-limit ook door voor vensters die al openstaan; oudere versies passen dit alleen toe op nieuwe vensters. 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 reactie 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 reacties 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 resultaten 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 de stijlnaam, de output-tokens van het laatste antwoord en een lopende kostenraming voor de sessie 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 hiernaar:

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

De balk onderaan de sessie toont nu de actieve stijl naast de grootte van de meest recente reactie en de geschatte kosten van de sessie tot nu toe. out heeft alleen betrekking op de laatste reactie, dus het laat zien hoe lang elk antwoord duurt. cost accumuleert, dus het cijfer aan het einde van elke run is uw voor en na. Lees het voordat u wist, want de kosten worden gereset naar $0 wanneer /clear een nieuwe sessie start, en beschouw het als een schatting in plaats van uw factuur. 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 print en niets rapporteert. Een aangepaste Claude Code statusregel somt de rest van de velden in dat object op. Voor de facturatiekant in plaats van de sessiekant, leest u waar de tokens van Claude Code daadwerkelijk naartoe 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 timing: bij een build van v2.1.73 tot v2.1.251 wacht een wissel halverwege de sessie op /clear, en in de terminal wacht een stijlbestand dat u halverwege de sessie hebt aangemaakt of bewerkt op een herstart. De tweede is prioriteit: .claude/settings.local.json overschrijft .claude/settings.json, en beide overschrijven ~/.claude/settings.json. Omdat de /config-kiezer en het /output-style-commando naar het lokale bestand schrijven, wordt een stijl die uw team in .claude/settings.json heeft vastgelegd stilletjes overschreven op elke machine waar iemand ooit een van beide heeft gebruikt. /status vertelt u welke bestanden zijn geladen, maar niet welke de sleutel heeft geleverd; open dus elk bestand dat het vermeldt en zoek naar outputStyle.

Een JSON-syntaxisfout heeft hetzelfde symptoom en een andere oplossing. claude doctor benoemt het bestand dat het niet kon parsen, wat de moeite waard is om uit te voeren voordat u naar iets ingewikkelder zoekt. Een waarde in de verkeerde hoofdlettergebruik, zoals explanatory, is geldige JSON en geeft u nog steeds de standaardstijl, dus controleer ook de hoofdletters.

FAQ

Waarom werkt het commando /output-style niet meer?

In een huidige build is dit niet het geval. /output-style toont de stijlen en /output-style concise schakelt naar een specifieke stijl. Het commando heeft een gat in zijn geschiedenis: v2.1.73 heeft het gemarkeerd als deprecated ten gunste van /config, en v2.1.269 heeft de huidige /output-style [name]-vorm toegevoegd. Op een build tussen deze twee versies in werkt het mogelijk niet zoals hier beschreven. Voer claude --version uit om te zien welke versie u heeft. In elke build kunt u de stijl kiezen via /config onder Output style, of de sleutel outputStyle instellen in een instellingenbestand. De documentatie vermeldt geen minimumversie voor deze sleutel, dus het direct instellen ervan is de instructie die u het beste in uw eigen notities kunt noteren.

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

Controleer eerst uw versie. In Claude Code v2.1.251 of later wordt een stijl waarnaar u halverwege een sessie schakelt, toegepast vanaf uw volgende bericht. Van v2.1.73 tot v2.1.251 werd de wijziging wel opgeslagen, maar pas toegepast na /clear of een nieuwe sessie. In de terminal vereist een aangepast stijlbestand dat u tijdens de sessie heeft gemaakt of bewerkt een herstart, omdat Claude Code stijlbestanden leest bij het opstarten. Als de stijl nog steeds niet wordt toegepast, controleer dan of de waarde exact overeenkomt met de stijlnaam, inclusief hoofdletters. Voer vervolgens /status uit om te zien welke instellingenbestanden zijn geladen, aangezien .claude/settings.local.json 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 verwacht, omdat het Claude instrueert om antwoorden standaard kort te houden. Hoeveel dit scheelt, hangt af van uw prompts en uw model; beschouw gepubliceerde percentages daarom als een meting van andermans werk. Meet het zelf: voer /context uit in een nieuwe sessie onder elke stijl voor de input-zijde, voer daarna dezelfde taak uit onder elke stijl en vergelijk het aantal output-tokens en de geschatte kosten. Concise kort nooit een foutmelding of beveiligingswaarschuwing in, dus de onderdelen die u het meest nodig heeft, blijven volledig behouden.

Verandert een output-stijl hoe mijn subagents schrijven?

Nee. Output-stijlen zijn alleen van toepassing op het hoofdgesprek, omdat een subagent een eigen gesprek start met een eigen systeemprompt en een eigen set tools. Een fork van het huidige gesprek is de uitzondering, aangezien een fork de systeemprompt van het oudergesprek exact overneemt. Om te wijzigen hoe een subagent reageert, moet u het bestand van die specifieke 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 systeemprompt 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, en dat is de instelling die u moet controleren voordat u een sessie op een server achterlaat.

Was dit artikel nuttig?