Démarrer avec Claude Code dans le cloud

Exécutez Claude Code dans le cloud depuis votre navigateur ou téléphone. Connectez un référentiel GitHub, soumettez une tâche et examinez la PR sans configuration locale.

Une session cloud exécute Claude Code sur l'infrastructure cloud au lieu de votre machine, gérée par Anthropic par défaut. Ce guide de démarrage rapide en lance une depuis claude.ai/code dans votre navigateur. Vous pouvez également en lancer une depuis l'application mobile Claude, l'application Desktop, ou votre terminal avec claude --cloud.

Vous aurez besoin d'un référentiel GitHub pour démarrer. Claude le clone dans une machine virtuelle isolée, effectue des modifications et pousse une branche pour que vous la révisiez. Les sessions persistent sur les appareils, donc une tâche que vous commencez sur votre ordinateur portable est prête à être examinée depuis votre téléphone plus tard.

Les sessions cloud fonctionnent bien pour :

• Tâches parallèles : exécutez plusieurs tâches indépendantes à la fois, chacune dans sa propre session et branche, sans gérer plusieurs worktrees
• Référentiels que vous n'avez pas localement : Claude clone le référentiel à nouveau à chaque session, vous n'avez donc pas besoin de l'avoir extrait
• Tâches qui ne nécessitent pas de direction fréquente : soumettez une tâche bien définie, faites autre chose et examinez le résultat quand Claude a terminé
• Questions de code et exploration : comprenez une base de code ou tracez comment une fonctionnalité est implémentée sans extraction locale

Pour les travaux qui nécessitent votre configuration locale, vos outils ou votre environnement, l'exécution de Claude Code localement ou l'utilisation de Remote Control est plus appropriée.

Comment les sessions s'exécutent

Les étapes ci-dessous décrivent les sessions hébergées par Anthropic. Dans un environnement auto-hébergé, le clone et tout ce qui suit s'exécutent sur les runners de votre organisation, où les limites réseau, la configuration et le comportement de push sont configurés par l'opérateur. Quand vous soumettez une tâche :

1. Clone et préparation : votre référentiel est cloné sur une VM gérée par Anthropic, et votre script de configuration s'exécute s'il est configuré.
2. Configurer le réseau : l'accès à Internet est défini en fonction du niveau d'accès de votre environnement.
3. Travail : Claude analyse le code, effectue des modifications, exécute des tests et vérifie son travail. Vous pouvez regarder et diriger tout au long du processus, ou vous éloigner et revenir quand c'est fait.
4. Pousser la branche : quand Claude atteint un point d'arrêt, il pousse sa branche vers GitHub. Vous examinez le diff, laissez des commentaires en ligne, créez une PR ou envoyez un autre message pour continuer.

La session ne se ferme pas quand la branche est poussée. La création de PR et les modifications supplémentaires se font toutes dans la même conversation.

Comparer les façons d'exécuter Claude Code

Claude Code se comporte de la même manière partout. Ce qui change, c'est où la session s'exécute et si votre configuration locale est disponible :

Consultez la documentation du démarrage rapide du terminal, Application Desktop, ou Remote Control pour configurer les sessions locales.

Connecter GitHub

La connexion à GitHub est une étape unique. Si vous utilisez déjà la CLI GitHub, vous pouvez le faire depuis votre terminal au lieu du navigateur.

Connecter depuis votre terminal

Si vous utilisez déjà la CLI GitHub (gh), vous pouvez connecter GitHub pour les sessions cloud depuis votre terminal. Cela nécessite la CLI Claude Code. Sur les plans Team et Enterprise, /web-setup n'est disponible qu'après qu'un Propriétaire active Configuration web rapide.

Lorsque vous exécutez /web-setup, Claude Code lit le jeton que gh auth token affiche, vous demande de confirmer, et envoie le jeton à Anthropic. Anthropic le stocke chiffré avec votre compte claude.ai, et vos sessions cloud l'utilisent pour l'accès GitHub jusqu'à ce que vous le supprimiez. Une session cloud que vous démarrez vous-même peut alors accéder à n'importe quel référentiel que ce jeton peut accéder, sans installation de l'application Claude GitHub. Les threads dans un projet ont toujours besoin de l'application Claude GitHub.

Si vous avez déjà connecté GitHub dans le navigateur, /web-setup vous avertit que continuer remplace cette connexion pour vos sessions cloud.

gh auth login

/web-setup

Supprimer le jeton `/web-setup`

Pour supprimer le jeton de votre compte Claude, déconnectez GitHub dans claude.ai/customize/connectors. La déconnexion supprime les identifiants GitHub que vos sessions cloud utilisent, qu'ils proviennent du navigateur ou de /web-setup, donc les sessions cloud perdent l'accès GitHub jusqu'à ce que vous vous reconnectiez. Votre gh local reste connecté, et le jeton reste valide sur GitHub.

Pour invalider le jeton lui-même, révoquez-le sur GitHub. Si vous vous êtes connecté à gh via le navigateur, le jeton appartient à l'entrée GitHub CLI sous Paramètres > Applications > Applications OAuth autorisées sur GitHub, et révoquer cette entrée déconnecte également la CLI GitHub sur vos machines. Les sessions cloud perdent alors l'accès GitHub jusqu'à ce que vous exécutiez gh auth login et /web-setup à nouveau.

Démarrer une tâche

Avec GitHub connecté et un environnement créé, vous êtes prêt à soumettre des tâches.

Pré-remplir les sessions

Vous pouvez pré-remplir l'invite, les référentiels et l'environnement pour une nouvelle session en ajoutant des paramètres de requête à l'URL claude.ai/code. Utilisez ceci pour créer des intégrations telles qu'un bouton dans votre suivi de problèmes qui ouvre Claude Code avec la description du problème comme invite.

Encodez en URL chaque valeur. L'exemple ci-dessous ouvre le formulaire avec une invite et un référentiel déjà sélectionnés :

https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp

Examiner et itérer

Quand Claude a terminé, examinez les modifications, laissez des commentaires sur des lignes spécifiques et continuez jusqu'à ce que le diff soit correct.

Dépanner la configuration

Aucun référentiel n'apparaît après la connexion à GitHub

Si vous avez connecté GitHub dans le navigateur, les sessions peuvent cloner n'importe quel référentiel public, mais un référentiel privé n'apparaît que lorsque l'application Claude GitHub est installée sur le compte ou l'organisation qui le possède et que l'accès aux référentiels de l'installation l'inclut. Installez l'application Claude GitHub là, ou demandez à un propriétaire d'organisation de l'installer ou de l'approuver.

Si vous avez connecté avec /web-setup, les sessions accèdent à chaque référentiel que votre jeton gh peut accéder. Exécutez gh repo view OWNER/REPO dans votre shell pour vérifier que votre connexion CLI GitHub peut voir le référentiel, et exécutez /web-setup à nouveau si vous avez changé de compte gh depuis la connexion.

La page affiche uniquement un bouton de connexion GitHub

Les sessions cloud nécessitent un compte GitHub connecté. Connectez-vous via le flux du navigateur ci-dessus, ou exécutez /web-setup depuis votre terminal si vous utilisez la CLI GitHub. Si vous préférez ne pas connecter GitHub du tout, consultez Remote Control pour exécuter Claude Code sur votre propre machine et le surveiller depuis votre navigateur ou votre téléphone.

« Non disponible pour l'organisation sélectionnée »

Les organisations Enterprise peuvent avoir besoin qu'un propriétaire active les sessions cloud. Contactez votre équipe de compte Anthropic.

`/web-setup` indique « Non connecté à Claude »

Si /web-setup répond avec « Not signed in to Claude. Run /login first. », la CLI n'a pas de connexion claude.ai valide. Cela peut également se produire quand une connexion précédente a expiré. Exécutez /login, connectez-vous avec votre compte claude.ai, puis exécutez /web-setup à nouveau.

`/web-setup` avertit que votre jeton n'a pas la portée `workflow`

Si /web-setup indique que votre jeton CLI GitHub n'a pas la portée workflow, vous pouvez continuer, mais GitHub peut rejeter certains envois effectués avec ce jeton, comme les envois qui modifient les fichiers de flux de travail GitHub Actions. Pour ajouter la portée, exécutez gh auth refresh -s workflow dans votre shell, puis exécutez /web-setup à nouveau.

`/web-setup` affiche « Aucune commande ne correspond » ou « Commande inconnue »

/web-setup s'exécute à l'intérieur de la CLI Claude Code, pas votre shell. Lancez claude d'abord, puis tapez /web-setup à l'invite.

Si vous l'avez tapé à l'intérieur de Claude Code et le menu de commandes affiche No commands match "/web-setup", ou que le soumettre retourne Unknown command: /web-setup, la commande est masquée parce qu'une exigence n'est pas satisfaite. La cause est généralement que vous êtes authentifié avec une clé API ou un fournisseur tiers au lieu d'un abonnement claude.ai. Exécutez /login pour vous connecter avec votre compte claude.ai.

Sur les plans Team et Enterprise, la commande est masquée par défaut : le commutateur de configuration web rapide est désactivé jusqu'à ce qu'un propriétaire l'active. Pendant qu'il est désactivé, connectez GitHub depuis le navigateur à la place.

La commande est également masquée dans deux autres cas :

• Un administrateur a désactivé les sessions cloud pour votre organisation. Dans ce cas, soumettre /web-setup retourne Cloud sessions are disabled by your organization's policy. Avant la v2.1.268, ce cas retournait également Unknown command: /web-setup.
• Votre organisation Enterprise a Zero Data Retention activé, ce qui rend les sessions cloud indisponibles.

« Impossible de créer un environnement cloud » ou « Aucun environnement cloud disponible » lors de l'utilisation de `--cloud`

Les fonctionnalités de session cloud créent automatiquement un environnement cloud par défaut si vous n'en avez pas. Si vous voyez « Impossible de créer un environnement cloud », la création automatique a échoué. Si vous voyez « Aucun environnement cloud disponible », votre CLI est antérieur à la création automatique. Dans les deux cas, exécutez /web-setup dans la CLI Claude Code, ou ajoutez un environnement à partir du sélecteur d'environnement sur claude.ai/code.

Le script de configuration a échoué

Le script de configuration s'est terminé avec un statut non-zéro, ce qui bloque le démarrage de la session. Les causes courantes :

• Une installation de paquet a échoué parce que le registre n'est pas dans votre niveau d'accès réseau. Trusted couvre la plupart des gestionnaires de paquets ; None les bloque tous.
• Le script fait référence à un fichier ou un chemin qui n'existe pas dans un clone frais.
• Une commande qui fonctionne localement a besoin d'une invocation différente sur Ubuntu.

Pour déboguer, ajoutez set -x en haut du script pour voir quelle commande a échoué. Pour les commandes non critiques, ajoutez || true pour qu'elles ne bloquent pas le démarrage de la session.

Les nouvelles sessions se figent ou expirent pendant la configuration

Si les nouvelles sessions se figent à l'étape du script de configuration ou échouent avec une erreur de conteneur générique avant la fin du script, le script dépasse probablement le budget de temps d'environ cinq minutes pour construire le cache d'environnement. Les étapes lourdes telles que l'extraction d'images Docker volumineuses, la synchronisation d'arbres de dépendances complets ou le téléchargement de poids de modèles dépassent souvent la limite, surtout quand elles s'exécutent l'une après l'autre.

Pour corriger cela, réduisez le script pour qu'il se termine de manière fiable en moins de cinq minutes :

• Exécutez les installations indépendantes en parallèle avec & et un wait final au lieu de les exécuter en série.
• Déplacez les plus grands téléchargements hors du script de configuration et dans un hook SessionStart qui les lance en arrière-plan, pour que la session devienne utilisable pendant qu'ils se terminent.
• Supprimez les longs délais de nouvelle tentative du script de configuration, car une boucle de nouvelle tentative figée compte dans le budget.

La session continue de s'exécuter après la fermeture de l'onglet

C'est intentionnel. Fermer l'onglet ou naviguer ailleurs n'arrête pas la session. Elle continue de s'exécuter en arrière-plan jusqu'à ce que Claude termine la tâche actuelle, puis elle reste inactive. Depuis la barre latérale, vous pouvez archiver une session pour la masquer de votre liste, ou la supprimer pour la supprimer définitivement.

Étapes suivantes

Maintenant que vous pouvez soumettre et examiner des tâches, ces pages couvrent ce qui vient ensuite : démarrer des sessions cloud depuis votre terminal, planifier des travaux récurrents et donner à Claude des instructions permanentes.

• Utiliser Claude Code sur le web : la référence complète, y compris la téléportation de sessions vers votre terminal, le partage de sessions et la correction automatique des demandes de tirage
• Configurer les environnements cloud : niveaux d'accès réseau, variables d'environnement et scripts de configuration pour les sessions cloud
• Routines : automatisez le travail selon un calendrier, via un appel API ou en réponse aux événements GitHub
• CLAUDE.md : donnez à Claude des instructions et un contexte persistants qui se chargent au début de chaque session
• Installez l'application mobile Claude pour iOS ou Android pour surveiller les sessions depuis votre téléphone. Depuis la CLI Claude Code, /mobile affiche un code QR pour claude.ai/mobile qui ouvre le bon app store pour votre téléphone.