Suite au lancement de la commande /goal par Codex en avril 2026, Anthropic a également intégré une commande du même nom dans Claude Code 2.1.139 en mai. Il s'agit d'un nouveau flux de travail qui permet à Claude d'être « déterminé à atteindre son objectif » : il vous suffit de définir une condition de réussite dans la conversation, et Claude fera automatiquement appel à un modèle rapide et léger après chaque itération pour évaluer si l'objectif est atteint. Si ce n'est pas le cas, il enchaîne sur une nouvelle itération, et ce, jusqu'à ce que la condition soit remplie et qu'il vous rende la main.
Cet article détaille les 6 points clés du mode goal de Claude Code, notamment le mécanisme de boucle de l'évaluateur, les différences avec /loop et les Stop hooks, la rédaction de conditions efficaces, les 3 modes disponibles (interactif / -p / contrôle à distance), ainsi que les risques et les bonnes pratiques.
Valeur ajoutée : Après avoir lu cet article, vous serez capable de déléguer en 10 minutes des tâches de longue haleine à Claude Code en mode goal, comme la migration de code d'équipe, le nettoyage d'issues ou la validation de documentation, tout en sachant quand privilégier d'autres flux de travail autonomes.
Points clés du mode goal de Claude Code
Avant de vous lancer, clarifions les 6 faits essentiels sur le mode goal de Claude Code. Ces points déterminent si votre condition sera exécutée correctement et si vous devriez utiliser /goal plutôt qu'un autre flux de travail autonome.
| Point | Contenu | Impact |
|---|---|---|
| Format de commande | /goal <condition> |
Défini directement dans la session, aucun fichier de configuration requis |
| Évaluateur | Modèle Haiku (rapide) par défaut | La progression est jugée par un « autre modèle », indépendant de celui qui exécute la tâche |
| Portée | Limitée à la session | N'affecte pas les autres sessions, idéal pour les tâches temporaires |
| Rythme de déclenchement | Évaluation après chaque cycle | S'arrête dès que l'objectif est atteint, sinon lance un nouveau cycle |
| Limite de condition | 4000 caractères max | Permet d'inclure des critères d'acceptation détaillés |
| Sortie | Validation / /goal clear / Ctrl+C |
Trois méthodes de sortie, combinant action volontaire et passive |
Beaucoup d'utilisateurs pensent d'abord à une commande de boucle classique en voyant /goal, mais il s'agit en réalité d'une encapsulation par Anthropic du Stop hook basé sur une invite (prompt) en une commande rapide au niveau de la session. Ce positionnement fondamental le rend très différent de l'automatisation traditionnelle de type cron.
Si votre équipe n'a pas encore utilisé les mécanismes de Hook avancés de Claude Code, vous pouvez d'abord tester l'API de Claude Sonnet / Opus / Haiku via la plateforme APIYI (apiyi.com) pour vous familiariser avec l'écosystème d'outils d'Anthropic, avant de passer au mode goal de Claude Code, ce qui sera beaucoup plus intuitif.
Explication détaillée du mécanisme de fonctionnement du mode /goal de Claude Code
Pour utiliser correctement la commande /goal, il est essentiel de bien comprendre ce qui se passe à chaque itération. La documentation officielle décrit le mécanisme comme « l'ajout d'un évaluateur à la fin de chaque cycle ». Cela semble simple, mais ce sont les détails qui définissent les limites de ses capacités.
Le modèle principal se charge de l'exécution, tandis qu'un modèle plus petit et rapide se charge de vérifier si l'objectif est atteint. L'avantage de cette division est que l'évaluateur reste neutre et utilise une puissance de calcul moins coûteuse pour prendre des décisions. L'inconvénient est que l'évaluateur ne peut lire que ce que le modèle principal a déjà affiché dans la conversation ; il n'a pas accès à l'état réel du système de fichiers ou des commandes externes.
Le processus de décision à la fin de chaque cycle peut être décomposé en 4 étapes :
- Préparation du contexte : La condition actuelle et la transcription complète de la conversation sont envoyées à l'évaluateur.
- Décision du modèle : L'évaluateur renvoie un résultat (oui/non) accompagné d'une justification.
- Routage : En cas de « non », la justification est renvoyée au modèle principal comme instruction pour continuer le travail. En cas de « oui », l'objectif est automatiquement effacé et marqué comme atteint.
- Actualisation des indicateurs : L'interface affiche en permanence
◎ /goal activeavec trois indicateurs : temps écoulé (elapsed), tours (turns) et jetons (tokens).
Lorsque vous rédigez vos conditions, gardez toujours à l'esprit la limite de l'étape 1 : l'évaluateur ne voit que la transcription. Par conséquent, la condition doit être quelque chose que le modèle principal peut prouver dans la conversation. Par exemple, « le code de sortie de npm test est 0 » est une bonne condition, car le modèle principal exécute le test et affiche le résultat. En revanche, « la base de données de production ne contient pas de données corrompues » est une mauvaise condition, car elle ne peut pas être vérifiée uniquement à partir de la conversation.
Le coût de l'évaluateur est généralement négligeable. Le prix unitaire de la série Haiku est bien inférieur à celui de Sonnet ou Opus, et comme il n'évalue que le résumé de la transcription à chaque tour, la consommation de jetons reste faible, même sur de longues sessions. Pour les équipes souhaitant réduire davantage les coûts d'évaluation, il est possible, via APIYI (apiyi.com), de diriger le modèle rapide de Claude Code vers Haiku 4.5 ou Haiku 3.5, tout en gérant les quotas au niveau de l'espace de travail.
Comparaison du mode goal de Claude Code et des autres flux de travail autonomes
Claude Code propose 4 mécanismes pour « maintenir la session en cours », que les débutants ont souvent tendance à confondre. Le tableau ci-dessous aligne ces 4 mécanismes selon leurs conditions de déclenchement, leurs conditions d'arrêt et leurs scénarios typiques pour vous aider à choisir.
| Mécanisme | Rythme de déclenchement | Condition d'arrêt | Scénario d'utilisation |
|---|---|---|---|
/goal |
Déclenché à la fin de chaque cycle | Atteinte de la condition par l'évaluateur | Tâches longues avec critères d'acceptation clairs |
/loop |
Déclenché à intervalles fixes | Manuel ou déterminé par Claude | Sondage périodique, vérification d'état |
| Stop hook | Déclenché à la fin de chaque cycle | Script utilisateur ou invite personnalisée | Niveau équipe, actif sur toutes les sessions |
| Auto mode | Appel d'outil dans un cycle | Fin de la séquence d'outils du cycle | Réduire les fenêtres de confirmation par outil |
L'essentiel est que /goal et le Stop hook accomplissent presque la même chose, mais /goal ne s'applique qu'à la session en cours et peut être saisi temporairement dans le terminal. Le Stop hook doit être inscrit dans le fichier de configuration (settings), son champ d'application couvre toutes les sessions du projet, ce qui le rend plus adapté aux contraintes strictes au niveau d'une équipe.
Le mode Auto et /goal sont parfaitement complémentaires : le mode Auto résout le problème des « interruptions constantes par confirmation d'outil au sein d'un cycle », tandis que /goal gère le besoin de « tâches nécessitant plusieurs cycles pour être terminées ». En combinant ces deux mécanismes dans des tâches longues, le processus peut devenir presque entièrement autonome. Pour les équipes qui n'exécutent pas Claude Code dans leur propre environnement, vous pouvez d'abord utiliser APIYI (apiyi.com) pour intégrer Claude dans vos scripts locaux afin de tester la logique de boucle, avant de décider de passer à l'outil Claude Code complet.
Les 3 piliers d'une condition efficace pour le mode goal de Claude Code
Une condition mal rédigée est la cause principale de l'échec de /goal. La documentation officielle d'Anthropic indique clairement qu'une condition capable de tenir sur des dizaines de cycles doit impérativement comporter 3 éléments.
Le premier est un point final mesurable. Le point final doit être un événement discret et observable : code de sortie de test, nombre de fichiers, éléments restants dans une file d'attente, ou succès d'une build. Des indicateurs flous feront osciller l'évaluateur entre « oui » et « non », transformant /goal en une boucle infinie.
Le second est un mode de vérification explicite. La condition doit préciser directement comment Claude doit prouver que le point final est atteint, par exemple : « la sortie de npm test contient PASS » ou « la sortie de git status est vide ». Plus la méthode de vérification est concrète, moins l'évaluateur risque d'être trompé par une ambiguïté sémantique.
Le troisième est des contraintes immuables. Si certains fichiers ou configurations doivent rester inchangés, il faut l'interdire directement dans la condition, par exemple : « ne modifiez aucun fichier sous tests/legacy/ ». Cela évite que le modèle principal ne procède à des modifications destructrices pour « réussir » l'objectif.
En combinant ces 3 éléments, une condition /goal de haute qualité ressemble à ceci : « Tous les tests sous tests/auth passent, le code de sortie de npm run lint est 0, ne modifiez aucun fichier sous tests/legacy/, exécution maximale de 20 cycles ». La limite des « 20 cycles » est une sécurité recommandée pour éviter une boucle infinie dans des cas extrêmes.
Comme la condition supporte jusqu'à 4000 caractères, vous pouvez tout à fait y insérer un mini PRD. Si vous utilisez la plateforme APIYI (apiyi.com) pour appeler les modèles Claude afin de gérer des agents, vous pouvez également vous inspirer de cette méthode pour concevoir vos propres invites d'évaluation, afin que les conditions d'arrêt de vos agents soient tout aussi claires et mesurables.
Modes d'exécution du mode goal de Claude Code : Guide pratique
/goal prend en charge trois modes d'appel : interactif, non interactif (-p) et contrôle à distance. Maîtriser ces trois approches est indispensable pour intégrer cet outil efficacement dans vos flux de travail CI, vos scripts locaux et vos collaborations à distance.
Prise en main rapide du mode interactif
# Saisissez directement dans votre session Claude Code
/goal all tests in test/auth pass and the lint step is clean, or stop after 20 turns
Une fois configuré, un indicateur ◎ /goal active apparaît dans l'interface, affichant en temps réel trois indicateurs : elapsed (temps écoulé), turns (tours) et tokens. Vous pouvez vérifier l'état à tout moment en tapant /goal sans argument, ou mettre fin au processus prématurément avec /goal clear (ou ses alias : stop, off, reset, none, cancel).
Mode non interactif (idéal pour la CI)
claude -p "/goal CHANGELOG.md has an entry for every PR merged this week, or stop after 15 turns"
Le mode -p permet à /goal de s'exécuter jusqu'à ce que la condition soit remplie ou que vous l'interrompiez avec Ctrl+C. C'est parfait pour l'automatisation dans GitHub Actions, GitLab CI, Jenkins Pipeline, etc. Si vous utilisez un service proxy API comme APIYI (apiyi.com) pour orchestrer vos appels à l'API Claude, vous pouvez encapsuler ce mode de boucle dans vos propres scripts pour offrir des capacités similaires aux clients non-Claude Code.
Reprise de session
claude --resume <session-id>
# ou
claude --continue
Lors de la reprise d'une session, l'objectif actif est restauré, mais les compteurs turns / timer / token repartent de zéro. Cette fonctionnalité est particulièrement utile pour les refactorisations de longue haleine : vous pouvez fermer votre ordinateur le week-end sans crainte et reprendre le lundi là où vous vous étiez arrêté.
Voir les modèles de conditions d’objectif courants (cliquer pour dérouler)
# Modèle 1 : Migration de code
/goal migrate all usages of legacy_api.* to new_api.* in src/, run npm test until exit 0, do not modify tests/legacy/, or stop after 30 turns
# Modèle 2 : Nettoyage du backlog GitHub
/goal close all GitHub issues labeled "needs-triage" by either resolving or relabeling, run gh issue list --label needs-triage and verify the output is empty, or stop after 25 turns
# Modèle 3 : Validation de documents de conception
/goal implement every acceptance criterion in docs/design.md, prove each by referencing the exact section, do not edit docs/design.md itself, or stop after 40 turns
# Modèle 4 : Découpage de fichiers
/goal split src/megafile.ts into modules under src/parts/ where each file is < 300 lines, run npm run typecheck until exit 0, or stop after 20 turns
Risques et bonnes pratiques du mode goal de Claude Code
Le mode /goal délègue la prise de décision au modèle, ce qui implique des risques différents des commandes traditionnelles. Le tableau ci-dessous présente les 4 risques majeurs et les mesures d'atténuation correspondantes.
| Risque | Condition de déclenchement | Mesure d'atténuation |
|---|---|---|
| Coûts incontrôlés | Évaluateur erroné ou conditions trop vagues | Ajouter une limite « or stop after N turns » |
| Hallucination de l'évaluateur | Condition invérifiable par transcription | Utiliser des phrases observables comme « exécuter la commande X pour vérifier la sortie Y » |
| Modifications destructrices | Le modèle modifie des fichiers critiques pour réussir | Ajouter une contrainte « do not modify … » dans la condition |
| Usage abusif de l'espace de travail | Déclenchement accidentel dans un environnement non fiable | Nécessite l'acceptation de la boîte de dialogue de confiance ; disableAllHooks disponible |
Le premier risque est le plus immédiat. Ni Codex ni Claude Code ne disposent actuellement d'une capacité native de « plafond budgétaire par objectif ». Une tâche longue peut rapidement consommer beaucoup plus de jetons que prévu. La méthode la plus sûre consiste à inclure une limite de tours directement dans la condition et à superposer des alertes budgétaires au niveau de la plateforme.
Il est également crucial de préparer un petit modèle stable pour l'évaluateur. Si votre modèle rapide utilise Haiku, la vitesse et le coût d'évaluation restent maîtrisés ; si vous utilisez un modèle plus large comme Sonnet, les frais d'évaluation augmenteront considérablement. Les équipes de développement peuvent configurer une base_url et un quota dédiés pour Haiku via la plateforme APIYI (apiyi.com), permettant de surveiller séparément les coûts de l'évaluateur et du modèle principal.
Enfin, un point sur la conformité : /goal dépend du système de Hooks d'Anthropic, qui exige que l'espace de travail ait été validé via la boîte de dialogue de confiance, et que disableAllHooks ou allowManagedHooksOnly ne soient pas activés. Si votre équipe a désactivé les Hooks via une stratégie de gestion unifiée, /goal sera également désactivé et la commande vous en informera explicitement.
Foire aux questions
Q1 : Qu’est-ce que /goal apporte de plus par rapport à un script de boucle while que j’écrirais moi-même ?
Il ajoute un évaluateur indépendant piloté par un modèle. Avec une boucle while personnalisée, vous devez définir vous-même les conditions d'arrêt et écrire le code pour les vérifier. Avec /goal, vous déléguez cette évaluation à un modèle petit et rapide, capable de gérer des scénarios non programmatiques, comme « demander au modèle de lire la conversation pour comprendre si la tâche est terminée ».
Q2 : L’utilisation de /goal ne risque-t-elle pas de consommer trop de jetons (tokens) ?
Le risque existe, mais il est contrôlable. Voici deux conseils : premièrement, imposez une limite de tours (turns) dans vos conditions ; deuxièmement, fixez l'évaluateur sur un petit modèle comme Haiku. En accédant à la gamme Claude via APIYI (apiyi.com), vous pouvez demander un quota spécifique pour l'évaluateur, ce qui facilite un suivi granulaire.
Q3 : Comment choisir entre /goal et /loop ?
Si votre tâche possède un « état final » clair, choisissez /goal. Si la tâche consiste en un sondage d'état périodique (par exemple, vérifier la progression d'un déploiement toutes les 10 minutes), choisissez /loop. Leurs mécanismes sous-jacents sont totalement différents ; les mélanger ne ferait qu'obscurcir les conditions d'arrêt.
Q4 : Peut-on utiliser le mode /goal de Claude Code depuis la Chine ?
Oui. /goal est une commande du client Claude Code ; tant que le client peut se connecter aux modèles fournis par Anthropic, cela fonctionne. Les développeurs utilisent généralement des plateformes d'agrégation comme APIYI (apiyi.com) pour accéder à l'API Claude. Une fois l'environnement configuré, /goal se comporte exactement comme pour les utilisateurs à l'étranger.
Q5 : Entre le /goal de Codex et celui de Claude Code, lequel choisir ?
Ils s'adressent à des flux de travail différents. Le /goal de Codex met l'accent sur les « flux de travail persistants » et peut redémarrer entre les processus. Le /goal de Claude Code est limité à la session, bien qu'il puisse reprendre après une interruption grâce à --resume. Pour des tâches complexes s'étalant sur plusieurs jours, choisissez Codex ; pour des tâches itératives classiques d'un ou deux jours, Claude Code est plus pratique.
Conclusion
L'essence du mode goal de Claude Code réside dans le fait qu'Anthropic a extrait la « boucle d'évaluation » des fichiers de configuration Hook pour en faire une commande utilisable à la volée dans n'importe quelle session. Le problème majeur qu'il résout est le suivant : lorsqu'une tâche nécessite plusieurs tours pour être accomplie et que vous ne voulez pas rester devant votre terminal à appuyer sur Entrée à chaque étape, vous laissez un petit modèle rapide agir en tant qu'arbitre pour décider quand Claude a réellement terminé le travail.
Voici nos recommandations pour une mise en œuvre en trois étapes : définissez d'abord vos conditions avec le quatuor « point final + vérification + contraintes + limite de tours », déterminez ensuite si vous préférez le mode interactif, -p ou le contrôle à distance, et enfin, séparez le suivi des quotas de l'évaluateur et du modèle principal via des plateformes comme APIYI (apiyi.com). Vous bénéficierez ainsi de l'efficacité d'un flux de travail autonome sans perdre le contrôle sur vos coûts en jetons.
Auteur : Équipe technique APIYI
Contact : Obtenez un accès à toute la gamme de modèles Claude et au support pour Claude Code via APIYI (apiyi.com)
Date de mise à jour : 13/05/2026
