SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Styles de sortie Claude Code : fonctionnement et création

Les styles de sortie modifient le system prompt de Claude Code. Découvrez l’effet des 5 styles intégrés sur le transcript et comment créer le vôtre.

Qu'est-ce qu'un style de sortie dans Claude Code

Un style de sortie dans Claude Code est un bloc d'instructions que Claude Code ajoute à ce qu'il envoie à Claude à chaque requête. Il modifie la manière dont Claude vous répond : le rôle qu'il adopte et la forme de ce qu'il affiche. Il n'apprend rien à Claude sur votre base de code et ne peut pas donner à Claude la permission d'exécuter quoi que ce soit.

Claude Code intègre cinq styles par défaut. Votre choix est conservé dans une clé de configuration, outputStyle. Sur Claude Code v2.1.251 ou version ultérieure, un style que vous modifiez au milieu d'une session s'applique à partir de votre message suivant. De la version v2.1.73 à la v2.1.251, le changement était enregistré puis ignoré jusqu'à ce que vous exécutiez une commande /clear ; ce fait explique la majeure partie de la confusion que vous trouverez encore dans les anciens guides sur cette fonctionnalité.

Sur un VPS, il s'agit de plus qu'une préférence esthétique. La transcription est ce que vous lisez via une connexion SSH (secure shell), généralement dans une fenêtre tmux ; chaque ligne narrée par Claude est donc une ligne que vous attendez et une ligne qui occupe de l'espace dans un tampon de défilement de taille fixe.

Emplacement du paramètre outputStyle

Choisissez un style depuis le menu /config, sous Output style. Claude Code écrit votre choix dans .claude/settings.local.json au sein du projet sur lequel vous travaillez.

La commande /output-style effectue la même opération depuis l'invite de commande. Exécutez /output-style concise pour changer de style, ou /output-style sans argument pour lister les styles et voir celui qui est actif. Elle enregistre le choix dans le même fichier .claude/settings.local.json, ignore la casse et fonctionne également en mode non interactif. La commande décrite ici est apparue dans Claude Code v2.1.269. Une ancienne commande /output-style existait dès la v2.0.30 et a été dépréciée en v2.1.73 au profit de /config ; une version située entre ces deux releases pourrait donc ne pas se comporter comme décrit sur cette page. Vérifiez votre version avant de suivre un guide, y compris celui-ci. Les versions mentionnées sur cette page ont été vérifiées en octobre 2026.

claude --version

Vous pouvez également définir la clé manuellement. Quatre fichiers de configuration peuvent la contenir, et le plus spécifique l'emporte sur le plus général.

  • ~/.claude/settings.json est votre fichier utilisateur. Il s'applique à chaque projet sur cette machine.
  • .claude/settings.json est le fichier de projet. Il est commit dans git, il s'applique donc à tous ceux qui clonent le dépôt.
  • .claude/settings.local.json est le fichier de projet local. Il n'est pas commit et il remplace les deux précédents. C'est le fichier dans lequel le menu /config et la commande /output-style écrivent.
  • Les paramètres gérés, déployés par une équipe informatique depuis un chemin système tel que /etc/claude-code/ sur Linux, remplacent tout le reste.

La valeur de la clé est le nom du style :

{
  "outputStyle": "Concise"
}

La valeur est sensible à la casse. Écrivez les noms intégrés comme Proactive, Concise, Explanatory et Learning. Une valeur qui ne correspond pas exactement à un nom de style, comme concise, active silencieusement le style Default.

Pour une session unique, passez la même clé en ligne de commande. Le flag --settings accepte un chemin ou une chaîne JSON en ligne, et ses valeurs remplacent les clés correspondantes dans vos fichiers de paramètres utilisateur, projet et locaux pour cette exécution. Les paramètres gérés restent prioritaires :

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

La documentation liste quatre méthodes pour choisir un style, et seules deux d'entre elles imposent une version minimale. Le menu /config dans le terminal n'en a aucune. La commande /output-style sous sa forme actuelle nécessite la v2.1.269, et le menu Output styles dans l'extension VS Code nécessite la v2.1.257. Dans l'application Desktop, vous définissez le champ outputStyle dans un fichier de paramètres. La clé outputStyle elle-même n'a pas de version minimale, c'est donc celle sur laquelle vous pouvez compter. Lorsqu'une capture d'écran dans un guide ne correspond plus à ce que vous voyez, définissez la clé directement et confirmez-la avec /status, qui liste les sources de paramètres actives.

Quand un nouveau style de sortie prend effet

Dans Claude Code v2.1.251 ou version ultérieure, un style que vous changez en cours de session, depuis la commande, le menu ou le fichier de configuration, s’applique à partir de votre message suivant. Vous n’avez pas besoin de vider le contexte. De v2.1.73 à v2.1.251, la session en cours conservait le style avec lequel elle avait démarré, et le nouveau style n’était chargé qu’au prochain /clear ou au prochain lancement.

Dans le terminal, Claude Code lit les fichiers de style au démarrage. Si vous créez ou modifiez un fichier de style personnalisé pendant qu’une session est en cours, redémarrez Claude Code avant de le sélectionner. Dans VS Code v2.1.261 ou version ultérieure, l’assistant Build a custom style du menu Output styles crée le fichier et affiche immédiatement le nouveau style. Avec une build de cette ancienne plage, ou après un redémarrage consécutif à la modification d’un fichier de style dans le terminal, ces deux commandes repartent d’un contexte vierge, puis affichent ce qui a été chargé :

/clear
/context

/context affiche ce qui occupe actuellement la fenêtre de contexte, ventilé par catégorie, y compris le system prompt. Exécutez-le dans une session vierge avec chaque style. La ligne du system prompt constitue alors l’élément d’entrée de votre comparaison. C’est aussi le moyen le plus rapide de vérifier qu’un style personnalisé a bien été chargé. Pour avoir une vue plus large de ce qui remplit cette fenêtre, consultez comment le contexte se remplit dans une longue session Claude Code.

La mise en cache explique ce fonctionnement. L’API sert les requêtes répétées depuis un prompt cache qui correspond au début de chaque requête, et le system prompt se trouve tout au début. Le réécrire en cours de conversation invaliderait tout ce qui le suit. Le tour suivant devrait alors retraiter tout votre historique comme une nouvelle entrée. Les builds de v2.1.73 à v2.1.251 évitaient ce coût en fixant le style au démarrage de la session. Les builds actuelles transmettent plutôt les instructions du nouveau style sous forme de message dans la conversation. Après un changement, la requête lit donc encore le system prompt et la conversation précédente depuis le cache. Dans les deux cas, changer de style coûte peu.

Ce que chaque style de sortie intégré change dans la transcription

  • Default correspond au prompt système normal de Claude Code, conçu pour les tâches de développement logiciel.
  • Concise commence par le résultat. Il supprime le préambule et la narration étape par étape, et conserve des réponses courtes jusqu’à ce que vous demandiez plus de détails. Le travail d’ingénierie effectué reste inchangé. Il ne raccourcit jamais un rapport d’erreur ni un avertissement de sécurité, et demande toujours une confirmation complète avant une action destructive. Ce style nécessite Claude Code v2.1.237 ou une version ultérieure.
  • Explanatory ajoute des « Insights » pédagogiques entre les étapes d’une tâche. Ils expliquent pourquoi un choix d’implémentation a été retenu et quels patterns votre base de code utilise déjà. La transcription est volontairement plus longue.
  • Learning va plus loin. Claude partage ces explications, puis vous demande d’écrire vous-même de petites portions du code, en marquant chaque emplacement avec un commentaire TODO(human) dans le fichier.
  • Proactive pousse Claude à agir plutôt qu’à poser des questions. Il fait des hypothèses raisonnables pour les décisions courantes au lieu de s’arrêter pour demander une confirmation.

Lisez attentivement ce dernier point, car il est souvent mal compris. Proactive fournit des indications dans le prompt système. Il modifie ce que Claude tente d’exécuter. Le mode d’autorisation détermine toujours ce qui est réellement exécuté sans vous demander confirmation. C’est le paramètre important sur un serveur que vous laissez fonctionner sans surveillance. Ce point est traité dans le mode automatique et les modes d’autorisation de Claude Code.

En quoi un style de sortie diffère de CLAUDE.md, d’un hook et d’un sous-agent

Ces mécanismes servent tous à indiquer à Claude comment se comporter, mais ils interviennent à des niveaux différents.

  • Un style de sortie fait partie des instructions que Claude Code envoie avec chaque requête. Il s’applique à toutes les réponses de la conversation principale.
  • CLAUDE.md est ajouté comme message utilisateur après le prompt système. C’est là que doivent figurer les conventions du projet et les informations sur la base de code.
  • --append-system-prompt ajoute du texte au prompt système pour une seule invocation, sans rien supprimer. C’est la version ponctuelle d’un style de sortie.
  • Un hook est une commande shell que Claude Code exécute lorsqu’un événement se produit. Il est imposé par le harness : il s’exécute donc même si Claude ne l’aurait pas choisi. Voir ce qu’un hook Claude Code peut et ne peut pas faire.
  • Un sous-agent s’exécute avec son propre prompt système et son propre jeu d’outils.

Un test simple permet de choisir entre les deux premiers mécanismes. Les informations sur votre projet vont dans CLAUDE.md, car Claude doit les connaître. La formulation va dans un style de sortie, car elle concerne la manière dont la réponse est rédigée. Tout ce qui doit se produire à chaque fois, quelle que soit la décision du modèle, doit être un hook. Le niveau auquel intervient chaque mécanisme dépend de l’application qui exécute le modèle, et non du modèle lui-même. C’est pourquoi un style peut seulement influencer le comportement, tandis qu’un hook peut l’imposer.

Les styles de sortie s’appliquent uniquement à la conversation principale. Un sous-agent n’hérite pas de votre style, car il démarre sa propre conversation avec son propre prompt système. Un fork de la conversation courante fait exception, car il hérite exactement du prompt système parent. Si la rédaction d’un sous-agent ne vous convient pas, modifiez le fichier de cet agent plutôt que votre style. Une deuxième session Claude Code sur le même serveur respecte la même séparation. Elle lit ses propres fichiers de configuration au démarrage. Ainsi, lorsque vous confiez une tâche à une autre session exécutée en parallèle de la vôtre, ses réponses utilisent le style chargé par cette session, et non le vôtre.

Comment rédiger votre propre style de sortie

Un style de sortie personnalisé est un fichier Markdown avec un frontmatter. Enregistrez-le dans votre répertoire personnel pour l’utiliser dans tous vos projets, ou dans le dépôt pour le conserver avec le code. Le répertoire utilisateur est ~/.claude/output-styles/ et le répertoire du projet est .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

Démarrez une session et ouvrez /config. Votre style apparaît dans la liste Output style, avec la description que vous avez écrite. S’il n’y figure pas, le fichier n’est pas lu : vérifiez le chemin, puis redémarrez Claude Code si la session était déjà en cours lorsque vous avez enregistré le fichier. S’il apparaît sous son nom de fichier sans description, le frontmatter n’a pas été analysé correctement et claude --debug affiche l’erreur d’analyse. Le nom du fichier devient le nom du style, sauf si le frontmatter définit name. Celui-ci s’appelle donc Terse ops et non terse-ops.

Sélectionnez-le, ou définissez la clé avec ce nom exact, en respectant les mêmes majuscules :

{
  "outputStyle": "Terse ops"
}

Un champ détermine si votre fichier est un ajustement ou un remplacement. keep-coding-instructions prend par défaut la valeur false, ce qui signifie qu’un style personnalisé supprime les instructions intégrées de Claude Code pour le software engineering et s’exécute uniquement avec votre texte. Ces instructions intégrées indiquent à Claude comment définir le périmètre d’une modification et comment vérifier son travail. Omettez ce champ pour un assistant de rédaction ou un analyste de données, lorsque ces instructions ne s’appliquent pas. Définissez-le sur true pour tout ce qui touche encore au code ; sinon, vous vous demanderez pourquoi un ingénieur soigneux a soudainement cessé de vérifier son propre travail. Seul le system prompt complet de Claude Code contient cette section. Le champ n’a donc aucun effet avec le system prompt court. Définir la variable d’environnement CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT sur 0 sélectionne le prompt complet avec n’importe quel modèle. Si vous cherchez réellement non pas une voix différente, mais une définition plus stricte de l’effort à consacrer à une tâche, cela relève des instructions d’ingénierie plutôt que du fichier de style : le skill Ponytail en fournit un exemple complet, avec une seule règle qui pousse un agent à appliquer la modification fonctionnelle la plus petite possible.

description est la ligne que le sélecteur /config affiche à côté du nom. Rédigez-la en pensant au moment où vous devrez choisir entre deux de vos propres styles dans six mois.

Pourquoi un style concis est différent en SSH

Sur un VPS, vous lisez la sortie à travers plusieurs couches qui n’existent pas dans un terminal local. Chacune augmente le coût de la verbosité.

Le scrollback est le premier point. Dans tmux, chaque pane conserve un nombre fixe de lignes défini par history-limit, qui vaut 2000 par défaut. Une sortie commentée remplit ce buffer plus rapidement. Les premières lignes de votre session sont donc supprimées plus tôt, et la sortie à laquelle vous vouliez revenir disparaît. Augmentez cette valeur si vous avez besoin de plus de marge :

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

Les panes créées ensuite conservent chacune 20000 lignes, au prix d’une consommation mémoire plus élevée par pane. Avec tmux 3.7 ou une version ultérieure, la modification de history-limit met également à jour les panes déjà ouvertes. Les versions plus anciennes appliquent cette modification uniquement aux nouvelles panes. Si vous êtes encore en train de définir la disposition de la session, exécuter Claude Code dans tmux sur un VPS explique la procédure.

La latence est le deuxième point. La réponse s’affiche dans votre terminal au fur et à mesure de sa génération. Sur une liaison avec un temps aller-retour élevé, un long préambule vous oblige à regarder le texte s’afficher avant de voir apparaître la réponse.

Les tokens de sortie sont le troisième point. Chaque ligne commentée est facturée comme une sortie. Les styles Explanatory et Learning sont volontairement plus longs. Le style Concise est volontairement plus court, car il demande à Claude de limiter la longueur des réponses par défaut.

Ne faites confiance à aucun pourcentage, y compris ceux de cette page. L’écart dépend de vos prompts, de votre modèle et du travail demandé. Mesurez donc vos propres résultats avant et après. Exécutez la même tâche réelle dans deux nouvelles sessions, l’une avec Default et l’autre avec Concise, puis comparez-les. Une statusline est le compteur le plus simple, car Claude Code transmet à votre script un objet JSON sur stdin. Cet objet contient déjà le nom du style, le nombre de tokens de sortie de la dernière réponse et une estimation cumulée du coût de la session :

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

Indiquez ce script dans le paramètre statusLine :

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

La barre située en bas de la session affiche maintenant le style actif, la taille de la réponse la plus récente et l’estimation du coût de la session jusqu’à présent. out concerne uniquement la dernière réponse. Il indique donc la longueur de chaque réponse. cost est cumulatif. La valeur à la fin de chaque exécution constitue donc votre comparaison avant/après. Consultez-la avant de l’effacer, car le coût revient à $0 lorsque /clear démarre une nouvelle session. Considérez cette valeur comme une estimation, et non comme le montant facturé. Le script nécessite jq, l’analyseur JSON en ligne de commande. Installez-le d’abord avec sudo apt install -y jq. Si la barre reste vide, exécutez le script manuellement et envoyez-lui un peu de JSON avec un pipe. Une statusline qui se termine avec un code différent de zéro n’affiche et ne signale rien. Une statusline Claude Code personnalisée présente les autres champs de cet objet. Pour la facturation plutôt que pour le suivi de la session, consultez où vont réellement les tokens de Claude Code et les outils qui suivent les dépenses liées à Claude Code.

Comment vérifier le style de sortie réellement chargé

Utilisez ces vérifications au lieu de procéder par déduction.

  • /status liste les sources de configuration actives pour cette session, notamment l’éventuelle présence de paramètres gérés par une organisation.
  • /context affiche le system prompt chargé comme une catégorie dans le détail de la fenêtre de contexte.
  • claude doctor, exécuté depuis le shell sans démarrer de session, affiche les diagnostics d’installation et de configuration, et signale les fichiers de configuration non valides.

Lorsqu’un style ne s’applique pas, la cause relève presque toujours de l’un de deux problèmes. Le premier concerne le moment du changement : avec une build comprise entre v2.1.73 et v2.1.251, un changement en cours de session attend /clear. Dans le terminal, un fichier de style créé ou modifié en cours de session attend un redémarrage. Le second concerne la priorité : .claude/settings.local.json remplace .claude/settings.json, et les deux remplacent ~/.claude/settings.json. Comme le sélecteur /config et la commande /output-style écrivent dans le fichier local, un style validé par votre équipe dans .claude/settings.json est silencieusement remplacé sur toute machine où quelqu’un a déjà utilisé l’un ou l’autre. /status indique quels fichiers ont été chargés, mais pas lequel a fourni la clé. Ouvrez donc chaque fichier listé et recherchez outputStyle.

Une erreur de syntaxe JSON produit le même symptôme, mais se corrige autrement. claude doctor indique le fichier qu’il n’a pas pu analyser. Exécutez cette commande avant de rechercher une cause plus complexe. Une valeur utilisant une casse incorrecte, comme explanatory, constitue un JSON valide, mais vous laisse tout de même avec le style Default. Vérifiez donc aussi les majuscules.

FAQ

Pourquoi la commande /output-style ne fonctionne-t-elle plus ?

Avec une build actuelle, elle fonctionne toujours. /output-style liste les styles et /output-style concise permet d’en sélectionner un. Cette commande a connu une interruption dans son historique : v2.1.73 l’a rendue obsolète au profit de /config, puis v2.1.269 a ajouté la forme actuelle /output-style [name]. Sur une build comprise entre ces deux versions, elle peut donc ne pas fonctionner comme indiqué ici. Exécutez claude --version pour connaître votre version. Quelle que soit la build, vous pouvez sélectionner le style dans /config, sous Output style, ou définir la clé outputStyle dans un fichier de configuration. La documentation ne précise aucune version minimale pour cette clé. La définir directement est donc l’instruction à conserver dans vos propres notes.

J’ai changé mon style de sortie, mais rien ne s’est passé. Pourquoi ?

Commencez par vérifier votre version. Dans Claude Code v2.1.251 ou version ultérieure, un style changé en cours de session s’applique à partir de votre message suivant. De v2.1.73 à v2.1.251, le changement était enregistré, mais ne s’appliquait qu’après /clear ou lors d’une nouvelle session. Dans le terminal, un fichier de style personnalisé créé ou modifié pendant la session nécessite un redémarrage, car Claude Code lit les fichiers de style au démarrage. Si le style ne s’applique toujours pas, vérifiez que la valeur correspond exactement au nom du style, y compris la casse. Exécutez ensuite /status pour voir quels fichiers de configuration ont été chargés, car .claude/settings.local.json remplace .claude/settings.json, et les deux remplacent ~/.claude/settings.json.

Le style de sortie Concise permet-il de réduire les coûts ?

Il réduit les output tokens dans le sens attendu, car il demande à Claude de produire par défaut des réponses courtes. L’ampleur de la réduction dépend de vos prompts et de votre modèle. Considérez donc tout pourcentage publié comme une mesure du travail d’une autre personne. Mesurez vos propres résultats : exécutez /context dans une session vierge avec chaque style pour le côté entrée, puis exécutez la même tâche avec chaque style et comparez les output tokens ainsi que le coût estimé. Concise ne raccourcit jamais un rapport d’erreur ni un avertissement de sécurité. Les éléments que vous devez le plus lire restent donc complets.

Un style de sortie modifie-t-il la manière dont mes subagents écrivent ?

Non. Les styles de sortie s’appliquent uniquement à la conversation principale, car un subagent démarre sa propre conversation avec son propre system prompt et son propre ensemble d’outils. Un fork de la conversation actuelle constitue une exception, car il hérite exactement du system prompt parent. Pour modifier la manière dont un subagent répond, éditez son propre fichier.

Un style de sortie peut-il permettre à Claude d’exécuter des commandes sans demander confirmation ?

Non. Un style de sortie est du texte dans le system prompt. Il peut donc uniquement influencer ce que Claude essaie de faire. Le style Proactive pousse Claude à prendre des décisions et à agir au lieu de s’arrêter pour les décisions courantes, mais il ne peut toujours pas approuver une commande. Votre permission mode détermine ce qui s’exécute sans confirmation. C’est ce paramètre que vous devez vérifier avant de laisser une session active sur un serveur.

Cet article vous a-t-il été utile ?