Passer au contenu principal
Interface Claude Code sur le bureau

Claude Code sur le bureau (Aperçu)

L’application Claude de bureau fournit une interface native pour exécuter plusieurs sessions Claude Code sur votre machine locale et une intégration transparente avec Claude Code sur le web.

Installation

Téléchargez l’application Claude de bureau pour votre plateforme : Pour Windows ARM64, téléchargez ici.
Les sessions locales ne sont pas disponibles sur Windows ARM64.

Fonctionnalités

Claude Code sur le bureau fournit :
  • Sessions locales parallèles avec des git worktrees : Exécutez plusieurs sessions Claude Code simultanément dans le même référentiel, chacune avec son propre git worktree isolé
  • Incluez les fichiers listés dans votre .gitignore dans vos worktrees : Copiez automatiquement les fichiers de votre .gitignore, comme .env, vers les nouveaux worktrees en utilisant .worktreeinclude
  • Lancez Claude Code sur le web : Démarrez des sessions cloud sécurisées directement depuis l’application de bureau

Utilisation des Git worktrees

Claude Code sur le bureau permet d’exécuter plusieurs sessions Claude Code dans le même référentiel en utilisant les Git worktrees. Chaque session obtient son propre worktree isolé, permettant à Claude de travailler sur différentes tâches sans conflits. L’emplacement par défaut des worktrees est ~/.claude-worktrees mais cela peut être configuré dans vos paramètres sur l’application Claude de bureau.
Si vous démarrez une session locale dans un dossier qui n’a pas Git initialisé, l’application de bureau ne créera pas de nouveau worktree.

Copie des fichiers ignorés avec .gitignore

Lorsque Claude Code crée un worktree, les fichiers ignorés via .gitignore ne sont pas automatiquement disponibles. L’inclusion d’un fichier .worktreeinclude résout ce problème en spécifiant quels fichiers ignorés doivent être copiés vers les nouveaux worktrees. Créez un fichier .worktreeinclude à la racine de votre référentiel :
.env
.env.local
.env.*
**/.claude/settings.local.json
Le fichier utilise des motifs de style .gitignore. Lorsqu’un worktree est créé, les fichiers correspondant à ces motifs qui sont également dans votre .gitignore seront copiés de votre référentiel principal vers le worktree.
Seuls les fichiers qui correspondent à la fois à .worktreeinclude ET qui sont listés dans .gitignore sont copiés. Cela empêche de dupliquer accidentellement les fichiers suivis.

Lancez Claude Code sur le web

Depuis l’application de bureau, vous pouvez démarrer des sessions Claude Code qui s’exécutent sur l’infrastructure cloud sécurisée d’Anthropic. Pour démarrer une session web depuis le bureau, sélectionnez un environnement distant lors de la création d’une nouvelle session. Pour plus de détails, consultez Claude Code sur le web.

Version groupée de Claude Code

Claude Code sur le bureau inclut une version groupée et stable de Claude Code pour assurer une expérience cohérente pour tous les utilisateurs de bureau. La version groupée est requise et téléchargée au premier lancement même si une version de Claude Code existe sur l’ordinateur. Le bureau gère automatiquement les mises à jour de version et nettoie les anciennes versions.
La version groupée de Claude Code dans Desktop peut différer de la dernière version CLI. Desktop privilégie la stabilité tandis que la CLI peut avoir des fonctionnalités plus récentes.

Configuration de l’environnement

Pour les environnements locaux, Claude Code sur le bureau extrait automatiquement votre variable d’environnement $PATH de la configuration de votre shell. Cela permet aux sessions locales d’accéder aux outils de développement comme yarn, npm, node et autres commandes disponibles dans votre terminal sans configuration supplémentaire.

Variables d’environnement personnalisées

Sélectionnez l’environnement « Local », puis à droite, sélectionnez le bouton des paramètres. Cela ouvrira une boîte de dialogue où vous pouvez mettre à jour les variables d’environnement locales. Ceci est utile pour définir des variables spécifiques au projet ou des clés API que vos flux de travail de développement nécessitent. Les valeurs des variables d’environnement sont masquées dans l’interface utilisateur pour des raisons de sécurité.
Les variables d’environnement doivent être spécifiées sous forme de paires clé-valeur, au format .env. Par exemple :
API_KEY=your_api_key
DEBUG=true

# Multiline values - wrap in quotes
CERT="---BEGIN CERT---
MIIE...
---END CERT---"

Configuration d’entreprise

Les organisations peuvent désactiver l’utilisation locale de Claude Code dans l’application de bureau avec l’option de politique d’entreprise isClaudeCodeForDesktopEnabled enterprise policy option. De plus, Claude Code sur le web peut être désactivé dans vos paramètres d’administration.

Ressources connexes