Ce que cette checklist ne fait pas
Elle ne rend pas ton agent incapable de faire une bêtise. Un agent qui a accès à ta boîte mail finira par écrire un mail que tu n'aurais pas écrit. Ce qu'on cherche ici, c'est que la bêtise reste rattrapable : pas de donnée client écrasée, pas de clé qui fuite, rien qui parte à l'extérieur sans qu'un humain ait cliqué.
C'est l'infrastructure qu'on pose sur nos projets Claude Code. Six points, dans l'ordre.
1. Le bypass permissions
Si tu fais beaucoup de Claude Code, tu l'as activé. Normal : ça fait gagner un temps fou de ne pas valider chaque commande.
La règle chez nous : bypass autorisé en local et sur staging, jamais sur un environnement de prod qui contient de la vraie donnée sensible. Dès que tu bosses sur une base qui a de vrais clients dedans, tu repasses en validation manuelle, même si c'est pénible pendant vingt minutes.
Le test simple : si une commande partie toute seule pouvait te faire appeler un client pour t'excuser, tu n'es pas dans un environnement où le bypass a sa place.
2. Tes secrets et tes clés d'API
Jamais dans le repo. Ni dans un fichier de config, ni en dur dans le code, ni « juste le temps du test ».
Deux endroits acceptables :
- un fichier d'environnement local, hors du repo, listé dans le
.gitignore - les variables d'environnement de Vercel pour tout ce qui tourne en ligne
Et tu vérifies que ton .gitignore est correct avant le premier commit, pas après. Une clé poussée une fois reste dans l'historique même si tu la supprimes au commit suivant : il faut la révoquer et en générer une nouvelle.
3. MCP : le scope minimum
Quand tu branches un MCP, la tentation c'est de tout cocher pour ne pas avoir à y revenir. C'est exactement comme ça qu'un agent censé lire un calendrier se retrouve à pouvoir supprimer des événements.
La règle : chaque MCP n'a accès qu'à ce qui le concerne, et en lecture seule tant que l'écriture n'est pas explicitement nécessaire.
Avant d'activer, pose-toi la question dans ce sens : « de quoi cet agent a-t-il besoin pour faire sa tâche », pas « qu'est-ce qui pourrait lui servir un jour ».
4. Sépare le staging et la prod
C'est le point qu'on voit le plus souvent sauté, et c'est celui qui coûte le plus cher.
Tu testes de l'agentique, donc tu testes un truc qui prend des décisions tout seul. Tant qu'il tourne sur une base de staging, un comportement imprévu te coûte un reset. Sur la prod, il te coûte un appel client.
Concrètement :
- deux bases, deux jeux de clés, deux URL
- des données de staging qui ressemblent à de la vraie donnée, mais qui n'en sont pas
- aucun envoi réel depuis staging : mails, SMS, webhooks, tout pointe vers un bac à sable
Un agent ne passe en prod qu'après avoir tourné sur staging sur des cas réels rejoués.
5. Un verrou humain sur tout ce qui sort de ta machine
La ligne de partage est simple : tout ce qui reste interne peut être automatique, tout ce qui sort passe par une décision humaine.
Ce qui sort, c'est :
- un mail ou un message envoyé à un client
- un post publié
- une donnée écrite dans un outil tiers
- un appel à une API externe qui déclenche une action irréversible
- un paiement, un remboursement, une suppression
Une validation à minima suffit : l'agent prépare, un humain clique. Ça ne coûte presque rien en temps et ça supprime la catégorie entière des catastrophes que tu découvres le lendemain.
6. Les règles écrites dans CLAUDE.md
Une règle qui n'est pas écrite n'existe pas. Elle vit dans ta tête, et l'agent n'a pas accès à ta tête.
Tout ce qui précède se met :
- dans le
CLAUDE.mdà la racine du projet - dans les consignes de chaque agent, un par un
Le fichier joint contient le bloc qu'on colle sur nos projets. Tu l'adaptes aux noms de tes environnements et tu le mets en haut de ton CLAUDE.md, pas en bas.
L'ordre dans lequel les mettre en place
Si tu dois en faire un seul ce soir : le 2, les clés d'API. C'est celui qui se répare le moins bien après coup.
Ensuite le 4 (séparer staging et prod), puis le 5 (le verrou humain). Le 1, le 3 et le 6 se posent en même temps que le projet suivant.
C'est l'infra qu'on déploie sur nos projets Claude Code. Rien de sophistiqué : des verrous simples, posés avant que l'agent ait quelque chose d'important entre les mains.












