Application de bureau (Desktop)
📚 Navigation de la série : L'article précédent 09 Intégration JetBrains a installé Claude Code dans la suite IntelliJ. Cet article aborde une porte d'entrée que beaucoup ignorent : l'application de bureau officielle, une fenêtre indépendante capable de faire tourner Claude Code sans terminal et sans IDE.
On dit souvent que la ligne de commande est le « vrai » moyen d'utiliser Claude Code, et que l'application de bureau n'est qu'une version simplifiée pour débutants — pour être franc, ce jugement est aujourd'hui dépassé.
Beaucoup le pensent au début. Mais lorsqu'on doit modifier trois fonctionnalités indépendantes en même temps, qu'on ouvre trois onglets dans le terminal, on finit par s'emmêler les pinceaux : quel onglet gère la connexion, lequel refactorise la couche de données ? On se trompe souvent en passant de l'un à l'autre. En refaisant la même chose dans l'application de bureau, on a trois sessions listées dans la barre latérale à gauche, chacune automatiquement isolée par un Git worktree, les modifications ne se polluent pas mutuellement, et un clic suffit pour passer de l'une à l'autre — c'est là qu'on réalise que ce n'est pas un « CLI bridé », c'est une autre façon de travailler.
Plus important encore : l'application de bureau, l'extension VS Code et la ligne de commande partagent le même moteur sous-jacent, la même configuration et le même fichier CLAUDE.md. Il ne s'agit donc pas d'un « outil affaibli », mais du même Claude Code doté d'une interface plus adaptée aux tâches parallèles et à la révision visuelle.
Quand l'utiliser, quand revenir au bon vieux terminal ? Cet article vous l'explique clairement.
Après avoir lu cet article, vous obtiendrez :
- Les étapes complètes pour installer l'application sur macOS / Windows, avec l'explication claire du « pourquoi elle n'est pas sur Linux ».
- Trois atouts exclusifs de l'application : sessions parallèles + isolation Git, terminal/éditeur de fichiers intégrés, et vue diff visuelle.
- Un tableau comparatif « Desktop vs Terminal vs Extension IDE » pour savoir quoi utiliser, et la commande magique pour basculer une session du terminal vers le bureau en un clic.
01 Bien comprendre : Qu'est-ce que l'application de bureau ?
Beaucoup s'imaginent : « L'application de bureau, c'est juste le client claude.ai avec une fenêtre de chat, non ? »
Non. Soyons clairs : l'application de bureau est un Claude Code complet avec interface graphique, spécialement conçu pour « gérer plusieurs sessions en même temps ». Elle tourne sur le même moteur que le claude du terminal, elle lit et écrit directement vos fichiers locaux, lance des commandes, mais place tout cela dans une fenêtre avec barre latérale et panneaux ajustables.
Analogie : Le même moteur, un autre tableau de bord. La ligne de commande, c'est le tableau de bord numérique d'une voiture de course — complet, réactif, mais il faut savoir lire les chiffres bruts ; l'application de bureau, c'est l'écran tactile d'une voiture familiale — les tâches parallèles, les diffs et les aperçus sont affichés clairement. Le moteur est le même, le résultat aussi, la différence réside dans le confort d'utilisation.
Un point qui peut prêter à confusion : une fois l'application ouverte, il y a trois onglets (tabs) en haut, ne vous trompez pas.
| Onglet | Fonction | Peut-il toucher à vos fichiers ? |
|---|---|---|
| Chat | Discussion classique, comme claude.ai | ❌ Non |
| Cowork | Dispatch et tâches d'agent longues | Sur une VM cloud, ne touche pas au local |
| Code | Programmation interactive, lecture/écriture en local | ✅ Oui, avec approbation à chaque étape |
Cet article ne porte que sur l'onglet Code — c'est lui le « Claude Code version bureau ». Les onglets Chat et Cowork font partie des autres fonctions de Claude Desktop et n'ont pas de lien direct avec notre ligne de code.
💡 En un mot : L'application de bureau n'est pas un simple client de chat, c'est un Claude Code complet avec interface, il faut utiliser l'onglet Code.
02 Installation : Trois plateformes, de grandes différences
Mettons le point le plus important d'emblée : Il n'y a pas d'application de bureau pour Linux.
Ce n'est pas un oubli d'installation, c'est un choix officiel : les utilisateurs Linux doivent utiliser le CLI (l'installation a été vue à l'article 02). La suite ne concerne donc que macOS et Windows.
Ce schéma retrace le chemin du téléchargement jusqu'à la première commande, et pointe deux pièges fréquents : l'abonnement payant (les comptes gratuits seront redirigés vers la page d'upgrade en cliquant sur Code) et l'installation de Git sous Windows (qui nécessite un redémarrage de l'app). L'absence de version Linux y est aussi rappelée. Détaillons par plateforme.
À vérifier avant l'installation : Vous devez avoir un abonnement payant
C'est un piège courant. L'onglet Code de l'application de bureau nécessite un abonnement Pro, Max, Team ou Enterprise. Les comptes gratuits verront une page de mise à niveau. Souvent, les utilisateurs gratuits cliquent sur Code, tombent sur l'upgrade, et pensent que l'installation a échoué — c'est simplement une question d'abonnement.
macOS
Téléchargez la version Universal (valable pour Intel et Apple Silicon) sur la page officielle, installez le .dmg, glissez l'app dans le dossier Applications. Lancez-la, connectez-vous avec votre compte Anthropic, puis cliquez sur l'onglet Code en haut au milieu.
macOS inclut généralement Git, dont dépend l'isolation des sessions parallèles. Pour être sûr, lancez dans le terminal :
git --versionLe résultat attendu (la version importe peu) :
git version 2.39.5 (Apple Git-154)Windows
Téléchargez l'installateur .exe pour processeurs x64 ; pour Windows ARM64, téléchargez le package dédié, ne vous trompez pas.
Windows a une exigence absolue que macOS n'a pas : Les sessions locales de l'onglet Code nécessitent l'installation préalable de Git for Windows. Sur un Windows neuf, c'est le piège classique : cliquer sur Code sans avoir Git affiche un message rouge Git is required, et la session ne démarre pas. Après avoir installé Git, n'oubliez pas de redémarrer l'application, sinon elle ne le détectera pas.
De plus, certaines bibliothèques Windows nécessitent Git LFS. Si vous rencontrez l'erreur Git LFS is required by this repository but is not installed, allez sur git-lfs.com pour l'installer, lancez git lfs install, puis redémarrez l'application.
Une remarque importante : L'application de bureau inclut son propre Claude Code, vous n'avez pas besoin d'installer Node.js ou le CLI séparément. Mais inversement, si vous voulez utiliser
claudedans le terminal, il faut installer le CLI à part (voir article 02) — ce sont deux programmes distincts qui partagent la même configuration.
💡 En un mot : Pas de Linux, pas de compte gratuit ; sur macOS (version Universal) ça marche direct, sur Windows il faut d'abord installer Git et redémarrer.
03 Premier atout : Sessions parallèles + Isolation automatique via Git
C'est la meilleure raison d'utiliser l'application, sans équivoque.
Le problème : La douleur du multi-tâche dans le terminal
Vous avez déjà vécu ça : trois tâches en cours (corriger le login, ajouter des tests, refactoriser des utilitaires). Dans le terminal, vous ouvrez trois onglets avec trois claude, mais ils modifient tous le même répertoire de travail — la session A modifie utils.js, la session B veut aussi le toucher, et les modifications se marchent dessus.
La solution de l'application de bureau
L'approche de l'application est très propre : en cliquant sur + New session dans la barre latérale pour ouvrir une nouvelle session, si le projet est un dépôt Git, elle lui allouera automatiquement un Git worktree indépendant.
Analogie : Des box d'étude individuels dans une bibliothèque. Vous êtes trois à consulter la même encyclopédie (le même dépôt), mais chacun a son box insonorisé (worktree) pour lire et prendre des notes sans déranger les autres ; quand vous avez fini (commit), les résultats retournent à l'accueil. Avant votre commit, les modifications d'une session ne pollueront jamais celles d'une autre.
La barre latérale liste toutes vos sessions, utilisez Ctrl+Tab / Ctrl+Shift+Tab pour naviguer de l'une à l'autre (ces raccourcis utilisent Ctrl sur toutes les plateformes, pas Cmd). Vous voulez voir deux sessions en même temps ? Sur macOS, maintenez Cmd (sur Windows, maintenez Ctrl) et cliquez sur une autre session dans la barre latérale, elle s'ouvrira en écran partagé à côté.
Quelques détails pratiques
- Où est stocké le worktree : Par défaut dans
<racine_projet>/.claude/worktrees/. Vous pouvez changer cela dans « Settings → Claude Code → Worktree location ». - Embarquer
.env(ou autres fichiers ignorés par git) dans le worktree : Créez un fichier.worktreeincludeà la racine du projet et listez les fichiers à inclure (référez-vous à la documentation officielle). - Nettoyer les sessions terminées : Survolez la session dans la barre latérale et cliquez sur l'icône d'archivage, le worktree correspondant sera supprimé.
- Archivage automatique après fusion de PR : Dans « Settings → Claude Code », activez Auto-archive after PR merge or close, les sessions locales terminées se fermeront toutes seules.
Une excellente habitude à prendre : Une PR = une session. On modifie, on commit, on ouvre la PR, on fusionne, la session s'archive, et le bureau reste propre, plus besoin de se souvenir de « ce que fait cet onglet ». La charge mentale est bien moindre qu'avec cinq ou six onglets de terminal.
💡 En un mot : Un Git worktree par session automatiquement, des modifications isolées en parallèle — c'est le vrai gros avantage de l'application par rapport au terminal.
04 Deuxième atout : Terminal et éditeur intégrés, fini les allers-retours
L'onglet Code de l'application repose sur des panneaux (panes) : chat, diff, preview, terminal, fichiers, plan, tâches... que vous pouvez disposer comme bon vous semble. Déplacez les titres pour réorganiser, tirez les bords pour redimensionner, comme des briques Lego.
Attention : Cette disposition en panneaux avec terminal et éditeur intégrés nécessite Claude Desktop v1.2581.0 ou supérieur. Si votre version est plus ancienne, utilisez « Check for Updates » (la version requise peut changer selon la doc officielle).
Terminal intégré : Le même environnement que Claude
Ouvrez le terminal depuis le menu Views, ou appuyez sur Ctrl+` (là encore, Ctrl sur toutes les plateformes).
Le plus génial : Le terminal s'ouvre dans le répertoire de la session, partageant le même environnement que Claude. Si vous y lancez npm test ou git status, vous travaillez sur la copie exacte que Claude est en train de modifier, sans risquer le syndrome du « Claude a modifié le fichier mais mon terminal regarde l'ancienne version ».
Cela résout un problème récurrent de l'extension VS Code, où il fallait s'assurer manuellement que le terminal était dans le bon répertoire — ici, il y est par défaut.
Remarque : Le terminal intégré n'est disponible que pour les sessions locales, pas pour les sessions distantes.
Éditeur de fichiers : Cliquez pour modifier
Cliquez sur n'importe quel chemin de fichier dans le chat ou le diff, il s'ouvrira dans le panneau de fichiers. Modifiez-le directement, puis cliquez sur Save pour enregistrer.
Si vous ouvrez un fichier et qu'il est modifié sur le disque entre-temps (par exemple, si Claude le modifie), le panneau vous avertira et vous demandera de choisir entre écraser ou abandonner, évitant ainsi d'effacer le travail d'un autre sans prévenir.
Un détail : Cliquer sur des chemins HTML, PDF, image ou vidéo ne les ouvrira pas dans l'éditeur de fichiers, mais dans le panneau d'aperçu (preview) — nous verrons cela plus loin. Le panneau de fichiers est disponible pour les sessions locales et SSH ; pour les sessions distantes, demandez à Claude de faire la modification.
Note en passant : Les modes d'affichage (Views)
Par défaut, l'historique du chat masque les appels d'outils sous forme de résumé (mode Normal). Pour voir exactement ce que Claude a fait, appuyez sur Ctrl+O pour passer en mode Verbose ; pour ne voir que les résultats et modifications finaux, passez en mode Summary. Verbose est très utile pour déboguer « pourquoi il fait ça », et Summary est parfait pour survoler rapidement les résultats de plusieurs sessions.
💡 En un mot : Le terminal partage le répertoire de travail, les fichiers se modifient d'un clic — tous les outils de dev sont dans une seule fenêtre, plus besoin de passer d'une application à l'autre.
05 Troisième atout : Révision visuelle des diffs, voir les erreurs d'un coup d'œil
C'est l'amélioration la plus visible de l'interface graphique par rapport au terminal brut.
Dans le terminal, le code modifié s'affiche sous forme de texte vert et rouge ; l'application transforme cela en une interface visuelle cliquable, annotable, et capable de faire s'auto-évaluer Claude.
Lire un diff
Quand Claude modifie un fichier, un petit indicateur +12 -1 apparaît (12 lignes ajoutées, 1 supprimée). Cliquez dessus pour ouvrir la vue diff : à gauche, la liste des fichiers modifiés ; à droite, le détail des modifications pour chaque fichier.
Annoter (commenter) une ligne précise
C'est la fonctionnalité de révision la plus puissante : cliquez sur n'importe quelle ligne du diff pour ouvrir une boîte de commentaire, tapez vos retours et validez. Pour commenter plusieurs lignes, cliquez-les une par une, écrivez, puis soumettez tous les commentaires en une fois :
- macOS :
Cmd+Enter - Windows :
Ctrl+Enter
Claude lit vos commentaires, ajuste le tir, et vous propose un nouveau diff à réviser. Cet échange est infiniment plus précis que de taper dans le terminal « Modifie la variable à la ligne 23 » — vous parlez directement sur la ligne concernée.
Demander à Claude de s'auto-évaluer (Review code)
En haut à droite de la vue diff, vous trouverez un bouton Review code. Si vous cliquez dessus, Claude passera en revue ses propres modifications avant que vous ne validiez, et laissera des commentaires dans le diff. Vous pouvez alors y répondre ou lui demander de corriger.
Attention, il vérifie les problèmes majeurs (High Signal) : erreurs de compilation, bugs logiques évidents, failles de sécurité. Il ne s'occupera pas du style, du formatage ou de ce qu'un linter fait déjà.
Créer une PR avec l'œil du CI
Après avoir créé une PR, une barre d'état CI apparaît dans la session, Claude interrogeant les résultats via le GitHub CLI. Deux options intéressantes :
- Auto-fix : Si le CI échoue, Claude lit les logs et tente de réparer de lui-même.
- Auto-merge : Une fois les tests validés, la PR est fusionnée (en squash, à condition d'avoir activé l'auto-merge dans GitHub).
Prérequis : Pour le suivi des PR, vous devez avoir installé et vous être connecté au GitHub CLI (
gh). Si ce n'est pas le cas, l'app vous le proposera lors de votre première PR.
À l'usage, la combinaison Annotations ligne par ligne + Review Code remplace aisément la première phase d'une "Code Review humaine". Auparavant, il fallait éplucher les fichiers modifiés par Claude ; aujourd'hui, on le laisse s'auto-évaluer et on se concentre sur les points majeurs qu'il remonte.
💡 En un mot : Le diff est cliquable, annotable ligne par ligne, et vous permet de faire s'auto-évaluer Claude sur les problèmes majeurs, puis d'utiliser l'Auto-fix pour le CI — la vérification passe d'une lecture fastidieuse à une validation fluide.
06 Desktop vs Terminal vs Extension IDE : Lequel choisir ?
Vous pourriez vous dire : « J'ai le claude dans le terminal, l'extension VS Code, et maintenant l'app Desktop, lequel dois-je utiliser ? »
Voici la position officielle :
Pour gérer des sessions parallèles dans une seule fenêtre, organiser des panneaux, et réviser visuellement les modifications, utilisez le Desktop ; pour les scripts, l'automatisation, ou si vous préférez le flux de travail du terminal, utilisez le CLI.
Faisons un comparatif, choisissez selon vos priorités :
| Votre priorité... | Terminal CLI | Extension VS Code / JetBrains | Application Desktop |
|---|---|---|---|
| Multisession + Iso. Git | Onglets manuels, gestion worktree | Moyenne | ✅ Worktree auto, bascule dans barre latérale |
| Diff visuel, annotations | Diff texte | ✅ Diff en ligne (inline) | ✅ Diff + annotations + auto-éval |
| Coder dans son éditeur | ❌ | ✅ Directement dans l'IDE | Éditeur intégré, mais pas votre IDE |
| Scripts/Automatisations | ✅ --print, Agent SDK | Partiel | ❌ Mode interactif uniquement |
Raccourcis !bash, Tab | ✅ | Partiel | ❌ (Pas d'avantages natifs du terminal) |
| Preview app, CI, Tâches | À monter soi-même | Partiel | ✅ Interface native |
| Linux | ✅ | ✅ | ❌ Non disponible |
| Modèles tiers (Bedrock...) | ✅ | ✅ | Anthropic API par défaut (Vertex/Gateways via déploiements d'entreprise) |
Vous avez compris la logique ? Ils ne se remplacent pas, chacun a son terrain de jeu :
- Pour des scripts, pipelines CI, ou modèles tiers → Utilisez le CLI, le Desktop n'est pas fait pour ça.
- Si vous codez principalement dans VS Code/JetBrains → L'extension IDE est la plus fluide, le code et l'IA sont dans la même fenêtre.
- Si vous gérez 3-4 tâches indépendantes et souhaitez une révision visuelle → C'est là que le Desktop brille.
Mieux encore, vous pouvez les utiliser en même temps, voire sur le même projet — ils partagent CLAUDE.md, les serveurs MCP, les hooks, les skills et settings.json. Un bon combo : coder au quotidien avec l'extension VS Code, basculer sur le Desktop quand on doit traiter plusieurs tâches en parallèle, et revenir au terminal pour les scripts et automatisations.
⚠️ Attention : Les commandes ouvrant des interfaces interactives dans le terminal (comme /permissions, /config, /agents, /doctor) ne fonctionnent pas dans l'onglet Code (l'app affichera isn't available in this environment). Pour modifier les règles de permission ou la configuration, éditez settings.json ou utilisez le CLI autonome.
💡 En un mot : Le CLI pour l'automatisation, l'extension pour coder, le Desktop pour les tâches parallèles et le visuel — ils partagent tout, passez de l'un à l'autre selon le besoin du moment.
07 Mise en pratique : Installer et lancer sa première session
Passons à la pratique. Voici le parcours minimal pour installer et lancer une session, avec des résultats vérifiables à chaque étape.
Étape 1 : Installer et ouvrir l'onglet Code
Installez l'application selon la section 02 (macOS Universal, ou Windows après avoir installé Git). Lancez, connectez-vous, cliquez sur l'onglet Code en haut au centre.
✅ Vérification : Vous voyez une barre latérale à gauche et la zone de chat au milieu. Si vous êtes redirigé vers une page de paiement → vous avez un compte gratuit, il faut un abonnement Pro/Max.
Étape 2 : Configurer l'environnement et le dossier
Avant le premier message, vérifiez ces quatre points dans la zone de saisie :
- Environnement : Choisissez Local (tourne sur votre machine, lit/écrit les fichiers). Les options Remote (cloud) et SSH (machine distante) existent, mais Local est le plus simple.
- Dossier du projet : Cliquez sur Select folder, choisissez un petit projet que vous connaissez — ne prenez pas votre plus gros dépôt pour commencer.
- Modèle : Sélectionnable via le menu déroulant à côté du bouton d'envoi (Opus / Sonnet / Haiku), modifiable en cours de route.
- Mode de permission : Laissez sur « Demander la permission » (
default), c'est le plus sûr pour les débutants.
Étape 3 : Envoyer la première commande
Tapez une tâche simple, par exemple celle de la documentation officielle :
Trouve un commentaire TODO et corrige-le.Ou encore :
Crée un fichier CLAUDE.md pour ce dépôt avec une description du projet.Appuyez sur Enter pour envoyer.
Étape 4 : Réviser et accepter
En mode « Demander la permission », Claude ne modifiera pas le fichier directement, il vous proposera d'abord un diff. Vous verrez :
- Une vue diff montrant les changements exacts par fichier.
- Des boutons Accepter (Accept) / Refuser (Reject).
- La progression en temps réel du traitement de Claude.
✅ Résultat attendu : Tant que vous ne cliquez pas sur Accepter, le fichier sur votre disque ne change pas. C'est la sécurité du mode par défaut. Si vous refusez, Claude vous demandera comment vous souhaitez corriger la proposition.
Étape 5 (Optionnel) : Basculer du terminal au Desktop
Si vous avez commencé une session claude dans le terminal et souhaitez la poursuivre dans l'application, pas besoin de recommencer. Dans la session terminal, tapez :
/desktopClaude sauvegardera la session, l'ouvrira dans l'application de bureau, puis quittera le CLI.
Note :
/desktopn'est disponible que sur macOS / Windows et seulement si vous êtes connecté via un abonnement claude.ai — les clés API ou les déploiements Bedrock/Vertex/Foundry ne sont pas supportés (selon la documentation).
08 Résumé
Cet article a clarifié l'utilisation de la troisième porte d'entrée de Claude Code : l'application de bureau (Desktop). Voici l'essentiel à retenir :
- C'est un Claude Code complet, pas une coquille de chat : Il partage le même moteur, le même CLAUDE.md et la même config que le terminal, utilisez l'onglet Code.
- Installation spécifique selon la plateforme : Inexistant sur Linux ; nécessite un abonnement (Pro/Max mini) ; Git doit être installé avant sous Windows.
- Trois atouts exclusifs : Isolement via Git worktree automatique pour les sessions parallèles, environnement unifié pour le terminal et l'éditeur intégrés, vue diff avec annotations ligne par ligne et auto-évaluation.
- L'outil idéal selon la tâche : CLI pour l'automatisation, extension IDE pour le code, Desktop pour le parallélisme et la révision visuelle. Les trois cohabitent parfaitement.
Vous savez désormais installer l'application sur macOS/Windows, lancer plusieurs sessions isolées par worktree, utiliser la vue diff pour annoter les modifications, et basculer du terminal au bureau si nécessaire. Maîtriser ce flux vous permettra de traiter plusieurs demandes de front sans vous perdre.
Article suivant : 11 Version Web et Cloud (Web / Mobile) — Qu'est-ce que l'environnement Remote du Desktop, et comment suivre la progression depuis son téléphone ? Nous découvrirons comment laisser Claude Code travailler dans le cloud pour vous, même lorsque votre ordinateur est éteint ou que vous n'êtes pas à votre bureau.