MEMCLAUDE

Sauvegardez la mémoire de Claude Code, et réinjectez-la sur un autre PC.

---

Aperçu rapide · Quick Overview

1 — Sauvegarder	2 — Restaurer	3 — Aperçu	Cinq langues
Choisir quoi archiver, voir le poids réel de chaque catégorie avant de lancer	Réinjecter une archive dans le dossier .claude de la machine courante	Parcourir et lire le contenu d'un dossier ou d'une archive avant d'agir	Interface en FR, EN, ES, PT et DE, changeable sans redémarrer

---

Français

Description

MEMCLAUDE archive le dossier .claude de Claude Code dans un fichier ZIP horodaté, puis sait le réinjecter dans le dossier .claude d'une autre machine. Mémoire, instructions globales, skills personnels et transcriptions de conversations : tout ce qui constitue le contexte accumulé au fil des sessions, et que rien ne sauvegarde par défaut.

Fini le dossier .claude qu'on découvre vide après une réinstallation, ou la mémoire patiemment constituée sur le poste fixe qui reste sur le poste fixe : sur le PC 1 vous cliquez sur Sauvegarder, vous emportez le ZIP, et sur le PC 2 vous cliquez sur Réinjecter.

Fonctionnalités

• Quatre catégories cochables : mémoire (projects/*/memory), configuration (CLAUDE.md, settings.json), skills personnels, transcriptions .jsonl — chacune affiche son nombre de fichiers et son poids réel avant l'archivage.
• Détection automatique du dossier : glissez le raccourci de Claude Code, un dossier de projet ou n'importe quel fichier dans la fenêtre, l'emplacement du .claude est retrouvé seul.
• Distinction profil / projet : il existe deux sortes de .claude, et sauvegarder le mauvais donne une archive vide. L'outil note chaque candidat selon ce qu'il contient réellement et retient le bon, en expliquant son choix dans le journal.
• Identifiants toujours exclus : .credentials.json, .key et .pem ne sont jamais archivés ni jamais écrits par une restauration, quelles que soient les cases cochées.
• Réinjection contrôlée : au choix compléter sans écraser, ou écraser ; avec une copie de sécurité de l'état actuel prise avant d'écrire.
• Chemins d'archive validés : antislash, chemin absolu, lettre de lecteur ou .. sont refusés — une archive venue d'ailleurs ne peut rien écrire hors du dossier visé.
• Deux compressions mesurées : Deflate (33 %, 3 s) par défaut, LZMA (20 %, 18 s) pour les transferts contraints. Sur 81 Mo réels : 27 Mo contre 16 Mo.
• Onglet Aperçu : parcourir et lire les fichiers d'un dossier ou d'une archive, avec filtre par nom, avant de sauvegarder ou de restaurer.
• Nom de la machine dans l'archive : claude-PC-BUREAU-20260829-090348.zip, pour que deux postes puissent déposer sur la même clé USB sans confusion.
• Rotation automatique des N dernières archives, dont les copies de sécurité sont exemptées, et suppression manuelle par sélection multiple.
• Interface en cinq langues : français, anglais, espagnol, portugais, allemand. La langue de Windows est détectée au premier lancement, le choix se change à tout moment et se retient.
• Version portable : un exécutable autonome de 35 Mo, sans Python ni installation, qui écrit ses archives à côté de lui.

Prérequis

Pour la version portable : aucun. L'exécutable embarque tout.

Pour le script : Python 3.9 ou supérieur et PyQt6. pip install PyQt6

Installation

Version portable — recommandée pour une machine d'appoint

1. Télécharger MEMCLAUDE.exe depuis la dernière release.
2. Le poser où l'on veut : Bureau, clé USB, disque externe.
3. Double-cliquer. Les archives sont écrites dans un sous-dossier sauvegardes créé à côté de l'exécutable.

Depuis les sources

git clone https://github.com/Cartoyoyo/MEMCLAUDE.git
cd MEMCLAUDE
pip install PyQt6
python memclaude.pyw

Sous Windows, MEMCLAUDE.bat lance l'interface sans fenêtre de console. Adapter la variable PYTHONW en tête du fichier si Python n'est pas dans C:\Python312.

Pour reconstruire l'exécutable après modification : construire_exe.bat (nécessite pip install pyinstaller).

Utilisation

Étape 1 — Sauvegarder

Le chemin du dossier .claude s'affiche en haut de la fenêtre, en permanence. Il vaut par défaut %USERPROFILE%\.claude et se change de trois façons : le bouton Parcourir, la saisie directe, ou le glisser-déposer.

Cocher les catégories, choisir la compression, cliquer sur Sauvegarder maintenant. Le panneau Déjà sauvegardé liste les archives existantes et permet d'en supprimer.

Étape 2 — Restaurer

Choisir l'archive dans la liste déroulante — ou Ouvrir un ZIP ailleurs pour celle qui arrive sur une clé USB. L'outil affiche ce qu'elle contient et d'où elle vient : machine, utilisateur et date sont lus dans la fiche MEMCLAUDE-INFOS.txt déposée dans chaque archive.

Cocher ce qu'on réinjecte, choisir le comportement en cas de conflit, cliquer sur Réinjecter.

Fermer Claude Code avant de restaurer : il relit ces fichiers au démarrage et peut réécrire par-dessus.

Étape 3 — Aperçu

Parcourir le dossier .claude ou une archive, filtrer par nom, lire le contenu des fichiers texte. Les gros fichiers sont tronqués à 200 Ko d'aperçu : une transcription de 40 Mo figerait la fenêtre pour rien.

Les deux sortes de .claude

C'est le piège principal, et la raison pour laquelle l'outil ne prend pas le premier .claude venu :

Emplacement	Contenu	Utile à sauvegarder
%USERPROFILE%\.claude	mémoire, skills, transcriptions, CLAUDE.md	oui
<projet>\.claude	settings.local.json, parfois quelques skills	marginal

Le raccourci de Claude Code pointe généralement vers un dossier de projet, donc le premier .claude rencontré en remontant l'arborescence est souvent le mauvais. L'outil note chaque candidat — mémoire et transcriptions, mémoire seule, skills seuls, rien — et retient le mieux noté, pas le plus proche. Si l'on force malgré tout un .claude de projet, un avertissement rouge apparaît sous le chemin.

Limite connue : le nom des projets

Les fiches mémoire vivent sous projects/<chemin-du-projet-encodé>/memory/, par exemple projects/C--Users-durand--Projets-mon-projet/. Ce nom encode le chemin du projet sur la machine d'origine. Si le projet se trouve ailleurs sur la machine de destination, le nom diffère : les fiches sont bien écrites, mais Claude Code ne les lit pas — il cherche sous le nom correspondant à son propre chemin.

L'outil détecte le cas et l'écrit dans son journal dès la sélection de l'archive. Le contournement est manuel : renommer le dossier restauré sous projects/, ou recopier les fichiers .md dans le dossier memory/ du bon projet. La configuration et les skills, eux, ne dépendent d'aucun chemin et se réinjectent tels quels.

Ce qui n'est jamais touché

.credentials.json et les fichiers .key / .pem sont exclus dans les deux sens : jamais mis dans une archive, jamais écrits par une restauration. Une archive qui voyage sur une clé USB ne doit pas contenir de jeton d'authentification, et une archive venue d'ailleurs ne doit pas pouvoir en déposer un.

Les dossiers de travail — cache, paste-cache, shell-snapshots, file-history, __pycache__ — sont ignorés : ils se reconstruisent seuls.

---

English

Description

MEMCLAUDE archives the Claude Code .claude folder into a timestamped ZIP file, then restores it into the .claude folder of another machine. Memory, global instructions, personal skills and conversation transcripts: everything that makes up the context accumulated over sessions, and that nothing backs up by default.

No more .claude folder found empty after a reinstall, or memory patiently built on the desktop machine that stays on the desktop machine: on PC 1 you click Save, you carry the ZIP, and on PC 2 you click Restore.

Features

• Four selectable categories: memory (projects/*/memory), configuration (CLAUDE.md, settings.json), personal skills, .jsonl transcripts — each showing its file count and real size before archiving.
• Automatic folder detection: drop the Claude Code shortcut, a project folder or any file onto the window; the .claude location is found on its own.
• Profile vs project awareness: two kinds of .claude exist, and archiving the wrong one yields an empty backup. Each candidate is scored on what it actually contains, and the choice is explained in the log.
• Credentials always excluded: .credentials.json, .key and .pem are never archived, and never written by a restore, whatever the checkboxes say.
• Controlled restore: fill in without overwriting, or overwrite; with a safety copy of the current state taken beforehand.
• Archive paths validated: backslashes, absolute paths, drive letters and .. are refused — a foreign archive cannot write outside the target folder.
• Two measured compressions: Deflate (33 %, 3 s) by default, LZMA (20 %, 18 s) for constrained transfers. On 81 MB of real data: 27 MB against 16 MB.
• Preview tab: browse and read files from a folder or an archive, with a name filter, before saving or restoring.
• Machine name in the archive: claude-PC-BUREAU-20260829-090348.zip, so two machines can write to the same USB drive without confusion.
• Automatic rotation of the last N archives, safety copies exempted, plus manual deletion with multiple selection.
• Five-language interface: French, English, Spanish, Portuguese, German. The Windows language is detected on first launch; the choice can be changed at any time and is remembered.
• Portable build: a 35 MB standalone executable, no Python and no installation, writing its archives next to itself.

Requirements

Portable build: none. Everything is embedded.

From source: Python 3.9 or later and PyQt6. pip install PyQt6

Installation

Download MEMCLAUDE.exe from the latest release, drop it anywhere — desktop, USB drive, external disk — and double-click. Archives are written into a sauvegardes subfolder created next to the executable.

From source:

git clone https://github.com/Cartoyoyo/MEMCLAUDE.git
cd MEMCLAUDE
pip install PyQt6
python memclaude.pyw

Usage

Screenshots of the three tabs are in the Aperçu rapide section at the top of this document.

1. Save — the .claude path is always visible at the top and can be changed by browsing, typing, or dropping a shortcut anywhere on the window. Tick the categories, pick a compression, click Sauvegarder maintenant.
2. Restore — pick the archive in the dropdown, or load one from a USB drive. Its origin (machine, user, date) is read from the MEMCLAUDE-INFOS.txt note embedded in every archive. Choose what to restore and how conflicts are handled.
3. Preview — browse and read the contents of a folder or an archive before acting. Large files are truncated to 200 KB of preview.

Close Claude Code before restoring: it reads these files at startup and may write over them.

Known limitation

Memory notes live under projects/<encoded-project-path>/memory/. That folder name encodes the project path on the source machine. If the project sits elsewhere on the destination machine, the name differs: the notes are written, but Claude Code will not read them — it looks under the name matching its own path. The tool detects this and says so in the log; the fix is to rename the restored folder under projects/. Configuration and skills depend on no path and restore as-is.

---

Español

Descripción

MEMCLAUDE archiva la carpeta .claude de Claude Code en un ZIP con marca de tiempo y la reinyecta en la carpeta .claude de otro equipo: memoria, instrucciones globales, skills personales y transcripciones de conversaciones.

Funcionalidades

• Cuatro categorías seleccionables, con recuento de archivos y peso real antes de archivar.
• Detección automática de la carpeta arrastrando el acceso directo de Claude Code o cualquier archivo del proyecto.
• Credenciales (.credentials.json, .key, .pem) excluidas siempre, tanto al archivar como al restaurar.
• Restauración controlada: completar sin sobrescribir o sobrescribir, con copia de seguridad previa.
• Dos compresiones medidas: Deflate (33 %) por defecto, LZMA (20 %) para transferencias limitadas.
• Pestaña de vista previa para leer el contenido antes de actuar.
• Versión portátil autónoma de 35 MB, sin instalación.

Instalación

Descargar MEMCLAUDE.exe desde la última versión y hacer doble clic. Desde el código fuente: pip install PyQt6 y python memclaude.pyw.

Las capturas de pantalla se encuentran en la sección Aperçu rapide al inicio de este documento.

---

Português

Descrição

O MEMCLAUDE arquiva a pasta .claude do Claude Code num ZIP com data e hora e volta a injetá-la na pasta .claude de outro computador: memória, instruções globais, skills pessoais e transcrições de conversas.

Funcionalidades

• Quatro categorias selecionáveis, com número de ficheiros e peso real antes de arquivar.
• Deteção automática da pasta arrastando o atalho do Claude Code ou qualquer ficheiro do projeto.
• Credenciais (.credentials.json, .key, .pem) sempre excluídas, ao arquivar e ao restaurar.
• Restauro controlado: completar sem substituir ou substituir, com cópia de segurança prévia.
• Duas compressões medidas: Deflate (33 %) por omissão, LZMA (20 %) para transferências limitadas.
• Separador de pré-visualização para ler o conteúdo antes de agir.
• Versão portátil autónoma de 35 MB, sem instalação.

Instalação

Transferir MEMCLAUDE.exe da última versão e fazer duplo clique. A partir do código: pip install PyQt6 e python memclaude.pyw.

As capturas de ecrã encontram-se na secção Aperçu rapide no início deste documento.

---

Deutsch

Beschreibung

MEMCLAUDE archiviert den .claude-Ordner von Claude Code in einer ZIP-Datei mit Zeitstempel und spielt sie im .claude-Ordner eines anderen Rechners wieder ein: Gedächtnis, globale Anweisungen, persönliche Skills und Gesprächsprotokolle.

Funktionen

• Vier auswählbare Kategorien, mit Dateianzahl und tatsächlicher Größe vor dem Archivieren.
• Automatische Ordnererkennung: Verknüpfung von Claude Code oder eine beliebige Projektdatei ins Fenster ziehen.
• Zugangsdaten (.credentials.json, .key, .pem) werden nie archiviert und nie zurückgeschrieben.
• Kontrolliertes Zurückspielen: ergänzen ohne Überschreiben oder überschreiben, mit vorheriger Sicherungskopie.
• Zwei gemessene Kompressionen: Deflate (33 %) als Vorgabe, LZMA (20 %) für begrenzte Übertragungen.
• Vorschau-Reiter zum Lesen der Inhalte, bevor etwas geschieht.
• Portable Fassung: eigenständige 35-MB-Datei, ohne Installation.

Installation

MEMCLAUDE.exe aus der neuesten Version herunterladen und doppelklicken. Aus dem Quellcode: pip install PyQt6, dann python memclaude.pyw.

Die Bildschirmfotos stehen im Abschnitt Aperçu rapide am Anfang dieses Dokuments.

---

Architecture

Un seul fichier, memclaude.pyw, organisé en quatre blocs :

Bloc	Rôle
Résolution de chemin	lecture des raccourcis .lnk, notation des .claude candidats, déduction du profil
Catégories	quatre fonctions qui listent les fichiers de .claude à archiver
Travailleurs	BackupWorker et RestoreWorker, deux QThread pour ne jamais figer l'interface
Interface	MainWindow et ses trois onglets, en PyQt6

Les libellés vivent dans traductions.py : une table de 142 entrées, cinq traductions chacune. Aucun fichier .ts ni .qm à compiler, et une seule source de vérité — _retranslate() applique la langue courante, les constructeurs de widgets ne posent aucun texte.

Les garde-fous de sécurité sont concentrés dans deux fonctions : is_secret() filtre les identifiants, safe_target() valide chaque chemin lu dans une archive avant écriture.

Le guide d'utilisation détaillé en français est dans LISEZMOI.md.

Changelog

Version	Notes
1.1.0	Interface traduite en FR, EN, ES, PT, DE avec détection de la langue de Windows — Dialogue À propos (version, auteur, licence, dépôt)
1.0.0	Sauvegarde par catégories — Réinjection sur une autre machine — Onglet Aperçu — Glisser-déposer avec détection du dossier .claude — Compression Deflate ou LZMA — Version portable

Auteur · Author

Développé par / Developed by Yoan Laloux

Concept et idée originale par Yoan Laloux — développé avec l'assistance d'outils d'IA générative. Concept and original idea by Yoan Laloux — developed with the assistance of generative AI tools.

Licence · License

Ce projet est distribué sous licence GNU GPL v3. Voir le fichier LICENSE.

This project is released under the GNU GPL v3 license. See the LICENSE file.

MEMCLAUDE est un outil indépendant, sans lien avec Anthropic. MEMCLAUDE is an independent tool, not affiliated with Anthropic.

Questions et anomalies : issues du dépôt.