Styles de sortie de Claude Code

Le style de sortie vous permet de personnaliser le style d'interaction et la méthode de réponse de Claude Code, en l'adaptant à davantage de cas d'usage au-delà du développement logiciel, tout en conservant les fonctionnalités principales comme l'exécution de scripts locaux, la lecture/écriture de fichiers et le suivi des tâches.

Essentiellement, il modifie la logique d'interaction et le style de réponse de Claude Code en modifiant le prompt système.


Styles de sortie intégrés

Claude Code propose 3 styles de sortie prêts à l'emploi :

Nom du style Scénarios applicables Fonctionnalités principales
Style par défaut (default) Tâches quotidiennes de génie logiciel Se concentre sur l'exécution efficace de tâches de codage, de débogage, de refactorisation et d'autres tâches, avec des réponses concises et directes
Style explicatif (explanatory) Scénarios d'apprentissage par la pratique Explique les idées d'implémentation, les patrons de conception et d'autres points de connaissance tout en accomplissant des tâches, adapté aux développeurs qui souhaitent comprendre en profondeur le code
Style d'apprentissage (learning) Apprentissage pratique actif Collabore avec vous pour accomplir des tâches, en ajoutant à des positions clésTODO(human)marqueurs qui vous guident pour implémenter vous-même les extraits de code essentiels plutôt que de fournir directement les réponses

Comment ça marche

Lorsque vous changez de style de sortie, Claude Code ajuste le prompt système selon les règles suivantes :

  1. Tous les styles suppriment les instructions de contrainte par défaut telles que "réponses concises, sortie efficace"
  2. Les styles personnalisés suppriment par défaut les instructions liées au codage telles que "vérifier le code avec des tests" (si vous devez les conserver, vous pouvez les activer dans le fichier de stylekeep-coding-instructions: true)
  3. Chaque style ajoute des règles personnalisées à la fin du prompt système, en remplaçant le comportement par défaut
  4. Des contrôles de conformité sont déclenchés pendant les conversations pour garantir que Claude suit toujours les instructions du style actuel

Changer les styles de sortie

Il existe deux façons de changer de style ; la configuration est enregistrée dans le répertoire du projet.claude/settings.local.jsonfichier, etne prend effet que pour le projet actuel:

Méthode 1 : Sélection dans le menuAprès avoir entré la commande, sélectionnez le style cible dans le menu interactif :

/output-style

Méthode 2 : Spécifier directementAjoutez directement le nom du style après la commande pour le faire en une seule étape :

/output-style explanatory
/output-style learning
/output-style default

En plus de changer avec des commandes, vous pouvez aussi modifier directement.claude/settings.local.json(au niveau du projet) ou~/.claude/settings.json(au niveau global) les fichiers pour modifieroutputStylela valeur du champ pour changer de style.


Créer des styles de sortie personnalisés

Si les styles intégrés ne répondent pas à vos besoins, vous pouvez définir votre propre style à l'aide d'un fichier Markdown.

1. Emplacement d'enregistrement du fichier

Niveau Chemin d'enregistrement Portée
Niveau utilisateur ~/.claude/output-styles/ Peut être utilisé par tous les projets de l'utilisateur actuel
Niveau projet .claude/output-styles/(dans le répertoire racine du projet) Disponible uniquement pour le projet actuel ; peut être commité dans git et partagé avec l'équipe

2. Format de fichier

Un fichier de style personnalisé se compose de deux parties : la partie supérieureYAML frontmatter(configuration des métadonnées) et la partie inférieurecorps Markdown(contenu des instructions spécifiques).

Exemple

---
name
: data-analyst               # Nom du style, affiché dans le menu /output-style (utilise le nom du fichier s'il n'est pas renseigné)
description
: Se concentre sur la transformation de données complexes en rapports visuels et conclusions analytiques
                                 # Description du style, affichée dans le texte de description du menu (facultatif)
keep-coding-instructions
: false  # Indique s'il faut conserver les instructions de codage par défaut
                                 # false (par défaut) : supprime les instructions de codage, adapté aux scénarios hors développement
                                 # true: conserver les instructions de codage tout en appliquant également des règles personnalisées
---

# Définition du rôle
Vous êtes un assistant professionnel d'analyse de données, compétent dans l'utilisation de Python pour traiter divers types de données structurées,
et pour transformer des données complexes en rapports visuels concis et faciles à comprendre.

## Règles de réponse
1. Toutes les analyses doivent inclure trois parties : "Conclusion + Support de données + Suggestions d'optimisation"
2. Lors de la génération de code, des commentaires détaillés doivent être inclus, avec priorité donnée à Pandas et Matplotlib
3. Évitez d'accumuler du jargon technique ; expliquez les concepts complexes en langage simple

## Exigences de format
1. La section de conclusion doit être affichée en gras
2. Les blocs de code doivent être entourés des balises ```python
3. La section des suggestions doit être présentée sous forme de liste ordonnée

## Scénarios spéciaux
1. En cas de données manquantes, invitez proactivement l'utilisateur à compléter les informations clés au lieu de lever directement une erreur
2. Lors de la génération de graphiques visuels, utilisez par défaut des libellés en chinois et un thème clair

3. Description des paramètres Frontmatter

Nom du paramètre Obligatoire ? Description Valeur par défaut
name non Nom du style, affiché dans/output-stylele menu. Si non renseigné, utilisez le nom du fichier (sans l'extension .md) Nom du fichier
description non Une brève description de la fonction du style, affichée dans le texte de description du menu pour aider à distinguer plusieurs styles personnalisés Aucune
keep-coding-instructions non Indique s'il faut conserver les instructions liées au codage dans le prompt système par défaut. Lorsqu'il est défini surtrue, les instructions personnalisées seront superposées aux instructions de codage par défaut false

4. Étapes d'utilisation

  1. Créez selon le format ci-dessus.mdfichier (par exempledata-analyst.md)
  2. Placez le fichier dans le répertoire correspondant :
    • Disponible pour tous les projets :~/.claude/output-styles/data-analyst.md
    • Disponible uniquement pour le projet actuel :.claude/output-styles/data-analyst.md
  3. Exécuter dans Claude Code/output-style, et vous pouvez voir et sélectionner le style nouvellement créé dans le menu

Différences avec les fonctionnalités associées

Les styles de sortie ressemblent aux fonctionnalités suivantes, mais ils opèrent à des niveaux différents :

Cible de comparaison Différence principale
Style de sortie vs CLAUDE.md Le style de sortie varemplacerle prompt système d'ingénierie logicielle par défaut, changeant fondamentalement le mode de fonctionnement de Claude ; CLAUDE.md ajoute le contexte et les conventions du projet sous forme de messages utilisateur, sans modifier le prompt système lui-même
Style de sortie vs --append-system-prompt Le style de sortie remplace et désactive l'invite par défaut ;--append-system-promptajoute du contenu à la fin de l'invite par défaut ; les deux préservent l'invite d'origine
Style de sortie vs sous-agent Le style de sortie modifie l'invite système de l'agent principal, affectant le style d'interaction global ; le sous-agent est un module de traitement de tâches indépendant qui peut personnaliser les modèles, les outils et les conditions de déclenchement, et renvoie les résultats après avoir traité des sous-tâches spécifiques
Style de sortie vs commandes slash personnalisées Le style de sortie est une "invite système stockée" qui détermine le style d'interaction global de Claude ; les commandes slash personnalisées sont des "invites utilisateur stockées" utilisées pour exécuter rapidement une instruction ou une tâche spécifique

Modèle de style personnalisé

Ce qui suit est un modèle générique de style de sortie personnalisé. Remplacez le[ ]contenu qu'il contient par vos besoins réels, et enregistrez-le sous forme d'.mdun fichier pour utilisation :

Exemple

---
name
: [Nom du style, par exemple, Assistant de rédaction]
description
: [Description en une phrase de l'objectif, par exemple, Se concentrer sur la rédaction de documentation technique, produire un contenu clair et précis]
keep-coding-instructions
: [true or false]
---

# 1. Positionnement principal
[Définissez le rôle et l'expertise de Claude, par exemple :
Vous êtes un assistant professionnel de rédaction de documentation technique, spécialisé dans la transformation de concepts techniques complexes en textes clairs et faciles à comprendre]

# 2. Règles de réponse
[Spécifiez la logique de réponse de Claude, par exemple :
1. Chaque réponse doit comprendre trois parties : « Point clé + Explication détaillée + Exemple »
2. Utilisez la voix active et évitez les structures de phrase passives
3. Fournissez une brève explication lorsque des termes techniques apparaissent pour la première fois]

# 3. Exigences de format
[Spécifiez le format de mise en page de la sortie, par exemple :
1. Utilisez## pour les titres de deuxième niveau
2. Les exemples de code utilisent des blocs de code et précisent le type de langage
3. Les informations clés sont marquées en gras]

# 4. Gestion des scénarios spéciaux
[Règles de traitement pour des situations spécifiques, par exemple :
1. Lorsque des exemples sont nécessaires, privilégiez des scénarios du monde réel plutôt que des exemples abstraits.
2. En cas d'exigences floues, confirmez l'intention avant de commencer à écrire.]
Autres extensions