Comment lancer des agents Claude Code en arrière-plan

Cinq façons de lancer Claude Code en arrière-plan

Elles diffèrent par ce qui doit rester en marche, et par qui lance le travail.

Les tâches en arrière-plan dans une session

Appuyez sur Ctrl+B pendant que Claude exécute une commande Bash ou un sous-agent pour l’envoyer en arrière-plan (deux fois dans tmux), et continuez à parler à Claude. Claude peut aussi lancer de lui-même une commande en arrière-plan. Les sous-agents que Claude crée tournent en arrière-plan par défaut.

Tapez /tasks pour lister les shells et sous-agents en cours et vérifier où ils en sont. Dans une session de terminal locale, une commande en arrière-plan n’a pas de limite de durée, mais elle s’arrête quand Claude Code se ferme. Pour faire tourner plusieurs agents côte à côte, voir comment lancer plusieurs agents Claude Code.

Agent view : des sessions qui survivent au terminal

claude --bg "<prompt>" lance une session en arrière-plan et rend la main immédiatement ; /bg envoie en arrière-plan la session dans laquelle vous êtes. Un processus superviseur les fait tourner : fermer le terminal ne les arrête pas, mais éteindre ou redémarrer l’ordinateur, si. Une session inactive à laquelle personne n’est attaché est arrêtée au bout d’environ une heure.

claude agents ouvre l’agent view ; claude attach <id>, claude logs <id> et claude stop <id> gèrent une session. Agent view est en research preview : les commandes peuvent changer.

Lancer Claude Code en headless avec claude -p

1. Exécutez un prompt et quittez

   -p (ou --print) lance Claude Code sans l’interface interactive et quitte une fois le travail fini, avec le code de sortie 0 en cas de succès. Vous pouvez aussi lui envoyer une entrée par un pipe.

   claude -p "List the failing tests and why they fail"
   cat error.log | claude -p "Explain this error"

2. Obtenez une sortie lisible par un script

   --output-format json renvoie le résultat avec l’ID de session et des métadonnées, dont total_cost_usd, une estimation calculée sur votre machine. stream-json (avec --verbose) diffuse les événements au fur et à mesure.

   claude -p "Summarize this repo" --output-format json | jq -r '.result'

3. N’autorisez que les outils nécessaires

   En mode headless, personne n’est là pour valider une demande. Depuis la v2.1.302, une exécution sans mode défini démarre en Manual et refuse tout ce qui nécessiterait une validation. Utilisez --allowedTools pour ce qu’il a le droit de faire et --permission-mode dontAsk pour refuser le reste au lieu d’attendre.

   claude -p "Run the test suite and summarize failures" \
     --permission-mode dontAsk --allowedTools "Read,Bash(npm test)"

4. Plafonnez l’exécution

   --max-turns s’arrête après un certain nombre de tours de l’agent, et --max-budget-usd à un coût estimé (qui peut être légèrement dépassé). Les deux ne fonctionnent qu’avec -p.

   claude -p "Fix the lint errors" --max-turns 15 --max-budget-usd 3

5. Reprenez la même conversation plus tard

   Enregistrez l’ID de session de la sortie JSON et passez-le à --resume, ou utilisez --continue pour la session la plus récente du dossier.

   id=$(claude -p "Start a code review of src/" --output-format json | jq -r '.session_id')
   claude -p "Now check the tests too" --resume "$id"

6. Lancez-le selon un planning avec cron

   La documentation d’Anthropic ne contient pas d’exemple cron ; celui-ci n’utilise que des options documentées. Cron a un PATH minimal : utilisez le chemin complet donné par which claude, et créez d’abord le dossier des logs. N’ajoutez pas --bare ici : cette option ignore votre connexion par abonnement et exige une clé API.

   # crontab -e : en semaine à 9:00
   0 9 * * 1-5  cd /path/to/repo && /path/to/claude -p "Summarize yesterday's commits and list new TODO comments. Do not edit files." --permission-mode dontAsk --allowedTools "Read,Bash(git log *),Bash(git diff *)" --max-turns 10 --output-format json >> "$HOME/logs/claude-daily.log" 2>&1

Source : documentation d’Anthropic sur le mode headless

Permissions pour les exécutions sans surveillance

• dontAsk plus une liste --allowedTools est le choix le plus verrouillé : tout ce qui n’est pas dans la liste est refusé.
• auto confie l’examen de chaque action à un classifieur plutôt qu’à vous. Anthropic précise que cela ne garantit pas la sécurité.
• acceptEdits valide les modifications de fichiers et les commandes de fichiers simples, mais pas les autres commandes shell.
• bypassPermissions saute les demandes et les contrôles de sécurité. Anthropic recommande de ne l’utiliser que dans des conteneurs ou VM isolés sans accès à Internet, car il n’offre aucune protection contre l’injection de prompt.
• Pour des règles qui s’appliquent à chaque exécution dans un projet, placez permissions.allow et permissions.deny dans .claude/settings.json. Les règles de refus l’emportent toujours.

Options cloud : quand votre ordinateur est éteint

• Sessions cloud : claude --cloud "<task>" tourne sur l’infrastructure d’Anthropic à partir de votre branche GitHub et continue avec le portable fermé. Envoyez des messages de suivi avec claude -p "..." --cloud <session-id>.
• Tâches planifiées dans le cloud : créées avec /schedule ou sur claude.ai/code, elles tournent selon un planning (au plus une fois par heure), via un appel API ou sur des événements GitHub. Pro, Max, Ultra, Team et Enterprise ; en research preview.
• GitHub Actions : anthropics/claude-code-action@v1 avec un déclencheur schedule. Un token OAuth obtenu avec claude setup-token utilise votre abonnement ; une clé API est facturée au token.

Confiez un poste permanent à un agent en arrière-plan

Les tâches en arrière-plan, l’agent view et cron lancent tous un travail que vous avez déjà décidé. Crewmark donne plutôt à une session Claude Code un rôle dans la durée : elle se réveille au rythme d’une pulsation pendant les heures de travail, prend le ticket suivant sur un tableau et vous écrit quand elle est bloquée.

1. Transformez une session en employé

   Choisissez un rôle et un objectif chiffré, et lancez dans Claude Code la commande de configuration que Crewmark vous donne. Cette conversation devient l’employé.

2. Laissez la pulsation lancer le travail

   Le daemon Crewmark réveille la session toutes les 15, 30 ou 60 minutes pendant ses heures de travail, avec l’abonnement que vous payez déjà, et la laisse tranquille en dehors.

3. Assignez des tickets, répondez aux messages

   Ajoutez du travail sous forme de tickets sur le tableau ; l’employé les prend en charge, commente au fil de l’eau et vous sollicite quand il a besoin d’une relecture. Voir ce qu’est un employé IA.

FAQ : agents Claude Code en arrière-plan