SpyBara
Go Premium

claude-code-on-the-web.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 147 additions and 668 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Sat 19 23:57 Tue 22 23:59 Wed 23 23:57 Fri 25 23:58

Utiliser Claude Code sur le web

Déplacez les sessions entre le web et le terminal avec --cloud et --teleport, gérez et partagez les sessions, et corrigez automatiquement les demandes de tirage depuis le cloud.

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.

Cette page couvre le produit web lui-même :

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 ça marche Idéal pour
Application GitHub Autorisez l'application Claude GitHub lors de l'intégration web. Intégration web ; équipes qui veulent Auto-fix
/web-setup Exécutez /web-setup dans votre terminal pour synchroniser votre jeton CLI gh local vers votre compte Claude. Développeurs individuels qui utilisent déjà gh

L'une ou l'autre méthode fonctionne. Pour savoir comment /schedule vérifie cet accès 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.

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.

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.

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. --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.

Utilisez /tasks dans le Claude Code CLI pour vérifier la progression, ou ouvrez la session sur claude.ai ou l'application mobile Claude pour 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"

Surveillez toutes les sessions avec /tasks dans le Claude Code CLI. 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'est pas connecté à GitHub, Claude Code regroupe votre référentiel local et le télécharge directement vers la session cloud. 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.

Ce fallback s'active automatiquement quand l'accès à GitHub n'est pas disponible. Pour le forcer même quand GitHub est connecté, 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
  • Les sessions créées à partir d'un bundle ne peuvent pas repousser vers un remote à moins que vous ayez également l'authentification GitHub configurée

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.

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é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 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 /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.
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, /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 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 : /effort signale Not applied tandis qu'un effort par défaut au lancement du modèle est en vigueur, et /fast fonctionne 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 compris key=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.

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.

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-pr sur la branche de la PR. Claude Code détecte la PR ouverte avec gh, 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.

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é. 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 référentiel est accessible. Le compte GitHub qui se connecte doit avoir accès au référentiel sur GitHub, soit par l'autorisation de l'application Claude GitHub, soit par un jeton gh synchronisé via /web-setup. L'installation de l'application sur le référentiel n'est pas requise. Consultez Options d'authentification 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 /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

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. 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. GitLab, Bitbucket et les autres référentiels non-GitHub peuvent être envoyés aux sessions cloud en tant que paquet local, mais la session ne peut pas pousser les résultats vers le 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
  • 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