Laissez Claude coordonner le travail en cours avec Projects

• Envoyer le travail à un seul endroit : collez un rapport de bug, une trace de pile ou une liste de tâches dans la conversation chaque fois qu’une apparaît. Claude démarre un thread pour chaque élément de travail ou le transmet au thread déjà en train de travailler dans ce domaine, et répond aux questions rapides sur place.
• Définir le contexte une seule fois : chaque nouveau thread commence avec les référentiels, les instructions et la mémoire du projet, donc une règle que vous énoncez une seule fois, comme la branche à cibler, atteint tous les threads.
• Partez et revenez au travail terminé : quand vous revenez une heure plus tard ou le lendemain matin, le volet Overview montre quels threads ont terminé, quelles pull requests sont prêtes pour examen, et quel thread attend votre réponse.

​

Quand utiliser un projet

• Un objectif sur plusieurs référentiels : « Mettre à jour chaque service avec la nouvelle configuration lint. » Claude peut exécuter un thread par référentiel, chacun avec sa propre pull request, et le volet Overview montre lesquels sont prêts pour examen.
• Un domaine que vous continuez à alimenter : les bugs, les traces de pile et les demandes d’examen pour un service, collés dans la conversation au fur et à mesure qu’ils vous parviennent. Une mise en garde que vous dites à Claude de mémoriser après une correction est dans la mémoire du projet pour la prochaine.
• Une construction ou une migration plus grande qu’une session : « Construire ce que docs/spec.md décrit » ou « Migrer l’application hors de l’ORM obsolète. » Le travail se divise en threads qui prennent chacun une partie, les décisions que vous demandez à Claude de mémoriser au début atteignent les threads ultérieurs, et la spécification change et les bugs que vous trouvez pendant la construction vont dans la même conversation.
• Un travail qui n’est pas du code : un dossier de contrats ou une exportation de tickets d’assistance sur laquelle vous revenez continuellement avec de nouvelles questions, comme « trouver les dix erreurs d’intégration les plus courantes dans ces tickets. » Téléchargez les documents au lieu d’ajouter un référentiel, et les threads livrent chaque rapport en tant que fichier sur l’onglet Library du projet.

​

Quand quelque chose d’autre convient mieux

• Une tâche qui tient dans une session : « Corriger le test de connexion instable. » Démarrez une session cloud vous-même.
• Un travail qui nécessite des outils ou des services que seule votre machine peut atteindre : une base de données locale, un émulateur d’appareil, une API derrière votre VPN. Utilisez une session locale, ou agent view pour en exécuter plusieurs à la fois. Si le travail ne nécessite que des fichiers locaux, téléchargez-les vers le projet à la place.
• Une tâche qui se répète selon un calendrier sans conversation autour : « Publier un rapport de dépendance chaque lundi. » Créez une routine seule.
• Plusieurs personnes donnant du travail à Claude et le dirigeant ensemble dans un canal Slack : voir Claude Tag.

​

Comment un projet est organisé

• La conversation du projet : une session longue durée unique où Claude agit en tant que coordinateur. Il prend ce que vous envoyez, décide ce qui devient un thread, et garde une trace de chaque thread qu’il a démarré. Il voit ce que les threads rapportent, pas chaque étape qu’ils prennent.
• Threads : les travailleurs. Chacun est une session cloud distincte avec sa propre fenêtre de contexte qui fait un morceau de travail sur sa propre branche, ouvre une pull request quand le travail l’exige, et rapporte à la conversation quand il termine.
• Ce que chaque thread commence avec :
  • Les référentiels et fichiers du projet, plus ses instructions et mémoire
  • Le CLAUDE.md, les skills et les plugins dans chacun des référentiels du projet, et dans un projet avec un référentiel, les règles de permission et les hooks de ce référentiel aussi
  • Les connecteurs sur votre compte claude.ai
  • Un environnement cloud qui définit son accès réseau, les variables d’environnement, les identifiants API et les outils installés
• Le volet Overview : où vous voyez tous les threads à la fois et lesquels vous attendent. Ses autres onglets sont Library pour les fichiers que vous avez ajoutés et les fichiers que les threads ont produits, Pull requests pour ceux que les threads ont ouverts, et Routines pour le travail programmé dans le projet.

​

Créer un projet

• À partir de zéro, quand vous connaissez le flux de travail que vous voulez que Claude exécute : ouvrez la boîte de dialogue New project et nommez-la. Démarrer un nouveau projet à partir de zéro parcourt la boîte de dialogue.
• À partir d’une session cloud qui fait déjà le travail : choisissez Continue as a project dans le menu de cette session, et Claude propose la configuration du projet à partir de ce que la session faisait. Voir Démarrer à partir d’une session cloud existante.

​

Vérifier les prérequis

• Plan : vous êtes sur Pro ou Max et Projects s’affiche dans votre barre latérale.
• GitHub, si le projet travaillera sur du code : votre code est sur github.com plutôt que sur GitHub Enterprise Server, GitLab ou Bitbucket, votre compte GitHub connecté y a accès en push, et l’application Claude GitHub est installée dessus. Si vous avez connecté GitHub avec /web-setup, ce token permet à vos autres sessions cloud d’atteindre un référentiel mais n’est pas suffisant pour les threads du projet, qui ont besoin de l’application Claude GitHub. Configurer l’accès GitHub a les étapes.
• Réseau, identifiants et outils : ceux-ci proviennent de l’environnement cloud du projet. L’environnement par défaut atteint déjà les registres de packages courants, donc vérifiez ceci seulement si le travail a besoin d’autres domaines, d’un secret ou d’un outil qui n’est pas préinstallé. Si le travail a besoin d’un serveur MCP, vérifiez qu’il s’affiche comme connecté dans vos connecteurs claude.ai.

​

Démarrer un nouveau projet à partir de zéro

​

Démarrer à partir d’une session cloud existante

• Continue as a project crée un nouveau projet nommé d’après la session et l’ouvre. Claude lit la session et publie Setup recommendations dans la conversation pour que vous confirmiez. La session d’origine reste dans votre liste de sessions, et si elle était au milieu d’un tour, elle continue à s’exécuter, donc arrêtez-la vous-même si vous ne voulez pas que les deux fonctionnent à la fois. Si vous utilisez la bannière Set up project qui peut apparaître au-dessus de la boîte de message de la session cloud à la place, le résultat est le même, sauf que le tour en cours de la session s’arrête une fois que le projet s’ouvre.
• Move to project apporte le travail de la session dans un projet existant. Il publie un message dans la conversation de ce projet demandant à Claude de lire la session et de continuer là où elle s’était arrêtée, et le nouveau travail continue dans les propres threads du projet. La session d’origine reste dans votre liste de sessions, inchangée.

​

Configurer l’accès GitHub

​

Travailler dans un projet

​

Votre premier lot

1. Écrire les instructions du projet : le brief que chaque thread commence, comme la branche à cibler, comment un thread vérifie son travail et ce qui a besoin de votre approbation.
2. Envoyez un petit morceau du vrai travail, ou démarrez l’un des threads que Claude a suggérés, et ouvrez le thread quand il termine pour voir comment il rapporte et ce qu’il a fait sur sa branche. S’il a supposé quelque chose de mal ou ne pouvait pas atteindre ce dont il avait besoin, Les threads ont deviné ou se sont arrêtés au lieu de demander couvre où corriger cela.
3. Vérifiez Thread model et Thread effort dans Project settings > General. Un nouveau projet exécute chaque thread sur Opus à effort élevé, ce qui utilise votre plan le plus rapidement ; Choisir des modèles et laisser Claude gérer le contexte couvre les alternatives.
4. Demandez à Claude de proposer des threads avant de les démarrer et d’en exécuter quelques-uns à la fois, et abandonnez ces limites une fois que quelques threads reviennent comme vous le souhaitez.

​

Envoyer du travail et lire les résultats

• Une question rapide obtient généralement une réponse dans la conversation.
• Le nouveau travail va à un nouveau thread ou à un thread qui travaille déjà dans ce domaine, et Claude vous dit lequel. Chaque nouveau thread s’affiche sous votre message sous forme de carte : une boîte avec le titre et l’état du thread, que vous cliquez pour ouvrir le thread.
• Plusieurs tâches non liées dans un message deviennent des threads séparés.

​

Examiner la pull request d’un thread

• Branch : travaille sur une nouvelle branche, commencée à partir de la branche par défaut du référentiel.
• Pull request : en ouvre une quand vous le demandez, et peut en ouvrir une seule pour une correction de bug ou un autre changement concret.
• Après l’ouverture : surveille la pull request avec auto-fix activé, que auto-fix soit activé ou non pour vos autres sessions cloud. Il pousse des corrections quand CI échoue, traite les commentaires d’examen, et répond dans le thread quand les vérifications réussissent et la pull request est prête pour vous.

​

Voir ce qui vous attend dans Overview

​

Ouvrir un thread quand vous avez besoin de contrôle

• Lire ce que Claude a fait, étape par étape.
• Diriger la tâche en écrivant dans la boîte de message propre du thread. Un message là va directement à ce thread, tandis qu’une suite dans la conversation du projet ne l’atteint que quand Claude correspond la suite à ce thread.
• Répondre à une invite de permission que le thread attend.
• Interrompre le thread avec Stop, qui remplace le bouton d’envoi pendant que le thread fonctionne, ou en appuyant sur Échap.

​

Choisir des modèles et laisser Claude gérer le contexte

• Thread model et Thread effort s’appliquent aux threads. Pour utiliser un modèle différent pour une tâche, demandez-le dans la tâche ; pour un thread déjà en cours d’exécution, utilisez le sélecteur de modèle de ce thread.
• Coordinator model et Coordinator effort s’appliquent à Claude dans la conversation du projet.

​

Affiner la façon dont Claude exécute un projet

• « Proposer des threads et attendre mon approbation avant de les démarrer » ou « Démarrer ceux-ci maintenant sans me demander de confirmer »
• « Exécuter au maximum deux threads à la fois » ou « Réutiliser un thread existant pour les suites dans le même domaine »
• « Publier des mises à jour plus courtes » ou « Publier seulement quand quelque chose se termine ou est bloqué »
• « Donnez-moi une mise à jour d’état sur chaque thread »
• « Faire cette tâche avec un modèle plus petit »
• « N’ouvrez pas de pull request jusqu’à ce que j’aie vu le plan »
• « Dites-moi ce qui ne va pas dans ces référentiels et ne corrigez rien pour l’instant », quand vous voulez examiner les résultats avant qu’aucun d’eux ne devienne un thread
• « Répondre à cela ici au lieu de démarrer un thread », quand Claude démarre un thread pour quelque chose que vous aviez l’intention comme une question rapide

​

Débloquer un thread en attente d’approbation

​

Donner un contexte permanent à un projet

​

Écrire les instructions du projet

• À quoi sert le projet
• Où le travail se fait : quels référentiels, quelle branche commencer, comment nommer les pull requests
• Comment un thread vérifie son propre travail avant de l’appeler terminé
• Quoi faire quand quelque chose dont il a besoin manque
• Ce qui a besoin de votre approbation en premier

Ce projet maintient la latence p95 de l'API des paiements sous 200 ms : profilage, corrections de requêtes et de cache, et les mises à jour de dépendances qui les accompagnent, dans le référentiel payments-api.

- Brancher à partir de main et ouvrir une pull request brouillon par thread.
- Avant d'appeler le travail terminé, exécutez `make test` et `make lint` et collez les lignes de résumé dans votre message final.
- Si vous ne pouvez pas atteindre quelque chose dont vous avez besoin, comme un référentiel, un secret, une API ou un connecteur, dites exactement ce qui manque dans votre premier message et arrêtez. Ne substituez pas, ne simulez pas et ne devinez pas.
- Ne fusionnez pas, ne forcez pas de push et ne changez pas la configuration CI sans me le demander dans le thread.

​

Décider quels référentiels ajouter

• L’ajouter au projet, dans la boîte de dialogue New project, dans Project settings > Environment, ou en demandant à Claude dans la conversation de l’ajouter au projet. Chaque thread à partir de là clone et commence avec son CLAUDE.md et ses skills chargés, que la tâche le touche ou non. Passer d’un référentiel à plusieurs change également ce que les threads prennent du .claude/settings.json de chaque référentiel ; voir Ce que les threads reprennent de vos référentiels.
• Le laisser de côté et laisser les threads l’ajouter quand nécessaire. Un thread dont la tâche a besoin d’un référentiel que le projet n’a pas peut l’ajouter à lui-même, et une note dans le thread dit qu’il a été ajouté à ce thread seulement. Le clone se produit à mi-chemin de la tâche, donc le CLAUDE.md et les skills de ce référentiel n’étaient pas là quand le thread a commencé. Le thread suivant commence sans lui à nouveau. Un référentiel qu’un thread ajoute a besoin des mêmes prérequis qu’un référentiel de projet : l’application Claude GitHub installée dessus et l’accès en push de votre compte GitHub.

​

Ce que les threads reprennent de vos référentiels

​

Choisir un environnement pour les threads

​

Obtenir des skills, des plugins, des connecteurs et des outils dans les threads

• Skills, subagents et commandes : validez-les dans un référentiel que vous avez ajouté au projet, par exemple un skill à .claude/skills/<skill-name>/SKILL.md. Chaque thread clone chaque référentiel du projet et charge .claude/skills/, .claude/agents/ et .claude/commands/ à partir de chacun d’eux, donc un skill validé dans un référentiel est disponible dans chaque nouveau thread. Les threads chargent également les skills que vous activez pour votre compte claude.ai.
• Plugins : ajoutez-les dans Project settings > Plugins ; ils se chargent dans chaque nouveau thread. Les plugins qu’un référentiel déclare dans son .claude/settings.json se chargent aussi ; voir Ce qui se transfère de votre configuration.
• Serveurs MCP : les threads obtiennent leurs outils MCP à partir des connecteurs sur votre compte claude.ai, qui sont des serveurs MCP que vous connectez une fois à claude.ai/customize/connectors ou via le lien Manage connectors dans Project settings > Environment. Chaque thread peut tous les utiliser sans configuration par projet. La conversation du projet elle-même n’a pas de connecteurs, donc envoyez le travail qui en a besoin en tant que tâche pour un thread. Dans un projet avec un référentiel, les threads chargent également les serveurs MCP à partir du .mcp.json de ce référentiel. Comment les connecteurs atteignent Claude Code énumère les règles pour les sessions cloud et les paramètres qui désactivent les connecteurs.
• Outils en ligne de commande et packages : installez-les dans le script de configuration de l’environnement.

​

Référence des paramètres du projet

​

Pause, archive ou suppression d’un projet

• Pause : arrête tout à la fois. Chaque thread en cours d’exécution et la conversation sont interrompus, aucun nouveau thread ne démarre, les routines ne s’exécutent pas, et le projet n’accepte pas de messages jusqu’à ce que vous le repreniez. Cliquez sur Resume au même endroit ou sur la bannière au-dessus de la boîte de message du projet ; un thread en pause continue quand vous lui envoyez un message après cela.
• Archive : masque le projet de la barre latérale et archive ses threads, ce qui arrête tout thread qui était en cours d’exécution ou surveillait une pull request. Les routines du projet ne s’exécutent pas pendant qu’il est archivé. Pour ramener le projet, ouvrez-le à partir de la page Projects et cliquez sur Unarchive. Ses threads restent archivés jusqu’à ce que vous les désarchiviez individuellement à partir de la liste des sessions.
• Delete : supprime définitivement le projet ainsi que ses threads, sa mémoire et ses fichiers, et désactive les routines du projet. Cela ne peut pas être annulé. Les branches et pull requests que les threads ont poussées vers GitHub ne sont pas affectées.

​

Utilisation et coût

​

Ce qui utilise votre plan

• Threads en cours d’exécution : chacun est une session complète, et plusieurs peuvent s’exécuter à la fois. Il n’y a pas de nombre fixe ; Claude démarre autant que le travail l’exige, et une limite que vous demandez est une préférence plutôt qu’un plafond. La limite appliquée est 200 nouveaux threads par jour sur vos projets.
• La conversation : Claude utilise des tokens en lisant ce que les threads rapportent et en décidant quoi faire ensuite.
• Threads surveillant une pull request : un thread inactif se réveille et utilise votre plan à nouveau quand CI échoue ou un commentaire d’examen arrive sur sa pull request. Pour arrêter cela, demandez dans le thread de cesser de surveiller la pull request.

​

Voir et réduire l’utilisation d’un projet

• Une suite acheminée vers un thread qui a été inactif plus longtemps que la durée de vie du cache, une heure sur Pro et Max dans les limites de votre plan, relit la conversation entière de ce thread avant de faire quoi que ce soit. Pour le nouveau travail, demander à Claude de démarrer un thread frais peut utiliser moins que de relancer un grand ancien.
• Pour le travail qui n’a pas besoin du plus grand modèle, choisissez un modèle plus petit ou un niveau d’effort inférieur pour les threads, la conversation ou les deux.
• Demandez à Claude dans la conversation du projet d’exécuter moins de threads à la fois, ou de répondre aux petites questions lui-même au lieu de démarrer un thread.

​

Comment les projets se rapportent à d’autres fonctionnalités de Claude Code

• Claude Tag : Claude Tag est Claude dans les canaux Slack de votre équipe, sur les plans Team et Enterprise. N’importe qui dans un canal peut lui donner du travail, tout le monde dans le canal le voit et le dirige, et il utilise les connexions qu’un administrateur a configurées pour ce canal. Un projet est le vôtre seul : vous êtes le seul à lui envoyer du travail ou à voir ses threads, il utilise votre propre accès GitHub et vos connecteurs, et il est sur Pro et Max. Comment Claude Tag diffère de Cowork et Claude Code a le côté à côté.
• Sessions cloud : chaque thread est une session cloud, démarrée et suivie par Claude au lieu de par vous. Une session cloud que vous avez démarrée vous-même peut devenir un projet ou en alimenter un via Continue as a project ou Move to project.
• Routines : quand vous demandez du travail programmé dans un projet, Claude crée une routine qui s’exécute en tant que threads dans ce projet et apparaît sur son onglet Routines. Les routines que vous créez en dehors d’un projet continuent à fonctionner seules.
• Sessions locales et agent view : les sessions dans votre terminal, IDE ou l’environnement local de l’application de bureau s’exécutent sur votre machine et ne peuvent pas faire partie d’un projet. Agent view est un écran pour suivre plusieurs de ces sessions locales ; il n’a pas de coordinateur.
• Worktrees : un worktree donne à chaque session locale sa propre copie de travail d’un référentiel pour que les sessions parallèles sur votre machine ne s’écrasent pas mutuellement. Les threads n’en ont pas besoin : chaque thread clone ses référentiels dans son propre sandbox cloud et travaille sur sa propre branche.
• Équipes d’agents : une équipe d’agents est une session qui démarre des sessions de coéquipiers pour une seule tâche, sur votre machine ou à l’intérieur d’une session cloud, et se termine avec cette tâche.
• Projects dans le chat claude.ai et Cowork : l’expérience Projects antérieure, qui groupe les conversations et les fichiers de référence sans threads ni coordinateur. Ces projets continuent à fonctionner comme ils le font aujourd’hui jusqu’à ce que l’expérience repensée les atteigne.

​

Limitations

• Les projets sont disponibles à claude.ai/code et dans l’application de bureau, pas dans le CLI du terminal ou via Amazon Bedrock, la plateforme d’agents de Google Cloud ou Microsoft Foundry. La commande claude project du CLI, qui gère l’état local de Claude Code pour un répertoire, n’est pas liée.
• Les threads du projet sont des sessions cloud avec Anthropic comme fournisseur de modèle. Sécurité et Utilisation des données couvrent comment les sessions cloud sont isolées et ce qui est conservé.
• Une session locale ne peut pas faire partie d’un projet.
• Le sandbox d’un thread se met en pause entre les tours et reprend quand le thread continue. Si le sandbox ne peut pas être repris, le thread continue à partir d’un clone frais, donc les modifications non validées peuvent être perdues. Sur les tâches longues, demandez à Claude de valider et de pousser le travail en cours.
• Un projet appartient à un utilisateur. Vous ne pouvez pas partager un projet ou ses threads avec un autre utilisateur, et les transcriptions de threads n’ont pas l’option de partage que les autres sessions cloud ont. Il n’y a pas de contrôles au niveau de l’organisation pour les projets pendant la bêta.
• Un thread appartient au seul projet qui l’a démarré. Vous ne pouvez pas déplacer ou copier un thread vers un autre projet, ou le déplacer pour qu’il soit seul. Move to project va seulement dans l’autre sens : il apporte le travail d’une session cloud dans un projet.

​

Dépannage

​

Un thread semble bloqué

​

Les threads ont deviné ou se sont arrêtés au lieu de demander

1. Demandez à Claude dans la conversation : « Pour chaque thread ouvert, énumérez ce que vous lui avez demandé de faire, ce qu’il a supposé ou ne pouvait pas atteindre, et sur quoi il attend. » Claude lit chaque thread et répond dans la conversation.
2. Pour les threads qui ont commencé à partir d’une mauvaise hypothèse, ouvrez le thread depuis Overview et marquez-le résolu depuis son menu, ou dites-lui quoi faire à la place dans sa boîte de message. Sa branche et toute pull request restent sur GitHub jusqu’à ce que vous les supprimiez.
3. Corrigez l’écart une seule fois, dans les instructions du projet ou l’environnement, puis envoyez un thread avant d’envoyer le reste du travail à nouveau en tant que nouveaux threads.

​

Claude n’a pas répondu

​

Erreurs d’accès au référentiel

• « Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository », rapporté avant le démarrage du thread, quand l’application Claude GitHub n’est pas installée sur ce référentiel, est suspendue ou n’est pas liée au compte GitHub que vous avez connecté.
• « Unable to access your repository », rapporté par un thread quand son clone échoue : GitHub a rejeté le clone, le référentiel n’a pas été trouvé sous le nom que le projet a, ou la branche à partir de laquelle le thread a été demandé de commencer n’existe pas.
• « Claude can’t access » un référentiel, affiché quand vous enregistrez les référentiels dans la boîte de dialogue New project ou Project settings. Le message continue avec un lien d’installation et un lien de reconnexion. Utilisez le lien d’installation si l’application Claude GitHub n’est pas sur ce référentiel, et le lien de reconnexion si elle l’est, puisque l’application GitHub peut être installée sur GitHub sans être liée au compte que vous avez connecté à Claude. Si le message dit que l’application GitHub est suspendue ou n’inclut pas ce référentiel, suivez son lien vers GitHub pour corriger cela.

​

Un thread a atteint la limite d’utilisation

​

Des crédits d’utilisation supplémentaires sont requis

​

Autres messages

​

Ressources connexes

• Utiliser Claude Code dans le cloud : comment fonctionnent les sessions cloud derrière chaque thread, y compris les options d’accès GitHub et l’auto-fix sur les pull requests
• Configurer les environnements cloud : changez ce que les threads peuvent atteindre sur le réseau, donnez-leur des variables d’environnement et des identifiants API, et installez des outils avec un script de configuration
• Automatiser le travail avec les routines : calendriers, déclencheurs et gestion des routines, y compris celles que Claude crée à partir d’un projet
• Gérer plusieurs agents avec agent view : exécutez et suivez plusieurs sessions sur votre propre machine quand le travail a besoin d’outils ou de services que seule votre machine peut atteindre
• Projects redesigned: from folder to conversation : l’annonce du lancement, avec la réflexion derrière la transformation d’un projet en conversation avec Claude