Claude Code Projects : coordinateur, fils et limites de la bêta

Anthropic a récemment repensé Projects dans Claude Code. Il s’agit désormais d’une seule conversation de coordination qui lance des sessions cloud parallèles — des fils — pour des tâches et en reçoit des comptes rendus. Un projet vaut la peine d’être créé lorsque votre travail poursuit un objectif qui dépassera une seule session et donnera lieu à de nouvelles tâches — par exemple, développer un dépôt GitHub sur plusieurs semaines. Le seul besoin de travailler en parallèle ne suffit pas. Si vous devez corriger rapidement un fichier, ici et maintenant, une session ordinaire suffit.

Le travail est dirigé par un coordinateur — une conversation de longue durée dans laquelle Claude décide de transformer ou non votre message en tâche pour un fil. Les fils écrivent le code : chacun est une session Claude Code dans le cloud distincte, sur sa propre branche du dépôt. Plusieurs fils peuvent s’exécuter en même temps, chacun avec son propre contexte et sa propre branche. Le coordinateur voit le compte rendu d’un fil lorsqu’il a terminé, mais pas chacune des étapes qu’il effectue. Il vous signale les pull requests terminées (demandes de fusion des modifications) et, sur votre instruction, demande à un fil de les réviser ou de les fusionner. Voici un aperçu fondé sur la documentation officielle d’Anthropic : ce qu’il faut configurer, comment le travail est organisé et quelles sont les limites de la bêta.

La bêta est déployée progressivement, en commençant par les comptes Pro et Max qui ont déjà utilisé des sessions cloud Claude Code et n’ont pas créé de projet dans le chat ordinaire ou Cowork. Si la section Projects n’apparaît pas encore, vous pouvez vous inscrire sur la liste d’attente.

Claude Code Projects expliqué simplement#

Un projet est une conversation unique de longue durée avec un coordinateur, à laquelle sont associés des dépôts, une mémoire et des consignes. Vous écrivez au coordinateur, qui décide de répondre immédiatement ou de lancer un fil. Vous n’avez pas besoin d’ouvrir manuellement une nouvelle session pour chaque tâche.

Un fil est une session Claude Code complète dans le cloud : il a son propre contexte et sa propre branche de dépôt, et ouvre une pull request si nécessaire. Le coordinateur peut garder plusieurs fils ouverts simultanément — par exemple, l’un corrige un bug, un autre écrit des tests et un troisième met à jour la documentation — tout en répondant à vos questions dans la conversation principale.

Pour comparer, imaginez plusieurs onglets contenant des sessions Claude Code locales, chacune dans sa propre copie de travail d’un dépôt. Cette copie s’appelle un worktree — un dossier distinct pour une branche, afin que les sessions locales ne se gênent pas. Vous passez vous-même d’une session à l’autre et décidez quoi attribuer à chacune. Les fils cloud n’ont pas besoin de worktree : chaque fil clone les dépôts dans son propre environnement cloud isolé. Projects s’occupe de la coordination et décide quand créer un nouveau fil et quand ce n’est pas nécessaire.

Un projet dispose d’une mémoire et de consignes partagées que chaque nouveau fil reçoit. La section consacrée à la configuration explique quoi y enregistrer et comment ces éléments sont transmis aux fils.

Différences avec une session ordinaire et une équipe d’agents#

Si vous exécutez déjà des sous-agents imbriqués dans une seule session Claude Code, il est utile de les distinguer des équipes d’agents et des fils de projet. Une équipe d’agents est une autre façon de déléguer le travail : une session lance des sessions de collègues pour une tâche précise. Vous pouvez l’utiliser sur votre propre machine ou dans une session cloud.

• Équipe d’agents — des sessions de collègues pour une tâche précise, qui peuvent être lancées localement ou dans le cloud. Ce ne sont pas des fils de projet distincts.
• Un projet et ses fils — le travail s’effectue dans le cloud. Chaque fil est une session distincte sur sa propre branche et continue de fonctionner même après la fermeture de votre ordinateur portable. Une session locale ne peut pas faire partie d’un projet.
• Vue des agents — un écran permettant d’observer plusieurs sessions locales sur votre machine. Il n’y a pas de coordinateur : vous décidez quoi attribuer à chacune.

La documentation officielle d’Anthropic souligne un point distinct : le seul fait de vouloir travailler en parallèle ne justifie pas la création d’un projet. Dans un projet, Claude lance lui-même les sessions et en reçoit les comptes rendus, et toutes les sessions démarrent avec des dépôts, des consignes et une mémoire partagés. Le travail reste dans le cloud pendant toute la tâche.

Une approche similaire — un coordinateur répartit les tâches entre des agents — est mise en œuvre dans un autre outil, présenté dans l’article sur Cursor Projects. Le mécanisme est différent, mais le coordinateur décide également qui fait quoi.

À configurer avant votre premier projet#

Avant de créer un projet, vérifiez trois points.

1. Compte GitHub et Claude GitHub App. Si vous avez déjà connecté GitHub via /web-setup, ce jeton permet à vos sessions cloud ordinaires d’accéder au dépôt. Cela ne suffit pas pour les fils de projet : vous devez disposer d’un compte GitHub connecté avec un accès en écriture au dépôt, et avoir installé Claude GitHub App pour ce dépôt. Sans cela, un fil ne peut ni cloner le dépôt ni ouvrir de pull request.

2. Consignes du projet. Les consignes du projet sont un texte de 16 000 caractères maximum, envoyé à chaque nouveau fil ainsi qu’au coordinateur lui-même. Ajoutez-y les informations que vous devriez autrement réexpliquer à chaque session : la structure du dépôt, les conventions de code et les vérifications requises avant une pull request.

3. Modèle et niveau d’effort. Par défaut, un nouveau projet exécute chaque fil avec le modèle Opus et un niveau d’effort élevé, et le coordinateur avec un niveau d’effort faible. La documentation indique que ce réglage « consomme le plus rapidement votre allocation de forfait » (traduction ; original : draws on your plan fastest). Si vos tâches sont simples, vous pouvez choisir un modèle moins coûteux ou réduire le niveau d’effort dans Project settings > General. Les réglages des fils et du coordinateur se modifient séparément ; la documentation décrit des options plus économiques.

La mémoire du projet est stockée dans des fichiers ordinaires, avec un fichier d’index nommé MEMORY.md. Chaque nouveau fil le lit au démarrage et accède aux autres fichiers selon ses besoins. Les découvertes d’un fil enregistrées dans la mémoire sont ainsi disponibles au suivant, sans qu’il soit nécessaire de les lui répéter.

Comment gérer les chevauchements entre fils Claude Code Projects ?#

Chaque fil travaille sur sa propre branche et ouvre lui-même une pull request si le travail le nécessite. Mais le coordinateur ne garantit pas que les tâches ne se chevaucheront jamais : si plusieurs fils travaillent dans la même zone du code, vous pouvez demander au fil concerné de résoudre le conflit depuis l’interface. Un bouton Resolve conflicts situé à côté de sa pull request envoie une consigne au fil sous la forme d’un message de votre part.

La documentation officielle suggère de préciser dans les consignes du projet vos préférences concernant le nombre de fils : vous pouvez, par exemple, demander au coordinateur de ne pas lancer plus de deux fils à la fois ou de réutiliser un fil existant pour les nouvelles tâches dans la même zone. Il s’agit d’une préférence que le coordinateur essaie de respecter, et non d’une limite stricte. À elle seule, elle ne garantit pas que les fils ne se heurteront pas dans le même fichier : un conflit existant doit être résolu séparément. Pour des tâches liées dans une même zone, vous pouvez réutiliser un fil actif ou inactif. S’il est resté inactif plus d’une heure, il relit tout l’historique à la réception d’un nouveau message, ce qui affecte la consommation de votre allocation d’abonnement.

Plus les tâches sont clairement réparties entre fichiers ou modules, plus il est facile de travailler en parallèle. Un article distinct explique comment diviser une tâche importante en parties indépendantes : comment déléguer le codage à des milliers d’agents. L’échelle y est différente, mais le principe de répartition du travail est le même.

Tant que le cache de conversation reste actif (sur les forfaits Pro et Max, pendant une heure, si les limites de votre forfait le permettent), un fil utilise moins de jetons de l’allocation d’abonnement pour retraiter son historique. Une fois le cache expiré, le fil relit tout son historique à la réception d’un nouveau message, avant de commencer à travailler. Pour une nouvelle tâche indépendante, il peut être plus économique de demander au coordinateur de créer un nouveau fil : cela peut consommer moins de jetons de la même allocation d’abonnement que de poursuivre une ancienne session avec un historique volumineux après l’expiration de son cache.

Limites de la bêta à connaître à l’avance#

Avant de créer un projet pour une tâche importante, vérifiez les limites de la bêta :

• Disponible uniquement avec Pro et Max. Team et Enterprise ne sont pas encore pris en charge.
• Limite de 200 nouveaux fils par jour et par compte, tous projets confondus.
• Un projet appartient à une seule personne. Vous ne pouvez pas partager le projet ni un fil individuel avec une autre personne, et la bêta ne propose pas de paramètres d’organisation pour les équipes.
• Accès uniquement via claude.ai/code, l’application de bureau et l’application mobile. Projects ne fonctionne pas dans la CLI du terminal, via Amazon Bedrock, Google Cloud Agent Platform ou Microsoft Foundry.
• Un projet ne peut pas accéder aux fichiers ni aux outils locaux. Les fils fonctionnent avec des dépôts GitHub, des fichiers importés et des dossiers Google Drive, mais pas avec les éléments présents uniquement sur votre machine.

Si vous avez besoin d’un accès au terminal ou à des outils disponibles uniquement sur votre machine, utilisez une session locale ou une vue des agents pour plusieurs sessions de ce type. Si plusieurs personnes doivent collaborer dans un même espace de travail, Anthropic propose un produit distinct pour les équipes sur Team et Enterprise : Claude Tag. Il se trouve dans un canal Slack ; chaque membre peut confier une tâche à Claude, et tous les membres du canal peuvent voir le travail et le diriger. Un projet fonctionne autrement : il vous appartient à vous seul. Si vous avez uniquement besoin de certains fichiers locaux, vous pouvez les importer dans le projet ; chaque fil pourra alors y accéder. Cela ne donne pas accès aux outils locaux.

Et ensuite#

Avant de déplacer votre flux de travail vers Projects, essayez de créer un projet de test dans un dépôt sans enjeu critique : connectez la GitHub App, rédigez de brèves consignes, confiez une tâche indépendante au coordinateur et observez comment il la traite. Ce premier essai vous permettra de voir si vous comprenez l’interface du coordinateur et des fils. Il ne permet pas d’évaluer le travail en parallèle, les conflits ni la consommation de l’allocation sur plusieurs tâches — ces aspects doivent être testés séparément.