AI-translated from English; not yet reviewed by a fluent editor.

# Déléguer une tâche de code Claude Code d’Opus à Haiku et vérifier le résultat

> Un parcours documenté dans Claude Code pour confier un changement limité d’un parent Opus à un sous-agent Haiku du projet, vérifier le modèle et le diff réels, puis interpréter l’usage sans supposer une économie.

By BIG CHANGE Editorial

Published: 2026-10-20T10:17:38.691Z
Updated: 2026-10-20T10:17:38.691Z
Canonical: https://bigchange.ai/blog/claude-code-opus-haiku-subagent-coding-guide

![Conceptual charcoal illustration of a reviewer using a laptop trackpad beside a generic two-column code diff with one orange changed section.](https://bigchange.ai/api/media/file/opus-haiku-diff-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code peut attribuer un modèle et des outils propres à un sous-agent de projet, tandis que la conversation principale gère le plan et la revue. Pour un changement de dépôt autorisé, un parent Opus peut ainsi confier une étape d’implémentation limitée à Haiku. Le résultat utile est une modification de code vérifiée et une trace des modèles exécutés. Un réglage de modèle moins coûteux ne démontre pas, à lui seul, une économie.

## Le grand changement

- **Ce qui change :** Un fichier d’agent de projet peut demander `model: haiku` pour un exécutant de code nommé, tandis que la session parent utilise Opus.
- **Pourquoi c’est important :** Le parent peut examiner une tâche d’exécution plus petite, mais le développeur décide toujours si le diff satisfait le contrôle d’acceptation initial.
- **À surveiller :** Les substitutions de modèle, la politique de l’organisation, les autorisations, la revue et les nouvelles tentatives peuvent modifier le modèle réel et l’usage total. Vérifiez-les avant d’annoncer un bénéfice financier.

## Partir d’une tâche déjà sous votre responsabilité

Vous avez besoin d’un dépôt Git que vous contrôlez, de l’autorisation de le modifier, d’un accès Claude Code aux deux familles de modèles et d’un changement autorisé assez limité pour être évalué par son diff. Notez le commit de départ, les fichiers ou comportements concernés, la commande d’acceptation existante et le sens d’un résultat réussi. Utilisez une copie de travail propre. La commande doit venir du projet ; ce guide ne peut pas fournir un test pertinent pour un dépôt inconnu.

Vérifiez `claude --version`, votre fournisseur et votre mode de facturation, ainsi que les restrictions effectives de modèles avant de commencer. Sur l’API Anthropic, les alias actuels `opus` et `haiku` correspondent à Opus 5.5 (`claude-opus-5-5`) et Haiku 5.5 (`claude-haiku-5-5`) ; cette paire exige Claude Code v2.1.293 ou ultérieur. D’autres fournisseurs peuvent associer ces alias à des générations antérieures. La politique `availableModels` d’une organisation peut bloquer ou remplacer un choix. Utilisez `/model` dans la session principale et notez le modèle parent exact affiché. Décidez du budget autorisé et examinez les contrôles réels du compte ou du fournisseur ; une instruction au modèle ne garantit pas un plafond de dépenses. [La configuration des modèles d’Anthropic](https://code.claude.com/docs/en/model-config) documente les correspondances et restrictions actuelles.

## 1. Définir un exécutant Haiku de projet

Créez dans le projet un fichier au nom unique, par exemple `.claude/agents/bounded-code-worker.md`, relisez-le, puis démarrez le parent Opus avec `claude --model opus` ou sélectionnez Opus au moyen de `/model`. Cet exemple définit un exécutant ; ce n’est pas une tâche de test :

```markdown
---
name: bounded-code-worker
description: Implements one explicitly bounded, authorized repository change and reports the diff and checks for parent review.
model: haiku
tools: Read, Glob, Grep, Edit, Bash
permissionMode: default
---
```

Ajoutez cette instruction système en langage courant immédiatement après le `---` de fermeture du fichier d’agent : Implémentez uniquement la tâche et le périmètre de fichiers transmis par le parent. Avant toute modification, examinez le code pertinent et le contrôle d’acceptation indiqué. Si la tâche, l’autorisation ou une entrée requise manque, arrêtez-vous et signalez la lacune. Faites la plus petite modification pertinente. Exécutez le contrôle initial si vous y êtes autorisé ; indiquez sa commande exacte et son résultat. Renvoyez les fichiers modifiés, l’objectif du diff, les échecs restants et tout travail non vérifié. Ne faites aucun commit, ne publiez pas, ne déployez pas et n’élargissez pas la tâche sans autorisation explicite.

La liste `tools` rend les outils disponibles ; elle ne **limite pas** les lectures ou commandes shell aux chemins indiqués. Vérifiez les autorisations effectives du projet et de l’organisation, particulièrement l’accès shell, avant de déléguer. Gardez le parent en mode Manual/default pour cette recette : Anthropic documente qu’un parent en `acceptEdits`, `auto` ou `bypassPermissions` remplace le réglage `permissionMode` de l’exécutant. Si c’est le premier fichier d’un nouveau répertoire d’agents, redémarrez Claude Code si l’agent n’apparaît pas. [Le manuel des sous-agents](https://code.claude.com/docs/en/sub-agents) décrit ces contrôles.

Une option `isolation: worktree` donne à l’exécutant une copie de travail séparée. Son point de départ documenté est la branche par défaut du dépôt, qui peut différer du commit actuel du parent. Vérifiez cette révision de départ par rapport à la base de tâche enregistrée avant d’utiliser ou comparer ses changements. Une copie de travail propre et autorisée reste nécessaire pour le contrôle d’acceptation initial.

## 2. Déléguer, examiner, puis accepter ou refuser

Donnez au parent une instruction liée à la tâche réelle, avec vos propres limites de fichiers et votre commande de contrôle :

> Planifiez brièvement ce changement autorisé. Déléguez uniquement l’implémentation indiquée à `bounded-code-worker`. Gardez les critères d’acceptation initiaux et la revue finale sous votre responsabilité. Au retour de l’exécutant, montrez-moi son diff exact et le résultat du contrôle. N’acceptez pas le changement et ne l’élargissez pas avant ma revue.

Pendant l’exécution, ouvrez `/tasks` et notez le modèle affiché sur sa ligne. C’est la vérification à l’exécution ; le mot `haiku` dans un fichier d’agent ou une instruction n’est qu’une demande. Claude Code v2.1.242 ou ultérieur y affiche le modèle exécuté. Une tâche d’arrière-plan terminée reste dans `/tasks` environ 30 secondes : examinez-la rapidement et conservez sa transcription. Si vous manquez la ligne, indiquez que la vérification du modèle est incomplète, sans déduire le modèle du fichier.

Lisez le diff réel, examinez chaque fichier modifié et exécutez vous-même la commande d’acceptation **initiale** dans votre copie de travail. Ajoutez des contrôles ciblés lorsque la modification le justifie. Acceptez le résultat seulement si comportement, périmètre et contrôles correspondent à la tâche. Si l’exécutant s’arrête tôt ou rend un travail partiel, examinez ses changements avant de poursuivre ou réparer. S’il a utilisé un worktree séparé, relisez ses modifications avant de les intégrer à la copie principale.

Pour une méthode connexe de vérification d’un échec de dépôt avec un assistant IA, consultez notre [guide de réparation et de vérification avec AI Goal](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide). Ce parcours ne configure pas la délégation d’Opus à Haiku utilisée ici.

Si `/tasks` affiche un autre modèle ou un avertissement de substitution, vérifiez l’argument de modèle de l’appel, les métadonnées du fichier d’agent, `CLAUDE_CODE_SUBAGENT_MODEL` et la liste de modèles gérée. Dans Claude Code actuel, le modèle demandé lors de l’appel prévaut sur les métadonnées, puis sur la valeur d’environnement, puis sur le modèle parent ; avant v2.1.251, l’environnement était prioritaire. `CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1` (v2.1.257+) peut remplacer la définition, et le hook `agent.spawn` d’un mod installé peut remplacer le modèle de l’appel. Corrigez la véritable origine du remplacement ou arrêtez l’exécution. Ne présentez pas un résultat non-Haiku comme un résultat Haiku.

## 3. Enregistrer l’usage sans inventer une économie

Relevez `/usage` autour de cette session contrôlée. Notez par modèle les jetons d’entrée, de sortie et de cache, le coût estimé affiché, le fournisseur ou l’abonnement, le diff accepté, le contrôle initial et la revue ou reprise nécessaire. Le bloc Session regroupe toute la session par modèle ; ce n’est pas une facture précise pour cet exécutant nommé. Les pourcentages d’attribution de l’abonnement sont un historique local approximatif par jour ou semaine, pas la mesure de cette tâche. Pour un compte API, Claude Console est la source de facturation faisant autorité. Pour un abonnement, l’estimation en dollars de la session n’est pas une facture supplémentaire. Signalez comme périmé un affichage d’usage correspondant au dernier état connu.

Pour affirmer que la délégation a économisé de l’argent sur **cette** tâche, comparez-la à une exécution à modèle unique autorisée séparément, depuis la même révision propre et avec les mêmes critères. Comptez planification et revue du parent, appels de l’exécutant, nouvelles tentatives et reprises ; comparez seulement des résultats acceptés. Une paire d’exécutions reste une observation propre à la tâche. Sans cette référence, rapportez le parcours de modèles vérifié et le résultat de code ; l’économie est inconnue. [Le guide des coûts d’Anthropic](https://code.claude.com/docs/en/costs) explique l’affichage d’usage et les limites de facturation.

Cette procédure repose sur la documentation actuelle, pas sur une exécution de Claude Code par BIG CHANGE ni sur une tâche mesurée. Ne transmettez pas de code ou de secrets que votre organisation n’a pas autorisés pour son fournisseur configuré. Ce parcours utilise la sélection native Opus et Haiku de Claude Code ; un autre fournisseur nécessiterait une passerelle ou une orchestration définie séparément et ses propres contrôles.

## Sources et lectures complémentaires

- [Anthropic, créer des sous-agents personnalisés](https://code.claude.com/docs/en/sub-agents) — fichiers d’agent de projet, priorité des modèles, `/tasks`, autorisations et comportement des worktrees. Manuel actuel consulté le 20 octobre 2026 ; il documente la fonction, pas le résultat de l’exemple non exécuté de ce guide.
- [Anthropic, configuration des modèles](https://code.claude.com/docs/en/model-config) — alias actuels, différences entre fournisseurs, versions requises et contrôles de modèles gérés. Confirmez votre version et votre fournisseur au moment de l’utilisation.
- [Anthropic, gérer efficacement les coûts](https://code.claude.com/docs/en/costs) — `/usage` : champs, estimations et facturation par abonnement ou API. Il ne démontre pas d’économie pour cette tâche.
- [Anthropic, configurer les autorisations](https://code.claude.com/docs/en/permissions) — règles effectives d’autorisation des outils à examiner avant l’exécution d’un agent qui modifie du code.

## Sources

- [Créer des sous-agents personnalisés — documentation Claude Code](https://code.claude.com/docs/en/sub-agents) — Manuel principal du produit pour les fichiers d’agent, leurs métadonnées, la priorité et les substitutions de modèles, la vérification via /tasks, l’héritage des autorisations et les worktrees. Il ne vérifie ni la tâche non exécutée de ce guide ni une économie.
- [Configuration des modèles — documentation Claude Code](https://code.claude.com/docs/en/model-config) — Source principale pour les alias et identifiants actuels d’Opus et Haiku sur l’API Anthropic, les correspondances d’autres fournisseurs, les versions minimales et les restrictions availableModels gérées. Le lecteur doit vérifier la résolution locale réelle.
- [Gérer efficacement les coûts — documentation Claude Code](https://code.claude.com/docs/en/costs) — Explique les jetons et estimations /usage de session, l’attribution locale d’abonnement, les affichages périmés, la facturation abonnement/API et l’autorité de Console pour les factures. Ne produit pas une facture précise pour un exécutant nommé ni une économie de tâche mesurée.
- [Configurer les autorisations — documentation Claude Code](https://code.claude.com/docs/en/permissions) — Explique les règles effectives d’autorisation shell et fichiers pour un exécutant qui modifie du code. Une liste d’outils de sous-agent n’est pas, à elle seule, une limite de chemins du système de fichiers.