Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 tout en conservant les capacités principales comme l’exécution de scripts, la lecture et l’écriture de fichiers, et le suivi des TODOs. 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. 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. Cela applique les mêmes conseils que le mode auto 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.

​
Fonctionnement des styles de sortie

Les styles de sortie modifient directement l’invite système de Claude Code.
  • Les styles de sortie personnalisés excluent les instructions de codage (comme la vérification du code avec des tests), sauf si keep-coding-instructions est true.
  • 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.
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.

​
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. Pour définir un style sans le menu, modifiez directement le champ outputStyle dans un fichier de paramètres : 
{
  "outputStyle": "Explanatory"
}
Comme le style de sortie est défini dans l’invite système au démarrage de la session, les modifications prennent effet la prochaine fois que vous démarrez une nouvelle session. Cela maintient l’invite système stable tout au long d’une conversation afin que la mise en cache des invites puisse réduire la latence et les coûts.

​
Créer un style de sortie personnalisé

Les styles de sortie personnalisés sont des fichiers Markdown avec frontmatter et le texte qui sera ajouté à l’invite système : 
---
name: My Custom Style
description:
  A brief description of what this style does, to be displayed to the user
---

# Custom Style Instructions

You are an interactive CLI tool that helps users with software engineering
tasks. [Your custom instructions here...]

## Specific Behaviors

[Define how the assistant should behave in this style...]
Vous pouvez enregistrer ces fichiers à trois niveaux : 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 frontmatter pour spécifier les métadonnées :
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-instructionsIndique s’il faut conserver les parties de l’invite système de Claude Code liées au codage.false
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, le premier chargé gagne.false

​
Comparaisons avec les fonctionnalités connexes

​
Styles de sortie vs. CLAUDE.md vs. —append-system-prompt

Choisissez en fonction de si Claude doit cesser d’agir comme assistant de codage ou conserver son rôle par défaut et en apprendre davantage. Les styles de sortie remplacent les parties liées à l’ingénierie logicielle de l’invite système de Claude Code par votre propre rôle et voix, donc utilisez-en un quand Claude doit adopter une identité différente, comme un éditeur d’écriture ou un assistant d’analyse de données. CLAUDE.md et --append-system-prompt conservent tous deux l’identité par défaut de Claude Code et y ajoutent du contenu, donc utilisez-les quand Claude doit rester un assistant de codage qui suit également vos conventions de projet ou des instructions supplémentaires. Les mécanismes diffèrent également. Les styles de sortie modifient directement l’invite système. CLAUDE.md ajoute son contenu en tant que message utilisateur après l’invite système. --append-system-prompt ajoute du contenu à la fin de l’invite système sans rien supprimer.

​
Styles de sortie vs. Agents

Utilisez un style de sortie pour modifier la façon dont la conversation principale répond dans chaque session. Utilisez un sous-agent quand vous voulez un assistant à portée séparée auquel la conversation principale délègue. Les styles de sortie affectent uniquement l’invite système de la boucle d’agent principal. Les agents gèrent des tâches spécifiques et peuvent avoir leur propre modèle, outils et contexte sur le moment de les invoquer.

​
Styles de sortie vs. Skills

Les styles de sortie modifient la façon dont Claude répond (formatage, ton, structure) et sont toujours actifs une fois sélectionnés. Les skills sont des invites spécifiques à une tâche que vous invoquez avec /skill-name ou que Claude charge automatiquement quand pertinent. Utilisez les styles de sortie pour les préférences de formatage cohérentes ; utilisez les skills pour les flux de travail et les tâches réutilisables.