Chapter 1 · L'essentiel
Tes secrets dans le .env, jamais dans le code
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeUne clé API est un mot de passe donné à un programme. Elle permet à ton site d'utiliser un service : envoi d'e-mails, paiement, IA, réseau social. Quiconque possède ta clé peut agir à ta place, et parfois à tes frais.
La règle : une clé ne s'écrit jamais dans le code
Elle vit dans un fichier à part, nommé .env, à la racine du projet. Le code va la chercher là. À côté, un fichier .env.example garde les mêmes noms avec des valeurs bidon : il sert de modèle sans rien révéler.
Le .gitignore, avant le premier commit
Git garde l'historique de ton projet et l'envoie souvent sur un site comme GitHub. Le fichier .gitignore liste ce que Git doit ignorer. Il doit contenir au minimum :
.env
.env.*
!.env.example
L'ordre compte : si .env est enregistré dans Git avant d'être ignoré, la clé reste dans l'historique, même si tu l'effaces ensuite.
Faire vérifier ton projet
Lance Claude Code dans le dossier de ton site et demande un état des lieux, sans modification :
Vérifie la gestion des secrets de ce projet, sans rien modifier :
1. Existe-t-il un fichier .env, et est-il ignoré par Git ?
2. Le .gitignore contient-il .env et ses variantes ?
3. Trouves-tu des clés, jetons ou mots de passe écrits en dur dans le code ? Donne le fichier et la ligne, mais n'affiche jamais la valeur (remplace-la par ****).
Rends un tableau : point vérifié, OK ou à corriger, correction proposée.
« N'affiche jamais la valeur » est important : la clé ne doit pas finir dans la conversation.
Ce qu'on ne colle jamais dans une IA
Ce que tu colles dans une conversation, tu le confies. Ni clé, ni mot de passe, ni code de double authentification, ni numéro de carte, ni fichier clients complet. Les captures d'écran sont le piège le plus courant : une clé dans un coin du tableau de bord, un e-mail client dans une liste. Regarde l'image en entier avant de l'envoyer, recadre ou floute.
Pour aller plus loin, tu peux interdire à Claude Code de lire ton .env avec une règle de permission (la commande /permissions affiche et gère tes règles). C'est un garde-fou de plus, pas un coffre-fort.
Écris la règle une fois pour toutes
Ajoute dans le fichier CLAUDE.md de ton projet : « Les clés et mots de passe vivent dans .env, listé dans .gitignore. Ne jamais les écrire dans le code ni les afficher. » Claude Code le lira au début de chaque session.
À toi de jouer
- Fais un commit de ton projet tel qu'il est.
- Lance le prompt de vérification ci-dessus.
- Si une clé est écrite en dur, demande à Claude Code de la déplacer dans .env, puis vérifie que .env n'apparaît pas dans les fichiers suivis par Git.