Utiliser Claude Code sur le web
Déplacez les sessions entre le web et le terminal avec
--cloudet--teleport, gérez et partagez les sessions, et corrigez automatiquement les demandes de tirage depuis le cloud.
Claude Code sur le web est en aperçu de recherche pour les utilisateurs Pro, Max et Team, ainsi que pour les utilisateurs Enterprise disposant de sièges premium ou de sièges Chat + Claude Code.
Claude Code sur le web exécute les tâches sur l'infrastructure cloud gérée par Anthropic à claude.ai/code, ou sur l'environnement auto-hébergé de votre organisation lorsqu'il y est acheminé. Les sessions persistent même si vous fermez votre navigateur, et vous pouvez les surveiller depuis l'application mobile Claude.
Nouveau sur Claude Code sur le web ? Commencez par Démarrer pour connecter votre compte GitHub et soumettre votre première tâche.
Cette page couvre le produit web lui-même :
- Environnements cloud : où les sessions s'exécutent et où configurer cela
- Options d'authentification GitHub : deux façons de connecter GitHub
- Déplacer les tâches entre le web et le terminal avec
--cloudet--teleport - Travailler avec les sessions : modes de permission, examen, partage, archivage, suppression
- Correction automatique des demandes de tirage : répondre automatiquement aux défaillances CI et aux commentaires d'examen
- Sécurité et isolation : comment les sessions sont isolées
- Limitations : limites de débit et restrictions de plateforme
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. Si vous n'avez pas encore d'environnement, 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 et comment les sessions choisissent un environnement lorsque vous en avez plus d'un.
Les mêmes environnements s'appliquent partout où vous démarrez une session cloud : le web, le terminal, Claude Tag, routines et les applications mobile et Desktop. Les sessions de canal Claude Tag utilisent uniquement les environnements au niveau de l'organisation, soit les environnements partagés, soit les environnements auto-hébergés.
Consultez Configurer les environnements cloud pour modifier ce qu'un environnement permet, définir des variables ou ajouter un script de configuration, et Outils installés pour ce que les sessions incluent sans aucune configuration.
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 |
L'installation de l'application Claude GitHub sur un référentiel active également Auto-fix pour les demandes de tirage qu'il contient.
Pour savoir comment /schedule vérifie l'accès au référentiel avant de créer une routine, consultez Référentiels et permissions de branche. 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.
La configuration web rapide est un paramètre d'organisation qui permet aux membres de connecter GitHub avec /web-setup, ignore l'invite d'installation de l'application Claude GitHub lors de l'intégration web, et fait que l'intégration web crée l'environnement Default pour eux au lieu d'afficher le formulaire d'environnement. Sur les plans Team et Enterprise, elle est désactivée par défaut, ce qui masque /web-setup. Un Propriétaire l'active avec le bouton bascule Quick web setup à Paramètres d'administration > Claude Code.
Les organisations avec Zéro rétention de données activée ne peuvent pas utiliser /web-setup ou d'autres fonctionnalités de session cloud.
Déplacer les tâches entre le web et le terminal
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 web. Le flag --cloud avec une description de tâche crée une nouvelle session cloud pour votre référentiel 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 fournit un menu Continuer dans qui peut envoyer une session locale vers le web.
Du terminal vers le web
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 expose une session CLI locale pour la surveillance depuis le web. 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 à distance : 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 l'interface web 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 référentiel qui n'a pas de remote git, ou depuis un référentiel github.com sur lequel l'application Claude GitHub n'est pas installée, Claude Code regroupe votre référentiel local et le télécharge directement vers la session cloud. Cela s'applique même si vous avez connecté GitHub avec /web-setup. Le bundle inclut l'historique complet de votre référentiel sur toutes les branches, plus les modifications non validées des fichiers suivis.
Sur macOS, Linux et WSL, Claude Code exclut les modifications non validées des fichiers nommés comme des identifiants ou des clés de l'upload et nomme les fichiers qu'il a laissés de côté. Cela couvre les fichiers .env, les fichiers Terraform *.tfvars et les fichiers clés tels que id_rsa et *.pem. La session démarre avec la version validée de chacun, ou sans le fichier si aucun n'est validé. Dans une worktree liée, un submodule ou une disposition similaire, Claude Code télécharge ces modifications avec le reste et nomme les fichiers qu'il télécharge.
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 addsur les fichiers que vous voulez que la session cloud voie - 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
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, et c'est la même dans chaque shell, y compris PowerShell.
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 et erreurs
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>.
Le CLI préfixe les erreurs avec Error: . Un échec de livraison est enveloppé comme failed to send message to cloud session <id>: <reason>.
| Message | Ce que cela signifie |
|---|---|
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 l'étiquette que votre configuration utilise, telle que Amazon Bedrock ou Google Vertex AI. Supprimez la configuration de ce fournisseur, par exemple en désactivant 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 organisationnelle allow_remote_sessions est désactivée. |
Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again. |
Claude Code n'a pas pu récupérer la politique de votre organisation, il refuse donc l'envoi plutôt que d'assumer que les sessions cloud sont autorisées. Vérifiez votre connexion réseau et réessayez. |
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 pas à une session à laquelle vous pouvez accéder. 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 une nouvelle session à la place. |
Du web vers le terminal
Extrayez une session cloud dans votre terminal en utilisant l'une de ces options :
- Utilisation de
--teleport: depuis la ligne de commande, exécutezclaude --teleportpour un sélecteur de session interactif, ouclaude --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/teleportou/tppour ouvrir le même sélecteur de session sans redémarrer Claude Code. - Depuis
/tasks: exécutez/taskspour voir vos sessions en arrière-plan, puis appuyez surtpour vous téléporter dans l'une d'elles. - Depuis l'interface web : 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
/teleportet Claude Code répond avec la commande exacteclaude --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. |
| Référentiel correct | Vous devez exécuter --teleport à partir d'un checkout du même référentiel, pas d'une fork. Si vous l'exécutez à partir d'un checkout d'un référentiel différent, Claude Code affiche une erreur qui nomme à la fois le référentiel de la session et 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 référentiel correspondent au référentiel 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. |
`--teleport` n'est pas disponible
Teleport nécessite l'authentification par abonnement claude.ai. Si vous êtes authentifié via clé API, exécutez /login pour vous connecter avec votre compte claude.ai à la place. Si l'erreur nomme votre fournisseur à la place, les sessions cloud ne sont pas disponibles via les fournisseurs tiers ; voir le tableau d'erreurs. Si vous êtes déjà connecté via claude.ai et que --teleport n'est toujours pas disponible, 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.
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,/fast,/coloret/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 nécessitent Claude Code v2.1.205 ou une version ultérieure dans l'environnement de la session et suivent les notes de disponibilité de chaque commande :/effortsignaleNot appliedtandis qu'un effort par défaut au lancement du modèle est en vigueur, et/fastfonctionne uniquement dans une session qui a démarré avec le mode rapide activé./config: sur le web, ouvre la section Claude Code de vos paramètres au lieu de définir une valeur, et le texte après la commande, y compriskey=value, est ignoré. Pour modifier les paramètres d'une session cloud, utilisez les variables d'environnement ou validez les fichiers de paramètres dans le référentiel.
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é. Claude Code sur le web définit CLAUDE_AUTOCOMPACT_PCT_OVERRIDE dans les sessions cloud lui-même, de sorte que la compaction se déclenche à mi-chemin dans 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.
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. Lorsque vous rouvrez une session dont l'environnement hébergé par Anthropic a expiré, ou que vous envoyez un message à une session qu'un exécuteur auto-hébergé a libérée pendant qu'elle était inactive, Claude Code reprend la session dans le mode de permission dans lequel elle se trouvait.
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.
Claude Code calcule ces diffs, y compris les diffs par fichier affichés lors des modifications de Claude, à partir du contenu brut des blobs git, de sorte que les pilotes diff et les filtres textconv configurés dans le référentiel ne s'appliquent pas. Pour un fichier dans un référentiel qui n'est pas l'un des checkouts de la session, comme un cloné à l'intérieur de l'espace de travail pendant la session, le diff par fichier affiche la modification de Claude elle-même plutôt qu'une comparaison git.
Consultez Examiner et itérer pour la procédure complète incluant la création de PR. Pour que Claude surveille automatiquement la PR pour les défaillances CI et les commentaires d'examen, consultez Correction automatique des demandes de tirage.
Partager les sessions
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.
Partager à partir d'un compte Enterprise ou Team
Pour les comptes Enterprise et Team, les deux options de visibilité sont Privé et Équipe. La visibilité Équipe rend la session visible aux autres membres de votre organisation claude.ai. Les sessions Claude dans Slack sont automatiquement partagées avec la visibilité Équipe.
La vérification de l'accès au référentiel est activée par défaut, en fonction du compte GitHub connecté au compte du destinataire. Le nom d'affichage de votre compte est visible à tous les destinataires ayant accès.
Partager à partir d'un compte Max ou Pro
Pour les comptes Max et Pro, les deux options de visibilité sont Privé et Public. La visibilité Public rend la session visible à tout utilisateur connecté à claude.ai.
Vérifiez votre session pour le contenu sensible avant de partager. Les sessions peuvent contenir du code et des identifiants provenant de référentiels GitHub privés. La vérification de l'accès au référentiel n'est pas activée par défaut.
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 Claude Code sur le web : ouvrez la barre d'état CI et sélectionnez Auto-fix
- À partir de votre terminal : exécutez
/autofix-prsur la branche de la PR. Claude Code détecte la PR ouverte avecgh, génère une session web 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 web 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
- Identifiants API : dans les environnements hébergés par Anthropic sur les plans Pro et Max, les clés que vous ajoutez à un environnement cloud restent en dehors du sandbox de la même manière, attachées aux demandes correspondantes après qu'elles quittent la session. Un environnement auto-hébergé n'a pas d'identifiants API, et les plans Team et Enterprise ne les ont pas encore
- 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, ces commandes échouent avec Unable to get organization UUID ou un message indiquant que l'authentification par clé API n'est pas suffisante. Avec l'authentification par clé API ou les détails de compte obsolètes, l'exécution de claude --teleport sans ID de session affiche Error loading Claude Code sessions dans le sélecteur de session au lieu de l'un ou l'autre message, et le même correctif s'applique.
Exécutez /login pour vous connecter avec votre compte claude.ai, puis réessayez la commande. Si le message nomme votre fournisseur à la place, consultez le tableau d'erreurs : les sessions cloud ne sont pas disponibles via les fournisseurs tiers.
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
/loginlocalement 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
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. Sur le web, la session est marquée comme expirée dans la liste des sessions.
Rouvrez la session à partir de claude.ai/code pour mettre en service une VM fraîche avec votre historique de conversation 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, n'est pas restauré.
Limitations
Avant de compter sur les sessions cloud pour un flux de travail, tenez compte de ces contraintes :
- Limites de débit : Claude Code sur le web partage 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. Il n'y a pas de frais de calcul séparé pour la VM cloud.
- Authentification du référentiel : vous ne pouvez déplacer les sessions du web vers le local 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.
Ressources connexes
- Environnements cloud : configurez l'accès réseau, les variables d'environnement et les scripts de configuration pour les sessions cloud
- 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