Qu'est-ce qu'un snippet ? Le guide de l'ingénieur sur les morceaux de code et de texte réutilisables
Combien de fois cette semaine avez-vous retapé le même paragraphe dans un devis, ou recherché encore la même formule Excel ? Un snippet vous permet d'enregistrer ce morceau une fois et de le coller en une seconde. Ce guide explique ce que sont les snippets, où on les rencontre dans l'IA, le code et le travail de bureau, et comment les utiliser sans se brûler les doigts.
01Un snippet, en une phrase
Un snippet est un court morceau de code ou de texte destiné à être réutilisé. Ce peut être une fonction Python de cinq lignes, une formule Excel, un paragraphe de conclusion type pour vos e-mails ou un prompt qui fonctionne bien avec Claude.
À quoi bon ? Pour ne plus retaper la même chose, pour que tout le bureau rédige et calcule de la même façon, et pour gagner du temps en évitant les fautes de frappe. Un morceau vérifié une fois puis enregistré n'a pas besoin d'être revérifié à chaque fois.
Attention : dans le domaine de la recherche en ligne, le mot snippet a aussi un sens totalement différent, le résumé que Google affiche sous un résultat. Nous y revenons plus bas.
02Pensez au tampon encreur posé sur le bureau
Autrefois, les bureaux avaient des tampons : « Vérifié et approuvé », « Copie conforme », l'adresse de l'entreprise. Personne ne recopiait ces mentions à la main à chaque fois, on tamponnait, tout simplement. Un snippet est un tampon numérique : un morceau prêt et vérifié que vous insérez en une seule action, au lieu de le réécrire et de vous tromper d'une lettre.
03Où l'on rencontre des snippets
Un bloc de code dans une réponse d'IA
Quand vous demandez un script à Claude ou à ChatGPT, le code apparaît dans un encadré séparé avec un bouton de copie. C'est un snippet de code classique.
Snippets d'expansion de texte
Les applications d'expansion de texte, ainsi que la fonction de remplacement de texte de votre système d'exploitation, transforment un code court comme ;merci en paragraphe complet.
Prompts enregistrés
Un prompt qui a très bien marché pour relire un rapport ou résumer une réunion, enregistré puis recollé au lieu d'être réécrit.
Snippets VS Code
L'éditeur VS Code permet de définir un court déclencheur qui se développe en tout un bloc de code, par exemple un en-tête type pour chaque script de calcul.
Formules Excel et codes d'intégration HTML
Une formule de vérification type, ou un code d'intégration à coller dans un site web : une balise Google Analytics, une vidéo YouTube ou un calculateur.
Le featured snippet de Google
Un sens totalement différent : l'encadré de réponse mis en avant que Google affiche parfois au-dessus des résultats, en citant un extrait d'une page web.
04Le chemin sûr : d'une réponse de Claude à votre fichier
- 1Demander et comprendreDemandez à Claude une explication ligne par ligne, pas seulement le code
- 2CopierUtilisez le bouton de copie de l'encadré pour ne perdre aucun caractère ni espace
- 3Tester sur une copieExécutez-le sur une copie du fichier ou sur un site de test, jamais sur l'original
- 4Vérifier à la mainEssayez un cas dont vous connaissez déjà la réponse
- 5Enregistrer avec un nomUn nom clair et une courte note : ce qu'il fait, quand l'utiliser, qui l'a vérifié
05Où conserver vos prompts préférés
Un outil d'expansion de texte
Tapez un court déclencheur et le prompt complet apparaît, dans n'importe quelle application ou site web. Idéal pour les prompts courts que vous utilisez chaque jour.
Les instructions d'un Project Claude
Un Project peut contenir des instructions permanentes qui s'appliquent à chaque conversation qu'il contient, par exemple « réponds toujours en unités SI ». La disponibilité dépend de votre abonnement. Voir Un contexte qui reste.
Une Skill
Quand un prompt est devenu une procédure complète avec modèle et liste de contrôle, transformez-le en Skill que Claude charge de lui-même au besoin. Voir Procédures pour l'IA.
Un simple fichier texte ou un document partagé
L'option la plus simple : un seul document qui regroupe tous vos bons prompts, classés par thème. Convient à toutes les équipes, rien à installer.
06Votre premier snippet VS Code en 5 minutes
- 1
Ouvrez les réglages des snippets
Allez dans File, Preferences, Configure Snippets, ou lancez Snippets: Configure Snippets depuis la Command Palette.
- 2
Choisissez un langage
Par exemple python, pour que le snippet n'apparaisse que dans les fichiers Python. Un fichier global pour tous les langages est aussi possible.
- 3
Saisissez un nom, un déclencheur et un corps
Chaque snippet comporte un prefix (le déclencheur que vous tapez), un body (les lignes insérées) et une description facultative.
- 4
Enregistrez et essayez
Dans un fichier Python, tapez le déclencheur, choisissez-le dans la liste de suggestions, et tout le bloc apparaît.
- 5
Partagez avec l'équipe
Un fichier de snippets placé dans le dossier .vscode du projet est accessible à toute personne travaillant sur ce projet.
07Exemple : conversion d'unités en Python
08Exemple : une formule Excel pour vérifier une distance au bord
09Exemple : une réponse type à une demande de devis
10Exemple : intégrer un calculateur au site de l'entreprise
11Votre besoin, où conserver le snippet, et pourquoi
| Besoin | Où le conserver | Pourquoi |
|---|---|---|
| Une phrase ou un e-mail envoyé chaque jour | Outil d'expansion de texte ou remplacement de texte du système | Fonctionne dans toutes les applications, en quelques frappes |
| Un prompt que vous utilisez souvent | Document de prompts ou outil d'expansion de texte | Disponible instantanément, facile à améliorer et à partager |
| Des instructions permanentes sur un sujet | Instructions d'un Project Claude | S'appliquent automatiquement à chaque conversation du projet |
| Une procédure complète avec modèle et liste de contrôle | Skill | Claude la charge de lui-même quand la tâche s'y prête |
| Un bloc de code répété d'un script à l'autre | Snippets utilisateur de VS Code | Inséré via un déclencheur, partageable avec l'équipe |
| Une formule Excel de vérification | Feuille modèle avec une note | Vérifiée une fois, reste cohérente |
| Un code d'intégration pour un site web | Un fichier texte bien rangé ou un bloc WordPress enregistré | Plus besoin de rechercher le code à chaque nouvelle page |
12Questions fréquentes
Puis-je exécuter du code fourni par Claude sans le comprendre ?
Mieux vaut éviter. Demandez une explication ligne par ligne, exécutez-le d'abord sur une copie du fichier et vérifiez-le sur un cas dont vous connaissez la réponse. C'est particulièrement important pour les macros VBA qui modifient des fichiers ou suppriment des données.
Et les mots de passe et clés d'API ?
Ne collez jamais un snippet contenant un mot de passe, une clé d'API ou un token dans une conversation, un document partagé ou un site web. Si le code a besoin d'une clé, conservez-la à part (par exemple dans une variable d'environnement) et ne laissez que son nom dans le code.
Puis-je copier n'importe quel code trouvé en ligne ?
Pas toujours. Le code publié sur des sites web et sur GitHub est accompagné d'une licence qui précise ce que vous avez le droit d'en faire. Avant d'intégrer un tel morceau dans un produit commercial, vérifiez la licence, voir GitHub sans coder.
Quelle est la différence entre un snippet et une Skill ?
Un snippet est un morceau que vous collez vous-même. Une Skill est un ensemble d'instructions que Claude charge de lui-même quand la tâche s'y prête. Un prompt devenu une procédure complète est un bon candidat pour une Skill.
Et qu'est-ce qu'un featured snippet ?
C'est un terme de SEO : un encadré de réponse mis en avant que Google affiche parfois au-dessus des résultats, en citant une partie d'une page. Cela n'a rien à voir avec le code, mais une réponse courte et claire en haut d'un article augmente vos chances d'y apparaître.
Un vieux snippet est-il toujours juste ?
Pas forcément. Les normes, les coefficients et les prix changent. Indiquez une date et une source dans chaque snippet, et repassez votre liste en revue à quelques mois d'intervalle.