Note d'architecture interne · workspace D:\Claude Code\

Où Claude Code
range ce qu'il retient

Il y a deux mémoires qui se ressemblent et qu'on confond tout le temps. L'une est le savoir de l'entreprise. L'autre est le bloc-notes de l'assistant. Voici comment elles se séparent, qui décide quoi, et ce qui est sauvegardé où.

🟦 KB métier · versionnée 🟥 mémoire auto · locale ⚙️ qui contrôle quoi 💾 sauvegarde
Le point de départ

Deux mondes sur le disque, jamais au même endroit

Avant même de parler de mémoire, il faut voir que Claude Code vit dans deux dossiers complètement distincts. VS Code ne t'en montre qu'un. C'est la source n°1 de confusion.

🗂️ Le workspace

D:\Claude Code\

Tes projets, ton code, ta base de connaissances. C'est ce que tu ouvres dans VS Code et ce qui part dans tes dépôts Git.

✓ visible dans VS Code

⚙️ Les coulisses de Claude Code

C:\Users\michael\.claude\

La configuration, les transcriptions, et la mémoire auto. Géré par l'outil, dans ton profil Windows.

✗ invisible dans VS Code
Tu ne retrouveras jamais une fiche de mémoire auto dans l'arbre VS Code de D:\Claude Code\ — elle n'y est pas. Elle vit dans l'autre monde, que VS Code ne montre pas.
Le cœur du sujet

Deux dossiers « memory » qui n'ont rien à voir

Les deux s'appellent memory. C'est tout ce qu'ils ont en commun. La vraie différence n'est pas technique — elle est de nature : à qui appartient l'info, et à quoi elle sert.

🟦 MÉMOIRE BLEUE

La KB — le savoir de l'entreprise

Un livrable. Un actif d'IoT-Link.
  • Quoi : décisions, registres, conventions, tableaux de bord, références métier.
  • Pour qui : des humains. Toi, un associé, une autre machine, demain un autre outil.
  • Versionnée dans Git, poussée sur GitHub → historique + sauvegarde off-machine.
  • Survit à l'outil : reste 100 % pertinente même sans Claude Code.
D:\Claude Code\iot-link\memory\ · visible dans VS Code
🟥 MÉMOIRE ROUGE

La mémoire auto — mon bloc-notes

Un cache de confort, lié à l'outil.
  • Quoi : astuces pour mieux bosser — un piège technique, une préférence, « cet outil existe ».
  • Pour qui : moi, l'assistant, à la session suivante.
  • Pas dans Git · silotée par dossier · sauvegardée seulement par le script claude-home.
  • Jetable : si tu quittais Claude Code, elle ne te manquerait pas.
C:\Users\michael\.claude\projects\…\memory\ · invisible dans VS Code
La règle de tri en une phrase : le savoir va dans la bleue ; les astuces pour que je travaille bien vont dans la rouge.
La question qui fâche

Qui décide ? Trois couches, trois niveaux de prise

« Est-ce qu'on a vraiment la main, ou est-ce qu'Anthropic décide tout ? » Réponse honnête : ça dépend de la couche.

1

La plomberie

Que la mémoire auto existe, où elle vit, son cloisonnement par dossier, le rechargement auto, le format des fiches. C'est du Claude Code « usine ».

Anthropic · aucune prise
2

La décision d'écrire

Si un fait mérite une fiche. C'est mon jugement, sur le moment, guidé par des consignes générales. Pas une loi déterministe — deux sessions peuvent trancher différemment.

Moi · prise indirecte
3

Le tri métier ↔ confort + la KB

Écrit nulle part chez Anthropic. Ça émerge de ton architecture : c'est toi qui as créé la KB, les registres, la Règle 0. Le levier, c'est le CLAUDE.md, qui infléchit mon jugement.

Nous · prise réelle
La nuance à ne pas perdre : cette prise par le CLAUDE.md n'est pas un interrupteur dur. C'est de l'influence sur un jugement, pas une contrainte mécanique. La discipline tient parce qu'une règle écrite existe et que tu me reprends quand je dérape.
L'outil mental

Le test pour trancher en 2 secondes

Quand on hésite sur l'endroit où ranger une info, une seule question suffit.

« Est-ce que ce serait vrai même si on n'avait jamais construit cet outil ? »
OUI → ça décrit le PRODUIT

🟦 Mémoire bleue (KB)

L'API, le firmware, le portail, une décision, un contact. C'est du savoir métier. Il doit être versionné, partagé, auditable.

NON → ça décrit l'OUTIL

🟥 Mémoire rouge (auto)

La mécanique, ma façon de travailler, un piège de déploiement. Idéalement avec un pointeur vers la bleue.

Cas réel — le fait « l'API IoT-Link n'a pas de CORS » :

🟦 LE FAIT MÉTIER → KB
« L'API n'émet aucun en-tête CORS — vérifié 08/06. »
Gravé dans iot-link/knowledge/portail-db/api-rest-v1.md (commit c7301cb, poussé). C'est l'autorité.
🟥 LA RAISON D'ARCHI → auto
« Cet outil a un proxy parce que l'API n'a pas de CORS. »
Dans la fiche de l'outil de test. Elle ne duplique pas le fait : elle pointe vers la KB.
Même phrase, deux sujets différents : le produit (→ bleue, autorité) vs pourquoi l'outil est bâti comme ça (→ rouge, avec renvoi). La rouge ne fait jamais autorité sur le métier.
Le piège à connaître

La mémoire rouge est cloisonnée par dossier

Chaque dossier de travail a sa propre mémoire auto. Une fiche écrite dans un projet ne suit pas dans un autre. C'est imposé par l'outil.

# Un silo mémoire séparé par dossier ouvert : ~/.claude/projects/ ├── d--Claude-Code/memory/ # racine du workspace ├── d--Claude-Code-iot-link/memory/ # KB → la fiche outil-test est ICI ├── d--Claude-Code-sites/memory/ # les sites └── …/ # un silo par projet
La conséquence : un réflexe qui doit valoir partout (ex. « comment publier sur Cloudflare ») ne va pas en mémoire auto — il irait dans un seul silo. Il va dans le CLAUDE.md, qui lui remonte l'arbre des dossiers et se charge dans toutes les sessions. C'est le seul véhicule d'un réflexe universel.
Ce qui est à l'abri (ou pas)

Versionné ≠ sauvegardé : la nuance qui compte

Deux notions différentes. Un dossier peut être sauvegardé sans avoir d'historique Git — et c'est le cas de la mémoire rouge.

Ce qui est écrit Versionné
(historique Git)
Copie off-machine Comment
🟦 Dépôts projets & workspace
KB, sites, fichiers workspace
✓ oui ✓ oui GitHub, automatique au push
🟥 Mémoire auto + config
tout le dossier ~/.claude/
✗ non ⚠ oui, mais manuel Archive chiffrée claude-home → lancer sauvegarder.ps1
Identifiants & transcriptions ✗ non ✗ non Exclus volontairement (sécurité)
Le piège « manuel » : claude-home n'est pas une synchro continue type Dropbox — c'est une photo que tu prends en lançant le script. Si la dernière photo a 10 jours, tout ce que la mémoire rouge a appris depuis n'a aucune copie off-machine. Réflexe : relancer le script après une session qui a beaucoup gravé.
À relire en cas de doute

Le mémo

🧭 Les 6 réflexes

🗂️Deux mondes. D:\Claude Code\ = visible dans VS Code. ~/.claude/ = coulisses invisibles.
🟦Bleue = savoir métier. Versionnée Git, partagée, durable. C'est un livrable de l'entreprise.
🟥Rouge = bloc-notes de l'assistant. Locale, silotée, jetable. Liée à l'outil.
Le test : « vrai même sans cet outil ? » → oui = bleue (produit), non = rouge (outil).
🌳Réflexe universel ?CLAUDE.md, pas la mémoire auto (qui est cloisonnée par dossier).
💾Sauvegarde : les dépôts Git sont à l'abri au push ; ~/.claude/ seulement après un sauvegarder.ps1 manuel.