Passer au contenu principal
Les styles de sortie modifient la façon dont Claude répond, non ce que Claude sait. Ils modifient l’invite système pour définir le rôle, le ton et le format de sortie. Utilisez-en un lorsque vous continuez à relancer avec la même voix ou le même format à chaque tour, ou lorsque vous voulez que Claude agisse comme quelque chose d’autre qu’un ingénieur logiciel. Un style de sortie personnalisé ajoute vos instructions à l’invite système et vous permet de choisir si vous souhaitez conserver les instructions d’ingénierie logicielle intégrées de Claude Code. Conservez-les lorsque vous modifiez la façon dont Claude communique mais que vous codez toujours, comme répondre toujours avec un diagramme. Omettez-les lorsque Claude ne fait pas d’ingénierie logicielle du tout, comme un assistant d’écriture ou un analyste de données. Pour les instructions concernant votre projet, les conventions ou votre base de code, utilisez CLAUDE.md à la place.

​
Styles de sortie intégrés

Le style de sortie Default de Claude Code est l’invite système existante, conçue pour vous aider à accomplir efficacement les tâches d’ingénierie logicielle. Il existe trois styles de sortie intégrés supplémentaires :
  • Proactive : Claude s’exécute immédiatement, fait des hypothèses raisonnables au lieu de s’arrêter pour les décisions courantes, et préfère l’action à la planification. Ceci applique des conseils d’exécution autonome plus forts que le mode auto, et cela fonctionne sans modifier votre mode de permission, vous voyez donc toujours les invites de permission avant l’exécution des outils.
  • Explanatory : Fournit des « Insights » éducatifs entre les tâches d’ingénierie logicielle pour vous aider à les accomplir. Vous aide à comprendre les choix d’implémentation et les modèles de base de code.
  • Learning : Mode collaboratif d’apprentissage par la pratique où Claude ne partagera pas seulement des « Insights » lors du codage, mais vous demandera également de contribuer à de petits éléments de code stratégiques. Claude Code ajoutera des marqueurs TODO(human) dans votre code pour que vous les implémentiez.

​
Modifier votre style de sortie

Exécutez /config et sélectionnez Output style pour choisir un style dans un menu. Votre sélection est enregistrée dans .claude/settings.local.json au niveau du projet local.
La commande autonome /output-style a été dépréciée dans la v2.1.73 et supprimée dans la v2.1.91. Utilisez /config ou modifiez directement le paramètre outputStyle.
Pour définir un style sans le menu, modifiez directement le champ outputStyle dans un fichier de paramètres : 
{
  "outputStyle": "Explanatory"
}
Le style de sortie fait partie de l’invite système, que Claude Code lit une seule fois au démarrage de la session. Les modifications prennent effet après /clear ou une nouvelle session. Consultez Comment Claude Code utilise la mise en cache des invites pour savoir ce qu’un changement de style de sortie fait au cache.

​
Créer un style de sortie personnalisé

Un style de sortie personnalisé est un fichier Markdown : frontmatter pour les métadonnées, puis les instructions à ajouter à l’invite système.
1

Créer un fichier Markdown

Enregistrez-le à l’un des trois niveaux. Le nom du fichier devient le nom du style sauf si vous définissez name dans le frontmatter.Les styles de sortie de projet se chargent à partir de chaque .claude/output-styles/ entre le répertoire de travail et la racine du référentiel. À partir de la v2.1.178, lorsque plusieurs de ces répertoires imbriqués définissent un style portant le même nom, Claude Code utilise celui le plus proche du répertoire de travail.
2

Ajouter le frontmatter et les instructions

Décidez si vous souhaitez conserver les instructions d’ingénierie logicielle de Claude Code. Définissez keep-coding-instructions: true si vous modifiez la façon dont Claude communique mais que vous voulez qu’il code de la même manière. Omettez-le si Claude ne fera pas d’ingénierie logicielle.Cet exemple commence chaque explication par un diagramme tout en conservant le comportement de codage de Claude :
---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.
3

Basculer vers votre style

Exécutez /config et sélectionnez votre style sous Output style. Il prend effet après /clear ou la prochaine fois que vous démarrez une session.
Les Plugins peuvent également fournir des styles de sortie dans un répertoire output-styles/.

​
Frontmatter

Les fichiers de style de sortie prennent en charge ces champs frontmatter :
FrontmatterObjectifPar défaut
nameNom du style de sortie, s’il ne s’agit pas du nom du fichierHérité du nom du fichier
descriptionDescription du style de sortie, affichée dans le sélecteur /configAucun
keep-coding-instructionsConserver les instructions d’ingénierie logicielle intégrées de Claude Codefalse
force-for-pluginStyles de sortie de plugin uniquement : appliquez ce style automatiquement chaque fois que le plugin est activé, sans nécessiter une sélection de l’utilisateur. Remplace le paramètre outputStyle de l’utilisateur. Si plusieurs plugins activés définissent ceci, Claude Code utilise le premier chargé.false

​
Fonctionnement des styles de sortie

Les styles de sortie modifient directement l’invite système de Claude Code.
  • Tous les styles de sortie ont leurs propres instructions personnalisées ajoutées à la fin de l’invite système.
  • Tous les styles de sortie déclenchent des rappels pour que Claude adhère aux instructions du style de sortie pendant la conversation.
  • Les styles de sortie personnalisés omettent les instructions d’ingénierie logicielle intégrées de Claude Code, comme la façon de délimiter les modifications, d’écrire des commentaires et de vérifier le travail, sauf si keep-coding-instructions est défini sur true.
L’utilisation des tokens dépend du style. L’ajout d’instructions à l’invite système augmente les tokens d’entrée, bien que la mise en cache des invites réduise ce coût après la première requête d’une session. Les styles Explanatory et Learning intégrés produisent des réponses plus longues que Default par conception, ce qui augmente les tokens de sortie. Pour les styles personnalisés, l’utilisation des tokens de sortie dépend de ce que vos instructions demandent à Claude de produire. Plusieurs fonctionnalités personnalisent le comportement de Claude Code. Les styles de sortie modifient directement l’invite système et s’appliquent à chaque réponse. Les autres ajoutent des instructions sans modifier l’invite système par défaut, ou les limitent à une tâche spécifique.
FonctionnalitéFonctionnementUtilisez-le quand
Styles de sortieModifie l’invite systèmeVous voulez un rôle, un ton ou un format de réponse par défaut différent à chaque tour
CLAUDE.mdAjoute un message utilisateur après l’invite systèmeClaude devrait toujours connaître vos conventions de projet et le contexte de votre base de code
--append-system-promptAjoute à l’invite système sans rien supprimerVous voulez un ajout ponctuel pour une seule invocation
AgentsExécute un sous-agent avec sa propre invite système, son modèle et ses outilsVous voulez un assistant à portée séparée pour une tâche ciblée
SkillsCharge les instructions spécifiques à une tâche lorsqu’elles sont invoquées ou pertinentesVous avez un flux de travail réutilisable
  • Settings : où se trouve le champ outputStyle et comment fonctionne la précédence des paramètres
  • Permission modes : comment le style Proactive se compare au mode auto
  • Plugins : empaquetez et distribuez les styles de sortie aux côtés des skills, des hooks et des agents
  • Debug your configuration : diagnostiquez pourquoi un style de sortie ne prend pas effet