Les agents de code sont bons pour le travail long, bien défini et fastidieux : ajouter des tests à cinquante modules, migrer chaque appel vers une nouvelle API, corriger mille avertissements de lint. Ce genre de travail n’a pas besoin que vous regardiez. Il lui faut un endroit sûr où tourner, une tâche claire, des garde-fous contre le blocage et un moyen de relire le résultat autour d’un café.
Voici une checklist pour mettre cela en place.
1. Comment mettre en sandbox un agent sans surveillance ?
Un agent sans surveillance exécute des commandes shell que personne ne valide. Partez du principe qu’il finira par lancer quelque chose que vous n’auriez pas lancé : supprimer le mauvais répertoire, installer un paquet, pousser vers un dépôt distant. Confinez-le.
- Un conteneur ou une VM, pas le compte utilisateur principal de votre portable. La documentation de sécurité de Docker décrit les mécanismes ; au minimum, exécutez-le avec un utilisateur non root et retirez les capabilities dont vous n’avez pas besoin.
- Ne montez que le dépôt. Pas de répertoire personnel, pas de clés SSH, pas d’identifiants cloud, pas de
~/.configplein de jetons. - Aucun secret de production. Utilisez des bases de test et des clés d’API factices. Si l’agent a besoin d’un vrai service, donnez-lui une clé restreinte et révocable.
- Limitez le réseau. L’agent a besoin de l’API du modèle et peut-être d’un registre de paquets. Il a rarement besoin d’autre chose.
- Pas de droits de push. Laissez-le committer en local. C’est vous qui poussez, après relecture.
La clé d’API du modèle est le seul identifiant que l’agent doit avoir. Utilisez une clé créée pour cet usage et, si votre fournisseur le permet, restreignez-la à l’IP de sortie de la sandbox. Les clés BroadNet prennent en charge des listes d’IP autorisées de 32 entrées au maximum : une clé divulguée est donc inutilisable depuis ailleurs.
2. Pourquoi donner à chaque agent sa propre branche ?
Travaillez sur une branche dédiée, jamais sur main. Si vous faites tourner plusieurs agents, donnez à chacun son propre répertoire de travail avec git worktree :
git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes
Chaque worktree est un checkout distinct du même dépôt : les agents n’écrasent pas les fichiers les uns des autres, et chaque branche montre exactement ce qu’un agent a fait.
Ensuite, faites un commit après chaque étape terminée. Aider le fait par défaut. Pour les autres agents, ajoutez-le aux instructions ou enveloppez la boucle pour qu’un commit ait lieu chaque fois que les tests passent. Un historique de petits commits transforme « l’agent a cassé quelque chose à 3 h du matin » en « le commit 14 l’a cassé ; on garde 1 à 13 ».
3. Que mettre dans le fichier de tâche ?
Un prompt d’une ligne qui fonctionne en interactif échoue la nuit, parce que personne n’est là pour répondre à la première question de l’agent. Écrivez un fichier de tâche :
# Task: add unit tests to src/billing/
## Goal
Every public function in src/billing/ has at least one unit test.
## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit
## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.
## Notes
Append decisions and skipped items to NOTES.md as you go.
La section « Done when » (terminé quand) est la partie importante. Elle donne à l’agent un moyen de savoir qu’il a fini, et à vous un moyen de le vérifier. Le fichier de notes sert aussi de mémoire si l’exécution redémarre ou si le contexte est compacté ; voir la gestion du contexte pour les agents de longue durée.
4. Quels garde-fous arrêtent un agent bloqué ?
Sans surveillance, personne ne remarque un agent bloqué avant le matin. Quatre garde-fous :
- Plafond d’étapes. Un nombre maximal fixe d’appels au modèle par tâche.
- Heure limite. Arrêter à une heure donnée, par exemple 07:00, quel que soit l’état.
- Détection des répétitions. Arrêter quand le même appel d’outil renvoie le même résultat trois fois, ou quand aucun fichier n’a changé depuis un nombre d’étapes donné.
- Délais par outil. Une suite de tests figée ne doit pas figer toute la nuit.
Quand un garde-fou se déclenche, l’agent doit écrire la raison dans le fichier de notes et s’arrêter proprement. Pourquoi plafonner les étapes et les nouvelles tentatives compte pour le coût est expliqué sous plafonner les étapes par tâche dans le guide des coûts des agents de code.
Aider se prête bien à ce mode : sa documentation de scripting montre l’option --message pour exécuter une instruction puis quitter, et --yes-always pour accepter automatiquement les confirmations. Placez cela dans une boucle shell sur une liste de tâches, avec timeout autour de chaque exécution, et vous avez une file d’attente de nuit toute simple.
5. La nuit, session de forfait ou facturation au token : qu’est-ce qui coûte le moins ?
Les exécutions de nuit changent la question du coût. Personne ne surveille le compteur, et un agent bloqué peut tourner en boucle pendant des heures.
Avec une clé facturée au token, le coût dépend de ce que l’agent envoie. Les agents renvoient le contexte à chaque étape, donc une exécution de huit heures s’additionne vite. Le prompt caching aide beaucoup (l’entrée en cache de DeepSeek V4.1 Flash coûte $0.0055 par million de tokens contre $0.175 pour une entrée nouvelle), mais les tokens de sortie et de raisonnement sont facturés en totalité. Il vous faut un budget de tokens par exécution et une limite de dépense sur le compte.
Avec une session de forfait, il n’y a pas de compteur de tokens. Une session Full Moon coûte $60 par mois pour DeepSeek V4.1 Flash en illimité, et c’est le plafond, quelle que soit la durée de l’exécution ou le nombre de boucles. Pour le travail de nuit, c’est l’atout principal : la facture du pire des cas est connue avant d’aller vous coucher.
| Clé facturée au token | Session de forfait | |
|---|---|---|
| Coût d’une nuit bloquée dans le pire des cas | Augmente avec les tokens | Fixé au prix du forfait |
| Agents en parallèle | Jusqu’à 4 requêtes en cours par clé en paiement à l’usage | Une requête à la fois par session |
| Modèles | Tous les modèles de chat | DeepSeek V4.1 Flash uniquement |
| Garde-fous toujours nécessaires | Oui, pour le coût et le temps | Oui, pour le temps |
Deux remarques pratiques sur les sessions. Une session traite une requête à la fois : deux agents qui partagent une session passent chacun leur tour, et les tâches d’une même session s’exécutent à la suite, ce qui convient souvent la nuit. Si vous voulez des agents côte à côte, achetez une session par agent. Des agents en parallèle au forfait détaille le calcul.
À une vitesse typique de environ 100 tokens par seconde, une session peut produire environ 259 millions tokens de sortie en un mois d’utilisation continue. Que cela batte la facturation au token pour vous dépend du volume ; l’exemple chiffré de BroadNet pour un agent de code à plein temps arrive à environ $65.40 par mois en paiement à l’usage. Faites vos propres calculs avec le calculateur forfait ou paiement au token. Les longues exécutions sans surveillance exigent aussi de la discipline sur le contexte et des relances qui survivent à un plantage : voir délais, relances et points de contrôle.
6. Comment relire l’exécution le matin ?
La valeur d’une exécution de nuit ne se concrétise qu’à la relecture. Rendez-la rapide :
- Lisez d’abord NOTES.md. Qu’est-ce que l’agent a terminé, sauté, et où a-t-il bloqué ?
- Vérifiez la raison de l’arrêt. Terminé, plafond d’étapes, heure limite ou répétition ?
- Lancez les tests vous-même. Ne vous fiez pas au rapport de l’agent annonçant des tests au vert.
- Lisez le diff commit par commit. Les petits commits rendent les mauvais changements faciles à repérer et à écarter.
- Faites un squash ou un rebase de ce que vous gardez, puis ouvrez une pull request normale.
La plupart des matins, vous garderez l’essentiel du travail et corrigerez quelques commits à la main. Les mauvais matins, vous supprimerez une branche. Dans les deux cas, rien n’a touché main sans vous.
Comment essayer en sécurité la première nuit ?
Commencez par une tâche bien spécifiée, un agent et une session. Une heure Meteor ($1) suffit pour vérifier que la sandbox, la branche et les garde-fous fonctionnent avant de laisser tourner quoi que ce soit toute la nuit. Pour l’agent lui-même, le guide Aider donne les réglages de connexion exacts, le meilleur modèle ouvert pour les agents de code vous aide à choisir un modèle, et le fonctionnement des sessions de forfait couvre les clés et les sessions.
