Styles de sortie

Adaptez Claude Code pour des usages au-delà de l'ingénierie logicielle

Les styles de sortie modifient la façon dont Claude répond, non ce que Claude sait. Ils définissent le rôle, le ton et le format de sortie de Claude pour chaque réponse. 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é donne à Claude vos propres instructions 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 son ensemble standard d'instructions, conçu pour vous aider à accomplir efficacement les tâches d'ingénierie logicielle.

Il existe quatre 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, donc votre mode de permission décide toujours ce qui s'exécute sans vous demander.

• Concise : Claude met en avant le résultat, omet le préambule et la narration, et garde les réponses courtes par défaut, tout en effectuant le travail d'ingénierie aussi minutieusement que dans le style Default. Quand vous demandez une explication ou plus de détails, Claude répond complètement. Claude conserve toujours le contenu complet des rapports d'erreur, des avertissements de sécurité et des confirmations pour les actions destructrices. Nécessite Claude Code v2.1.237 ou ultérieur.

• 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

Choisissez un style de l'une de ces façons :

• Commande /output-style : exécutez /output-style <style> pour basculer, par exemple /output-style concise. Sans argument, la commande liste les styles que vous pouvez choisir et marque celui en cours. Claude Code enregistre votre sélection dans .claude/settings.local.json au niveau du projet local.

  La commande fonctionne également en mode non interactif et dans les sessions Agent SDK, et depuis l'application mobile ou le web via Contrôle à distance, où vous pouvez lister et sélectionner uniquement les styles intégrés. Nécessite Claude Code v2.1.269 ou ultérieur.

• Terminal : exécutez /config et sélectionnez Output style pour choisir un style dans un menu. Claude Code enregistre votre sélection dans .claude/settings.local.json au niveau du projet local.

• Extension VS Code : ouvrez le menu de commandes avec / et sélectionnez Output styles pour choisir un style, y compris vos styles personnalisés. Claude Code enregistre votre sélection dans .claude/settings.local.json, le même fichier que le menu terminal écrit. Nécessite Claude Code v2.1.257 ou ultérieur.

• Application de bureau : définissez le champ outputStyle dans un fichier de paramètres, par exemple .claude/settings.local.json, le fichier que le menu terminal écrit. Lorsque vous exécutez /config là-bas, Claude Code ouvre Paramètres > Claude Code plutôt qu'un menu.

Pour définir un style sans le menu, modifiez directement le champ outputStyle dans un fichier de paramètres :

{
  "outputStyle": "Explanatory"
}

Lorsque vous changez de style en cours de session, Claude utilise le nouveau style à partir de votre message suivant. Pour le coût de ce premier message en mise en cache des invites, consultez Modifier le style de sortie. Avant la v2.1.251, le nouveau style s'appliquait uniquement après que vous ayez exécuté /clear ou démarré une nouvelle session.

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 pour Claude.

Dans l'extension VS Code, vous pouvez également créer le fichier à partir du menu Output styles plutôt que de l'écrire à la main. Cela nécessite Claude Code v2.1.261 ou version ultérieure.

---
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.

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 :

Fonctionnement des styles de sortie

Un style de sortie modifie les instructions que Claude Code donne à Claude.

• Claude Code envoie les instructions du style actif avec chaque requête.
• Lorsque vous sélectionnez un style autre que Default, Claude Code rappelle également à Claude le style 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.

Les styles de sortie s'appliquent à la conversation principale et à une branche, qui hérite de la conversation complète du parent et de l'invite système. Les autres sous-agents exécutent leur propre invite système, donc les styles ne modifient pas la façon dont ils répondent.

L'utilisation des tokens dépend du style. Les instructions d'un style ajoutent des 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. Le style Concise fait l'inverse en demandant à Claude de garder les réponses courtes par défaut. Pour les styles personnalisés, l'utilisation des tokens de sortie dépend de ce que vos instructions demandent à Claude de produire.

Comparaisons avec les fonctionnalités connexes

Plusieurs fonctionnalités personnalisent le comportement de Claude Code. Les styles de sortie modifient les instructions par défaut de Claude Code et s'appliquent à chaque réponse. Les autres ajoutent des instructions sans modifier les valeurs par défaut, ou les limitent à une tâche spécifique.

Ressources connexes

• 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