Bulkhead empêche les sessions parallèles de Claude Code de faire planter votre machine

Les développeurs exécutant plusieurs instances de Claude Code sur une seule station de travail font souvent face à une contention des ressources, où un agent tue accidentellement le serveur d'un autre ou épuise la mémoire système. Un nouvel outil open source nommé claude-bulkhead résout ce problème en installant des hooks légers qui surveillent et restreignent les commandes shell entre les sessions parallèles. Publié en novembre 2026, il permet aux ingénieurs d'exécuter en toute sécurité des assistants IA concurrents sans gestion manuelle des processus.

Ce qui s'est passé

À mesure que les assistants de codage IA deviennent plus autonomes, les développeurs exécutent de plus en plus de sessions simultanément, utilisant souvent des worktrees git distincts pour différentes branches ou fonctionnalités. Bien que git isole les modifications de code, le système d'exploitation sous-jacent n'isole pas les ressources telles que les ports, la mémoire ou les processus actifs. Cela entraîne des collisions fréquentes où une commande de maintenance courante d'un agent, comme le redémarrage d'un serveur de développement, termine involontairement les processus appartenant à d'autres sessions actives.

Le créateur de claude-bulkhead a identifié ces points de friction grâce à de nombreux rapports communautaires signalant que des agents tuaient des services critiques ou gelaient des machines en saturant la RAM. Pour résoudre ce problème, ils ont développé un ensemble de huit garde-fous spécifiques agissant comme intermédiaires entre l'agent IA et le shell. Ces garde-fous interceptent les commandes avant leur exécution, les vérifiant par rapport à l'état actuel de toutes les autres sessions actives sur la machine.

L'outil fonctionne avec zéro dépendance externe au-delà de Node.js 18, ce qui facilite son installation via la marketplace de plugins Claude Code. Il inclut une fonctionnalité de scan qui analyse les transcriptions des sessions passées pour montrer aux utilisateurs combien de conflits auraient été évités si l'outil avait été actif, offrant une visibilité immédiate sur l'ampleur du problème sans altérer les workflows existants.

Comment cela fonctionne

Claude-bulkhead exploite le système de hooks natif de Claude Code, qui permet à de petits programmes de s'exécuter à des points fixes, tels qu'avant chaque commande shell. Lorsqu'un agent tente d'exécuter une commande Bash ou PowerShell, le garde-fou pertinent l'intercepte. Le garde-fou lit ensuite le répertoire d'état global, qui suit les sessions actives, leurs ports assignés et leur utilisation de la mémoire. Si une commande viole une règle de sécurité, le hook la bloque et renvoie un message d'erreur spécifique avec une alternative plus sûre.

Par exemple, si un agent tente de tuer tous les processus Node pour redémarrer un serveur, le kill-guard vérifie si certains de ces processus appartiennent à d'autres sessions. Si c'est le cas, la commande est bloquée, et l'agent est instruit de cibler uniquement son propre ID de processus. De même, le memory-guard surveille la RAM disponible et peut mettre en file d'attente les tâches lourdes en utilisant un système de slots partagés, garantissant que trois processus de build simultanés ne gèlent pas toute la machine.

Le système inclut également un orphan-reaper qui se déclenche lorsqu'une session se termine. Il identifie automatiquement et arrête les serveurs de dev, les workers de test ou les watchers laissés actifs par la session sortante. Cela prévient le problème courant des processus « zombies » consommant des ressources longtemps après que l'agent IA a terminé sa tâche. Tout l'état est géré localement dans un répertoire dédié, garantissant qu'aucune donnée ne quitte la machine.

Détails clés

• Huit garde-fous spécialisés : Inclut kill-guard, port-guard, memory-guard, checkout-guard, wait-guard, orphan-reaper, disk-guard et basics.
• Architecture sans dépendances : Nécessite uniquement Node.js 18 ou ultérieur, sans autres bibliothèques externes ni services requis.
• Scan de transcription : La commande bulkhead scan rejoue les logs des sessions passées pour identifier les conflits historiques sans modifier aucune donnée.
• Prise en charge de l'exécution distante : La fonctionnalité optionnelle bulkhead remote permet de déléguer les builds ou tests lourds à une autre machine via SSH.
• Statut en temps réel : Fournit une ligne de statut affichant les sessions actives, la mémoire libre et les tâches en file d'attente avec une latence inférieure à 100 ms.
• Paramètres de sécurité par défaut : Bloque les opérations dangereuses comme rm -rf sur les répertoires racines et empêche par défaut les commits signés par « Claude ».

Pourquoi c'est important

Pour les responsables techniques et les ingénieurs développant des produits avec l'IA, la fiabilité est primordiale. L'exécution de multiples agents IA en parallèle est une façon puissante d'accélérer le développement, mais elle introduit une complexité opérationnelle que les outils traditionnels ne gèrent pas. Sans isolation, le coût du débogage des problèmes d'environnement causés par l'interférence des agents peut dépasser le temps gagné par l'automatisation. Claue-bulkhead restaure la prévisibilité de l'environnement de développement en imposant des limites dont le système d'exploitation manque.

Cet outil met également en lumière un changement dans la manière dont nous gérons les agents IA. Au lieu de les traiter comme de simples générateurs de texte, nous devons les gérer comme des processus concurrents ayant des besoins en ressources et des effets secondaires potentiels. En implémentant des patterns bulkhead—nommés d'après les compartiments étanches des navires qui empêchent l'inondation de couler tout le vaisseau—les développeurs peuvent faire évoluer leur usage de l'IA en toute sécurité. Cette approche réduit la charge cognitive des ingénieurs qui n'ont plus besoin de suivre manuellement quels ports sont utilisés ou quels processus appartiennent à quelle branche.

Ce que vous pouvez faire

• Installez le plugin via la marketplace Claude Code en utilisant /plugin install bulkhead@bulkhead.
• Exécutez /bulkhead:scan 30d pour analyser vos transcriptions du mois dernier et voir les conflits potentiels.
• Utilisez /bulkhead:doctor pour vérifier que tous les garde-fous sont correctement configurés et opérationnels.
• Surveillez les sessions actives et l'utilisation des ressources en temps réel avec la commande bulkhead top.
• Configurez des listes blanches ou des seuils spécifiques dans le fichier de configuration du projet si certaines commandes nécessitent des exceptions.
• Envisagez de configurer bulkhead remote si vous atteignez fréquemment les limites de mémoire lors des builds locaux.