Sous-agents en arrière-plan de Claude Code : moins de quota consommé, Haiku 5.5 écrit la ligne d'état dès la 2.1.316 (mise à jour, vérification, configuration)

En bref

• Selon le compte officiel d'Anthropic @ClaudeDevs (publié le 4 novembre, heure des États-Unis) : un sous-agent en arrière-plan rafraîchit sa ligne d'état toutes les 30 secondes, et chaque rafraîchissement relisait toute la conversation du sous-agent. Désormais Haiku 5.5 l'écrit à partir de notes courtes, ce qui demande environ 99 % de moins à chaque fois.
• Selon le message de suivi : le sous-agent garde son propre modèle ; les sessions avec sous-agents en arrière-plan ont consommé environ 5 % de quota en moins, soit environ 6 % de prompts en plus pour le même quota. C'est actif pour la plupart des utilisateurs Pro, Max et Ultra et pour tous les comptes Team et Enterprise, avec Claude Code v2.1.316 ou plus récent.
• Une seule chose à faire : lancer claude --version et mettre à jour si vous êtes sous la 2.1.316. Selon AlphaSignal, aucun changement de configuration n'est nécessaire.
• Nous avons testé le 5 novembre avec une API Key aicodewith sur Claude Code 2.1.318. La ligne d'état du sous-agent changeait bien environ toutes les 30 secondes (« Reading shop and test files » → « Re-running tests on test_shop.py ») et le sous-agent a terminé en 1 min 46 s avec le bon fichier:ligne. Avec une API Key, les requêtes de rafraîchissement que nous avons capturées utilisaient le modèle du sous-agent. Pour mettre le sous-agent et sa ligne d'état sur Haiku 5.5, réglez CLAUDE_CODE_SUBAGENT_MODEL ; /tasks affiche alors « Haiku 5.5 ».

Créer une API Key et lancer des sous-agents en arrière-plan dans Claude Code →

Ce qui a changé

Sources : le message principal et le message de suivi de @ClaudeDevs. Selon METAL, Anthropic a aussi publié une vidéo explicative de 6,6 secondes ; selon AlphaSignal, le message date du 4 novembre, heure des États-Unis.

La « ligne d'état » dont il est question n'est pas la barre du bas que vous personnalisez avec /statusline. C'est le court texte « ce qu'il fait en ce moment » affiché après chaque sous-agent en arrière-plan, dans le panneau sous la zone de saisie. Selon l'article du développeur Gabriel Anhaia sur DEV, ce texte venait jusqu'ici de l'envoi de la conversation du sous-agent à son propre modèle, avec la demande de résumer sa dernière action en 3 à 5 mots. Cela ne se déclenche que pour les sous-agents en arrière-plan qui travaillent. Plus vous en lancez et plus ils tournent longtemps, plus cela pèse.

Le journal des modifications de Claude Code montre d'autres corrections sur cette même ligne : la 2.1.128 a corrigé des résumés de progression qui rataient le cache de prompt, la 2.1.274 un résumé qui devenait une longue réponse de plusieurs paragraphes, et la toute dernière 2.1.318 la notice « Now using usage credits » qui réapparaissait environ toutes les 30 secondes pendant qu'un sous-agent tournait en arrière-plan.

Qui est concerné

Pour le fonctionnement des limites (fenêtre de 5 heures et limite hebdomadaire), voir Limites d'usage de Claude Code et Max 20x.

Passer en 2.1.316+ et vérifier la version

Vérifiez votre version actuelle :

claude --version
2.1.318 (Claude Code)

Si elle est inférieure à 2.1.316, mettez à jour selon votre mode d'installation. Selon la documentation d'installation de Claude Code, l'installation native se met à jour en arrière-plan, alors que Homebrew et WinGet ne le font pas par défaut :

# Installation native ou npm : passer à la dernière version
claude update
# Homebrew : le cask claude-code suit le canal stable, en général environ une semaine de retard ; @latest reçoit les nouvelles versions tout de suite
brew upgrade claude-code@latest
# Windows WinGet
winget upgrade Anthropic.ClaudeCode
# Vérifier le mode d'installation, les mises à jour automatiques et la dernière mise à jour
claude doctor

Ouvrez un nouveau terminal et relancez claude --version. Les messages d'Anthropic ne mentionnent aucun nouvel interrupteur ni réglage : utilisez simplement vos sous-agents en arrière-plan après la mise à jour.

Test réel : un sous-agent en arrière-plan dans Claude Code avec une API Key

Test du 5 novembre 2026, Claude Code 2.1.318 sous Linux, session principale sur Opus 5.5. Nous avons utilisé un dossier HOME vierge pour ne toucher à aucune configuration existante.

Étape 1 : créer une API Key et connecter Claude Code

1. Inscrivez-vous sur aicodewith.ai et connectez-vous, puis cliquez sur « Gestion des clés » dans la barre de navigation à gauche.
2. Cliquez sur « Créer une clé » et donnez-lui un nom clair, par exemple « Sous-agents Claude Code ».
3. Copiez immédiatement la clé complète. Une fois la fenêtre fermée, la clé complète ne s'affiche plus. Détails dans la documentation Créer une API Key.

Créer une API Key →

Ajoutez la clé dans ~/.claude/settings.json :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "VOTRE_API_KEY"
  }
}

Pour les autres façons de se connecter, voir Utiliser Claude Code avec une API tierce.

Étape 2 : une tâche qui dure un peu

Le dépôt de démonstration est un petit projet Python : 3 fichiers dans shop/ et 7 tests dans tests/. Le setUp de chaque test attend 6 secondes, donc une exécution complète prend environ 42 secondes, et shop/pricing.py cache un bug de seuil : « 10 unités ou plus » écrit qty > 10. Envoyez ceci dans Claude Code :

Use a general-purpose subagent in the background for a read-only review of this repo:
first run python3 -m unittest discover -s tests -v (about 45 seconds), then read every
file in shop/ and tests/ one by one, then run the test suite a second time, and finally
report each failing test with file:line, a one-line fix, and two other risks you notice.
The subagent must not edit any file. While it runs, just tell me it started.

Étape 3 : observer la ligne d'état du sous-agent

La session principale répond aussitôt que c'est lancé, et le panneau des sous-agents apparaît sous la zone de saisie. Voici la même ligne à différents moments, dans l'ordre :

● Agent(Read-only repo review)
  ⎿  Backgrounded agent (↓ to manage · ctrl+o to expand)
✻ Waiting for 1 background agent to finish

  ● main
  ◯ general-purpose  Read-only repo review                 48s · ↓ 12.0k tokens
  ◯ general-purpose  Reading shop and test files        1m 10s · ↓ 14.0k tokens
  ◯ general-purpose  Re-running tests on test_shop.py   1m 40s · ↓ 14.1k tokens

● Agent "Read-only repo review" finished · 1m 46s

Elle affiche d'abord le nom de la tâche « Read-only repo review ». À 1 min 10 s elle devient « Reading shop and test files », à 1 min 40 s « Re-running tests on test_shop.py », soit environ 30 secondes d'écart, et le sous-agent termine à 1 min 46 s. Dans un autre essai qui ne lançait les tests qu'une fois (sous-agent sur l'Opus 5.5 de la session principale), il a terminé en 59 s et la ligne est passée du nom de la tâche à « Preparing shop unittest discovery run ».

Le rapport final du sous-agent (extrait) :

Tests: 7 ran and 1 failed. Both runs gave the same results, so nothing looks flaky.
Failing test: test_bulk_at_threshold (tests/test_shop.py:10)
- It expects 10 units at 1.0 to total 9.5, but the code returns 10.0.
- The cause is shop/pricing.py:3, which uses if qty > 10.
- Fix: change > to >= at shop/pricing.py:3.
Two other risks:
1. Overselling (shop/inventory.py:4-7): reserve() checks stock and then sets it with no lock.
2. Missing input checks (shop/cart.py:5, shop/cart.py:9).

shop/pricing.py:3 et la correction de > en >= sont justes, et aucun fichier n'a été modifié.

Étape 4 : quel modèle écrit la ligne d'état ?

Nous avons placé devant l'API un relais local qui n'enregistrait que le nom du modèle et le nombre de messages :

Dans notre test avec une API Key via ANTHROPIC_BASE_URL, le rafraîchissement envoyait donc encore la conversation actuelle du sous-agent à son propre modèle, comme dans l'ancien fonctionnement décrit par Anthropic. Anthropic indique que le nouveau fonctionnement est actif pour la plupart des abonnés et ne parle pas des connexions par API Key. Pour les utilisateurs d'API Key, le plus direct est de passer les sous-agents sur Haiku 5.5 : le travail et les rafraîchissements tournent alors tous deux sur Haiku 5.5.

Choisir le modèle des sous-agents

Selon la documentation des sous-agents de Claude Code, le modèle d'un sous-agent est choisi dans cet ordre :

1. Le paramètre model passé par Claude pour cet appel ;
2. Le champ model de la définition du sous-agent (inherit = modèle de la session principale) ;
3. La variable d'environnement CLAUDE_CODE_SUBAGENT_MODEL ;
4. Le modèle de la session principale.

Option 1 : un modèle par défaut pour tous les sous-agents

Ajoutez une ligne dans env de ~/.claude/settings.json. C'est la configuration de l'étape 3 :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "VOTRE_API_KEY",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-5-5"
  }
}

Ce n'est qu'une valeur par défaut : un sous-agent dont la définition fixe model, ou un appel où Claude passe un modèle, l'emporte. Seule, elle ne change pas non plus les sous-agents intégrés Explore et Plan.

Option 2 : un modèle pour un sous-agent précis

Créez un fichier Markdown dans .claude/agents/ du projet ou dans votre ~/.claude/agents/ :

---
name: test-runner
description: Runs the test suite and reports failing tests with file:line. Read-only.
tools: Read, Grep, Glob, Bash
model: haiku
effort: medium
---
Run the tests, read only the files you need, and report each failing test
with file:line and a one-line fix. Never edit files.

model accepte haiku, sonnet, opus, inherit ou un identifiant complet comme claude-haiku-5-5. Pour un sous-agent en lecture seule plus complet, voir Sous-agents Claude Code sur Haiku 5.5 : configuration.

Option 3 : imposer un seul modèle à tous les sous-agents

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1",
    "CLAUDE_CODE_SUBAGENT_EFFORT": "medium"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 ignore le champ model des définitions (v2.1.257+). CLAUDE_CODE_SUBAGENT_EFFORT, nouveau en 2.1.316, fixe l'effort par défaut des sous-agents au lieu d'hériter de celui de la session.

Vérifier que c'est pris en compte

Pendant que le sous-agent tourne, tapez /tasks et sélectionnez-le pour voir le modèle réellement utilisé. Notre sortie :

/tasks
  general-purpose › Read-only repo review
  1m 1s · 14.0k tokens · 8 tools · Haiku 5.5
  Progress
    Read(shop/cart.py)
    Read(shop/inventory.py)
    Read(shop/pricing.py)
    Read(tests/test_shop.py)
  › Bash(python3 -m unittest discover -s tests -v 2>&1; echo "EXIT=$?")

« Haiku 5.5 » en fin de deuxième ligne est le modèle sur lequel tourne le sous-agent. Pour savoir quelles tâches conviennent à Haiku 5.5 ou à Sonnet 5.5, voir Claude Haiku 5.5 vs Sonnet 5.5.

Autres façons de consommer moins

• Moins de sous-agents en arrière-plan en même temps : la ligne d'état ne se rafraîchit que pour les sous-agents qui travaillent ; cinq à la fois, ce sont cinq boucles de rafraîchissement.
• Confiez la recherche de fichiers et les tests à Haiku 5.5, et gardez la session principale pour ce qui demande de la réflexion.
• Transformez les flux répétitifs en Skills : ce qui n'a pas besoin de son propre contexte tourne plus léger dans la session principale, voir Intégrer les sous-agents Claude Code dans des Skills.
• Utilisateurs de Codex : pour découper le travail Codex en sous-tâches, voir Sous-agents Codex : stratégie de découpage ; pour faire tourner Claude Code et Codex côte à côte dans des dossiers séparés, voir Lancer plusieurs Claude Code / Codex en parallèle sans Conductor.

Questions fréquentes

Faut-il changer un réglage ?

Anthropic demande seulement de passer en v2.1.316 ou plus récent, et ses messages ne citent aucun nouvel interrupteur. Selon AlphaSignal, aucun changement de configuration n'est nécessaire.

Mes sous-agents vont-ils passer sur Haiku ?

Non. Selon Anthropic, Haiku 5.5 n'écrit que la ligne d'état ; le sous-agent travaille sur le modèle configuré. Pour faire tourner le sous-agent lui-même sur Haiku, réglez CLAUDE_CODE_SUBAGENT_MODEL ou écrivez model: haiku dans sa définition.

Quel lien entre « 99 % de moins » et « 5 % de moins » ?

99 %, c'est par rafraîchissement de la ligne d'état ; 5 %, c'est sur toute la session. Les rafraîchissements ne pèsent qu'une petite part d'une session, d'où environ 5 % d'économie, soit environ 6 % de prompts en plus pour le même quota.

Comment voir ce que fait un sous-agent en arrière-plan ?

Le panneau sous la zone de saisie affiche une ligne par sous-agent en arrière-plan avec son état, sa durée et ses tokens. Sélectionnez-le avec ↓, ouvrez sa transcription avec Enter, et utilisez /tasks pour voir son modèle, ses appels d'outils et sa progression.

Le nouveau fonctionnement s'applique-t-il avec une API Key ?

Les messages d'Anthropic ne citent que Pro, Max, Ultra, Team et Enterprise. Dans notre test API Key sur 2.1.318, les rafraîchissements suivaient le modèle du sous-agent ; avec le sous-agent sur Haiku 5.5, ils tournaient aussi sur Haiku 5.5.

Créer une API Key et utiliser les sous-agents en arrière-plan de Claude Code →

À lire aussi

• Sous-agents Claude Code sur Haiku 5.5 : configuration
• Intégrer les sous-agents Claude Code dans des Skills
• Limites d'usage de Claude Code et Max 20x
• Claude Haiku 5.5 vs Sonnet 5.5
• Utiliser Claude Code avec une API tierce