Pourquoi l'espace Claude est commun à tous les worktrees¶
Cette page explique le pourquoi d'une décision d'infrastructure de dev : sortir l'espace utilisateur de Claude Code de ~/.claude pour le loger dans un dossier dédié au projet, ~/.kirexo/claude, unique et partagé entre l'hôte et tous les worktrees. Elle expose les contreparties assumées et ce qui reste ouvert.
Pour les gestes, voir castor claude:space ; pour la moitié « jeton » du même dossier, voir Créer et faire tourner le jeton GitLab de Kirexo.
Le problème : un espace personnel qui n'avait rien à faire là¶
Le dispositif d'origine montait ~/.claude de l'hôte tel quel dans le conteneur php. Son motif était légitime — sans ce bind, il fallait se ré-authentifier à chaque ouverture — mais le prix a grossi avec le temps.
~/.claude n'est pas un dossier de projet : c'est l'espace personnel de Claude Code sur la machine. Il contient projects/<slug>/ pour chaque dépôt jamais ouvert sur l'hôte — soit, sur un poste de développeur freelance, plusieurs centaines de mégaoctets de transcrits de conversations appartenant à d'autres clients. Un agent qui tourne sur Kirexo en bypassPermissions n'a aucune raison de pouvoir lire ça. En face, ~/.config/glab-cli était monté lui aussi : le jeton du compte GitLab, qui ouvre 20+ projets dont ceux de tiers.
Deux fuites du même genre, avec la même réponse : ne plus monter l'espace personnel, monter un espace dédié au projet.
La décision : un espace unique, pas un espace par worktree¶
L'alternative naturelle aurait été un espace par worktree (~/.kirexo/<ticket>/claude). Elle a été écartée au profit d'un espace unique commun à l'hôte et à tous les worktrees.
La raison est ergonomique, et elle est le cœur de la décision : une conversation démarrée dans le worktree du ticket 185 doit être listée et reprise par claude --resume depuis le worktree du ticket 212, mémoire comprise. Un espace par worktree fragmenterait l'historique exactement au moment où on en a le plus besoin : quand on revient sur un sujet traité ailleurs, deux semaines plus tôt.
Le corollaire est que l'espace n'est pas une frontière d'isolation entre worktrees. Il n'a jamais prétendu l'être : l'isolation, ici, se joue entre le projet Kirexo et le reste de la machine — pas entre deux tickets du même projet.
Pourquoi le slug -app suffit¶
Claude Code range ses conversations sous projects/<slug>/, où le slug dérive du chemin absolu du répertoire de travail : /home/user/work/my-repo devient -home-user-work-my-repo.
Or chaque worktree Kirexo est monté sur /app dans son conteneur. Le slug vaut donc -app partout, quel que soit le worktree, quel que soit le ticket. Deux conteneurs différents, montant deux checkouts différents, écrivent dans le même projects/-app/.
La reprise cross-worktree ne demande donc aucun code : elle tombe du chemin de montage. C'est le genre de propriété qu'il faut nommer explicitement, parce qu'elle est involontaire par construction — et parce que la même propriété fonde la question ouverte de la dernière section.
Pourquoi un dossier en lecture-écriture complète, et pas une liste blanche¶
L'instinct sécurité voudrait projeter fichier par fichier ce dont Claude Code a besoin. Il a été écarté, et c'est un choix délibéré.
L'inventaire officiel de l'espace utilisateur comprend, entre autres : projects/<projet>/<session>.jsonl, projects/<projet>/<session>/subagents/, .../tool-results/, projects/<projet>/memory/, file-history/<session>/, history.jsonl, paste-cache/, image-cache/, session-env/, shell-snapshots/, tasks/, debug/, plans/, plugins/, backups/, todos/, statsig/, logs/. Une liste blanche de cette taille a deux défauts rédhibitoires : elle plante au premier oubli (un dossier absent devient un répertoire root:root créé par Docker, et Claude Code part en erreur au boot), et elle périme silencieusement à chaque version de l'outil qui ajoute un sous-dossier.
La logique est donc inversée : un dossier dédié, entièrement en lecture-écriture, dont on sait qu'il ne contient que Kirexo. La question n'est plus « qu'est-ce que j'autorise dans un dossier partagé » mais « qu'est-ce que je mets dans un dossier qui n'a rien d'autre ».
Trois fichiers seulement sont projetés depuis l'espace personnel de l'hôte, et leurs modes ne sont pas symétriques :
.credentials.jsonen lecture-écriture — Claude Code réécrit ce fichier à chaque rafraîchissement du jeton OAuth, toutes les 12 à 24 h. En lecture seule, le rafraîchissement ne serait pas persisté et il faudrait se reconnecter presque tous les jours.settings.jsonetCLAUDE.mden lecture seule — un agent compromis (postinstall hostile, CVE dans une dépendance) ne doit pouvoir ni désactiver la deny-list utilisateur qui le verrouille, ni injecter des instructions globales. La lecture, elle, reste nécessaire et autorisée. C'est le substrat de l'invariant de confinementC5(cf. Modèle de menace et contrat de confinement).
Cette lecture seule a une conséquence qui ne se devine pas. Claude Code écrit de lui-même dans le settings.json utilisateur — en particulier le consentement skipDangerousModePermissionPrompt, qu'il y pose quand on valide le dialogue d'avertissement du mode bypassPermissions. Dans le conteneur, cette écriture échoue, et l'unique symptôme est le dialogue qui revient à chaque ouverture de session. C'est pourquoi ce consentement est logé ailleurs : dans le .claude/settings.local.json du worktree, que castor wt:up aligne à chaque appel. Le reste de l'espace est bien inscriptible — ce ne sont pas les dossiers qui bloquent, ce sont ces deux fichiers-là, et c'est exactement ce qu'on leur demande.
Le seeding, lui, est volontairement partiel : castor claude:space recopie au premier démarrage plugins/, agents/, commands/ et skills/ — la configuration personnelle qu'on veut conserver — et jamais projects/, history.jsonl, file-history/ ni backups/. Ce sont précisément ceux-là qu'on ferme. De même, .claude.json est recopié filtré de ses clés mcpServers (serveurs MCP personnels, dont des jetons potentiellement en clair) et projects (chemins, décisions de confiance et métriques de tous les dépôts de l'hôte) : les recopier rouvrirait la fuite qu'on vient de fermer. Le détail de ce filtrage vit dans infra/claude-space/bootstrap.lib.sh.
Deux écritures concurrentes, aucun verrou¶
Un espace partagé entre plusieurs agents qui tournent en parallèle pose une question de concurrence. Elle a une réponse courte : le gros de l'espace n'a rien à protéger.
Les transcrits sont un .jsonl par session, plus un dossier par session. Deux agents concurrents écrivent des fichiers distincts — il n'y a pas de contention du tout. Restent deux fichiers réellement partagés :
| Fichier | Nature de l'écriture | Risque réel | Traitement |
|---|---|---|---|
.claude.json (~50 Ko) |
réécriture complète | last-writer-wins sur des caches, des compteurs et des bascules d'interface | accepté — Claude Code conserve de lui-même des copies horodatées sous backups/ avant toute migration de configuration |
history.jsonl (~450 Ko) |
append | entrelacement théorique de lignes (le rappel de prompt à la flèche haut) | accepté |
Aucun flock, aucune sérialisation, aucun verrou. Ce n'est pas un oubli : le coût d'un verrou — des agents bloqués en attente, un deadlock au premier process tué — dépasse largement l'impact d'un compteur d'interface perdu. Perdre l'état d'un toggle d'UI est un incident nul ; bloquer un agent de développement pendant qu'un autre écrit un fichier de 50 Ko est un incident réel.
La contrepartie assumée¶
Un espace commun signifie lecture croisée : un agent compromis dans le worktree du ticket 185 peut lire les conversations menées dans le worktree du ticket 212. C'est le prix direct de la reprise cross-worktree — la même propriété, vue de l'autre côté.
Ce prix est accepté parce que le périmètre est borné : ce sont les worktrees du même projet, tous porteurs du même code, du même contexte et des mêmes secrets de dev. Le gain de confidentialité qu'apporterait un cloisonnement entre eux est marginal ; le coût ergonomique, lui, est quotidien.
Ce qui est fermé, en revanche, l'est réellement :
- les transcrits de tous les autres projets de l'hôte (
~/.claude/projects/, plusieurs centaines de mégaoctets) — plus montés du tout ; - la configuration
glabdu compte (~/.config/glab-cli), qui donnait accès à 20+ projets dont ceux de tiers — remplacée par un jeton dédié à Kirexo, injecté par variable d'environnement ; - les serveurs MCP personnels et les métadonnées de projets de
~/.claude.json— filtrés au seeding.
La frontière a changé de place : elle ne passe plus entre l'hôte et le conteneur, elle passe entre Kirexo et le reste de la machine.
Question ouverte : /rewind après une reprise cross-worktree¶
Un point n'est pas tranché, et il est consigné ici tel quel plutôt que deviné.
Claude Code enregistre des points de restauration avant chaque édition de fichier, dans file-history/<session>/. La documentation officielle précise que ces checkpoints sont sauvegardés avec la conversation : /rewind reste donc disponible après un claude --resume. Et la restauration agit par chemin de fichier.
Or tous les worktrees sont montés sur /app. Un snapshot pris dans le worktree A porte le chemin /app/src/Entity/Article.php — qui désigne un autre fichier, sur une autre branche, dans le worktree B. La question n'est pas « est-ce qu'un worktree peut lire l'autre » (non, ils ne se voient pas), mais : est-ce qu'un /rewind, après une reprise cross-worktree, peut écrire dans le worktree courant un contenu venu d'un autre ?
La vérification exige deux worktrees simultanés, que castor wt:up sait créer — mais le protocole n'a pas été joué : aucun résultat n'est donc annoncé ici, plutôt qu'un comportement supposé. Le jour où il le sera, le comportement observé et la version de Claude Code sur laquelle il l'aura été seront consignés dans cette page.
En attendant, la conduite à tenir est simple et suffit : après une reprise cross-worktree, restaurer avec git, pas avec /rewind. git diff, git restore, git stash raisonnent sur le worktree courant, par construction — ils ne peuvent pas se tromper de cible.
Voir aussi¶
castor claude:space— la cible qui prépare~/.kirexo/, ses options et son idempotence.castor wt:claude— la cible qui ouvre une session dans le conteneur d'un worktree, et donc le geste par lequel cet espace commun se constate (castor wt:claude --resume, depuis le répertoire du worktree).- Créer et faire tourner le jeton GitLab de Kirexo — l'autre moitié de
~/.kirexo/. - Variables d'environnement — Espace Claude et jeton GitLab (dev local) —
CLAUDE_CONFIG_DIRetGITLAB_TOKENcôté dev. - Modèle de menace et contrat de confinement — les invariants
C1(binds autorisés) etC5(fichiers de l'espace Claude) que ce dispositif alimente. - Pourquoi l'agent pousse lui-même, et ce qui le retient — l'autre dossier partagé entre l'hôte et tous les worktrees,
var/claude, et l'arbitrage de sécurité qui l'accompagne. À ne pas confondre avec~/.kirexo/claude, objet de cette page : l'un porte l'espace utilisateur de Claude Code, l'autre la mémoire de travail des skills. - Pourquoi la sortie réseau passe par un proxy à allowlist — l'autre volet du confinement, côté réseau.