46 46
47Avant d'envoyer votre premier message, configurez quatre choses dans la zone de prompt :47Avant d'envoyer votre premier message, configurez quatre choses dans la zone de prompt :
48 48
49* **Environnement** : choisissez où Claude s'exécute. Sélectionnez **Local** pour votre machine, **Cloud** pour une [session cloud](#cloud-sessions) qui continue après la fermeture de l'application, une [**connexion SSH**](#ssh-sessions) pour une machine distante que vous gérez, ou sur Windows une [**distribution WSL**](/docs/fr/desktop-wsl). Voir [configuration de l'environnement](#environment-configuration).49* **Environnement** : choisissez où Claude s'exécute. Sélectionnez **Local** pour votre machine, **Cloud** pour une [session cloud](#cloud-sessions) qui continue après la fermeture de l'application, une [**connexion SSH**](#ssh-sessions) pour une machine distante que vous gérez, ou sur Windows une [**distribution WSL**](/docs/fr/desktop-wsl). Une tâche dans une session SSH peut [continuer pendant que Desktop est déconnecté](#keep-a-task-running-while-desktop-is-disconnected), mais avec un compte Claude, elle peut s'arrêter lorsque sa connexion expire. Voir [configuration de l'environnement](#environment-configuration).
50* **Dossier du projet** : sélectionnez le dossier ou le référentiel dans lequel Claude travaille. Pour les sessions cloud, vous pouvez ajouter [plusieurs référentiels](#run-long-running-tasks-in-the-cloud).50* **Dossier du projet** : sélectionnez le dossier ou le référentiel dans lequel Claude travaille. Pour les sessions cloud, vous pouvez ajouter [plusieurs référentiels](#run-long-running-tasks-in-the-cloud).
51* **Modèle** : choisissez un [modèle](/docs/fr/model-config#available-models) dans la liste déroulante à côté du bouton d'envoi. Vous pouvez modifier ceci pendant la session.51* **Modèle** : choisissez un [modèle](/docs/fr/model-config#available-models) dans la liste déroulante à côté du bouton d'envoi. Vous pouvez modifier ceci pendant la session.
52* **Mode de permission** : choisissez le niveau d'autonomie de Claude à partir du [sélecteur de mode](#choose-a-permission-mode). Vous pouvez modifier ceci pendant la session.52* **Mode de permission** : choisissez le niveau d'autonomie de Claude à partir du [sélecteur de mode](#choose-a-permission-mode). Vous pouvez modifier ceci pendant la session.
236 Exécuter les commandes dans le terminal236 Exécuter les commandes dans le terminal
237</h3>237</h3>
238 238
239Le terminal intégré vous permet d'exécuter les commandes aux côtés de votre session sans basculer vers une autre application. Cliquez sur **Terminal** dans la barre de titre de la session ou appuyez sur **Ctrl+\`** sur macOS ou Windows. Le terminal s'ouvre dans le répertoire de travail de votre session et partage le même environnement que Claude, donc les commandes comme `npm test` ou `git status` voient les mêmes fichiers que Claude édite. Pour ouvrir un deuxième onglet de terminal, cliquez sur **+** dans l'en-tête du volet de terminal ou cliquez avec le bouton droit sur un dossier dans le chat pour choisir **Ouvrir dans le terminal**. Le terminal est disponible dans les sessions locales et [SSH](#ssh-sessions).239Le terminal intégré vous permet d'exécuter les commandes aux côtés de votre session sans basculer vers une autre application. Cliquez sur **Terminal** dans la barre de titre de la session ou appuyez sur **Ctrl+\`** sur macOS ou Windows. Le terminal s'ouvre dans le répertoire de travail de votre session et partage le même environnement que Claude, donc les commandes comme `npm test` ou `git status` voient les mêmes fichiers que Claude édite. Pour ouvrir un deuxième onglet de terminal, cliquez sur **+** dans l'en-tête du volet de terminal ou cliquez avec le bouton droit sur un dossier dans le chat pour choisir **Ouvrir dans le terminal**.
240
241Le terminal est disponible dans les sessions locales et [SSH](#ssh-sessions), avec une limitation sur les [machines distantes Windows](#windows-remote-machines).
240 242
241<h3 id="open-and-edit-files">243<h3 id="open-and-edit-files">
242 Ouvrir et modifier les fichiers244 Ouvrir et modifier les fichiers
468 470
469Voir [Utiliser Claude Code dans le cloud](/docs/fr/claude-code-on-the-web) pour plus d'informations sur le fonctionnement des sessions cloud. Quand un corps de travail nécessite de nombreuses sessions cloud, sélectionnez **Projets** dans la barre latérale pour créer un [projet](/docs/fr/claude-projects), où Claude démarre et suit les sessions pour vous à partir d'une conversation.471Voir [Utiliser Claude Code dans le cloud](/docs/fr/claude-code-on-the-web) pour plus d'informations sur le fonctionnement des sessions cloud. Quand un corps de travail nécessite de nombreuses sessions cloud, sélectionnez **Projets** dans la barre latérale pour créer un [projet](/docs/fr/claude-projects), où Claude démarre et suit les sessions pour vous à partir d'une conversation.
470 472
473<Note>
474 Une tâche dans une [session SSH](#ssh-sessions) peut également [continuer pendant que Desktop est déconnecté](#keep-a-task-running-while-desktop-is-disconnected), mais avec un compte Claude, elle peut s'arrêter lorsque sa connexion expire.
475</Note>
476
471<h3 id="continue-in-another-surface">477<h3 id="continue-in-another-surface">
472 Continuer sur une autre surface478 Continuer sur une autre surface
473</h3>479</h3>
772 778
773* **Local** : s'exécute sur votre machine avec accès direct à vos fichiers779* **Local** : s'exécute sur votre machine avec accès direct à vos fichiers
774* **Cloud** : s'exécute sur l'infrastructure gérée par Anthropic par défaut. Les sessions continuent même si vous fermez l'application.780* **Cloud** : s'exécute sur l'infrastructure gérée par Anthropic par défaut. Les sessions continuent même si vous fermez l'application.
775* **SSH** : s'exécute sur une machine distante à laquelle vous vous connectez via SSH, comme vos propres serveurs, des machines virtuelles cloud ou des conteneurs de développement781* **SSH** : s'exécute sur une machine distante à laquelle vous vous connectez via SSH, comme vos propres serveurs, des machines virtuelles cloud ou des conteneurs de développement. Une tâche en cours peut [continuer pendant que Desktop est déconnecté](#keep-a-task-running-while-desktop-is-disconnected), mais avec un compte Claude, elle peut s'arrêter lorsque son authentification expire.
776* **WSL** (Windows) : s'exécute à l'intérieur d'une [distribution WSL 2](/docs/fr/desktop-wsl) sur votre machine, en utilisant sa chaîne d'outils Linux et ses chemins natifs782* **WSL** (Windows) : s'exécute à l'intérieur d'une [distribution WSL 2](/docs/fr/desktop-wsl) sur votre machine, en utilisant sa chaîne d'outils Linux et ses chemins natifs
777 783
778<h3 id="local-sessions">784<h3 id="local-sessions">
812 818
813Les sessions SSH vous permettent d'exécuter Claude Code sur une machine distante tout en utilisant l'application de bureau comme votre interface. Ceci est utile pour travailler avec des bases de code qui vivent sur des machines virtuelles cloud, des conteneurs de développement ou des serveurs avec du matériel ou des dépendances spécifiques.819Les sessions SSH vous permettent d'exécuter Claude Code sur une machine distante tout en utilisant l'application de bureau comme votre interface. Ceci est utile pour travailler avec des bases de code qui vivent sur des machines virtuelles cloud, des conteneurs de développement ou des serveurs avec du matériel ou des dépendances spécifiques.
814 820
821<Note>
822 Si vous utilisez Desktop avec un [fournisseur tiers](/docs/fr/third-party-integrations), les sessions SSH nécessitent leur propre configuration. Voir [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
823</Note>
824
815Pour ajouter une connexion SSH, ouvrez la liste déroulante d'environnement dans la zone de prompt avant de démarrer une session, puis sélectionnez **SSH > Ajouter une connexion SSH…** et renseignez les détails de la connexion :825Pour ajouter une connexion SSH, ouvrez la liste déroulante d'environnement dans la zone de prompt avant de démarrer une session, puis sélectionnez **SSH > Ajouter une connexion SSH…** et renseignez les détails de la connexion :
816 826
817* **Nom** : une étiquette conviviale pour cette connexion827* **Nom** : une étiquette conviviale pour cette connexion
822 832
823Une fois ajoutée, la connexion apparaît sous **SSH** dans la liste déroulante d'environnement. Sélectionnez-la pour démarrer une session sur cette machine. Claude s'exécute sur la machine distante avec accès à ses fichiers et outils.833Une fois ajoutée, la connexion apparaît sous **SSH** dans la liste déroulante d'environnement. Sélectionnez-la pour démarrer une session sur cette machine. Claude s'exécute sur la machine distante avec accès à ses fichiers et outils.
824 834
825La machine distante doit exécuter Linux ou macOS. Desktop installe Claude Code sur la machine distante automatiquement la première fois que vous vous connectez. Une fois connecté, les sessions SSH supportent les modes de permission, les connecteurs, les plugins et les serveurs MCP.835La machine distante peut exécuter Linux, macOS ou [Windows](#windows-remote-machines). Desktop installe Claude Code sur la machine distante automatiquement la première fois que vous vous connectez. Une fois connecté, les sessions SSH supportent les modes de permission, les connecteurs, les plugins et les serveurs MCP.
836
837<h4 id="remote-machine-requirements-for-ssh-sessions">
838 Exigences de la machine distante pour les sessions SSH
839</h4>
840
841Une machine distante Linux ou macOS nécessite un processeur pris en charge, un serveur SSH avec SFTP, un dossier d'installation qui n'est pas monté en `noexec`, un shell fonctionnel et un accès réseau. Vérifiez chaque exigence avant de vous connecter, ou lorsqu'une connexion échoue après votre authentification :
842
843* **Système** : un processeur x86\_64 ou arm64. La machine doit également satisfaire la [configuration système requise](/docs/fr/setup#system-requirements) de Claude Code.
844* **SFTP** : le serveur SSH doit proposer le sous-système SFTP, qu'une ligne `Subsystem sftp` dans son `sshd_config` active. Pour vérifier, connectez-vous au même hôte et au même port avec `sftp` dans un terminal sur votre ordinateur. Un serveur fonctionnel affiche l'invite `sftp>`.
845* **Sessions par connexion** : Desktop sur macOS et Linux ouvre plusieurs sessions sur une même connexion SSH. Si le `sshd_config` du serveur définit `MaxSessions 1`, augmentez cette valeur, par exemple à la valeur par défaut d'OpenSSH, 10.
846* **Dossier d'installation** : Desktop installe un programme auxiliaire et Claude Code sous `~/.claude/remote/` dans votre répertoire personnel. Il les exécute depuis cet emplacement, donc ce dossier ne peut pas se trouver sur un système de fichiers monté en `noexec`. Prévoyez environ 1 Go d'espace disque dans le répertoire personnel de chaque utilisateur qui se connecte.
847* **Shell** : le shell défini pour votre compte sur la machine distante doit exécuter les commandes envoyées via SSH, comme le font Bash, Zsh et `sh`
848* **Réseau** : Claude Code s'exécute sur la machine distante et effectue ses requêtes réseau depuis celle-ci ; la machine a donc besoin de l'[accès réseau requis par Claude Code](/docs/fr/network-config#network-access-requirements). Si la machine ne peut pas télécharger Claude Code, Desktop le télécharge sur votre ordinateur et le transfère. Les autres requêtes de Claude Code partent toujours de la machine distante.
849
850<h4 id="use-your-ssh-configuration-on-macos-and-linux">
851 Utiliser votre configuration SSH sur macOS et Linux
852</h4>
853
854Sur macOS et Linux, Desktop se connecte en exécutant le client OpenSSH sur votre ordinateur ; il utilise donc votre `~/.ssh/config`. La connexion via le client OpenSSH nécessite Claude Desktop v1.37937.0 ou une version ultérieure. Saisissez un nom `Host` de ce fichier dans le champ **Hôte SSH** pour utiliser les paramètres de son entrée, comme `HostName`, `User`, `IdentityFile`, `CertificateFile`, `ProxyJump` et `ProxyCommand`.
855
856Avant d'ajouter la connexion, vérifiez le client et l'entrée dans un terminal sur votre ordinateur :
857
858* **Version du client** : exécutez `ssh -V`. Le client doit être OpenSSH 7.6 ou une version ultérieure.
859* **Entrée** : exécutez `ssh` avec le nom `Host`, comme `ssh devbox`. Si cela échoue, corrigez d'abord l'entrée.
860
861Vous pouvez laisser les champs **Port SSH** et **Clé SSH (facultatif)** vides. Si vous en renseignez un, Desktop l'utilise avec l'entrée :
862
863* **Port SSH** : une valeur ici remplace le `Port` de l'entrée
864* **Clé SSH (facultatif)** : Desktop propose le fichier de clé que vous choisissez en plus de l'`IdentityFile` de l'entrée et des clés de votre agent SSH
865
866<h5 id="reach-a-machine-behind-a-jump-host">
867 Atteindre une machine derrière un hôte de rebond
868</h5>
869
870Pour atteindre une machine derrière un hôte de rebond, également appelé bastion, définissez `ProxyJump` ou `ProxyCommand` dans l'entrée. L'entrée suivante atteint `devbox.internal.example.com` via `bastion.example.com` :
871
872```text ~/.ssh/config theme={null}
873Host devbox
874 HostName devbox.internal.example.com
875 User alice
876 ProxyJump bastion.example.com
877```
878
879Saisissez `devbox` dans le champ **Hôte SSH**.
880
881<h5 id="raise-the-ssh-connection-timeout">
882 Augmenter le délai d'expiration de la connexion SSH
883</h5>
884
885Si votre configuration SSH ne définit aucun `ConnectTimeout` pour l'hôte, Desktop accorde 30 secondes à `ssh` pour se connecter. Via un hôte de rebond ou un `ProxyCommand`, ce délai inclut le temps nécessaire à l'établissement de la route. Si votre route a besoin de plus de temps, ajoutez une valeur plus élevée à l'entrée :
886
887```text ~/.ssh/config theme={null}
888Host devbox
889 HostName devbox.internal.example.com
890 User alice
891 ProxyJump bastion.example.com
892 ConnectTimeout 120
893```
894
895`ssh` utilise la première valeur qu'il trouve pour un hôte ; placez donc l'entrée au-dessus de toute entrée `Host *` qui définit `ConnectTimeout`. Pour confirmer, exécutez `ssh -G devbox` dans un terminal sur votre ordinateur. Sa sortie inclut `connecttimeout 120`. Après avoir modifié la valeur, quittez et rouvrez Desktop.
896
897<h4 id="windows-remote-machines">
898 Machines distantes Windows
899</h4>
900
901Une machine distante Windows nécessite Claude Desktop v2.31226.0 ou une version ultérieure.
902
903Utilisez le serveur OpenSSH de Microsoft. La machine peut être x64 ou ARM64. Le shell que démarre le serveur SSH peut être `cmd.exe`, Windows PowerShell 5.1 ou Git Bash.
904
905Les machines distantes Windows sont moins testées que les machines Linux. Essayez votre propre travail dessus avant de vous y fier.
906
907Attendez-vous notamment à ces limites sur une machine distante Windows :
908
909* **Terminal** : le [terminal](#run-commands-in-the-terminal) ne s'ouvre pas dans une session dont le dossier est un chemin Windows, comme `C:/projects/app`
910* **Sandbox** : Claude Code s'y exécute sur Windows natif, où il exécute les commandes hors sandbox. Voir [où le sandbox s'exécute](/docs/fr/sandboxing).
911* **Plugins** : Desktop ne copie pas un plugin qui contient un nom de fichier ou de dossier que Windows ne peut pas stocker, comme un nom avec `:`. La session liste les plugins que Desktop a laissés de côté.
912* **Serveurs MCP** : sur certaines machines distantes Windows, les appels de Claude aux serveurs MCP de `claude_desktop_config.json` passent par Desktop ; Claude ne peut donc pas appeler leurs outils [pendant que Desktop est déconnecté](#limits-while-desktop-is-disconnected). Avant Claude Desktop v2.37337.0, cela vaut pour toutes les machines distantes Windows.
913* **Worktrees** : les worktrees vont dans `<project-root>/.claude/worktrees/`. Si vous [choisissez un autre dossier](#choose-where-ssh-session-worktrees-go), Desktop l'ignore.
914* **Messages précédents** : si le shell du serveur SSH est `cmd.exe` ou Windows PowerShell, vous devrez peut-être vous connecter avant de voir les messages précédents d'une session
915* **Forks** : si le shell du serveur SSH est `cmd.exe` ou Windows PowerShell, vous ne pouvez forker une session qu'à son premier message
916* **Exécution pendant la déconnexion** : une tâche [continue de s'exécuter pendant que Desktop est déconnecté](#keep-a-task-running-while-desktop-is-disconnected) uniquement si le serveur SSH permet à un programme de survivre à la connexion qui l'a démarré. Pour le savoir, [testez la machine distante](#prepare-a-long-task).
917* **Processus résiduels** : après la fin d'une session, vérifiez sur la machine les programmes que Claude Code a démarrés, car ils peuvent continuer à s'exécuter. Le [programme auxiliaire d'arrière-plan](#keep-a-task-running-while-desktop-is-disconnected) que Desktop installe ne s'arrête pas de lui-même sur cette machine.
918
919<h4 id="keep-a-task-running-while-desktop-is-disconnected">
920 Garder une tâche en cours d'exécution pendant que Desktop est déconnecté
921</h4>
922
923Si votre ordinateur se met en veille, si vous perdez le réseau ou si vous quittez Desktop, la tâche continue jusqu'à ce qu'elle se termine, ait besoin de vous ou atteigne l'une des [limites](#limits-while-desktop-is-disconnected). Fermer le capot compte comme une mise en veille. Un redémarrage de Desktop ou de votre ordinateur, y compris pour une mise à jour, compte comme le fait de quitter Desktop.
924
925Claude Code s'exécute en tant que processus sur la machine distante, sous un programme auxiliaire d'arrière-plan que Desktop y installe ; il n'a donc pas besoin de votre connexion SSH pour continuer à s'exécuter. Le comportement décrit dans cette section nécessite Claude Desktop v2.31226.0 ou une version ultérieure.
926
927<Warning>
928 Si vous vous connectez à Desktop avec un compte Claude, ne comptez pas sur une tâche pour s'exécuter toute la nuit. Desktop renouvelle cette authentification pour la tâche uniquement tant que Desktop est en cours d'exécution et connecté ; l'authentification de la tâche peut donc expirer après votre déconnexion, et la tâche s'arrête alors. Le temps restant au moment de votre déconnexion varie.
929
930 Le travail effectué jusque-là reste sur la machine distante, et vous pouvez reprendre avec un message à votre retour.
931
932 Si la tâche doit s'exécuter toute la nuit :
933
934 * [Gardez votre ordinateur éveillé](/docs/fr/desktop-scheduled-tasks#how-scheduled-tasks-run) et en ligne, avec le capot ouvert et Desktop en cours d'exécution
935 * Utilisez une méthode de connexion qui fonctionne sans invite, comme une clé détenue par votre agent SSH, pour la machine distante et pour tout hôte de rebond sur le chemin. Desktop peut alors se reconnecter de lui-même après une coupure.
936
937 Pour une tâche qui doit s'exécuter pendant que votre ordinateur est en veille ou éteint, démarrez plutôt une [session cloud](#run-long-running-tasks-in-the-cloud).
938</Warning>
939
940* **Après une mise en veille ou une perte réseau** : vous récupérez la tâche en cours si le processus [s'exécute toujours](#limits-while-desktop-is-disconnected) et si Desktop peut se connecter sans invite. Sinon, [envoyez un message](#reconnect-after-sleep-or-a-network-loss).
941* **Après avoir quitté Desktop, avec Desktop sur macOS ou Linux et un compte Claude** : vous récupérez la tâche en cours si Desktop peut [rejoindre le processus](#reopen-a-session-after-you-quit-desktop). Sinon, la tâche s'arrête. Si elle reste arrêtée, envoyez un message.
942* **Après avoir quitté Desktop, avec Desktop sur Windows ou un [fournisseur tiers](/docs/fr/third-party-integrations)** : vous perdez la tâche en cours, car Desktop met fin au processus à l'ouverture de la session. Envoyez un message pour continuer.
943
944Lorsque vous revenez et que la tâche n'est pas terminée, recherchez une indication que Desktop ne peut pas se reconnecter, une erreur d'authentification ou une demande en attente :
945
946* **Desktop ne peut pas se reconnecter** : la session indique pourquoi, et une notification peut aussi l'indiquer. Desktop peut [avoir besoin que vous vous connectiez](#reconnect-after-sleep-or-a-network-loss).
947* **Erreur d'authentification** : le [jeton de connexion ou les identifiants](#limits-while-desktop-is-disconnected) ont peut-être expiré. Avec un compte Claude, envoyez un message pour continuer. Avec un fournisseur tiers, voir [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
948* **Demande en attente** : [répondez-y](#handle-requests-that-arrive-while-you-are-away)
949* **Aucun de ces cas** : envoyez un message pour continuer
950
951<a id="prepare-a-long-task" />
952
953<h5 id="prepare-a-long-task">
954 Préparer une tâche longue
955</h5>
956
957* **Mettez à jour d'abord** : mettez à jour Desktop avant de démarrer une tâche longue. Sur macOS et Windows, Desktop peut redémarrer de lui-même pour installer une mise à jour qu'il a téléchargée. Ce redémarrage attend pendant que Claude travaille sur une tâche SSH. Sur macOS avec un compte Claude, par défaut, le redémarrage peut quand même avoir lieu une fois que la mise à jour a attendu 72 heures.
958* **Ne quittez pas Desktop** : si Desktop s'exécute sur Windows ou utilise un fournisseur tiers, laissez-le ouvert pendant l'exécution de la tâche longue. Après avoir été quitté, il [met fin à la tâche en cours](#reopen-a-session-after-you-quit-desktop) à l'ouverture de la session. Le laisser ouvert ne protège pas une demande qui [vous attend](#handle-requests-that-arrive-while-you-are-away).
959* **Réduisez les demandes** : choisissez un mode de permission, des règles ou des hooks qui [font que la tâche vous attend moins souvent](#handle-requests-that-arrive-while-you-are-away)
960* **Vérifiez l'hôte de rebond** : si votre hôte de rebond demande une authentification, par exemple une notification push sur un téléphone, passez à une méthode de connexion qui fonctionne sans invite. Sinon, Desktop peut envoyer une nouvelle notification push à chaque tentative de reconnexion.
961* **Testez la machine distante** : démarrez une tâche courte, quittez Desktop pendant que la tâche s'exécute encore, et rouvrez la session bien après le moment où la tâche devrait être terminée. Si la tâche n'est pas terminée et que la session n'affiche aucune erreur d'authentification, vérifiez sur la machine distante [ce qui peut mettre fin à une tâche](#limits-while-desktop-is-disconnected).
962* **Gardez les commandes hors du terminal de Desktop** : si la machine distante [déconnecte les terminaux inactifs](#limits-while-desktop-is-disconnected), exécutez vos propres commandes depuis une connexion SSH en dehors de Desktop
963
964<a id="limits-while-desktop-is-disconnected" />
965
966<h5 id="limits-while-desktop-is-disconnected">
967 Limites pendant que Desktop est déconnecté
968</h5>
969
970Une tâche que vous laissez s'exécuter peut se terminer lorsque son authentification expire, lorsque la machine distante y met fin, ou lorsque le programme auxiliaire s'arrête ou est remplacé :
971
972* **Jeton de connexion ou identifiants** : avec un compte Claude, la tâche s'arrête avec une erreur d'authentification lorsque le jeton expire. Avec un fournisseur tiers, il en va de même pour des identifiants qui expirent, comme ceux issus de l'authentification unique ou d'un credential helper. Voir [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions). Avec un compte Claude, [gardez Desktop en cours d'exécution et connecté](#keep-a-task-running-while-desktop-is-disconnected) afin qu'il puisse renouveler l'authentification.
973* **La machine distante** : si la machine distante redémarre, ou met fin à vos processus lorsque votre connexion SSH se ferme, la tâche en cours se termine. Rien ne la redémarre pendant que Desktop est déconnecté. Les machines Linux où le `KillUserProcesses` de systemd-logind vaut `yes` et s'applique à votre utilisateur mettent fin à vos processus de cette manière. Pour y garder une tâche en cours d'exécution, demandez à l'administrateur d'exempter votre utilisateur, par exemple avec `KillExcludeUsers`.
974* **Terminaux inactifs** : certaines machines distantes Linux déconnectent un terminal dans lequel personne ne tape pendant une durée définie (`StopIdleSessionSec` de systemd-logind). Avec Desktop sur macOS ou Linux, le [terminal](#run-commands-in-the-terminal) d'une session et les commandes `!` partagent par défaut la connexion SSH de Desktop. Cette déconnexion met alors fin à la connexion pendant que Desktop est connecté, et la tâche en cours peut se terminer avec elle. Fermer le panneau du terminal ne l'empêche pas ; [gardez donc les commandes hors de ce terminal](#prepare-a-long-task).
975* **Mises à jour de Desktop** : si une mise à jour apporte un nouveau programme auxiliaire, Desktop remplace le programme auxiliaire sur la machine distante lors d'une connexion ultérieure, ce qui peut mettre fin à une tâche encore en cours
976* **Absences prolongées** : sur une machine distante Linux ou macOS, si Desktop ne se connecte pas pendant 30 jours, le programme auxiliaire s'arrête et met fin à chaque processus Claude Code qui s'exécute sous lui. Connectez-vous avant cette échéance.
977
978Les modifications de fichiers et certains outils peuvent échouer pendant que Desktop est déconnecté. Si la tâche en a besoin, gardez Desktop connecté :
979
980* **Worktrees** : dans une session qui utilise un [worktree](#work-in-parallel-with-sessions), Desktop vérifie chaque modification de fichier avant que Claude ne l'effectue. Pendant que Desktop est déconnecté, chaque modification attend environ 30 secondes puis échoue. Les commandes shell s'exécutent toujours. Sur une machine distante Linux ou macOS, [les modifications peuvent continuer à fonctionner](#worktree-edits-while-disconnected). En cas de doute, démarrez la session sans worktree.
981* **Restrictions de dossiers** : si votre organisation restreint les dossiers que les sessions peuvent utiliser, Desktop vérifie chaque lecture, recherche et modification de fichier, avec ou sans worktree. Pendant que Desktop est déconnecté, chacune attend jusqu'à 10 minutes puis échoue.
982* **Connecteurs** : les [connecteurs](#connect-external-tools) et les autres outils fournis par Desktop passent par Desktop ; pendant qu'il est déconnecté, chaque appel échoue donc après environ 30 secondes
983* **Workflows** : Desktop vérifie chaque nouveau [workflow](/docs/fr/workflows) avant son démarrage ; pendant que Desktop est déconnecté, un nouveau workflow attend donc jusqu'à 10 minutes puis échoue
984* **Serveurs MCP** : les serveurs MCP que Claude Code démarre sur la machine distante ne passent pas par Desktop ; Claude peut donc toujours appeler leurs outils. Les serveurs de `claude_desktop_config.json` en font partie uniquement si Desktop n'utilise pas son [client SSH intégré](#worktree-edits-while-disconnected). Sinon, et sur [certaines machines distantes Windows](#windows-remote-machines), Claude ne peut pas appeler leurs outils pendant que Desktop est déconnecté.
985
986<span id="worktree-edits-while-disconnected" />
987
988<Accordion title="Quand les modifications dans un worktree continuent de fonctionner">
989 Sur une machine distante Linux ou macOS, la vérification ne passe pas par Desktop ; les modifications à l'intérieur du worktree continuent donc de fonctionner pendant que Desktop est déconnecté. Avant Claude Desktop v2.37337.0, cela vaut uniquement sur une machine distante Linux.
990
991 Les modifications échouent encore dans certains cas, notamment ceux-ci :
992
993 * **Client SSH intégré** : Desktop l'utilise, par exemple dans une installation Microsoft Store, sur un ordinateur Windows sans OpenSSH 9.4 ou version ultérieure de Microsoft, ou par défaut sur Windows avec un fournisseur tiers
994 * **Emplacement du dépôt** : le dépôt est votre répertoire personnel, un dossier au-dessus de celui-ci, ou `~/.claude`
995 * **Chemins macOS** : sur une machine distante macOS, le dépôt se trouve sous `/Volumes`, ou un nom de dossier dans le chemin du dépôt ou du worktree contient un `~` ou un caractère non ASCII
996 * **Restrictions de dossiers** : votre organisation restreint les dossiers que les sessions peuvent utiliser
997 * **Lanceur d'entreprise** : avant Claude Desktop v2.37337.0, vous vous connectez avec un compte Claude, et votre organisation démarre Claude Code sur la machine distante via un [lanceur d'entreprise](/docs/fr/corporate-launcher)
998
999 Une session sans worktree n'est soumise à aucune vérification de ce type, sauf si votre organisation restreint les dossiers que les sessions peuvent utiliser.
1000</Accordion>
1001
1002<a id="handle-requests-that-arrive-while-you-are-away" />
1003
1004<h5 id="handle-requests-that-arrive-while-you-are-away">
1005 Gérer les demandes qui arrivent pendant votre absence
1006</h5>
1007
1008Si Claude a besoin de votre approbation ou vous pose une question pendant que Desktop est déconnecté, Claude attend sur la machine distante. L'attente n'a pas de limite de temps propre. Lorsque Desktop rejoint le processus, il vous affiche la demande. Si Desktop démarre plutôt un nouveau processus, vous perdez la demande.
1009
1010Pendant qu'une tâche vous attend, Desktop peut redémarrer de lui-même, par exemple pour installer une mise à jour. Si Desktop s'exécute sur Windows ou utilise un fournisseur tiers, vous perdez la demande après ce redémarrage.
1011
1012Si vous perdez une demande, envoyez un message pour continuer.
1013
1014Pour réduire la fréquence à laquelle une tâche s'arrête pour vous attendre, et pour en recevoir des nouvelles pendant votre absence, configurez l'un de ces éléments avant de partir :
1015
1016* **Mode auto** : choisissez le [mode auto](#choose-a-permission-mode) s'il [vous est disponible](#auto-mode-availability). Après des blocages répétés, [la question vous est à nouveau posée](/docs/fr/permission-modes#when-auto-mode-falls-back).
1017* **Règles d'autorisation** : dans votre fichier de paramètres utilisateur sur la machine distante, `~/.claude/settings.json`, ajoutez des [règles d'autorisation](/docs/fr/permissions#manage-permissions) pour les commandes dont la tâche a besoin. Si votre organisation [n'accepte les règles de permission que depuis les paramètres gérés](/docs/fr/settings-reference#allowmanagedpermissionrulesonly), demandez à votre administrateur de les ajouter aux [paramètres gérés](#managed-settings) qui atteignent la machine distante. Pour les règles d'autorisation dans le `.claude/settings.json` d'un projet, voir [Règles d'autorisation du projet et confiance de l'espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust).
1018* **Un hook qui répond** : configurez un [hook `PermissionRequest`](/docs/fr/hooks#permissionrequest) dans `~/.claude/settings.json` sur la machine distante pour autoriser ou refuser les demandes à votre place
1019* **Un hook qui vous alerte** : configurez un [hook `Notification`](/docs/fr/hooks#notification) avec le matcher `permission_prompt` dans le même fichier pour vous envoyer un message lorsqu'une demande est en attente
1020* **Un hook qui vous prévient quand Claude a terminé** : configurez un [hook `Stop`](/docs/fr/hooks#stop) dans le même fichier pour vous envoyer un message lorsque Claude a fini de répondre. Il ne s'exécute pas lorsqu'une erreur d'API met fin au tour. Pour ce cas, configurez un [hook `StopFailure`](/docs/fr/hooks#stopfailure).
1021
1022Si votre organisation [n'exécute que des hooks gérés](/docs/fr/settings-reference#allowmanagedhooksonly), demandez à votre administrateur d'ajouter le hook aux [paramètres gérés](#managed-settings) qui atteignent la machine distante.
1023
1024Claude Code n'approuve automatiquement [quelques actions](/docs/fr/permission-modes#actions-no-mode-auto-approves) dans aucun mode de permission, y compris Bypass permissions. Selon le mode de permission, Claude Code refuse une telle action ou vous la demande, et la tâche attend alors votre réponse.
1025
1026<a id="reconnect-after-sleep-or-a-network-loss" />
1027
1028<h5 id="reconnect-after-sleep-or-a-network-loss">
1029 Se reconnecter après une mise en veille ou une perte réseau
1030</h5>
1031
1032Si Desktop ne s'est pas reconnecté à votre retour, envoyez un message dans la session. Desktop se reconnecte de lui-même uniquement lorsqu'il peut se connecter sans invite, par exemple avec une clé détenue par votre agent SSH.
1033
1034* **Mot de passe mémorisé** : un mot de passe que vous laissez Desktop mémoriser fonctionne aussi sans invite, mais pour une absence prolongée, préférez une clé détenue par votre agent SSH. Si les connexions avec ce mot de passe s'interrompent ou se bloquent, Desktop peut cesser de se reconnecter et vous attendre.
1035* **Toute autre invite** : si la machine distante demande autre chose, comme un code à usage unique, vous pouvez recevoir une notification sur votre ordinateur. Cliquez sur la notification, ou envoyez un message dans la session, et Desktop affiche l'invite.
1036
1037<Accordion title="Si un hôte de rebond demande une authentification, si la panne est longue, si une sortie manque ou si le processus a disparu">
1038 - **Hôte de rebond, les notifications push s'arrêtent pendant votre absence** : cela peut se produire avec Desktop sur macOS ou Linux lorsque personne ne répond à l'authentification d'un hôte de rebond, par exemple une notification push sur un téléphone. Desktop cesse alors de se reconnecter tant que personne n'est devant votre ordinateur. Lorsque vous déverrouillez ou utilisez l'ordinateur, vous pouvez recevoir une nouvelle notification push, car Desktop peut réessayer. Après trois tentatives sans réponse, il attend que vous réessayiez ou envoyiez un message.
1039 - **Hôte de rebond, les notifications push continuent** : lorsque Desktop ne peut pas savoir que personne ne répond, comme avec Desktop sur Windows, il continue d'essayer tant qu'il a un processus à rejoindre, que ce processus s'exécute encore ou non. Vous pouvez recevoir une nouvelle notification push à chaque tentative. Pour mettre fin aux tentatives, quittez Desktop, ce qui [peut vous faire perdre la tâche en cours](#reopen-a-session-after-you-quit-desktop).
1040 - **Panne longue** : Desktop ralentit à environ une tentative toutes les cinq minutes. Pour vous reconnecter plus tôt, réessayez dans la session ou envoyez un message, que Desktop transmet une fois connecté.
1041 - **Sortie manquante** : pendant que Desktop est déconnecté, le programme auxiliaire conserve la sortie Claude Code la plus récente de chaque session dans un tampon de 16 Mio et supprime la sortie plus ancienne. Après la reconnexion de Desktop, la session peut afficher `Loading recent output from <host>…`. Si Desktop ne peut pas charger toute la sortie, vous voyez la ligne `Some output produced while you were disconnected may be missing here.` Cette ligne ne signifie pas que la tâche s'est arrêtée.
1042 - **Processus disparu** : si le processus a disparu lorsque Desktop se reconnecte, Desktop peut en démarrer un nouveau à partir de l'historique enregistré de la conversation et demander à Claude de poursuivre la tâche. Desktop ne poursuit pas la tâche de lui-même si le processus continue de se terminer, ou si Desktop utilise un fournisseur tiers. Envoyez un message pour continuer.
1043</Accordion>
1044
1045<a id="reopen-a-session-after-you-quit-desktop" />
1046
1047<h5 id="reopen-a-session-after-you-quit-desktop">
1048 Rouvrir une session après avoir quitté Desktop
1049</h5>
1050
1051Après que vous avez quitté Desktop, la tâche continue de s'exécuter sur la machine distante jusqu'à ce qu'elle se termine, ait besoin de vous ou atteigne l'une des [limites](#limits-while-desktop-is-disconnected).
1052
1053* **Desktop sur macOS ou Linux, avec un compte Claude** : démarrez Desktop et ouvrez la session. Vous récupérez la tâche en cours lorsque Desktop peut rejoindre le processus. Il ne peut pas toujours le rejoindre, par exemple après certaines mises à jour de Desktop ou après que votre organisation a modifié ses paramètres gérés.
1054* **Sur macOS ou Linux, lorsque Desktop ne peut pas rejoindre le processus** : Desktop met fin au processus et en démarre un nouveau à partir de l'historique enregistré de la conversation. Votre tâche en cours s'arrête, et vous perdez toute approbation ou question qui vous attendait. Après une mise à jour, Desktop peut alors demander à Claude de continuer. Si la tâche reste arrêtée, envoyez un message.
1055* **Desktop sur Windows, ou avec un fournisseur tiers sur n'importe quelle plateforme** : ne redémarrez Desktop que lorsque vous pensez que la tâche est terminée. Vous ne récupérez pas la tâche en cours, car Desktop ne rejoint jamais le processus après avoir été quitté. Il met fin au processus à l'ouverture de la session, ce qui peut se produire au démarrage de Desktop. Envoyez un message pour continuer.
1056
1057Pour les déploiements tiers, voir [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
1058
1059<Warning>
1060 Tant que le processus Claude Code d'une conversation s'exécute encore, n'exécutez pas [`claude --resume`](/docs/fr/cli-reference#cli-flags) pour celle-ci sur la machine distante. Claude Code ne vous en empêche pas, et les deux processus écrivent alors dans la même conversation. En cas de doute, ajoutez `--fork-session`, qui continue dans une copie de la conversation, mais les deux processus travaillent toujours sur les mêmes fichiers.
1061</Warning>
826 1062
827<h4 id="choose-where-ssh-session-worktrees-go">1063<h4 id="choose-where-ssh-session-worktrees-go">
828 Choisir l'emplacement des worktrees des sessions SSH1064 Choisir l'emplacement des worktrees des sessions SSH
8342. [`worktree.location`](/docs/fr/settings-reference#worktree-location) dans `~/.claude/settings.json` sur la machine distante10702. [`worktree.location`](/docs/fr/settings-reference#worktree-location) dans `~/.claude/settings.json` sur la machine distante
8353. `<project-root>/.claude/worktrees/`, la valeur par défaut10713. `<project-root>/.claude/worktrees/`, la valeur par défaut
836 1072
837Chaque projet obtient son propre sous-dossier dans le dossier que vous définissez ; ainsi, avec `~/worktrees`, le chemin d'un worktree est `~/worktrees/<project>-<id>/<worktree-name>`. Si le dossier que vous définissez se trouve à l'intérieur du projet, Desktop l'ignore pour ce projet et utilise la valeur par défaut.1073Chaque projet obtient son propre sous-dossier dans le dossier que vous définissez ; ainsi, avec `~/worktrees`, le chemin d'un worktree est `~/worktrees/<project>-<id>/<worktree-name>`. Si le dossier que vous définissez se trouve à l'intérieur du projet, Desktop l'ignore pour ce projet et utilise la valeur par défaut. Sur une [machine distante Windows](#windows-remote-machines), Desktop utilise toujours la valeur par défaut.
838 1074
839Pour définir **Dossier des worktrees** sur une connexion que vous avez ajoutée précédemment ou sur une connexion gérée par votre organisation, survolez-la dans la liste déroulante d'environnement et cliquez sur l'icône d'engrenage.1075Pour définir **Dossier des worktrees** sur une connexion que vous avez ajoutée précédemment ou sur une connexion gérée par votre organisation, survolez-la dans la liste déroulante d'environnement et cliquez sur l'icône d'engrenage.
840 1076
