Passer au contenu principal
Projects est en bêta publique sur les plans Pro, Max et Ultra et se déploie progressivement. Le déploiement a commencé par les comptes qui ont utilisé les sessions cloud et qui n’ont pas de projets existants dans le chat claude.ai ou Cowork. Projects n’est pas encore proposé sur les plans Team ou Enterprise.Si Projects n’apparaît pas dans la barre latérale sur claude.ai/code ou dans l’onglet Code de l’application de bureau, vérifiez sous More à cet endroit. S’il n’y figure pas non plus, le déploiement n’a pas encore atteint votre compte. Vous pouvez rejoindre la liste d’attente, et consulter Exécuter des agents en parallèle pour voir ce que vous pouvez utiliser en attendant.
Un projet est une conversation en cours unique où Claude coordonne un flux de travaux connexes pour vous. Vous lui dites ce qui doit être fait et il démarre un thread pour chaque tâche. Chaque thread est généralement une session cloud : Claude Code s’exécutant dans le cloud plutôt que sur votre machine. Quand une tâche a besoin de quelque chose que seul votre ordinateur possède, vous pouvez demander à Claude d’exécuter ce thread sur votre ordinateur à la place via Remote Control. Les threads s’exécutent en parallèle et vous pouvez les vérifier et les diriger depuis votre téléphone. Les threads cloud continuent après que vous ayez fermé l’ordinateur portable, tandis qu’un thread sur votre ordinateur s’exécute uniquement tant que cet ordinateur est actif. Sans projet, l’exécution de plusieurs sessions signifie faire la coordination vous-même : vous décidez sur quoi chacun travaille, répétez le même contexte au début de chacun, et vérifiez lequel a terminé ou a besoin d’une réponse. Avec un projet, vous pouvez plutôt :
  • 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 instructions 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.
Si vous connaissez déjà le travail que vous voulez qu’un projet exécute, allez directement à Créer un projet.

Quand utiliser un projet

Un projet vaut la peine d’être créé quand le travail a un objectif qui dépasse une session et continue à produire des tâches. Ces types de travaux conviennent bien à 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.
Dans n’importe lequel d’entre eux, vous pouvez envoyer un lot de tâches, dire à Claude de commencer sans vous demander de confirmer, et vous éloigner. À votre retour, vous trouverez les threads qui vous attendent sous Waiting on you. Vous pouvez également demander à Claude de planifier une partie du travail en tant que tâche planifiée cloud. Si l’un de ces cas correspond à votre situation, créez un projet.

Quand quelque chose d’autre convient mieux

Un projet convient toujours quand seules certaines tâches nécessitent votre machine. Les threads cloud fonctionnent sur les référentiels GitHub et sur les fichiers, dossiers et dossiers Google Drive que vous téléchargez vers le projet, et pour la tâche occasionnelle qui nécessite une base de données locale ou un outil sur votre ordinateur, vous pouvez demander à Claude d’exécuter le thread de cette tâche sur votre ordinateur. Quelque chose d’autre qu’un projet convient mieux dans ces cas :
  • Une tâche qui tient dans une session : « Corriger le test de connexion instable. » Démarrez une session cloud vous-même.
  • Un travail où chaque tâche nécessite votre machine : une base de données locale, un émulateur d’appareil, ou 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épendances chaque lundi. » Créez une tâche planifiée cloud seule.
  • Plusieurs personnes donnant du travail à Claude et le dirigeant ensemble dans un canal Slack : voir Claude Tag.
Un projet utilise les mêmes limites de plan que vos autres sessions Claude Code et les utilise plus rapidement. Utilisation et coût couvre ce qui utilise votre plan et comment le réduire.

Comment un projet est organisé

Un projet est une conversation de coordination unique avec Claude plus les threads qu’il démarre pour faire le travail. Voici ses parties :
  • 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 distincte avec sa propre fenêtre de contexte qui fait un morceau de travail et rapporte à la conversation quand il termine. Un thread cloud travaille sur sa propre branche et ouvre une pull request quand le travail l’exige.
  • Ce que chaque thread cloud commence avec :
  • 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 celles que les threads ont ouvertes, et Scheduled tasks pour le travail planifié dans le projet.
Les threads cloud ne reprennent rien de la configuration Claude Code sur votre propre machine. Obtenir des skills, des plugins, des connecteurs et des outils dans les threads couvre comment leur donner ce qui leur manquerait autrement. Voici comment ces parties se connectent, de vous à travers la conversation aux threads qui font le travail, avec Overview qui suit leur état :
Diagramme d'un projet. Vous écrivez dans la conversation du projet, où Claude répond ou démarre un thread. Chaque thread cloud travaille sur sa propre branche et pull request. Le volet Overview énumère les threads par état, comme prêt pour examen, en attente de vous et en cours.Diagramme d'un projet. Vous écrivez dans la conversation du projet, où Claude répond ou démarre un thread. Chaque thread cloud travaille sur sa propre branche et pull request. Le volet Overview énumère les threads par état, comme prêt pour examen, en attente de vous et en cours.

Créer un projet

Vous créez et utilisez des projets à claude.ai/code, dans l’onglet Code de l’application de bureau, ou dans l’application mobile Claude pour iOS et Android. Dans le navigateur et l’application de bureau, il y a deux façons de démarrer 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 : dans le menu de cette session dans la barre latérale, choisissez Continue in project, puis Continue as new project. Claude propose la configuration du projet à partir de ce que la session faisait. Voir Démarrer à partir d’une session cloud existante.
De toute façon, vérifiez d’abord les prérequis.

Vérifier les prérequis

Avant de créer un projet, vérifiez votre plan, votre configuration GitHub et ce que le travail doit atteindre :
  • Plan : vous êtes sur Pro, Max ou Ultra et Projects s’affiche dans votre barre latérale, directement ou sous More. Sélectionnez Projects et vérifiez qu’il propose New project ou Get started.
  • 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.
  • Accès réseau, secrets et outils : pour les threads cloud, 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 un projet à partir de zéro signifie ouvrir la boîte de dialogue New project, nommer le flux de travail et éventuellement lui donner un objectif et les référentiels et fichiers sur lesquels il travaille. Seul le nom est requis, vous pouvez donc créer le projet en premier et remplir le reste au fur et à mesure que le travail prend forme.
1

Ouvrir Projects

À claude.ai/code ou dans l’onglet Code de l’application de bureau, sélectionnez Projects dans la barre latérale gauche, ou sous More dans celle-ci. Dans un navigateur, vous pouvez également aller directement à claude.ai/code/projects/browse. Sélectionnez ensuite New project. Si le bouton indique Get started à la place, sélectionnez-le et commencez par mettre à niveau ou archiver les projets claude.ai existants qu’il répertorie.
2

Remplir la boîte de dialogue New project

Limitez le projet à un flux de travail que vous continuerez à ajouter, comme tout ce qu’il faut pour maintenir une API sous sa cible de latence. Quand utiliser un projet a plus d’exemples. Ensuite, remplissez les champs de la boîte de dialogue :
  • Name : comment le projet apparaît dans la liste Projects.
  • Goal (optionnel) : une ligne de ce que vous essayez d’accomplir, comme « Maintenir la latence p95 de l’API sous 200 ms ». Claude dans la conversation travaille vers cela. Sans objectif, Claude travaille à partir des tâches que vous envoyez, et vous pouvez ajouter un objectif plus tard dans Project settings > General.
  • Context (optionnel) : les référentiels GitHub sur lesquels ce projet travaille, plus tous les fichiers, dossiers ou dossiers Google Drive que les threads doivent lire. Cliquez sur Add pour chacun. Ajoutez les référentiels dont la plupart des tâches ont besoin plutôt que tous ceux que le travail pourrait toucher ; Décider quels référentiels ajouter couvre le choix, et vous pouvez en ajouter d’autres plus tard dans Project settings > Environment.
Les règles permanentes sur la façon dont les threads doivent fonctionner vont dans les instructions du projet, que vous définissez après que le projet existe.
3

Créer le projet

Cliquez sur Create project. La conversation du projet s’ouvre avec une boîte de message en bas, où vous décrivez le travail pour Claude.Sur votre premier projet, Claude prend un tour de son propre chef dès que le projet est créé, sauf si vous envoyez d’abord un message. Ce tour utilise votre plan. En cela, Claude peut :
  • Démarrer un thread qui explore le dépôt sans rien changer et propose les prochaines étapes, si le projet a un dépôt qu’il peut lire.
  • Publier Setup recommendations tirées de vos sessions cloud récentes : dépôts à ajouter, tâches planifiées à créer et threads qu’il pourrait démarrer. Chaque dépôt et tâche planifiée recommandés commencent activés. Désactivez ceux que vous ne voulez pas, puis cliquez sur Update setup pour ajouter le reste, ou ignorez les recommandations et décrivez le travail vous-même.
Le projet est maintenant listé sous Projects dans la barre latérale, et sa conversation est ouverte. Votre premier lot couvre ce qu’il faut configurer avant de lui envoyer du travail.

Démarrer à partir d’une session existante

Si une session cloud que vous avez démarrée vous-même effectue un travail qui a sa place dans un projet, ouvrez son menu dans la barre latérale et choisissez Continue in project, puis faites votre choix dans le sous-menu :
  • Choisissez Continue as new project pour créer un nouveau projet à partir de la session. Le projet s’ouvre, et Claude lit la session et publie Setup recommendations dans la conversation du projet pour que vous les confirmiez. La session d’origine reste dans votre liste de sessions. 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.
  • Choisissez l’un de vos projets existants pour apporter le travail de la session dans ce projet. Ce projet s’ouvre, et un message envoyé en votre nom demande à Claude de lire la session et de reprendre là où elle s’était arrêtée. La session d’origine reste dans votre liste de sessions, inchangée.
Une bannière Set up project peut également apparaître au-dessus de la boîte de message d’une session cloud. Si vous l’utilisez à la place de Continue as new project, 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. Une session sur votre propre machine obtient le même menu de barre latérale sur claude.ai/code une fois que vous la connectez via Remote Control. Depuis un projet, Claude ne peut pas lire la transcription d’une session qui s’est connectée alors que Require trusted devices était activé pour votre compte. Si ce paramètre est désactivé :
  1. Si la session n’est pas encore connectée, exécutez /remote-control dans celle-ci. Si elle s’est connectée alors que ce paramètre était activé, déconnectez-la et reconnectez-la d’abord.
  2. Dans un navigateur, trouvez la ligne de la session dans la barre latérale sur claude.ai/code, ouvrez son menu et faites votre choix dans le même sous-menu.
Si Require trusted devices est activé, ou si vous n’utilisez pas Remote Control, décrivez vous-même le travail dans la conversation du projet. Ou poussez la branche de la session, ajoutez son dépôt au projet et indiquez à Claude le nom de la branche.

Configurer l’accès GitHub

La plupart de la configuration GitHub se fait une fois, pas par projet. Vous connectez votre compte GitHub à Claude une fois, et l’application Claude GitHub est installée une fois par référentiel, ou une fois pour toute une organisation GitHub si vous lui donnez tous les référentiels. Vous revenez à ces étapes quand vous ajoutez un référentiel que l’application Claude GitHub ne couvre pas encore ou un dans une organisation GitHub qui applique SSO.
1

Connecter votre compte GitHub

Si vous n’avez pas utilisé claude.ai/code avant, votre première visite vous guide à travers la connexion de GitHub ; voir Connecter GitHub. Sinon, utilisez l’une des options d’authentification GitHub.
2

Installer l'application Claude GitHub sur les référentiels du projet

Installez l’application Claude GitHub et accordez-lui les référentiels que le projet utilisera. Sur un référentiel appartenant à une organisation GitHub, seul un propriétaire d’organisation peut terminer l’installation ; si vous n’en êtes pas un, GitHub envoie au propriétaire une demande d’installation et le projet ne peut pas utiliser le référentiel jusqu’à ce qu’il l’approuve.
3

Autoriser SSO pour les organisations qui l'appliquent

Si une organisation GitHub applique SAML SSO, reconnectez GitHub et autorisez l’application Claude pour cette organisation. Jusqu’à ce que vous le fassiez, les référentiels privés de cette organisation n’apparaissent pas dans la boîte de dialogue New project ou Project settings > Environment.
Quand l’une de ces étapes est incomplète, la boîte de dialogue New project et la page du projet nomment l’étape manquante et créent un lien vers où vous la terminez. Terminez l’étape là, puis cliquez sur Check again si la boîte de dialogue l’offre. Si un référentiel manque toujours de la liste après, ouvrez l’installation de l’application Claude GitHub sur GitHub, à github.com/settings/installations pour un compte personnel, et confirmez que le référentiel est listé sous Repository access. Pour les messages d’erreur qu’un thread ou le projet rapporte quand l’accès est toujours mauvais, voir Erreurs d’accès au référentiel.

Travailler dans un projet

Confiez du travail à Claude via la conversation du projet : des tâches une par une ou plusieurs à la fois, ainsi que des mises à jour et des idées au fil de l’eau. Claude oriente chaque message, et les threads effectuent le travail puis rendent compte.

Votre premier lot

Avant d’envoyer un lot de travail à un nouveau projet, configurez-le pour que les premiers threads reviennent comme vous le souhaitez :
  1. Rédigez les instructions du projet : le brief dont part chaque thread, par exemple quelle branche cibler, comment un thread vérifie son travail et ce qui nécessite votre feu vert.
  2. Envoyez une petite partie du vrai travail, ou démarrez l’un des threads suggérés par Claude s’il en a proposé, et ouvrez le thread une fois terminé pour voir comment il rend compte et ce qu’il a fait sur sa branche. S’il a supposé quelque chose de faux ou n’a pas pu accéder à ce dont il avait besoin, Les threads ont deviné ou se sont bloqués au lieu de demander explique où corriger cela.
  3. Vérifiez Thread model et Thread effort dans Project settings > General. Un nouveau projet exécute chaque thread sur Opus avec un effort élevé, ce qui consomme votre forfait le plus rapidement ; Choisir les modèles et laisser Claude gérer le contexte présente les alternatives.
  4. Demandez à Claude de proposer les threads avant de les démarrer et d’en exécuter quelques-uns à la fois, puis levez ces limites une fois que quelques threads sont revenus comme vous le souhaitez.

Envoyer du travail et lire les résultats

Claude décide où va chaque message que vous envoyez dans la conversation :
  • Une question rapide obtient généralement une réponse dans la conversation.
  • Un nouveau travail va dans un nouveau thread ou dans un thread travaillant déjà dans ce domaine, et Claude vous indique lequel. Chaque nouveau thread apparaît sous votre message sous forme de carte : un encadré avec le titre et le statut du thread, sur lequel vous cliquez pour ouvrir le thread.
  • Plusieurs tâches sans rapport dans un même message deviennent des threads distincts.
Si Claude oriente quelque chose différemment de ce que vous vouliez, dites-le. Ajuster la façon dont Claude gère un projet liste ce que vous pouvez lui dire, comme réutiliser un thread existant pour les suites ou répondre sur place au lieu de démarrer un thread. Les résultats complets d’un thread restent dans le thread, et vous ouvrez sa carte dans la conversation pour les lire. Les fichiers produits par un thread se trouvent également dans l’onglet Library de Overview. Parfois, Claude propose des threads au lieu de les démarrer, dans une liste Suggested threads. Cliquez sur la flèche d’une suggestion pour démarrer ce thread. Lorsque plusieurs sont listées, un bouton sous la liste les démarre toutes.

Examiner la pull request d’un thread

Lorsqu’un thread cloud modifie du code, voici ce qu’il fait sauf indication contraire de votre part :
  • Branche : travaille sur une nouvelle branche, créée à partir de la branche par défaut du dépôt.
  • Pull request : en ouvre une lorsque vous le demandez, et peut en ouvrir une de lui-même pour une correction de bug ou une autre modification concrète.
  • Après son ouverture : surveille la pull request avec l’auto-fix activé, que l’auto-fix soit activé ou non pour vos autres sessions cloud. Il pousse des correctifs lorsque la CI échoue, traite les commentaires de revue et répond dans le thread lorsque les vérifications réussissent et que la pull request est prête pour vous.
Lorsqu’un thread a poussé une branche ou ouvert une pull request, sa carte dans la conversation peut afficher un bouton pour l’étape suivante :
  • Resolve conflicts, Fix CI, Address comments et Merge it envoient cette instruction au thread sous forme de message de votre part, afin que vous puissiez relancer le thread vous-même au lieu d’attendre qu’il réagisse à la pull request.
  • Review PR ouvre la pull request sur GitHub.
  • Create PR apparaît lorsqu’un thread inactif a poussé une branche mais n’a pas ouvert de pull request. Cliquer dessus crée directement la pull request à partir de cette branche, plutôt que d’envoyer au thread l’instruction d’en ouvrir une.
Pour modifier le moment où les threads ouvrent des pull requests, par exemple uniquement à votre demande, ou la branche à partir de laquelle ils démarrent, indiquez-le dans la tâche ou dans les instructions du projet.

Voir ce qui requiert votre attention dans Overview

Le volet Overview à côté de la conversation suit les threads du projet. Il est déjà ouvert la première fois que vous ouvrez un nouveau projet. Le bouton Overview dans l’en-tête du projet le ferme et le rouvre, et affiche un point lorsqu’un thread vous attend. Dans l’application de bureau, vous recevez également une notification de bureau lorsque Claude publie dans la conversation, qu’un thread rencontre une erreur ou qu’un thread a besoin de votre intervention, ce qui vous évite de garder le projet ouvert pour le savoir. Pour en recevoir aussi une chaque fois qu’un thread termine un tour, ou pour les désactiver pour un projet, choisissez Notifications dans le menu de la barre latérale du projet. Ces notifications sont réservées à l’application de bureau : dans un navigateur, vérifiez le point sur le bouton Overview. L’onglet Threads du volet regroupe les threads par état : Les autres onglets du volet sont :
  • Library : les fichiers et dossiers que vous avez ajoutés et les fichiers produits par les threads
  • Pull requests : affiché dès que des threads en ont ouvert
  • Scheduled tasks : les tâches planifiées cloud que Claude a configurées depuis ce projet

Ouvrir un thread lorsque vous avez besoin de contrôle

Cliquez sur la carte d’un thread dans la conversation ou sur sa ligne dans Overview pour ouvrir sa transcription dans le volet Overview. De là, vous pouvez :
  • Lire ce que Claude a fait, étape par étape.
  • Orienter la tâche en écrivant dans la zone de message propre au thread. Un message écrit là va directement à ce thread, tandis qu’une suite dans la conversation du projet ne l’atteint que lorsque Claude associe cette suite à ce thread.
  • Répondre à une demande de permission que le thread attend.
  • Interrompre le thread avec Stop, qui remplace le bouton d’envoi pendant que le thread travaille, ou en appuyant sur Esc.

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

Définissez les modèles et l’effort dans Project settings > General. Un nouveau projet exécute Opus partout, avec un effort élevé pour les threads et un effort faible pour la conversation :
  • Thread model et Thread effort s’appliquent aux threads. Pour utiliser un autre modèle pour une tâche, demandez-le dans la tâche ; pour un thread déjà en cours, utilisez le sélecteur de modèle de ce thread.
  • Coordinator model et Coordinator effort s’appliquent à Claude dans la conversation du projet.
Vous ne gérez pas les fenêtres de contexte dans un projet. Les threads se compactent automatiquement, et la conversation s’appuie sur les messages récents, les threads récents et la mémoire du projet plutôt que sur l’intégralité de son historique, de sorte qu’elle se poursuit aussi longtemps que le projet est actif. Placez tout ce qui ne doit jamais être perdu dans la mémoire du projet. Si un thread dépasse son contexte, il affiche Claude ran out of context on this turn.

Ajuster la façon dont Claude gère un projet

Indiquez à Claude dans la conversation combien de threads exécuter à la fois, quand publier des mises à jour et quand ouvrir des pull requests. Si Claude coordonne d’une manière qui ne vous convient pas, dites-le. Par exemple, vous pouvez dire :
  • « Propose des threads et attends mon feu vert avant de les démarrer » ou « Démarre-les maintenant sans me demander de confirmer »
  • « Exécute au maximum deux threads à la fois » ou « Réutilise un thread existant pour les suites dans le même domaine »
  • « Publie des mises à jour plus courtes » ou « Ne publie que lorsque quelque chose se termine ou est bloqué »
  • « Donne-moi un point d’avancement sur chaque thread »
  • « Fais cette tâche avec un modèle plus petit »
  • « N’ouvre pas de pull request avant que j’aie vu le plan »
  • « Dis-moi ce qui ne va pas dans ces dépôts et ne corrige rien pour l’instant », lorsque vous voulez passer en revue les constats avant que l’un d’eux ne devienne un thread
  • « Réponds ici au lieu de démarrer un thread », lorsque Claude démarre un thread pour ce que vous considériez comme une question rapide
Claude enregistre de lui-même ce type de préférences dans la mémoire du projet et les applique dans les threads cloud ultérieurs. Ce sont des instructions que Claude respecte, pas des paramètres imposés, donc une limite de threads donnée de cette façon n’est pas un plafond strict. Ajoutez-en une aux instructions du projet lorsque vous souhaitez qu’elle soit formulée exactement et appliquée à chaque thread dès le départ.

Débloquer un thread en attente d’approbation

Les threads s’exécutent en mode auto lorsque le modèle du thread le prend en charge, de sorte que la plupart des appels d’outils s’exécutent sans vous demander. Lorsqu’un thread a besoin de votre approbation, la demande se trouve dans ce thread, et le thread attend que vous y répondiez à cet endroit. Dire à Claude de continuer dans la conversation du projet ne l’atteint pas. Chaque approbation couvre cette demande, ou le reste de ce thread si vous choisissez l’option plus large. Les threads cloud ne lisent pas les règles de permission du fichier .claude/settings.json d’un dépôt ; vous vous appuyez donc sur le mode auto et sur les approbations que vous donnez dans chaque thread.

Exécuter un thread sur votre propre ordinateur

Lorsqu’une tâche nécessite quelque chose que seul votre ordinateur possède, comme une base de données locale, un émulateur d’appareil ou une API derrière votre VPN, demandez à Claude d’exécuter le thread de cette tâche sur votre ordinateur plutôt que dans le cloud. Lorsque vous le demandez dans la conversation du projet, le thread est une session Claude Code dans un dossier de votre machine, connectée via Remote Control. Les autres threads du projet continuent de s’exécuter dans le cloud. Par rapport à un thread cloud, un thread sur votre ordinateur :
  • Travaille avec les fichiers, outils, serveurs MCP et paramètres Claude Code de cette machine, y compris ses hooks et ses règles de permission, au lieu de l’environnement cloud du projet
  • Démarre avec les instructions du projet, mais sans ses fichiers de mémoire chargés
  • Ne s’exécute que tant que cet ordinateur est allumé avec Remote Control activé
1

Connecter le dossier

Sur l’ordinateur qui contient le dossier nécessaire à la tâche, rendez-le disponible via Remote Control de l’une des deux façons suivantes. Les deux nécessitent Claude Code v2.1.280 ou une version ultérieure sur cet ordinateur.
  • Dans l’application de bureau Claude : ouvrez Settings > Code ou Settings > Claude Code et activez Use this computer from your phone and claude.ai. Ajoutez le dossier à la liste sous cet interrupteur. Les threads peuvent s’exécuter sur cet ordinateur tant que l’application est ouverte.
  • Dans un terminal : exécutez claude remote-control dans le dossier et laissez-le tourner. Dans un dépôt git, ajoutez --spawn worktree pour donner à chaque thread qui s’y exécute son propre worktree au lieu du dossier lui-même.
2

Demander la tâche avec Work locally

Dans la conversation du projet, choisissez Work locally dans le menu + à côté de la zone de message, ce qui étiquette votre message Local, puis écrivez ce que vous voulez faire. Indiquer dans le message que la tâche doit s’exécuter sur votre ordinateur fonctionne également.
3

L'autoriser sur la carte

Claude répond avec une carte Allow Claude to work in a folder on your device. Choisissez le dossier si vous en avez connecté plusieurs. Deux threads travaillant simultanément dans un même dossier peuvent écraser mutuellement leurs modifications ; si le dossier est un dépôt git, vous pouvez donc activer Worktree dans les options du dossier pour donner à ce thread son propre worktree. Cliquez ensuite sur Allow once.
Le thread s’exécute en mode auto, de sorte que Claude exécute des commandes et modifie des fichiers dans ce dossier sans vous demander à chaque fois. Si le mode auto n’est pas disponible ou est désactivé dans le Claude Code de cet ordinateur, le thread s’exécute sans lui, et toute demande de permission qu’il émet attend votre réponse dans le thread, comme le décrit Débloquer un thread en attente d’approbation. Pendant l’exécution du thread, une icône d’ordinateur portable dans son en-tête indique si votre ordinateur est connecté. Cliquez dessus pour voir quel dossier le thread utilise ou pour couper la connexion. Le thread se met en pause lorsque cet ordinateur est en veille, et s’arrête si l’application de bureau ou claude remote-control se ferme.
  • Pour relancer le thread : consultez Lost contact with your folder
  • Pour empêcher l’ordinateur de se mettre en veille de lui-même : dans l’application de bureau, activez Keep this computer awake for Remote Control dans Settings > Code ou Settings > Claude Code
Un projet ne peut pas exécuter de thread sur votre ordinateur tant que Require trusted devices est activé pour votre compte.

Donner un contexte permanent à un projet

La mémoire du projet, les instructions du projet et les dépôts, fichiers et environnement du projet portent le contexte sur les threads. Vous définissez chacun une fois. Project settings > Memory énumère ces fichiers sous Auto memory, car Claude les écrit lui-même en travaillant dans le projet. Ils sont distincts de la mémoire automatique que Claude Code garde sur votre machine, même si les deux utilisent un index MEMORY.md. La mémoire du projet est également distincte des fichiers CLAUDE.md dans les dépôts du projet. Chaque thread cloud lit toujours ces fichiers CLAUDE.md à partir de son clone au démarrage, donc mettez les instructions sur un dépôt dans son CLAUDE.md et les notes sur le projet dans la mémoire du projet.

Écrire les instructions du projet

Les instructions du projet sont le brief que chaque nouveau thread commence. Cliquez sur l’icône d’engrenage dans l’en-tête du projet pour ouvrir Project settings, puis allez à Memory > Project instructions. Un brief utile couvre :
  • À quoi sert le projet
  • Où le travail se fait : quels dépôts, à partir de 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
Par exemple :
Les règles sur un dépôt, comme ses commandes de build, appartiennent au CLAUDE.md de ce dépôt, que chaque thread cloud lit quand le dépôt fait partie du projet. Une fois que le travail est en cours, quand vous corrigez un thread, dites aussi à Claude de mémoriser la correction : elle va dans la mémoire du projet et les threads cloud ultérieurs commencent avec elle.

Décider quels dépôts ajouter

Les dépôts que vous ajoutez à un projet viennent avec leur code et leur CLAUDE.md dans chaque thread cloud, mais pas leurs skills, leur .claude/settings.json ni leur .mcp.json. Les dépôts que vous n’ajoutez pas sont toujours à portée : un thread cloud peut en ajouter un à lui-même quand sa tâche en a besoin. La plupart des projets utilisent les deux :
  • 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 cloud à partir de là le clone et commence avec son CLAUDE.md chargé, que la tâche le touche ou non.
  • Le laisser de côté et laisser les threads l’ajouter quand nécessaire. Un thread cloud dont la tâche a besoin d’un dépôt 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 de ce dépôt n’était pas là quand le thread a commencé. Le thread suivant commence sans lui. Un dépôt ajouté de cette façon a besoin des mêmes prérequis qu’un dépôt de projet : l’application Claude GitHub installée dessus et l’accès en push de votre compte GitHub.
Un projet n’a pas besoin d’un dépôt du tout. Ses threads cloud peuvent toujours faire de la recherche, écrire des documents et écrire et exécuter du code dans leur propre sandbox, et ils livrent des fichiers à l’onglet Library. N’importe quel thread cloud peut aussi ajouter un dépôt à lui-même quand une tâche l’exige. Une fois que le projet a des dépôts, Claude ne peut ajouter que des dépôts d’un propriétaire GitHub que le projet utilise déjà, qu’il en ajoute un au projet ou qu’un thread en ajoute un à lui-même. Pour apporter un dépôt d’un propriétaire différent, ajoutez-le au projet vous-même dans Project settings > Environment. Pour un projet qui s’étend sur plusieurs dépôts, comme une fonctionnalité avec du code serveur, web, mobile et de bureau, ajoutez le ou les deux dépôts que presque chaque tâche touche et nommez les autres dans les instructions du projet pour que Claude sache où le reste du code vit. Les threads cloud commencent alors petit et tirent les autres dépôts seulement pour les tâches qui en ont besoin.

Ajouter des fichiers et des dossiers

Ajoutez les fichiers et dossiers que vous voulez que les threads lisent dans le champ Context de la boîte de dialogue New project, ou après avec Add sur l’onglet Library dans Overview. Ces limites s’appliquent à ce que vous ajoutez :
  • Library tab : jusqu’à 100 fichiers et 2 GB en un seul choix, avec un seul fichier jusqu’à 480 MB.
  • New project dialog : les fichiers de plus de 30 MB sont ignorés, donc ajoutez les fichiers plus volumineux à partir de l’onglet Library après avoir créé le projet.
  • Folders : quand vous ajoutez un dossier à partir de l’un ou l’autre endroit, le projet reçoit une copie de ses 100 premiers fichiers jusqu’à 200 MB, sans aucun fichier de plus de 30 MB, fichiers cachés ou node_modules. Un projet contient jusqu’à 10 dossiers et dossiers Google Drive combinés, et les fichiers uniques ne comptent pas vers cette limite.
  • Changes after upload : les uploads sont des copies, donc une modification que vous apportez sur votre ordinateur après ne parvient au projet que si vous téléchargez le fichier à nouveau et choisissez Replace quand on vous demande le nom existant.

Ce que les threads reprennent de vos dépôts

Les threads cloud chargent les instructions CLAUDE.md de chaque dépôt, mais pas ses skills, ses serveurs .mcp.json ni son .claude/settings.json, que le projet ait un dépôt ou plusieurs.

Choisir un environnement pour les threads

Chaque nouveau thread cloud démarre dans l’environnement cloud du projet. L’environnement définit quels domaines les threads peuvent atteindre, quelles variables d’environnement ils ont, quels secrets réseau sont ajoutés à leurs requêtes et ce que le script de configuration installe avant que Claude commence. Les threads cloud utilisent un environnement par défaut hébergé par Anthropic jusqu’à ce que vous en choisissiez un dans Project settings > Environment. Si les threads cloud ont besoin d’atteindre une API interne ou un registre de packages privé, ou ont besoin d’un jeton que votre machine détient normalement, changez l’environnement plutôt que le projet : voir Accès réseau, Ajouter des secrets réseau et Scripts de configuration.

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

Les threads cloud n’ont pas les skills, les serveurs MCP, les plugins et les outils installés seulement sur votre machine. Un thread que Claude exécute sur votre machine via Remote Control utilise ce qui y est installé. Pour rendre chacun de ceux-ci disponible aux threads cloud :
  • Skills : activez-les pour votre compte claude.ai, et les threads cloud chargent les skills que vous y activez, à l’exception de certains threads dans un environnement auto-hébergé. Les skills commités dans le .claude/skills/ d’un dépôt ne se chargent pas dans les threads cloud.
  • Plugins : ajoutez-les dans Project settings > Plugins ; ils se chargent dans chaque nouveau thread cloud. Les plugins qu’un dépôt déclare dans son .claude/settings.json ne se chargent pas dans les threads cloud.
  • Serveurs MCP : les threads cloud 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. Chaque thread cloud 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 cloud. 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.
Pour voir quels connecteurs un thread cloud en cours d’exécution a à claude.ai/code, ouvrez le thread et sélectionnez Connectors dans le menu + à côté de sa boîte de message. Désactiver un connecteur là le supprime de ce thread et enregistre cela comme votre paramètre par défaut du compte, donc les nouveaux threads et les chats claude.ai commencent sans lui jusqu’à ce que vous le réactiviez. Un thread cloud reprend un connecteur que vous ajoutez ou reconnectez après le prochain message que vous lui envoyez.

Référence des paramètres du projet

Vous changez les paramètres du projet à claude.ai/code ou dans l’application de bureau, pas dans settings.json. Ouvrez Project settings depuis Settings dans le menu de la barre latérale du projet ou depuis l’icône d’engrenage dans l’en-tête du projet. Les paramètres s’enregistrent au fur et à mesure que vous les modifiez ; un champ de texte que vous modifiez, comme l’objectif ou les instructions, affiche Save changes et Discard jusqu’à ce que vous le quittiez. Les modifications apportées aux instructions, référentiels, plugins et environnement dans Project settings atteignent les nouveaux threads, pas les threads déjà en cours d’exécution.

Pause, archive ou suppression d’un projet

Les trois contrôles sont en bas de Project settings > General :
  • 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 tâches planifiées 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 tâches planifiées 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 tâches planifiées 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

L’utilisation du projet compte par rapport aux mêmes limites de plan que vos autres sessions Claude Code, et un projet ne peut pas dépenser au-delà de ces limites de lui-même. Un thread qui atteint la limite de votre plan attend et continue de lui-même quand la limite se réinitialise, donc le travail que vous avez laissé en cours d’exécution commence à utiliser votre prochaine fenêtre d’utilisation sans message de vous. Un thread a atteint la limite d’utilisation couvre ce que vous voyez, comment l’arrêter et le seul cas qui n’attend pas. Le travail dépasse vos limites de plan seulement si vous avez activé les crédits d’utilisation pour votre compte. Un thread ne peut pas les activer pour vous.

Ce qui utilise votre plan

Un projet utilise vos limites plus rapidement qu’une seule session, et sur un plan Pro en particulier, vous devriez vous attendre à atteindre votre limite plus tôt les jours où vous en exécutez un. Ce sont les parties d’un projet qui utilisent 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 500 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.
Un projet sans threads en cours d’exécution, sans pull requests surveillées et sans nouveaux messages n’utilise pas votre plan pendant qu’il reste inactif, et un projet archivé non plus.

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

Ouvrez l’onglet Usage dans Project settings pour voir l’utilisation des tokens par thread et par modèle, et combien est allé à la conversation du projet. Pour la réduire :
  • Sur Pro, Max et Ultra dans les limites de votre plan, la durée de vie du cache est d’une heure. Un thread inactif depuis plus longtemps relit l’intégralité de sa conversation avant de faire quoi que ce soit lorsqu’une suite lui parvient. Pour le nouveau travail, demandez à Claude de démarrer un thread frais, ce qui 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

Plusieurs fonctionnalités de Claude Code permettent à plus d’une session de fonctionner en même temps, donc exécuter du travail en parallèle n’est pas en soi à quoi sert un projet. Dans un projet, Claude démarre et suit les sessions au lieu de vous, et chacun commence à partir des mêmes instructions. Voici comment chaque fonctionnalité voisine se connecte à un projet :
  • 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. Les projets sont disponibles sur Pro, Max et Ultra. Un projet est le vôtre seul : vous êtes le seul à lui envoyer du travail ou à voir ses threads, et il utilise votre propre accès GitHub et vos connecteurs. Comment Claude Tag diffère de Cowork et Claude Code présente la comparaison côte à côte.
  • Sessions cloud : chaque thread est une session cloud sauf si vous demandez à Claude de l’exécuter sur votre machine. De toute façon, Claude la démarre et la suit au lieu de vous. Vous pouvez également intégrer à un projet le travail d’une session cloud que vous avez démarrée vous-même : choisissez Continue in project dans le menu de la barre latérale de cette session.
  • Tâches planifiées : quand vous demandez du travail planifié dans un projet, Claude crée une tâche planifiée cloud qui s’exécute en tant que threads dans ce projet et apparaît sur son onglet Scheduled tasks. Les tâches planifiées que vous créez en dehors d’un projet continuent à fonctionner seules.
  • Remote Control : Remote Control connecte claude.ai à une session Claude Code s’exécutant sur votre machine. Quand vous demandez à Claude dans un projet d’exécuter un thread sur votre ordinateur, le projet utilise Remote Control pour le faire.
  • Sessions locales et agent view : une session que vous démarrez vous-même dans votre terminal, IDE ou l’environnement local de l’application de bureau reste en dehors de vos projets, mais vous pouvez intégrer son travail à l’un d’eux. Agent view est un écran pour suivre plusieurs sessions locales côte à côte, et vous démarrez toujours chacune et lui donnez sa tâche vous-même.
  • Worktrees : un worktree donne à chaque session locale sa propre copie de travail d’un dépôt. Les threads cloud n’en ont pas besoin : chacun clone ses dépôts 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.
  • Subagents : un subagent s’exécute à l’intérieur d’une session, effectue une tâche secondaire dans sa propre fenêtre de contexte, et retourne un résumé à cette session. Les threads d’un projet sont des sessions complètes que Claude démarre et qui rendent compte à la conversation du projet, et un thread peut toujours utiliser des subagents pour ses propres tâches secondaires.
  • 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.
Exécuter des agents en parallèle compare ces options côte à côte.

Limitations

  • Les projets sont disponibles à claude.ai/code, dans l’application de bureau et dans l’application mobile Claude, pas dans le CLI du terminal, l’extension VS Code ou le plugin JetBrains, et pas via Amazon Bedrock, la plateforme d’agents de Google Cloud ou Microsoft Foundry.
  • Les threads du projet sont des sessions cloud, ou des sessions sur votre propre machine via Remote Control, avec Anthropic comme fournisseur de modèle dans les deux cas. Sécurité et Utilisation des données couvrent comment les sessions cloud sont isolées et ce qui est conservé, et Connexion et sécurité couvre comment un thread sur votre machine se connecte et ce qui est stocké.
  • Vous ne pouvez pas ajouter une session que vous avez démarrée vous-même sur votre machine à un projet, mais vous pouvez intégrer son travail dans un projet. Un projet atteint votre machine en exécutant un thread là-bas via Remote Control, et cette section énumère ce dont il a besoin.
  • Le sandbox d’un thread cloud 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. Continue in project va seulement dans l’autre sens : il apporte le travail d’une session cloud dans un projet. Vous ne pouvez pas fusionner deux projets en un.

Dépannage

Pour les invites de configuration GitHub dans la boîte de dialogue New project, voir Configurer l’accès GitHub.

Un thread semble bloqué

Claude ne publie pas chaque étape qu’un thread prend, donc un thread qui s’affiche comme en cours d’exécution sans nouveaux messages dans la conversation du projet fonctionne généralement toujours. Un nouveau thread cloud provisionne également son environnement cloud avant que Claude commence, donc sa première mise à jour prend un moment. Ouvrez le thread pour lire sa transcription. Si le thread attend une invite de permission, répondez-y là.

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

Quand plusieurs threads reviennent ayant supposé quelque chose de mal, contourné l’accès manquant ou arrêté avec « bloqué », la cause est généralement le même écart dans la configuration du projet plutôt qu’un problème avec chaque tâche. Triez les threads qui sont solides avant de corriger quoi que ce soit :
  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

La conversation du projet affiche une bannière « Claude hasn’t responded » quand Claude fonctionne mais ses réponses n’atteignent pas le projet. Cliquez sur Restart Claude sur la bannière, ou allez à Project settings > General et cliquez sur Restart dans la ligne Restart Claude. Claude se reconnecte à la conversation ; toute réponse qu’il était en train d’écrire est perdue, et les threads ne sont pas affectés.

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

Trois messages signifient qu’un thread ou le projet ne peut pas atteindre l’un de ses référentiels. Un thread cloud du projet a besoin des prérequis GitHub même quand vos autres sessions cloud clonent le même référentiel sans problème.
  • « 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.
Pour corriger l’un d’eux, cliquez sur le bouton que le message offre, comme Install GitHub App ou Select repositories on GitHub, puis Check again. Quand le bloc est du côté de l’organisation GitHub, comme un propriétaire qui n’a pas approuvé l’application ou une liste d’autorisation IP qui exclut Claude, le message affiche un lien See how to fix à la place. S’il n’y a pas de bouton, suivez Configurer l’accès GitHub, puis envoyez un autre message pour réessayer.

Un thread a atteint la limite d’utilisation

Quand un thread ou la conversation du projet atteint la limite de cinq heures ou hebdomadaire de votre plan, il continue à réessayer de lui-même et continue quand la limite se réinitialise. Un thread qu’une tâche planifiée a démarré n’attend pas : son tour s’arrête avec une erreur de limite, et vous lui envoyez un message après que la limite se réinitialise. Pendant qu’il attend, le thread affiche Service is busy avec « Claude is still retrying and will continue automatically. » Vous n’avez rien à faire pour que le travail continue. Si vous préférez qu’il n’utilise pas votre prochaine fenêtre d’utilisation, cliquez sur Stop dans le thread, ou mettez le projet en pause pour suspendre tous les threads. Erreurs de limite d’utilisation expliquent les limites et quand elles se réinitialisent.

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

Un thread ou la conversation du projet a fait une demande que votre plan ne couvre que avec des crédits d’utilisation, comme une à un modèle ou une taille de contexte que votre plan n’inclut pas, et les crédits d’utilisation ne sont pas activés pour votre compte. Ajouter des crédits d’utilisation à votre abonnement couvre qui peut les activer ou les acheter sur chaque plan. Une fois que les crédits sont disponibles, envoyez un autre message pour réessayer.

Perte de contact avec votre dossier

Un thread s’exécutant sur votre ordinateur affiche ceci quand la session Claude Code là-bas a cessé de répondre, généralement parce que l’ordinateur s’est mis en veille ou que l’application de bureau ou claude remote-control s’est fermé. Réveillez l’ordinateur. Si l’application de bureau ou claude remote-control ne s’exécute plus là-bas, redémarrez-le :
  • Application de bureau : rouvrez l’application et confirmez que Use this computer from your phone and claude.ai est toujours activé sous Settings > Code ou Settings > Claude Code
  • Terminal : exécutez à nouveau claude remote-control dans le même dossier

Autres messages

Ces messages nomment leur propre cause. Le tableau donne la prochaine étape pour chacun.