Guides

Comment lancer plusieurs agents IA sur un projet

Faire tourner plusieurs agents sur un projet demande trois choses : une machine qui les héberge, un dossier qu'ils partagent, et une règle qui décide qui écrit où. Sans la troisième, le deuxième agent efface le travail du premier sans que rien ne l'annonce.

Étape par étape

  1. Créez le projet. Un canvas démarre sa propre machine et un dépôt privé. C'est là que le dossier partagé vit, et il est le même pour tous les agents que vous ouvrirez ensuite.
  2. Branchez vos comptes. Connectez l'abonnement ou la clé d'API que vous payez déjà chez Anthropic, OpenAI ou un autre. Aucun jeton n'est revendu, la consommation reste sur votre compte.
  3. Ouvrez une fenêtre par agent. Claude Code, Codex, Kimi et OpenCode s'ouvrent chacun dans sa fenêtre, avec un vrai terminal. Deux fenêtres sur la formule Solo, cinq sur Pro.
  4. Découpez par fichier, pas par tâche. Donnez à chaque agent un coin du projet plutôt qu'une tâche qui traverse tout. Deux agents sur deux zones avancent en parallèle, deux agents sur un même fichier attendent l'un l'autre.
  5. Laissez le tableau arbitrer. Un agent réserve les chemins qu'il va toucher avant d'écrire, et le serveur les refuse aux autres jusqu'à ce qu'il les rende. Vous voyez qui tient quoi, et qui attend.

Ce qu'il faut avoir sous la main

Un dépôt, même vide, et un compte chez un fournisseur de modèle. Le reste est fourni par le projet : la machine, le dossier et le tableau qui distribue les fichiers.

Un fichier d'instructions à la racine du dépôt change le résultat plus que n'importe quel réglage. Les agents le lisent au démarrage, et il évite les cinq premières erreurs de chacun.

Le découpage qui marche

La bonne unité n'est pas la fonctionnalité, c'est le fichier. Un agent sur l'API, un sur l'interface, un sur les tests : ils se croisent peu et n'attendent presque jamais. Trois agents sur « la page de paiement » se disputeront les mêmes trois fichiers toute l'heure.

Ce que vous regardez pendant

Les terminaux défilent dans leurs fenêtres, et le tableau montre qui détient quel chemin. Un agent bloqué est visible avant de faire des dégâts, ce qui est la vraie différence avec une file d'attente invisible. Le mécanisme en détail.

Réponses directes

Combien agents en même temps sont utiles ?

Autant que le projet contient de chantiers indépendants à cet instant, ce qui fait deux ou trois la plupart du temps et cinq sur un gros refactoring. Au-delà, les agents passent leur temps à attendre des fichiers plutôt qu'à écrire.

Faut-il un git worktree par agent ?

C'est la méthode que recommandent la plupart des guides, et elle fonctionne : chaque agent reçoit sa copie de travail avec son propre index, donc aucune collision. Le coût est une fusion par copie, et un conflit qu'on découvre à la fin. Sur un dossier partagé avec réservation, il n'y a rien à fusionner parce qu'il n'y a jamais eu deux versions vivantes.

Faut-il une branche par agent ?

Non, et c'est le point. Une branche par agent déplace le conflit vers la fusion, au moment où plus personne ne se souvient du raisonnement. Un dossier partagé avec une réservation règle le conflit à la seconde où il se produit.

Que se passe-t-il si deux agents veulent le même fichier ?

Le second attend. Il le voit à l'écran, vous aussi, et vous pouvez lui donner autre chose à faire immédiatement au lieu de découvrir le problème une heure plus tard.