Faire tourner un agent Claude Code en production, vraiment
Entre l'agent qui marche dans ton terminal et l'agent qui tourne en cron sur un compte client, il y a une douzaine de pièges. Je les ai tous rencontrés. Voilà lesquels et comment les éviter.
Le piège n°1 : la session qui meurt après le premier tour
Tu lances ton agent depuis un script, il traite le premier message, puis il s'arrête. Aucune erreur, aucun journal, rien.
La cause : rediriger la sortie lui fait perdre son terminal, et sans terminal, la session interactive ne survit pas au premier tour. La solution tient en une ligne de tmux, plus une règle absolue : ne jamais rediriger directement la sortie de la commande.
# ✗ la session meurt après le premier tour
claude --remote-control > session.log
# ✓ terminal préservé, journal quand même
tmux new-session -d -s "$SESSION" "./run-session.sh $SESSION"
tmux pipe-pane -t "$SESSION" -o "cat >> sessions/$SESSION.log"
Le piège n°2 : le JSON tronqué pris pour un résultat vide
Tu demandes du JSON structuré, tu le parses dans un try/catch, et tu traites l'échec comme « rien à faire ». Le jour où le modèle produit du JSON tronqué ou l'entoure de balises de code, ton système t'annonce que tout va bien.
Chez moi ça a duré sept jours. Onze mails attendaient, dont deux d'un client.
# Trois états, jamais deux. C'est la leçon la plus rentable du lot.
EMPTY → rien à traiter, tout va bien
PARSE_ERROR → sortie illisible, on rejoue une fois
AUTH_ERROR → session expirée, rejouer ne sert à rien : alerter
Le piège n°3 : les limites silencieuses des connecteurs
Une recherche dans une boîte mail ne renvoie souvent que les premiers messages de chaque fil, et plafonne le nombre de fils sans le dire. Sur un long échange, le dernier message n'y est pas.
Déduire l'expéditeur courant ou la demande depuis cette liste produit un agent qui répond à côté, avec assurance. La parade : ne jamais conclure depuis une recherche, toujours repasser par la lecture du fil.
57 leçons, 24 heures, du prototype à la facture
La formation, le kit de production, les post-mortems, et le groupe.
Le programme détaillé · Les trois formules · 5 leçons en accès libre
Pourquoi me croire
Questions fréquentes
Peut-on lancer Claude Code en tâche planifiée ?
Oui, et c'est exactement ce que je fais. Deux précautions : un verrou pour empêcher deux exécutions de se chevaucher, et une session persistante pour la partie interactive. Le module déploiement couvre les deux.
Comment valider les actions depuis un téléphone ?
La session tourne sur le serveur et se pilote à distance. Tu reçois la question sur ton téléphone, tu réponds par un numéro, la session continue. C'est ce qui rend le human-in-the-loop supportable au quotidien.
Quel est le coût d'un agent de ce type ?
Quelques dizaines d'euros par mois pour un volume de support normal, à condition de séparer la détection du traitement. La leçon sur le coût par session détaille le calcul.
Ça marche avec un autre outil que Claude Code ?
L'architecture, oui : elle est indépendante de l'outil. Les exemples sont donnés avec Claude Code parce que c'est ce qui tourne chez moi, mais rien n'y est spécifique à un fournisseur.
Claude Code agent production : commence par une leçon gratuite.
5 leçons complètes, sans compte et sans email. Si elles ne te servent à rien, tu auras perdu vingt minutes.
À lire aussi : agent IA support client · vibe coding production