desktop.md +32 −5
120 120
121> [!NOTE]121> [!NOTE]
122>122>
123123> Dans une [session SSH](#ssh-sessions), Claude ne peut pas ouvrir votre application dans le panneau Browser, car il n'y dispose pas des outils du panneau. Pour consulter l'application vous-même, [redirigez son port vers votre ordinateur](#reach-a-port-on-the-remote-machine).> Dans une [session SSH](#ssh-sessions), Claude ne dispose pas des outils du panneau Browser : il ne peut donc pas ouvrir votre application dans le panneau ni [vérifier automatiquement](#auto-verify-changes) ses modifications. Le menu **Dev servers** du panneau et vos [serveurs de prévisualisation configurés](#configure-preview-servers) ne sont pas non plus disponibles. Pour consulter l'application vous-même, démarrez son serveur sur la machine distante, puis [redirigez son port vers votre ordinateur](#reach-a-port-on-the-remote-machine).
124 124
125Si le panneau Browser n'est pas ouvert après que Claude a démarré un serveur dans une session locale, cliquez sur **Open** sur la carte du serveur dans le chat.125Si le panneau Browser n'est pas ouvert après que Claude a démarré un serveur dans une session locale, cliquez sur **Open** sur la carte du serveur dans le chat.
126 126
1002* **Codes à usage unique avec `MaxSessions 1`** : si chaque connexion vous demande une saisie, comme avec des codes à usage unique, les commandes `!` échouent. Exécutez plutôt ces commandes dans un onglet de terminal, qui affiche la demande dans son propre panneau.1002* **Codes à usage unique avec `MaxSessions 1`** : si chaque connexion vous demande une saisie, comme avec des codes à usage unique, les commandes `!` échouent. Exécutez plutôt ces commandes dans un onglet de terminal, qui affiche la demande dans son propre panneau.
1003* **Dossier d'installation** : Desktop installe un programme d'assistance et Claude Code sous `~/.claude/remote/` dans votre répertoire personnel. Il les exécute depuis cet emplacement : ce dossier ne peut donc 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. Pour savoir ce que contient ce dossier, consultez [Fichiers et processus sur la machine distante](#files-and-processes-on-the-remote-machine).1003* **Dossier d'installation** : Desktop installe un programme d'assistance et Claude Code sous `~/.claude/remote/` dans votre répertoire personnel. Il les exécute depuis cet emplacement : ce dossier ne peut donc 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. Pour savoir ce que contient ce dossier, consultez [Fichiers et processus sur la machine distante](#files-and-processes-on-the-remote-machine).
1004* **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`1004* **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`
10051005* **Réseau** : Claude Code s'exécute sur la machine distante et y émet ses requêtes réseau : la machine a donc besoin de l'[accès réseau requis par Claude Code](https://code.claude.com/docs/fr/network-config.md#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. Sur une machine distante Linux, si ces requêtes nécessitent un proxy, [définissez-le pour les sessions SSH](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions).* **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](https://code.claude.com/docs/fr/network-config.md#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. Si une machine distante Linux nécessite un proxy ou un certificat d'autorité de certification, [définissez-le pour les sessions SSH](#set-a-proxy-or-a-ca-certificate-for-ssh-sessions).
1006 1006
1007#### Vérifier la clé d'hôte d'une machine distante1007#### Vérifier la clé d'hôte d'une machine distante
1008 1008
1030 1030
1031Si une machine distante Linux accède à Internet via un proxy ou a besoin d'un certificat CA, ajoutez les [variables de proxy et de CA](https://code.claude.com/docs/fr/network-config.md) sous `env` dans `~/.claude/settings.json` sur cette machine. Ajoutez-les même si vous les exportez déjà dans `~/.profile`, `~/.bash_profile`, `~/.zprofile` ou `~/.zshrc` sur cette machine.1031Si une machine distante Linux accède à Internet via un proxy ou a besoin d'un certificat CA, ajoutez les [variables de proxy et de CA](https://code.claude.com/docs/fr/network-config.md) sous `env` dans `~/.claude/settings.json` sur cette machine. Ajoutez-les même si vous les exportez déjà dans `~/.profile`, `~/.bash_profile`, `~/.zprofile` ou `~/.zshrc` sur cette machine.
1032 1032
10331033Dans une session SSH, Claude Code ne reçoit pas les variables de ces fichiers, même lorsque `claude` dans un terminal sur cette machine les reçoit. La session peut alors se bloquer, ou afficher **The connection from … to the API failed** ou **Authentication failed**, et se reconnecter n'y change rien.Dans une session SSH, Claude Code ne reçoit pas les variables de ces fichiers, même lorsque `claude` les reçoit dans un terminal sur cette machine. La session peut alors se bloquer, ou afficher **The connection from … to the API failed**, **Authentication failed** ou **Claude Code on … couldn’t verify the API connection’s certificate**. Se reconnecter n'y change rien.
1034 1034
1035**1. Ajouter les variables**1035**1. Ajouter les variables**
1036 1036
1948 1948
1949Pour les clés de permission, de plugin et de livraison que seule une source gérée peut définir, voir [Clés que seuls les paramètres gérés peuvent définir](https://code.claude.com/docs/fr/managed-settings.md#managed-only-settings).1949Pour les clés de permission, de plugin et de livraison que seule une source gérée peut définir, voir [Clés que seuls les paramètres gérés peuvent définir](https://code.claude.com/docs/fr/managed-settings.md#managed-only-settings).
1950 1950
1951#### Paramètres Claude Code qui se comportent différemment dans l'onglet Code
1952
1953Dans une session locale, ces clés, entre autres, ont un effet différent ou aucun effet visible, car l'onglet Code remplace l'interface du terminal. Elles s'appliquent toujours dans le terminal, vous pouvez donc les laisser définies.
1954
1955| Clé | Dans une session locale |
1956| - | - |
1957| `askUserQuestionTimeout` | le délai d'expiration ne s'applique pas, de sorte qu'une question de Claude reste ouverte jusqu'à ce qu'un utilisateur y réponde |
1958| `awaySummaryEnabled` | la clé n'a aucun effet |
1959| `bashEditDiffEnabled` | l'onglet Code n'affiche pas la liste des fichiers qu'une commande Bash a modifiés |
1960| `companyAnnouncements` | l'onglet Code n'affiche pas les annonces |
1961| `defaultShell` | les commandes que les utilisateurs saisissent après `!` s'exécutent dans un shell choisi par l'application : leur shell de connexion sur macOS et Linux, PowerShell sur Windows |
1962| `fileSuggestion` | le sélecteur de fichiers `@` construit sa propre liste de fichiers et n'exécute pas la commande que vous avez définie |
1963| `modelPicker` | le sélecteur de modèle liste les modèles disponibles pour le compte de chaque utilisateur. Pour les limiter, définissez [`availableModels`](https://code.claude.com/docs/fr/model-config#restrict-model-selection). |
1964| `pluginTrustMessage` | l'avertissement que voient les utilisateurs lorsqu'ils installent un plugin n'inclut pas le message que vous avez défini |
1965| `prUrlTemplate` | les liens de pull request utilisent l'URL propre de la pull request, et non le modèle |
1966| `respectGitignore` | le sélecteur de fichiers `@` construit sa propre liste de fichiers et ne lit pas cette clé |
1967| `respondToBashCommands` | Claude répond à la sortie des commandes que les utilisateurs exécutent avec `!`, quelle que soit la valeur |
1968| `showClearContextOnPlanAccept` | les utilisateurs n'ont aucune option pour effacer le contexte lorsqu'ils approuvent un plan |
1969| `skipDangerousModePermissionPrompt` | l'onglet Code a sa propre confirmation pour le [mode de contournement des permissions](#choose-a-permission-mode), et cette clé ne permet pas de l'ignorer |
1970| `verbose`, `viewMode` | chaque utilisateur choisit la vue sous [**Transcript view** dans le menu de session](#switch-view-modes) |
1971| `worktree.baseRef`, `worktree.sparsePaths`, `worktree.symlinkDirectories` | non utilisées pour le worktree que l'onglet Code crée pour une session |
1972
1951### Politiques de gestion des appareils1973### Politiques de gestion des appareils
1952 1974
1953Les équipes informatiques peuvent gérer l'application de bureau via MDM sur macOS, la politique de groupe sur Windows ou un fichier de politique sur Linux. Les politiques disponibles incluent l'activation ou la désactivation de la fonctionnalité Claude Code, le contrôle des mises à jour automatiques sur macOS et Windows, et la définition d'une URL de déploiement personnalisée.1975Les équipes informatiques peuvent gérer l'application de bureau via MDM sur macOS, la politique de groupe sur Windows ou un fichier de politique sur Linux. Les politiques disponibles incluent l'activation ou la désactivation de la fonctionnalité Claude Code, le contrôle des mises à jour automatiques sur macOS et Windows, et la définition d'une URL de déploiement personnalisée.
2100* Les fichiers **[CLAUDE.md](https://code.claude.com/docs/fr/memory.md)** et `CLAUDE.local.md` dans votre projet sont utilisés par les deux2122* Les fichiers **[CLAUDE.md](https://code.claude.com/docs/fr/memory.md)** et `CLAUDE.local.md` dans votre projet sont utilisés par les deux
2101* Les **[serveurs MCP](https://code.claude.com/docs/fr/mcp.md)** configurés dans `~/.claude.json` ou `.mcp.json` fonctionnent dans les deux2123* Les **[serveurs MCP](https://code.claude.com/docs/fr/mcp.md)** configurés dans `~/.claude.json` ou `.mcp.json` fonctionnent dans les deux
2102* Les **[hooks](https://code.claude.com/docs/fr/hooks.md)** et **[skills](https://code.claude.com/docs/fr/skills.md)** définis dans les paramètres s'appliquent aux deux2124* Les **[hooks](https://code.claude.com/docs/fr/hooks.md)** et **[skills](https://code.claude.com/docs/fr/skills.md)** définis dans les paramètres s'appliquent aux deux
21032125* Les **[paramètres](https://code.claude.com/docs/fr/settings.md)** dans `~/.claude.json` et `~/.claude/settings.json` sont partagés. Les règles de permission, les outils autorisés et d'autres paramètres dans `settings.json` s'appliquent aux sessions Desktop.* Les **[paramètres](https://code.claude.com/docs/fr/settings.md)** dans `~/.claude.json` et `~/.claude/settings.json` sont partagés. Les règles de permission, les outils autorisés et d'autres paramètres dans `settings.json` s'appliquent aux sessions Desktop. Certaines clés [se comportent différemment dans l'onglet Code](#claude-code-settings-that-behave-differently-in-the-code-tab).
2104* **Modèles** : les mêmes [modèles](https://code.claude.com/docs/fr/model-config.md#available-models) sont disponibles dans les deux. Dans Desktop, sélectionnez le modèle à partir du sélecteur de modèle dans la ligne sous la zone de saisie. Vous pouvez modifier le modèle pendant la session à partir du même sélecteur.2126* **Modèles** : les mêmes [modèles](https://code.claude.com/docs/fr/model-config.md#available-models) sont disponibles dans les deux. Dans Desktop, sélectionnez le modèle à partir du sélecteur de modèle dans la ligne sous la zone de saisie. Vous pouvez modifier le modèle pendant la session à partir du même sélecteur.
2105 2127
2106#### Serveurs MCP de l'application de chat Claude Desktop2128#### Serveurs MCP de l'application de chat Claude Desktop
2281 2303
2282Parcourez les fichiers avant de les envoyer, car ils peuvent contenir des noms et d'autres détails de votre environnement. `<host>` et `<user>` représentent des noms que Desktop a remplacés. Desktop ne remplace pas tous les noms, et un nom d'hôte ou d'utilisateur SSH peut encore apparaître tel quel. Si vous envoyez le fichier zip à quelqu'un, indiquez-lui quel hôte a échoué et à quel moment, car les logs peuvent ne pas le nommer.2304Parcourez les fichiers avant de les envoyer, car ils peuvent contenir des noms et d'autres détails de votre environnement. `<host>` et `<user>` représentent des noms que Desktop a remplacés. Desktop ne remplace pas tous les noms, et un nom d'hôte ou d'utilisateur SSH peut encore apparaître tel quel. Si vous envoyez le fichier zip à quelqu'un, indiquez-lui quel hôte a échoué et à quel moment, car les logs peuvent ne pas le nommer.
2283 2305
22842306Le fichier zip ne contient pas le log du programme auxiliaire que Desktop installe sur la machine distante. Pour obtenir également ce log, copiez `remote-server.log` depuis le dossier du programme auxiliaire sous [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine), dans le répertoire personnel de l'utilisateur qui s'est connecté. Parcourez également ce fichier avant de l'envoyer.Le fichier zip ne contient pas le log du programme auxiliaire que Desktop installe sur la machine distante. Pour obtenir également ce log, copiez ces fichiers depuis le dossier du programme auxiliaire sous [`~/.claude/remote/run/`](#files-and-processes-on-the-remote-machine), dans le répertoire personnel de l'utilisateur qui s'est connecté :
2307
2308* **`remote-server.log`** : le log de la dernière exécution du programme auxiliaire.
2309* **`remote-server.log.old`**, s'il existe : le log de l'exécution précédente. Copiez-le dès que possible, car vous le perdez la prochaine fois que Desktop se connecte et doit redémarrer le programme auxiliaire.
2310
2311Parcourez également ces fichiers avant de les envoyer.
2285 2312
2286### L'application ne se ferme pas2313### L'application ne se ferme pas
2287 2314