Claude Code
Claude Code dans Claude Desktop
Source officielle : https://code.claude.com/docs/en/desktop-quickstart
Claude Code dans Claude Desktop
TL;DR
L'onglet Code de Claude Desktop est l'interface graphique officielle de Claude Code. Même moteur agentique que le CLI ou que les extensions IDE, mais piloté à la souris : panneau de chat, vue des diffs visuelle, terminal intégré, sessions en parallèle, validation explicite à chaque modification de fichier. C'est le point d'entrée le plus simple pour faire travailler Claude Code sur un dépôt local sans ouvrir un terminal.
Pour qui c'est utile
Quatre profils tirent vraiment parti de Desktop Code, chacun pour des raisons différentes.
- Développeurs qui veulent une UI native : ceux qui connaissent le CLI mais préfèrent une vue graphique des diffs et la possibilité d'ouvrir plusieurs sessions en onglets sans gérer eux-mêmes des tmux ou des fenêtres de terminal.
- Profils ops et techniques non développeurs : sysadmins, intégrateurs, automaticiens qui manipulent du code de configuration (YAML, Terraform, Ansible) sans être à l'aise dans un terminal pur. L'UI rassure et limite les fausses manipulations.
- Équipes mixtes dev / métier : product owners, chefs de projet, formateurs qui relisent ou complètent du code sans installer Node.js ni mémoriser des commandes. Ils ouvrent un dépôt, dialoguent, valident les diffs.
- Power users non-CLI : utilisateurs avancés de Claude (consultants, formateurs, dirigeants techniques) qui veulent toute la puissance agentique de Claude Code sans la friction de la ligne de commande au quotidien.
Comprendre Claude Desktop Code (la mécanique sous le capot)
Desktop Code n'est pas un produit séparé. C'est un onglet de Claude Desktop qui embarque exactement le même moteur que claude en CLI ou que l'extension VS Code. Trois choses à avoir en tête.
Un seul moteur, plusieurs surfaces. Le moteur Claude Code (agent, gestion de contexte, lecture / écriture de fichiers, outils MCP, hooks, skills) est commun à toutes les surfaces. CLI, extension IDE et onglet Code de Desktop partagent les mêmes fichiers CLAUDE.md, les mêmes serveurs MCP configurés dans .mcp.json, les mêmes skills installés. Vous changez juste la façon de dialoguer avec lui.
Trois types de sessions. Local (l'agent agit sur les fichiers de votre Mac ou de votre PC), Remote (l'agent tourne dans une VM cloud gérée par Anthropic, utile pour ne pas exposer la machine locale), SSH (l'agent se connecte à un serveur distant que vous gérez). La session Local est la plus courante pour commencer.
Sessions partagées et reprises. Dans Desktop Code, on peut ouvrir plusieurs sessions en parallèle (onglets multiples), reprendre une session interrompue, et basculer entre elles sans tout perdre. Le contexte agent (historique du dialogue, fichiers vus, décisions prises) reste attaché à la session, pas à la fenêtre.
Différence avec Cowork. Cowork (autre onglet de Claude Desktop) est un agent visuel pour utilisateurs non-dev : il pilote un navigateur dans une VM cloud et fait du clic-clic à votre place sur des sites web. Desktop Code est l'inverse : c'est le vrai Claude Code, qui agit sur des fichiers de code dans une UI graphique. Cowork = automatiser le web visuellement. Desktop Code = coder ou modifier du code visuellement.
Quand Desktop Code brille vs CLI vs extensions IDE
Desktop Code brille quand vous voulez une UI propre, des diffs lisibles, plusieurs sessions en parallèle sur des projets différents, ou quand vous n'avez pas envie de garder un terminal ouvert toute la journée. C'est aussi le bon choix pour démontrer Claude Code à quelqu'un qui n'est pas développeur (le visuel parle).
Le CLI brille dans tout ce qui est scriptable, batch, automatisé, ou quand vous êtes déjà dans un terminal (tmux, SSH sur un serveur, pipeline CI/CD). Plus rapide, plus léger, scriptable.
Les extensions IDE brillent quand vous voulez Claude Code à côté du code que vous éditez vous-même, avec accès direct aux fichiers ouverts, à la sélection en cours, aux erreurs du linter, à la console. C'est la surface la plus intégrée pour un dev qui code à plein temps dans VS Code ou JetBrains.
Les trois cohabitent sans se gêner. Beaucoup d'utilisateurs alternent : Desktop Code pour les sessions exploratoires ou métier, CLI pour les scripts, IDE pour le code au quotidien.
Pas à pas détaillé
Ouvrir l'onglet Code
- Lancez Claude Desktop (Mac ou Windows). Connectez-vous avec un compte Pro, Max, Team ou Enterprise.
- En haut de la fenêtre, repérez les trois onglets :
Chat,Cowork,Code. Cliquez surCode. - La première fois, l'app demande votre consentement pour accéder aux fichiers locaux. Acceptez.
Monter un projet
- Cliquez sur
Select folder(ou glissez-déposez un dossier dans la fenêtre). Pointez vers un dossier de projet versionné Git (recommandé, indispensable sous Windows). - Choisissez le type de session :
Local(machine actuelle),Remote(VM Anthropic) ouSSH(serveur distant). Pour commencer,Local. - Vérifiez que Claude affiche bien le nom du dossier en haut de la session et la liste des fichiers en sidebar.
Créer une session
- Cliquez sur
+ New sessionsi vous voulez plusieurs sessions en parallèle. Chaque session a son propre fil de dialogue et son propre contexte. - Choisissez le modèle (Opus, Sonnet ou Haiku) dans le menu déroulant. Sonnet par défaut.
- Vérifiez le mode d'approbation :
Ask permissions(recommandé) demande validation à chaque écriture,Auto acceptécrit directement (à réserver aux projets versionnés).
Exécuter un prompt
- Tapez une instruction concrète dans la zone de saisie. Exemple :
ajoute un README.md avec la description du projet, les prérequis et les commandes de démarrage. - Claude analyse le dépôt, propose un plan, puis affiche les modifications dans la vue
Diff(côté droit ou en overlay selon votre disposition).
Voir les diffs et sauvegarder
- Passez en revue chaque diff. Cliquez sur
Acceptpour appliquer la modification, surRejectpour la refuser, ou demandez à Claude de retravailler la proposition dans le chat. - Une fois les diffs acceptés, les fichiers sont écrits sur le disque. Vérifiez avec votre IDE ou un
git diffque le résultat correspond à vos attentes. - Commitez normalement avec votre client Git habituel : Desktop Code ne commite pas tout seul.
Cas d'usage avec exemples concrets
Ajouter un README à un projet existant
Ouvrir l'onglet Code, sélectionner le dépôt, taper : lis les fichiers source de ce projet et propose un README.md complet avec description, prérequis, installation et exemples d'usage. Claude scanne, propose, vous validez le diff.
Corriger les erreurs de lint d'un dépôt
Session sur le projet, prompt : lance le linter, identifie les erreurs et corrige-les fichier par fichier en me montrant chaque diff. Vous validez ou refusez chaque correction.
Refactor d'un module métier
Prompt : extrais la logique de calcul des frais kilométriques du fichier app.py dans un module dédié frais_km.py avec ses tests unitaires. Claude crée le module, le test, met à jour les imports. Diffs visuels, validation par étape.
Documentation technique d'un dépôt mal documenté
Prompt : pour chaque fichier Python du dossier src, ajoute des docstrings en français au format Google. Ne modifie pas le code, uniquement la documentation. Pratique pour rattraper la documentation sur un projet hérité.
À retenir
- L'onglet
Codeest le même Claude Code que le CLI ou les extensions IDE, juste avec une UI graphique. Pas un produit séparé, pas un moteur différent. - Vos
CLAUDE.md, vos serveurs MCP, vos skills et vos hooks sont partagés entre toutes les surfaces (CLI, IDE, Desktop Code). - Le mode par défaut
Ask permissionsest le bon mode pour découvrir l'outil : Claude ne touche à rien tant que vous n'avez pas approuvé un diff. - Sessions multiples en parallèle : vous pouvez avoir un onglet sur un projet client et un autre sur un script interne, sans interférence.
- Pour les profils non-dev, Desktop Code est la rampe d'accès la plus douce vers Claude Code. Une fois à l'aise, le passage au CLI ou aux extensions IDE est trivial.
Pièges à éviter
- Pas de Linux : l'app Claude Desktop n'existe pas sous Linux. Sur Linux, passez par le CLI (
curl -fsSL https://claude.ai/install.sh | bash). - Git obligatoire sous Windows : sans Git for Windows installé, les sessions Local plantent. Sur macOS, Git est livré par défaut avec les Xcode Command Line Tools.
- Confusion Cowork vs Code : Cowork est un agent visuel qui pilote un navigateur dans une VM cloud (automatisation web). Desktop Code agit sur des fichiers de code. Les deux cohabitent dans la même app mais ne servent pas au même usage.
- Plan gratuit insuffisant : si l'onglet Code propose un upgrade au clic, c'est qu'il faut au minimum un Pro. Le Free n'y a pas accès.
- Mode Auto accept sur dossier non versionné : pratique pour itérer vite, mais Claude écrit sans demander. À réserver aux projets sous Git, jamais sur un dossier sans contrôle de version.
- Sessions Local sur un dossier énorme : si vous pointez vers un dépôt de plusieurs gigaoctets ou des dizaines de milliers de fichiers, Claude rame à l'indexation. Ouvrez plutôt un sous-dossier ciblé.
- Oublier que c'est un agent : Desktop Code n'est pas un simple chat. Il peut lancer des commandes, lire et écrire des fichiers, modifier votre projet. Pas de blagues avec les permissions.
Exercice 1 minute
Ouvrez Claude Desktop, cliquez sur l'onglet Code, sélectionnez un petit dossier de test en mode Local et demandez : crée un fichier HELLO.md avec un titre et trois lignes de présentation du projet. Validez le diff proposé, puis vérifiez dans votre Finder ou Explorateur que le fichier est bien apparu. C'est tout : vous avez fait votre premier aller-retour avec Desktop Code.
Variantes par plan
- Free : pas d'accès à l'onglet Code (le clic propose un upgrade vers Pro).
- Pro : accès complet à l'onglet Code, sessions Local, Remote et SSH, choix entre Opus, Sonnet et Haiku.
- Max : équivalent Pro avec limites d'usage 5x à 20x plus généreuses (sessions longues, parallélisme accru).
- Team : mêmes capacités fonctionnelles, gestion centralisée des membres, facturation, politique d'accès. L'admin peut restreindre les sessions Remote.
- Enterprise : SSO, audit logs, administration des sessions remote, politiques de sécurité, contrôle granulaire des skills et MCP autorisés.
Liens internes
- Feature liée :
claude-code/01-cli-base(même moteur en ligne de commande, plus scriptable) - Feature liée :
claude-code/02-extensions-ide(même moteur dans VS Code et JetBrains, intégré à l'IDE) - Feature liée :
desktop/02-cowork(agent visuel qui pilote un navigateur, à ne pas confondre avec Desktop Code)