Claude Code prend désormais en charge le travail sur plusieurs répertoires dans une seule session à l'aide de l'indicateur --add-dir et de la commande interactive /add-dir. Cela élimine le changement constant de contexte entre les projets.
Qu'est-ce que le support multi-répertoire
Fonctionnalité principale
L'indicateur --add-dir /path/to/dir ajoute des répertoires à votre session Claude Code sans modifier votre répertoire de travail. Utilisez /add-dir <path> pendant les sessions interactives pour étendre votre espace de travail de manière dynamique.
Claude Code maintient les relations entre les fichiers à travers différentes structures de répertoires tout en préservant les performances. Le système gère automatiquement la résolution des chemins lorsque vous référencez des fichiers à partir de répertoires ajoutés.
Cas d'utilisation clés
Monorepos
Travaillez sur les modules frontend, backend et partagés sans changer de session. Les grandes applications avec une séparation logique bénéficient d'un accès unifié à tous les composants.
Fichiers de configuration partagés
Accédez aux fichiers de configuration, à la documentation et aux artefacts de développement stockés dans des emplacements séparés. Les fichiers de productivité personnels et la documentation d'équipe deviennent constamment disponibles à travers les sessions.
Développement inter-projets
Gérez simultanément des dépôts interconnectés. Les clients API restent synchronisés avec les implémentations de serveur. La documentation se met à jour en même temps que les modifications de code.
Stratégies d'implémentation
Configuration de l'espace de travail
- Identifiez votre répertoire de travail principal
- Ajoutez des répertoires liés à l'aide de
--add-dir - Créez des alias de shell pour les configurations courantes
- Établissez des modèles de répertoires à l'échelle de l'équipe
Optimisation des performances
- Ajoutez uniquement les répertoires que vous utilisez activement
- Évitez les répertoires contenant des artefacts de construction
- Surveillez l'utilisation des jetons de contexte avec de grandes configurations
- Utilisez des chemins absolus pour un accès fiable
Intégration au développement
Le support multi-répertoire fonctionne avec les flux de travail Git existants, les systèmes CI et les pipelines de déploiement. Les outils de développement API comme Apidog peuvent surveiller les spécifications à travers plusieurs répertoires de projet.
Exemples pratiques
Architecture de microservices
Accédez aux implémentations de services, aux bibliothèques partagées, aux modèles de configuration et aux scripts de déploiement en une seule session. Référencez les modèles existants lors du développement de nouveaux services.
Contributions open source
Travaillez simultanément avec des dépôts forkés, des sources en amont et des configurations personnelles. Maintenez des contributions propres tout en accédant à toutes les bases de code pertinentes.
Infrastructure as Code
Gérez les définitions d'applications, les configurations de déploiement et les configurations de surveillance à travers plusieurs dépôts. Maintenez la cohérence lors des changements d'infrastructure.
Bonnes pratiques
Gestion de la configuration
Utilisez des chemins absolus pour éviter les problèmes de résolution. Vérifiez les permissions de lecture pour tous les répertoires. Créez des configurations standardisées pour la cohérence de l'équipe.
Considérations de sécurité
Examinez le contenu des répertoires avant de les ajouter. Excluez les informations sensibles et les identifiants de production. Utilisez des répertoires de développement dédiés.
Surveillance des performances
Surveillez l'utilisation de la mémoire avec des structures de répertoires étendues. Les répertoires locaux offrent de meilleures performances que ceux montés en réseau. Supprimez les répertoires inutilisés des sessions.
Fonctionnalités avancées
Intégration en ligne de commande
claude-code --add-dir /path/to/backend --add-dir /path/to/frontend
Commandes interactives
/add-dir /path/to/shared-config
/add-dir /path/to/documentation
Flux de travail d'équipe
Standardisez les configurations multi-répertoires entre les équipes. Documentez les modèles courants pour une expérience développeur cohérente. Intégrez-vous aux processus d'intégration.
Flux de travail de développement API
Le support multi-répertoire améliore le développement API-first. Les services backend, la documentation, les SDK clients et les suites de tests existent souvent dans des dépôts séparés mais nécessitent des mises à jour synchronisées.
Apidog fournit des interfaces de test unifiées qui fonctionnent sur votre espace de travail multi-répertoire. Cela garantit la cohérence des API lorsque vous développez des fonctionnalités couvrant plusieurs projets.
Dépannage des problèmes courants
Problèmes de résolution de chemin
- Utilisez des chemins absolus au lieu de chemins relatifs
- Vérifiez que les liens symboliques fonctionnent correctement
- Vérifiez les permissions de répertoire
Problèmes de performances
- Limitez les répertoires ajoutés à ceux qui sont nécessaires
- Surveillez les ressources système
- Supprimez les répertoires inutilisés pendant les longues sessions
Contrôle d'accès
- Assurez-vous d'avoir les permissions de lecture appropriées
- Évitez d'ajouter des répertoires contenant des données sensibles
- Utilisez des structures de répertoires spécifiques au développement
Améliorations futures
La communauté demande des fichiers de configuration pour des configurations d'espace de travail persistantes. Cela permettrait une standardisation à l'échelle de l'équipe et réduirait les tâches de configuration répétitives.
Les opportunités d'intégration avec les plateformes de développement continuent de s'étendre. Les outils de développement API, les systèmes de gestion de projet et les plateformes de collaboration peuvent tirer parti des capacités d'espace de travail améliorées.
Conclusion
Le support multi-répertoire de Claude Code élimine les frictions de flux de travail dans le développement moderne. Les monorepos, les microservices et la collaboration inter-projets deviennent transparents sans le surcoût du changement de contexte.
Commencez par des configurations simples à deux répertoires et développez-vous en fonction des besoins du projet. La courbe d'apprentissage minimale apporte des améliorations significatives de la productivité à mesure que la complexité du projet augmente.
Combiné avec des outils de test API complets comme Apidog, le support multi-répertoire crée des expériences de développement de bout en bout rationalisées. Expérimentez avec des configurations qui correspondent à vos exigences de projet spécifiques pour un bénéfice maximal.