Utiliser Claude Code dans le cloud

Les sessions cloud sont disponibles sur les plans Pro, Max et Team, ainsi que pour les utilisateurs Enterprise disposant de sièges premium ou de sièges Chat + Claude Code.

Une session cloud est une session Claude Code qui s’exécute sur l’infrastructure cloud au lieu de sur votre machine. Par défaut, elle s’exécute sur l’infrastructure gérée par Anthropic, ou sur l’environnement auto-hébergé de votre organisation lorsqu’elle y est acheminée. La session continue de s’exécuter après que vous fermiez votre ordinateur portable, et vous pouvez la vérifier ou la diriger depuis n’importe quel appareil. Elle est comptabilisée dans les limites d’utilisation de votre plan, avec le reste de votre utilisation de Claude et de Claude Code, et la VM cloud ne fait l’objet d’aucune facturation séparée. Pour permettre aux sessions cloud de cloner votre code depuis GitHub et de pousser des branches, connectez GitHub avec l’une des méthodes de connexion GitHub. Si votre dépôt est hébergé sur GitLab, Bitbucket ou un autre hébergeur, consultez Restrictions de plateforme pour savoir ce qui fonctionne. Vous pouvez démarrer une session cloud à partir de l’une de ces surfaces :

Navigateur : claude.ai/code, également appelé Claude Code sur le web
Mobile : l’onglet Code dans l’application Claude
Application de bureau : sélectionnez Cloud au lieu de Local lorsque vous démarrez une session
Terminal : claude --cloud
Routines : les exécutions planifiées et déclenchées s’exécutent chacune en tant que session cloud

Une fois la configuration terminée, utilisez cette page pour déplacer le travail entre votre terminal et le cloud, gérer et partager des sessions, activer la correction automatique des pull requests et résoudre les problèmes.

Ces cas sont traités sur d’autres pages :

Démarrer votre première session cloud : Démarrer avec les sessions cloud connecte GitHub et vous guide à travers une tâche dans le navigateur
De nombreuses sessions cloud pour un même corps de travail : avec un projet, Claude les démarre et en assure le suivi pour vous
Diriger une session locale depuis un autre appareil : les sessions dans votre terminal, votre IDE ou l’application de bureau avec Local sélectionné s’exécutent sur votre machine, et Remote Control vous permet d’y accéder depuis votre téléphone ou votre navigateur

Environnements cloud

Chaque session cloud s’exécute dans un environnement cloud, la configuration enregistrée qui contrôle l’accès réseau, les variables d’environnement et les scripts de configuration.

Votre premier environnement : si vous n’en avez pas encore, l’intégration configure un environnement Default avec accès réseau Trusted, soit en le créant pour vous, soit en vous demandant de le créer. Consultez L’environnement Default pour savoir lequel se produit sur votre plan
Quel environnement une session utilise : consultez L’environnement Default pour savoir comment les sessions choisissent un environnement lorsque vous en avez plus d’un
Modifier ce que les sessions peuvent atteindre ou exécuter au démarrage : consultez Configurer les environnements cloud
Ce qui est installé sans aucune configuration : consultez Outils installés

Options d’authentification GitHub

Les sessions cloud ont besoin d’accès à vos référentiels GitHub pour cloner le code et pousser les branches. Vous pouvez accorder l’accès de deux façons :

Méthode	Comment vous vous connectez	Référentiels que les sessions peuvent atteindre	Idéal pour
Application GitHub	Autorisez l’application Claude GitHub lors de l’intégration web	N’importe quel référentiel public, et les référentiels privés sur lesquels l’application Claude GitHub est installée	Intégration web ; équipes qui veulent Auto-fix
`/web-setup`	Exécutez `/web-setup` dans votre terminal pour envoyer votre jeton CLI `gh` local à votre compte Claude	N’importe quel référentiel auquel votre jeton `gh` peut accéder, que l’application soit installée ou non	Développeurs individuels qui utilisent déjà `gh`

Ces fonctionnalités nécessitent que l’application Claude GitHub soit installée sur le dépôt :

Auto-fix : l’installation de l’application Claude GitHub sur un dépôt active également Auto-fix pour les pull requests qu’il contient
Projets : les threads dans un projet ont besoin que l’application Claude GitHub soit installée sur chaque dépôt qu’ils clonent, quelle que soit la méthode de connexion utilisée. Consultez Configurer l’accès GitHub

Dans les environnements hébergés par Anthropic, vos identifiants GitHub restent chiffrés sur les serveurs d’Anthropic et n’entrent jamais dans la VM d’une session. Les opérations GitHub depuis la VM passent par le proxy GitHub, qui attache l’identifiant côté serveur. Consultez Connecter depuis votre terminal pour la procédure pas à pas de /web-setup, y compris ce que /web-setup stocke et comment le supprimer.

Les organisations avec Zéro rétention de données activée, ou avec la configuration HIPAA appliquée, ne peuvent pas utiliser /web-setup ou d’autres fonctionnalités de session cloud.

Configuration rapide pour Team et Enterprise

La configuration rapide est un paramètre d’organisation qui supprime des étapes de la configuration GitHub et de l’environnement des membres. Sur les plans Team et Enterprise, elle est désactivée par défaut. Voici ce qui change pour les membres lorsqu’elle est activée :

/web-setup : les membres peuvent connecter GitHub avec /web-setup. Tant que le paramètre est désactivé, la commande est masquée
Invite de l’application GitHub : l’intégration dans le navigateur ignore l’invite d’installation de l’application Claude GitHub
Premier environnement : l’intégration dans le navigateur crée l’environnement Default pour les membres au lieu d’afficher le formulaire d’environnement

Un Propriétaire l’active avec le bouton bascule Quick setup dans Paramètres de l’organisation > Claude Code.

Déplacer les tâches entre le terminal et le cloud

Ces workflows nécessitent que le Claude Code CLI soit connecté au même compte claude.ai. Vous pouvez démarrer de nouvelles sessions cloud depuis votre terminal, ou extraire des sessions cloud dans votre terminal pour continuer localement. Les sessions cloud persistent même si vous fermez votre ordinateur portable, et vous pouvez les surveiller de n’importe où, y compris depuis l’application mobile Claude.

Depuis le CLI, le transfert de session est unidirectionnel : vous pouvez extraire des sessions cloud dans votre terminal avec --teleport, mais vous ne pouvez pas envoyer une session terminal existante vers le cloud. Le flag --cloud avec une description de tâche crée une nouvelle session cloud pour votre dépôt actuel ; avec -p et un ID de session ou une URL claude.ai/code, il met plutôt en file d’attente un message dans cette session existante. L’application de bureau peut envoyer vers le cloud une session locale de son onglet Code depuis son menu Ouvrir dans.

Démarrer une session cloud depuis votre terminal

Démarrez une session cloud depuis la ligne de commande avec le flag --cloud :

claude --cloud "Fix the authentication bug in src/auth/login.ts"

Cela crée une nouvelle session cloud sur claude.ai. La VM cloud clone le remote GitHub du répertoire actuel à votre branche actuelle, pas votre checkout local, donc poussez d’abord si vous avez des commits locaux. Consultez Envoyer des référentiels locaux sans GitHub pour les cas où Claude Code télécharge votre référentiel local au lieu de le cloner. --cloud fonctionne avec un seul référentiel à la fois. La tâche s’exécute dans le cloud tandis que vous continuez à travailler localement. L’ancienne orthographe --remote fonctionne toujours comme alias déprécié pour --cloud. Pendant que le conteneur cloud démarre, le CLI affiche une liste de contrôle en direct des étapes de configuration, telles que le clonage du référentiel et l’exécution de votre script de configuration. Il met en file d’attente les messages que vous tapez pendant le provisionnement et les envoie une fois que la session est prête.

--cloud crée des sessions cloud. --remote-control n’est pas lié : il vous permet de surveiller et de diriger une session CLI locale depuis claude.ai ou l’application Claude. Voir Remote Control.

Ouvrez la session sur claude.ai ou l’application mobile Claude pour vérifier la progression ou interagir directement. De là, vous pouvez diriger Claude, fournir des commentaires ou répondre à des questions comme dans n’importe quelle autre conversation. Si Claude pose une question et que la session reste inactive, vous pouvez toujours répondre quand vous revenez, jusqu’à l’expiration de l’environnement, et la session continue à partir de votre réponse.

Conseils pour les tâches cloud

Planifiez localement, exécutez dans le cloud : pour les tâches complexes, démarrez Claude en mode plan pour collaborer sur l’approche, puis envoyez le travail vers le cloud :

claude --permission-mode plan

En mode plan, Claude lit les fichiers, exécute des commandes pour explorer et propose un plan sans modifier le code source. Une fois que vous êtes satisfait, enregistrez le plan dans le référentiel, validez et poussez afin que la VM cloud puisse le cloner. Ensuite, démarrez une session cloud pour l’exécution autonome :

claude --cloud "Execute the migration plan in docs/migration-plan.md"

Exécutez les tâches en parallèle : chaque commande --cloud crée sa propre session cloud qui s’exécute indépendamment. Vous pouvez démarrer plusieurs tâches et elles s’exécuteront toutes simultanément dans des sessions séparées :

claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"

Quand une session se termine, vous pouvez créer une PR depuis claude.ai/code ou téléporter la session dans votre terminal pour continuer à travailler.

Envoyer des référentiels locaux sans GitHub

Quand vous exécutez claude --cloud depuis un dépôt qui n’a pas de remote git, ou depuis un dépôt github.com sur lequel l’application Claude GitHub n’est pas installée, Claude Code regroupe votre dépôt local et le télécharge directement vers la session cloud. Cela s’applique même si vous avez connecté GitHub avec /web-setup. Pour un clone complet, le bundle inclut l’historique de votre dépôt sur toutes les branches, plus les modifications non commitées des fichiers suivis. Ce qu’il advient des modifications non commitées dans les fichiers sensibles dépend de votre plateforme :

macOS, Linux et WSL : Claude Code exclut de l’upload les modifications non commitées des fichiers nommés comme des identifiants ou des clés. Cela inclut les fichiers .env, les fichiers Terraform *.tfvars et les fichiers clés tels que id_rsa et *.pem. Il exclut également les modifications non commitées des fichiers gérés par un filtre git tel que Git LFS. Un avis Left on this machine: nomme les fichiers exclus, et la session démarre avec la version commitée de chacun, ou sans le fichier si aucune version n’est commitée.
Windows natif : les modifications non commitées des fichiers suivis sont uploadées telles quelles, quel que soit le nom du fichier. Remisez (stash) ou annulez toute modification que vous ne voulez pas dans la session cloud avant de la démarrer.

Pour télécharger un bundle même quand Claude Code clonerait autrement depuis le remote, définissez CCR_FORCE_BUNDLE=1 :

CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

Les référentiels regroupés doivent respecter ces limites :

Le répertoire doit être un référentiel git avec au moins un commit
Le référentiel regroupé doit être inférieur à 100 MB. Les référentiels plus grands reviennent à regrouper uniquement la branche actuelle, puis à un seul snapshot aplati de l’arborescence de travail, et échouent uniquement si le snapshot est toujours trop volumineux
Les fichiers non suivis ne sont pas inclus ; exécutez git add sur les fichiers que vous voulez que la session cloud voie
Sur macOS, Linux et WSL, Claude Code refuse l’upload quand il ne peut pas suivre un paramètre git qui affecte les règles d’attributs qui s’appliquent à vos fichiers, comme core.attributesFile défini dans un fichier config inclus. Le message de refus nomme le paramètre et la correction
Les sessions créées à partir d’un bundle ne peuvent repousser vers un remote GitHub que si votre connexion GitHub a accès en push à ce référentiel

Sur macOS, Linux et WSL, l’upload nécessite également git 2.31 ou ultérieur et une organisation de checkout prise en charge, tandis que sur Windows natif, Claude Code effectue l’upload sans aucune de ces vérifications. Quand un checkout ne satisfait pas ces exigences, Claude Code ne démarre pas la session. Il affiche une erreur contenant Not uploading this working tree:, nomme la cause et indique ce qu’il faut changer. Voici les causes courantes :

Version de git trop ancienne : le git installé est antérieur à 2.31. Mettez à jour git, puis réessayez.
Une organisation de checkout que l’upload ne prend pas en charge : vous avez démarré à l’intérieur d’un sous-module, dans un clone créé avec git clone --separate-git-dir, --shared ou --reference, dans un checkout où core.worktree est défini, ou dans un dépôt qui stocke ses refs au format reftable. Démarrez plutôt depuis le checkout principal d’un clone créé avec un simple git clone.
Un worktree lié avec un sparse checkout : git sparse-checkout écrit des paramètres dans le propre fichier config.worktree du worktree, que l’upload n’accepte pas ; un worktree qui possède ces paramètres n’est donc pas uploadé, pas plus qu’un worktree créé par Claude Code avec worktree.sparsePaths. Démarrez plutôt depuis le checkout principal du dépôt.
Configuration git conservée dans la copie de travail : votre configuration git inclut un fichier situé à l’intérieur du checkout, par exemple une entrée include.path qui pointe vers le dépôt. Déplacez ce fichier en dehors de la copie de travail ou supprimez l’inclusion, puis réessayez.

Sur macOS, Linux et WSL, un clone partiel créé avec git clone --filter est uploadé sous forme de snapshot de sa copie de travail sans historique, à condition que le clone contienne localement tous les fichiers suivis. Pour claude --cloud, si le dépôt est sur GitHub, vous pouvez éviter l’upload et ses exigences : poussez votre branche, installez l’application Claude GitHub sur le dépôt, puis démarrez à nouveau la session afin qu’elle clone depuis GitHub.

Envoyer des messages de suivi depuis le CLI

Une fois qu’une session cloud est en cours d’exécution, où qu’elle s’exécute, envoyez-lui un message de suivi depuis le CLI claude sur n’importe quelle machine où vous êtes connecté avec claude auth login. Le CLI s’authentifie avec vos identifiants de compte Anthropic et n’envoie aucun état de session local, donc la commande n’a pas besoin de s’exécuter depuis la machine qui a démarré la session. La commande publie un message et se termine :

claude -p "your message" --cloud <session-id>

Le CLI met le message en file d’attente dans la session et se termine sans attendre une réponse. Utilisez-le pour diriger une session longue, mettre en file d’attente l’étape suivante tandis que la session actuelle se termine toujours, ou envoyer des messages de suivi depuis un script CI. Vous pouvez également rediriger le message sur stdin au lieu de le passer en tant qu’argument : echo "your message" | claude -p --cloud <session-id>. Pour <session-id>, passez l’ID nu, tel que session_... ou cse_..., ou l’URL claude.ai/code/<id> de la session, avec ou sans le schéma ou la chaîne de requête. Trouvez l’ID dans votre liste de sessions sur claude.ai/code.

--cloud nécessite un compte Anthropic. Il n’est pas disponible quand Claude Code est configuré pour Amazon Bedrock, Google Cloud’s Agent Platform ou un autre fournisseur tiers. Une passerelle LLM configurée uniquement via ANTHROPIC_BASE_URL ne compte pas comme un fournisseur tiers pour cette vérification, mais vous devez toujours vous connecter avec claude auth login. La politique allow_remote_sessions de votre organisation doit également être activée. Un propriétaire peut l’activer dans les paramètres d’administration Claude Code sur claude.ai/admin-settings/claude-code.

Sortie

En cas de succès, la commande imprime l’ID de session et un lien pour afficher la session :

Sent to cloud session.
Session ID: session_01DiUkqY2kzbUbDmW1w96rfi
View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0

Passez --output-format json pour un résultat lisible par machine : {ok, session_id, url} en cas de succès, ou {ok: false, session_id, error} quand l’envoi échoue, par exemple quand la session est manquante ou archivée. Les erreurs de configuration, telles qu’un fournisseur non pris en charge ou une politique organisationnelle désactivée, s’impriment sur stderr sans JSON. --output-format stream-json n’est pas pris en charge avec --cloud <session-id>. Si l’envoi échoue, consultez Erreurs lors de l’envoi vers une session cloud.

Continuer une session cloud dans votre terminal

Extrayez une session cloud dans votre terminal en utilisant l’une de ces options :

Utilisation de --teleport : depuis la ligne de commande, exécutez claude --teleport pour un sélecteur de session interactif, ou claude --teleport <session-id> pour reprendre une session spécifique directement. Si vous avez des modifications non validées, vous serez invité à les ranger d’abord.
Utilisation de /teleport : à l’intérieur d’une session CLI existante, exécutez /teleport ou /tp pour ouvrir le même sélecteur de session sans redémarrer Claude Code.
Depuis /tasks : exécutez /tasks pour voir vos sessions en arrière-plan, puis appuyez sur t pour vous téléporter dans l’une d’elles.
Depuis claude.ai/code : sélectionnez Ouvrir dans > Terminal dans le menu de session pour copier une commande que vous pouvez coller dans votre terminal.
Depuis l’intérieur de la session cloud : tapez /teleport et Claude Code répond avec la commande exacte claude --teleport <session-id> pour cette session, prête à s’exécuter à partir d’un checkout du référentiel. Nécessite Claude Code v2.1.223 ou ultérieur dans l’environnement de la session.

Quand vous téléportez une session, Claude vérifie que vous êtes dans le bon référentiel, récupère et vérifie la branche de la session cloud, et charge l’historique complet de la conversation dans votre terminal. Le terminal obtient sa propre copie de la session : le nouveau travail là-bas reste local et n’apparaît pas dans la session cloud sur claude.ai ou l’application mobile Claude. Pour continuer à diriger depuis votre téléphone après la téléportation, démarrez /remote-control dans la session locale. --teleport est distinct de --resume. --resume rouvre une conversation à partir de l’historique local de cette machine et ne liste pas les sessions cloud ; --teleport extrait une session cloud et sa branche.

Exigences de téléportation

Teleport vérifie ces exigences avant de reprendre une session. Si une exigence n’est pas satisfaite, vous verrez une erreur ou serez invité à résoudre le problème.

Exigence	Détails
État git propre	Votre répertoire de travail ne doit avoir aucune modification non validée. Teleport vous invite à ranger les modifications si nécessaire.
Dépôt correct	Vous devez exécuter `--teleport` à partir d’un checkout du même dépôt, pas d’un fork. Si vous l’exécutez à partir d’un checkout d’un dépôt différent, Claude Code affiche une erreur qui nomme à la fois le dépôt de la session et celui de votre checkout. Si Claude Code ne peut pas analyser votre remote en un nom d’hôte, par exemple un alias d’hôte SSH comme `git@work:owner/repo.git`, il vous demande de confirmer et accepte le checkout quand le propriétaire du remote et le nom du dépôt correspondent au dépôt de la session.
Branche disponible	La branche de la session cloud doit avoir été poussée vers le remote. Teleport la récupère et la vérifie automatiquement.
Même compte	Vous devez être authentifié au même compte claude.ai utilisé dans la session cloud.

Quand Teleport récupère la branche de la session, le fetch n’attend jamais de saisie dans votre terminal. Si git ou ssh demandait un mot de passe, une phrase secrète de clé ou la confirmation d’un nouvel hôte SSH, le fetch échoue, et le checkout ne fonctionne alors que si votre clone local possède déjà la branche. Pour les deux cas SSH, chargez votre clé dans ssh-agent et exécutez d’abord git fetch une fois manuellement pour enregistrer l’hôte.

`--teleport` n’est pas disponible

Teleport nécessite l’authentification par abonnement claude.ai. Trouvez le cas qui correspond au vôtre :

Vous êtes authentifié via clé API : exécutez /login pour vous connecter avec votre compte claude.ai à la place
L’erreur nomme votre fournisseur : les sessions cloud ne sont pas disponibles via les fournisseurs tiers. Voir le tableau d’erreurs
Vous êtes déjà connecté via claude.ai : votre organisation a peut-être désactivé les sessions cloud

Travailler avec les sessions

Les sessions apparaissent dans la barre latérale sur claude.ai/code. De là, vous pouvez examiner les modifications, partager avec vos coéquipiers, archiver le travail terminé ou supprimer définitivement les sessions.

Modes de permission dans les sessions cloud

Vous choisissez le mode de permission d’une session cloud à partir du menu déroulant de mode, à la fois lorsque vous créez la tâche et pendant que la session s’exécute. Claude Code reprend une session dans le mode de permission dans lequel elle se trouvait lorsque vous effectuez l’une des actions suivantes :

Rouvrir une session dont l’environnement hébergé par Anthropic a expiré
Envoyer un message à une session qu’un exécuteur auto-hébergé a libérée pendant qu’elle était inactive

Examiner les modifications

Chaque session affiche un indicateur de diff avec les lignes ajoutées et supprimées, comme +42 -18. Sélectionnez-le pour ouvrir la vue diff, laisser des commentaires en ligne sur des lignes spécifiques et les envoyer à Claude avec votre prochain message. La vue diff compare les modifications de la session par rapport à sa branche de base par défaut. Pour comparer avec n’importe quelle autre branche du dépôt, sélectionnez Comparer avec et choisissez-en une. Claude Code calcule ces diffs à partir du contenu brut des blobs git, de sorte que les pilotes diff et les filtres textconv configurés dans le dépôt ne s’appliquent pas. Ces étapes sont traitées ailleurs :

La procédure complète, incluant la création de PR : consultez Examiner et itérer
Faire en sorte que Claude surveille automatiquement la PR pour les défaillances CI et les commentaires d’examen : consultez Correction automatique des pull requests

Gérer le contexte

Les sessions cloud prennent en charge les commandes intégrées qui produisent une sortie textuelle. Les commandes qui s’exécutent uniquement dans l’interface du terminal, telles que /plugin ou /resume, ne sont pas disponibles. Les commandes qui ouvrent un sélecteur ou un panneau dans le terminal se comportent différemment dans les sessions cloud :

/model, /effort, /color et /rename : transmettez la valeur en tant qu’argument, par exemple /model sonnet, au lieu d’ouvrir le sélecteur du terminal ou le curseur. Les formes d’argument suivent les notes de disponibilité de chaque commande.
/fast : bascule le mode rapide pour la session lorsque le mode rapide est disponible sur votre compte. Nécessite Claude Code v2.1.271 ou une version ultérieure dans l’environnement de la session.
/config : dans votre navigateur sur claude.ai/code, ouvre la section Claude Code de vos paramètres au lieu de définir une valeur, et le texte après la commande, y compris key=value, est ignoré. Pour modifier un paramètre pour une session cloud, définissez une variable d’environnement sur l’environnement, ou dans une session avec un référentiel, validez la clé dans le fichier .claude/settings.json de ce référentiel. Les paramètres dans les sessions cloud énumère ce que chaque session lit.

Pour la gestion du contexte spécifiquement :

Commande	Fonctionne dans les sessions cloud	Notes
`/compact`	Oui	Résume la conversation pour libérer du contexte. Accepte les instructions de focus optionnelles comme `/compact keep the test output`
`/context`	Oui	Affiche ce qui se trouve actuellement dans la fenêtre de contexte
`/clear`	Non	Démarrez plutôt une nouvelle session à partir de la barre latérale

La compaction automatique s’exécute automatiquement lorsque la fenêtre de contexte approche de sa capacité. Les sessions cloud définissent CLAUDE_AUTOCOMPACT_PCT_OVERRIDE elles-mêmes, de sorte que la compaction se déclenche avant la fin de la fenêtre de compaction automatique plutôt que lorsque la fenêtre se remplit. Cette valeur remplace celle que vous ajoutez dans vos variables d’environnement, donc ajouter la variable là-bas ne change pas le moment où la compaction se déclenche. Pour modifier la fenêtre de compaction automatique à la place, définissez CLAUDE_CODE_AUTO_COMPACT_WINDOW dans vos variables d’environnement, ou exécutez /autocompact avec un nombre de jetons dans une session où la variable n’est pas définie. Les sous-agents fonctionnent de la même manière qu’en local. Claude peut les générer avec l’outil Agent pour déléguer la recherche ou le travail parallèle à une fenêtre de contexte séparée, en gardant la conversation principale plus légère. Les sous-agents définis dans le répertoire .claude/agents/ de votre référentiel sont détectés automatiquement. Les équipes d’agents sont désactivées par défaut mais peuvent être activées en ajoutant CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 à vos variables d’environnement.

Annuler un message en attente

Si vous envoyez un message alors que Claude travaille, le message est mis en attente jusqu’à ce que Claude le lise. Pour annuler un message en attente, cliquez sur le ✕ qui s’y trouve. Le texte revient à la boîte de message pour que vous puissiez le modifier ou envoyer quelque chose d’autre. Si Claude a déjà lu le message, il reste dans la conversation. Pour partager une session, basculez sa visibilité selon les types de compte ci-dessous. Après cela, partagez le lien de session tel quel. Les destinataires voient l’état le plus récent lorsqu’ils ouvrent le lien, mais leur vue ne se met pas à jour en temps réel. Le partage fonctionne comme suit pour les comptes Enterprise et Team :

Options de visibilité : Privé et Équipe. La visibilité Équipe rend la session visible aux autres membres de votre organisation claude.ai
Accès au dépôt : la vérification est activée par défaut, en fonction du compte GitHub connecté au compte du destinataire
Votre nom : le nom d’affichage de votre compte est visible à tous les destinataires ayant accès
Sessions Slack : les sessions Claude dans Slack sont automatiquement partagées avec la visibilité Équipe

Le partage fonctionne comme suit pour les comptes Max et Pro :

Options de visibilité : Privé et Public. La visibilité Public rend la session visible à tout utilisateur connecté à claude.ai
Accès au dépôt : la vérification n’est pas activée par défaut
Contenu sensible : vérifiez votre session avant de partager. Les sessions peuvent contenir du code et des identifiants provenant de dépôts GitHub privés

Pour exiger que les destinataires aient accès au référentiel, ou pour masquer votre nom des sessions partagées, accédez à Paramètres > Claude Code > Paramètres de partage.

Archiver les sessions

Vous pouvez archiver les sessions pour garder votre liste de sessions organisée. Les sessions archivées sont masquées de la liste de sessions par défaut mais peuvent être visualisées en filtrant les sessions archivées. Pour archiver une session, survolez la session dans la barre latérale et sélectionnez l’icône d’archive.

Supprimer les sessions

La suppression d’une session supprime définitivement la session et ses données. Cette action ne peut pas être annulée. Vous pouvez supprimer une session de deux façons :

À partir de la barre latérale : filtrez les sessions archivées, puis survolez la session que vous souhaitez supprimer et sélectionnez l’icône de suppression
À partir du menu de session : ouvrez une session, sélectionnez la liste déroulante à côté du titre de la session, et sélectionnez Supprimer

Vous serez invité à confirmer avant la suppression d’une session.

Correction automatique des demandes de tirage

Claude peut surveiller une demande de tirage et répondre automatiquement aux défaillances CI et aux commentaires d’examen. Claude s’abonne aux événements GitHub sur la PR, et lorsqu’une vérification échoue ou qu’un examinateur laisse un commentaire, Claude enquête et pousse une correction si elle est claire.

Auto-fix nécessite que l’application Claude GitHub soit installée sur votre référentiel. Si vous ne l’avez pas déjà fait, installez-la à partir de la page de l’application GitHub.

Il existe plusieurs façons d’activer auto-fix selon d’où provient la PR et quel appareil vous utilisez :

PR créées dans une session cloud : ouvrez la session sur claude.ai/code, ouvrez la barre d’état CI et sélectionnez Auto-fix
À partir de votre terminal : exécutez /autofix-pr sur la branche de la PR. Claude Code détecte la PR ouverte avec gh, génère une session cloud et active auto-fix en une seule étape
À partir de l’application mobile : dites à Claude de corriger automatiquement la PR, par exemple « regardez cette PR et corrigez les défaillances CI ou les commentaires d’examen »
N’importe quelle PR existante : collez l’URL de la PR dans une session et dites à Claude de la corriger automatiquement

Auto-fix est un bouton bascule par PR. Pour arrêter la surveillance, ouvrez la barre d’état CI dans la session sur claude.ai/code et désactivez le bouton bascule Auto-fix, ou dites à Claude d’arrêter de surveiller la PR.

Comment Claude répond à l’activité PR

Lorsque auto-fix est actif, Claude reçoit les événements GitHub pour la PR, y compris les nouveaux commentaires d’examen et les défaillances de vérification CI. Pour chaque événement, Claude enquête et décide comment procéder :

Corrections claires : si Claude est confiant dans une correction et qu’elle n’entre pas en conflit avec les instructions antérieures, Claude apporte la modification, la pousse et explique ce qui a été fait dans la session
Demandes ambiguës : si le commentaire d’un examinateur peut être interprété de plusieurs façons ou implique quelque chose d’architecturalement significatif, Claude vous demande avant d’agir
Événements en double ou sans action : si un événement est un doublon ou ne nécessite aucune modification, Claude le note dans la session et continue

GitHub n’émet pas de webhook lorsque la branche de base avance et crée un conflit de fusion, donc auto-fix ne peut pas réagir aux conflits de son propre chef. Pour résoudre un conflit, ouvrez la session et demandez à Claude de rebaser. Claude peut répondre aux fils de commentaires d’examen sur GitHub dans le cadre de leur résolution. Ces réponses sont publiées en utilisant votre compte GitHub, elles apparaissent donc sous votre nom d’utilisateur, mais chaque réponse est étiquetée comme provenant de Claude Code pour que les examinateurs sachent qu’elle a été écrite par l’agent et non par vous directement.

Si votre référentiel utilise une automatisation déclenchée par commentaire comme Atlantis, Terraform Cloud ou des GitHub Actions personnalisées qui s’exécutent sur les événements issue_comment, sachez que Claude peut répondre en votre nom, ce qui peut déclencher ces flux de travail. Examinez l’automatisation de votre référentiel avant d’activer auto-fix et envisagez de désactiver auto-fix pour les référentiels où un commentaire PR peut déployer une infrastructure ou exécuter des opérations privilégiées.

Sécurité et isolation

Chaque session cloud est séparée de votre machine et des autres sessions par plusieurs couches :

Machines virtuelles isolées : chaque session s’exécute dans une VM isolée gérée par Anthropic. Les sessions que votre organisation achemine vers un environnement auto-hébergé s’exécutent sur votre propre infrastructure à la place, où l’isolation est la responsabilité de votre déploiement
Contrôles d’accès réseau : dans les environnements hébergés par Anthropic, l’accès réseau est limité par défaut et peut être désactivé. Consultez Accès réseau pour les niveaux d’accès, les domaines autorisés par défaut, et le trafic qui ne passe pas par la liste d’autorisation. Dans un environnement auto-hébergé, vous restreignez la sortie de session à votre propre limite réseau. Lors de l’exécution avec l’accès réseau désactivé, Claude Code peut toujours communiquer avec l’API Anthropic, ce qui peut permettre aux données de quitter la VM.
Protection des identifiants : dans les environnements hébergés par Anthropic, les identifiants git et les clés de signature restent en dehors du sandbox, et un proxy authentifie au nom de la session avec des identifiants limités. Dans un environnement auto-hébergé, votre déploiement fournit les identifiants git ; consultez Configurer git
Secrets réseau : dans les environnements hébergés par Anthropic, les clés que vous ajoutez à un environnement cloud restent en dehors du sandbox de la même manière, attachées aux requêtes correspondantes après qu’elles quittent la session. Un environnement auto-hébergé n’a pas de secrets réseau
Analyse sécurisée : le code est analysé et modifié dans l’environnement isolé de la session avant la création de PR

Dépannage

Pour les erreurs d’API d’exécution qui apparaissent dans la conversation comme API Error: 500, 529 Overloaded, 429 ou Prompt is too long, consultez la référence des erreurs. Ces erreurs et leurs corrections sont partagées avec le CLI et l’application Desktop. Les sections ci-dessous couvrent les problèmes spécifiques aux sessions cloud.

Échec de la création de session

Si une nouvelle session ne démarre pas avec Session creation failed ou stagne à la mise en service, Claude Code n’a pas pu allouer une VM pour la session.

Vérifiez status.claude.com pour les incidents de session cloud
Réessayez après une minute, car la capacité est mise en service à la demande
Confirmez que votre connexion GitHub peut atteindre le référentiel en suivant Aucun référentiel n’apparaît après la connexion à GitHub

Impossible d’obtenir l’UUID de l’organisation

claude --cloud et claude --teleport nécessitent une connexion avec un compte claude.ai. Si vous vous authentifiez avec une clé API, ou si vos détails de compte stockés sont obsolètes, vous voyez l’un des messages suivants :

Unable to get organization UUID
Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.
Error loading Claude Code sessions dans le sélecteur de session, lorsque vous exécutez claude --teleport sans ID de session

Exécutez claude auth login dans votre shell pour vous connecter avec votre compte claude.ai, puis réessayez la commande. Dans une session en cours, /login fait de même. Si l’erreur nomme votre fournisseur à la place, consultez le tableau d’erreurs : les sessions cloud ne sont pas disponibles via les fournisseurs tiers. De la v2.1.274 à la v2.1.289, le message de connexion était

Claude Code cloud sessions require authentication with a Claude.ai account. API key authentication is not sufficient. Please run /login to authenticate, or check your authentication status with /status.

Session Remote Control expirée ou accès refusé

--teleport se connecte via la même infrastructure de session Remote Control que les sessions cloud, donc les erreurs d’authentification et d’expiration de session apparaissent avec la terminologie Remote Control. Vous pouvez voir Remote Control session expired ou Access denied. Le jeton de connexion est de courte durée et limité à votre compte.

Exécutez /login localement pour actualiser vos identifiants, puis reconnectez-vous
Confirmez que vous êtes connecté au même compte qui possède la session
Si vous voyez Remote Control may not be available for this organization, un Propriétaire n’a pas activé les sessions cloud pour votre organisation

Erreurs lors de l’envoi vers une session cloud

Ces erreurs proviennent de l’exécution de claude avec --cloud <session-id>, avec ou sans -p. Le CLI préfixe les erreurs avec Error: . Un échec de livraison est encapsulé sous la forme failed to send message to cloud session <id>: <reason>.

Message	Signification
`Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.`	Claude Code est configuré pour un fournisseur tiers. Le message nomme le fournisseur avec le libellé utilisé par votre configuration, comme `Amazon Bedrock` ou `Google Vertex AI`. Supprimez la configuration de ce fournisseur, par exemple en supprimant `CLAUDE_CODE_USE_BEDROCK`, et connectez-vous avec un compte Anthropic (`claude auth login`).
`Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.`	La politique `allow_remote_sessions` de votre organisation est désactivée ; consultez Cloud sessions are disabled by your organization’s policy. Si le message nomme plutôt un identifiant de connexion utilisé par cette session, consultez Les sessions cloud utilisent votre connexion claude.ai.
`Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.`	Claude Code n’a pas fini de charger la politique de votre organisation ; il refuse donc l’envoi plutôt que de supposer que les sessions cloud sont autorisées. Vérifiez votre connexion réseau et réessayez.
`Cloud sessions aren't available:` suivi d’une cause	Le chargement de la politique de votre organisation a échoué, et la suite du message indique comment. Agissez selon la cause indiquée ; consultez Couldn’t verify your organization’s policy for cloud sessions.
`Attaching to an existing cloud session is not enabled for your account.`	Vous avez exécuté `--cloud <session-id>` sans `-p`. Envoyez le message avec `claude -p "your message" --cloud <session-id>`.
`Session not found: <id>`	L’ID ou l’URL ne correspond à aucune session à laquelle vous avez accès. Vérifiez-le par rapport à l’URL claude.ai/code de la session.
`cloud session <id> is archived and cannot accept new messages`	La session a été archivée. Démarrez plutôt une nouvelle session.

Environnement expiré

Les sessions cloud s’arrêtent après une période d’inactivité et la VM de la session est réclamée. Une session est considérée comme inactive pendant qu’elle attend votre approbation d’un appel d’outil connecteur MCP ou votre connexion à un serveur MCP, et elle peut expirer pendant cette attente. Rouvrez la session à partir de claude.ai/code pour mettre en service une VM fraîche :

Restauré : votre historique de conversation
Non restauré : le travail en arrière-plan qui était toujours en cours d’exécution lorsque la VM a été réclamée, comme les sous-agents et les commandes shell, ainsi que le réveil en attente d’une /loop à rythme autonome. Pour relancer la boucle, exécutez à nouveau /loop.

Limitations

Avant de compter sur les sessions cloud pour un flux de travail, tenez compte de ces contraintes :

Limites de débit : les sessions cloud partagent les limites de débit avec tous les autres usages de Claude et Claude Code au sein de votre compte. L’exécution de plusieurs tâches en parallèle consomme proportionnellement plus de limites de débit.
Limites de temps : les commandes que Claude exécute et les hooks SessionStart ont des délais d’expiration par défaut que vous pouvez modifier, et un script de configuration n’est mis en cache que lorsqu’il se termine en environ cinq minutes. Voir Limites de temps
Authentification du référentiel : vous ne pouvez déplacer une session cloud vers votre terminal que lorsque vous êtes authentifié au même compte
Restrictions de plateforme : le clonage du référentiel et la création de demandes de tirage nécessitent GitHub. Les instances GitHub Enterprise Server auto-hébergées sont prises en charge pour les plans Team et Enterprise. Vous pouvez envoyer un référentiel GitLab, Bitbucket ou autre référentiel non-GitHub à une session cloud en tant que paquet local en définissant CCR_FORCE_BUNDLE=1, mais la session ne peut pas pousser les résultats vers ce serveur distant
Liste d’autorisation IP de l’organisation : les sessions cloud appellent l’API Anthropic à partir de l’infrastructure gérée par Anthropic, pas de votre réseau, tandis que les sessions dans un environnement auto-hébergé l’appellent à partir de votre propre réseau. Si votre organisation a l’autorisation IP activée, chaque session cloud hébergée par Anthropic échoue avec une erreur d’authentification. Il en va de même pour Code Review et pour les routines qui s’exécutent sur les environnements hébergés par Anthropic ; une routine acheminée vers un environnement auto-hébergé appelle l’API à partir de votre propre réseau. Contactez le support Anthropic pour exempter les services hébergés par Anthropic de la liste d’autorisation IP de votre organisation.

Environnements cloud : configurez l’accès réseau, les variables d’environnement et les scripts de configuration pour les sessions cloud
Projects : une conversation où Claude coordonne les sessions cloud parallèles sur vos référentiels et vous rend compte
Ultrareview : exécutez un examen de code multi-agent approfondi dans un sandbox cloud
Routines : automatisez le travail selon un calendrier, via un appel API ou en réponse aux événements GitHub
Configuration des hooks : exécutez les scripts aux événements du cycle de vie de la session
Tous les paramètres : toutes les options de configuration
Sécurité : garanties d’isolation et gestion des données
Utilisation des données : ce qu’Anthropic conserve des sessions cloud
Claude Tag : un @Claude géré par l’organisation dans Slack qui s’exécute sur la même infrastructure cloud

Premiers pas

Concepts fondamentaux