Qu'est-ce que la commande /loop de Claude Code ? Usage, polling et planification comparés

« Préviens-moi quand le build est terminé. » « Si la CI passe au rouge, corrige-la. » « Surveille le déploiement toutes les 5 minutes. » Et si vous pouviez confier entièrement à l'IA ces corvées qui vous tiennent collé à l'écran ? La commande /loop ajoutée à Claude Code en 2026 fait exactement cela. Elle exécute un prompt ou une commande slash de façon répétée, sur un intervalle que vous définissez — ou que l'IA décide elle-même — un « veilleur » et un « répéteur » au sein de votre session.

Voici l'essentiel. /loop comble le fossé entre « je veux vérifier tout de suite » et « je veux que ce soit automatisé 24h/24 ». Tapez /loop 5m vérifie le statut du déploiement et la commande s'exécute automatiquement toutes les cinq minutes. Omettez l'intervalle et Claude observe la situation et choisit lui-même le meilleur temps d'attente (auto-cadence). Cet article explique, pour les débutants, les quatre façons de l'utiliser, le fonctionnement de l'auto-cadence, des recettes pratiques, comment l'arrêter et à quoi faire attention, ainsi que ce qui la distingue des fonctions voisines (tâches Desktop, Routines dans le cloud). Notez que /loop est une fonction récente dont le comportement peut évoluer ; consultez la documentation officielle pour les dernières informations (cet article reflète les informations de 2026).

* Le comportement de /loop décrit dans cet article s'appuie sur la documentation officielle de Claude Code (en date de 2026). En tant que fonction récente, il peut évoluer selon la version. Vérifiez `claude --version` et la documentation officielle pour les dernières informations avant utilisation.

1. Qu'est-ce que /loop ? — en une phrase

/loop est une fonction intégrée à Claude Code qui « exécute un prompt ou une commande slash de façon répétée sur un intervalle ». Techniquement, c'est un « planificateur de tâches à portée de session », et sous le capot il utilise cron (un planificateur temporel).

En termes de tous les jours, /loop est « un assistant attentionné à qui vous pouvez demander d'aller vérifier les choses toutes les cinq minutes ». Pendant que vous travaillez sur autre chose, l'IA vérifie périodiquement en arrière-plan et réagit quand quelque chose change. Et si vous omettez l'intervalle, l'IA jauge elle-même le moment — « ça bouge, donc une minute ; c'est calme maintenant, donc trente ». C'est la différence décisive avec un simple cron. La nature « décide et agit par lui-même » d'un agent IA sous-jacent est précisément ce qui paie ici.

2. Quatre façons de l'utiliser (intervalle × prompt)

La forme de base est /loop [intervalle] [prompt]. L'intervalle et le prompt sont tous deux facultatifs, et ce que vous passez change le comportement. Il y a quatre combinaisons.

Les intervalles s'écrivent avec un nombre + une unité (s=secondes, m=minutes, h=heures, d=jours). Le minimum est d'une minute, et les secondes sont arrondies au supérieur pour correspondre à la granularité de cron. Vous pouvez aussi l'écrire en langage naturel, comme every 2 hours. Et surtout — vous pouvez passer une commande slash à la place d'un prompt. Par exemple, ceci met en boucle la revue d'une PR précise toutes les 20 minutes :

# Exemple de mise en boucle d'une commande slash
/loop 20m /review-pr 1234

# Exemple de spécification de l'intervalle en langage naturel
/loop check the test results every 30m

Autrement dit, vous pouvez automatiser « la commande que vous tapiez à la main » simplement en ajoutant un intervalle. Si le coût du codage avec l'IA vous importe, l'astuce est d'éviter les boucles inutiles et de ne les lancer que lorsque c'est nécessaire.

3. La force de l'auto-cadence (l'IA choisit l'intervalle)

Parmi les quatre usages, celui qui hisse /loop au-dessus du « simple cron » est l'auto-cadence (intervalles jugés automatiquement). Omettez l'intervalle et Claude, après chaque exécution, décide lui-même « quand devrais-je revenir ? »

C'est là qu'elle brille. Demandez, en mode auto-cadence, « surveille jusqu'à ce que les tests passent », et elle vérifie à intervalles courts pendant que les tests tournent, augmente la fréquence à l'approche de la fin, puis arrête la boucle et fait son rapport une fois qu'ils passent — se comportant à peu près comme un veilleur humain. Avec un intervalle fixe, vous obtenez « ça continue de tourner inutilement alors que c'est déjà fini » ou, à l'inverse, « l'intervalle est trop long et ça rate des choses » ; l'auto-cadence évite cela. Personnellement, j'utiliserais l'auto-cadence pour une surveillance qui n'exige pas d'heure exacte, et un intervalle fixe pour ce où le temps compte, comme un rapport planifié.

4. Recettes pratiques

Le concret vaut mieux que l'abstrait. Voici là où /loop aide vraiment, sous une forme prête à l'emploi.

L'idée est de cibler « le travail qu'une personne vérifiait périodiquement ». Les tâches qui répètent « attendre → vérifier → réagir », comme la CI et les déploiements, sont en particulier le terrain de prédilection de /loop. Une surveillance de routine comme une vérification du statut d'une PR, mise en boucle, vous libère de la nécessité de rester collé.

5. L'arrêter, et précautions

Malgré toute sa commodité, /loop a des contraintes qui viennent du fait de « s'exécuter au sein d'une session ». Les ignorer mène à « tiens, ça ne tourne pas ? »

• Arrêter avec Esc : appuyez sur Esc pendant qu'elle attend la prochaine exécution, et le réveil en attente est effacé et la boucle s'arrête. En auto-cadence, Claude peut aussi s'arrêter de lui-même quand il juge la tâche « terminée ».
• Ne tourne que pendant que la session est ouverte : /loop est liée à cette session (conversation). Démarrer une nouvelle conversation efface les tâches. Fermer le terminal l'arrête aussi (reprenez sous 7 jours avec `claude --resume`).
• Les intervalles fixes durent jusqu'à 7 jours : ils continuent de tourner jusqu'à ce que vous les arrêtiez ou que 7 jours s'écoulent.
• Jusqu'à 50 tâches par session : vous ne pouvez pas en enregistrer davantage.
• Se déclenche entre les tours (réponses) : elle n'interrompt pas en pleine action ; elle se déclenche à l'intervalle entre les tours. Quand c'est chargé, elle peut dériver un peu (il y a aussi un jitter intentionnel pour éviter de marteler l'API). Les heures sont dans votre fuseau horaire local.

Honnêtement, le plus gros piège est d'oublier que « ça s'arrête quand vous fermez la session ». /loop n'est pas adaptée à un fonctionnement 24h/24 sans surveillance. Pour cela, utilisez une fonction différente, abordée juste après.

6. Choisir parmi trois fonctions de planification

Claude Code a en réalité trois couches de planification. /loop gère celle « au sein d'une session ». Elles sont faciles à confondre, alors démêlons-les.

* Les noms de fonctions et les spécifications sont en date de 2026. Ils peuvent évoluer selon la version ou la disponibilité ; consultez la source officielle.

Le choix est simple. Vous voulez juste surveiller un peu pendant le travail ? /loop. Vous voulez que ça continue après avoir fermé la session ? Tâches Desktop. Vous voulez que ça tourne sans surveillance même PC fermé ? Routines dans le cloud. S'agit-il de « surveiller dans le prolongement de ce que je fais », ou de « tourner même quand je ne suis pas là » ? Cette seule question tranche. Si vous faites tourner des agents IA sérieusement, comprendre ces trois couches paie.

7. Personnalisation (loop.md) et désactivation

Pour finir, deux touches plus avancées.

• Faites du « comportement par défaut » le vôtre avec loop.md : l'action par défaut d'un /loop sans prompt peut être remplacée en écrivant votre propre Markdown dans `.claude/loop.md` (niveau projet) ou `~/.claude/loop.md` (niveau utilisateur). Par exemple, vous pouvez faire de « votre routine de surveillance » la valeur par défaut — comme « vérifie la prochaine PR de release ; si la CI est rouge, pousse un correctif minimal ; si vert, fais un rapport en une ligne ». Les modifications prennent effet à la prochaine exécution.
• La désactiver entièrement : pour arrêter le planificateur lui-même, définissez la variable d'environnement CLAUDE_CODE_DISABLE_CRON=1.

loop.md suit la même idée que les fichiers de directives comme CLAUDE.md. Notez une bonne fois « ce que vous voulez faire périodiquement », et votre boucle de surveillance personnelle tourne sans que vous ayez à taper un prompt à chaque fois.

Résumé

Voici /loop de Claude Code, mise au clair.

• Ce qu'est /loop : un planificateur à portée de session qui exécute un prompt/une commande slash de façon répétée sur un intervalle que vous définissez (ou que l'IA définit).
• Quatre usages : intervalle fixe / auto-cadence / intervalle seul (maintenance) / les deux omis (auto-maintenance).
• L'auto-cadence est la clé : elle varie l'intervalle selon l'activité et s'arrête automatiquement quand c'est fini. La différence avec un simple cron.
• L'usage pratique, c'est la surveillance : veille CI/déploiement, maternage de PR, vérifications de build, rappels.
• Contraintes : au sein d'une session seulement, jusqu'à 50 tâches, les intervalles fixes durent 7 jours, arrêt avec Esc.
• Choisir : /loop pendant le travail, tâches Desktop pour le résident, Routines dans le cloud pour le sans surveillance.

Au final, ce que /loop change, c'est l'« axe temporel » du travail que vous pouvez confier à l'IA. Jusqu'ici, vous ne pouviez demander que des tâches se terminant en une seule conversation ; /loop rend possible, pour la première fois, de confier à l'IA « un travail qui se poursuit — attendre, regarder à nouveau, réagir ». Pendant que vous vous concentrez sur autre chose, la boucle continue de tourner discrètement. Reprenez à l'IA votre temps passé collé à l'écran.

FAQ