Passer au contenu principal
L’exécution sur votre appareil signifie que l’agent cloud contrôle à distance l’un de vos ordinateurs. Il lit et écrit des fichiers et exécute des commandes sur cet ordinateur, en utilisant son environnement et ses fichiers locaux, avec le même résultat qu’une exécution locale. Dans l’application, cette option s’appelle Run on your device.

Choisir votre appareil ou le serveur cloud

Chaque session définit son mode d’exécution au moment où vous la démarrez. Vous ne pouvez plus le modifier ensuite. Pour les tâches qui doivent continuer après la fermeture de votre ordinateur portable, choisissez le serveur cloud.

Autoriser un ordinateur à exécuter des sessions

1

Se connecter à l'application de bureau sur l'ordinateur

Installez l’application de bureau et connectez-vous avec le même compte. Consultez Télécharger et se connecter. Après la connexion, l’ordinateur rejoint automatiquement votre espace de travail. L’application web n’ajoute pas d’appareil.
2

Ouvrir les détails de la machine

Allez dans Settings › Workspace › Machines et cliquez sur l’ordinateur. La liste indique le système d’exploitation, la version du client et l’état de connexion de chaque machine.
3

Activer Allow execution

Activez Allow execution (désactivé par défaut pour les ordinateurs) et vérifiez dans la boîte de dialogue de confirmation ce qui est assoupli. Une fois activé, ce réglage reste en vigueur pour toutes les futures sessions qui s’exécutent sur cet ordinateur.
4

Ajuster l'autorisation si nécessaire

Définissez l’étendue d’accès, les emplacements sensibles et la limite de permissions. Après l’enregistrement, les modifications s’appliquent immédiatement aux nouvelles sessions.
Liste des machines

Settings › Workspace › Machines

Dans les détails de la machine, vous pouvez ajuster :
  • Étendue d’accès : dossiers de projet uniquement, dossiers sélectionnés ou l’ordinateur entier (par défaut).
  • Sensitive locations (emplacements sensibles) : par exemple SSH, le trousseau et la configuration système. Choisissez Ask each time (par défaut), Block access ou Allow access.
  • Permission limit (limite de permissions) : les permissions des sessions ne peuvent pas la dépasser. Choisissez No limit (par défaut), Approve for me ou Ask for approval.
  • Secrets autorisés : les secrets de l’espace de travail utilisables sur cet ordinateur. Tous par défaut.
  • Environment variable overrides (remplacements de variables d’environnement) : les variables d’environnement à remplacer lors de l’exécution sur cet ordinateur. N’y placez pas de secrets en texte clair.
L’assouplissement de l’autorisation demande une confirmation. Son renforcement n’en demande pas. Lorsque vous désactivez Allow execution, les sessions qui utilisent cet ordinateur sont mises en pause. Les commandes s’exécutent avec les permissions de votre compte sur cet ordinateur.
L’autorisation d’exécution ne peut être modifiée que dans l’application de bureau de cet ordinateur. Les autres appareils et l’application web peuvent uniquement la consulter.

Choisir un appareil pour démarrer une session

1

Ouvrir le menu de l'environnement d'exécution

Au-dessus du champ de saisie de la nouvelle session, cliquez sur le bouton de l’environnement d’exécution à côté du projet.
2

Choisir un appareil

Sous Run on your device, choisissez un ordinateur. Chaque appareil affiche en dessous son étendue d’accès et sa limite de permissions.
3

Envoyer la tâche

Rédigez votre tâche et envoyez-la. Une fois la session démarrée, elle reste sur cet ordinateur.
  • Les projets locaux utilisent par défaut l’ordinateur où se trouve le projet. Tout le reste utilise par défaut le serveur cloud.
  • Un appareil ne peut pas être sélectionné s’il est hors ligne, si Allow execution est désactivé, si le projet ne se trouve pas sur cet appareil ou si l’agent actuel n’est pas Claude Code. Le menu en indique la raison.
  • Après avoir choisi un appareil, les permissions supérieures à sa limite de permissions ne peuvent pas être sélectionnées.
  • Pour passer à un autre ordinateur ou au serveur cloud, démarrez une nouvelle session.
La première fois qu’une session s’exécute sur un ordinateur, si Allow execution n’est pas encore activé ou si le projet n’a pas de dossier correspondant sur cet ordinateur, le client de cet ordinateur vous le signale. Cliquez sur Open Machines & access pour activer Allow execution, ou cliquez sur Allow et choisissez le dossier du projet (le dossier n’est pas synchronisé avec le cloud). Les sessions sans projet utilisent leur propre dossier temporaire.

Confirmer l’accès aux emplacements sensibles

Lorsque les emplacements sensibles sont réglés sur Ask each time, le client de l’appareil d’exécution affiche la raison et le chemin avant que l’agent accède à un emplacement comme la configuration SSH.
  • Allow once : autorise cette fois uniquement, sans modifier l’autorisation de la machine.
  • Deny : refuse l’accès. Si vous ne répondez pas pendant un certain temps, la demande est considérée comme refusée.
  • Respond later : masque temporairement la demande, et la session est signalée dans la barre latérale comme nécessitant votre attention.

Consulter le journal d’exécution

En bas du menu de l’environnement d’exécution, cliquez sur Execution log pour voir les actions de cette session. Dans les détails de la machine, cliquez sur View execution log pour voir les actions de toutes les sessions sur cet ordinateur. Chaque ligne du journal indique ce que l’agent a fait, sur quoi il a agi et le résultat. Dans le client de l’appareil d’exécution, vous pouvez aussi arrêter des processus, vous déconnecter ou vous reconnecter immédiatement. Ailleurs, vous pouvez uniquement consulter.

Que se passe-t-il lorsque l’ordinateur se déconnecte

Lorsque l’ordinateur s’éteint, se met en veille, passe hors ligne ou quitte le client, la tâche en cours est mise en pause. Une fois la connexion rétablie, elle reprend automatiquement là où elle s’était arrêtée, et les actions déjà effectuées ne sont pas répétées. Vous pouvez aussi cliquer sur Reconnect. Sur les autres appareils et dans l’application web, la session est signalée comme ayant son appareil hors ligne. Une session ne passe pas automatiquement sur le serveur cloud lorsque son appareil se déconnecte. Pour les problèmes de connexion, consultez FAQ et dépannage.

Supprimer un appareil

En bas des détails de la machine, cliquez sur Remove device et confirmez.
Après la suppression, l’appareil est immédiatement déconnecté et les sessions qui l’utilisent sont interrompues. Pour réutiliser cet ordinateur plus tard, reconnectez-vous dessus.
Le serveur cloud ne peut pas être supprimé. L’ordinateur que vous utilisez actuellement ne peut pas être supprimé ici ; déconnectez-vous de votre compte pour le supprimer.