# Copier une configuration existante > Copiez les paramètres, CLAUDE.md, les extensions, les serveurs MCP et les connexions MCP d'un ~/.claude existant dans un groupe de partage ccam avec ccam migrate. Source: https://ccam.dev/fr/features/migrate/ · Updated 2026-10-19 Si vous utilisiez Claude Code avant ccam, votre configuration se trouve dans `~/.claude` et `~/.claude.json`. `ccam migrate` la copie dans un groupe de partage, si bien que chaque compte qui partage ces éléments par ce groupe démarre avec la configuration que vous avez déjà. Le dossier source est seulement lu, et `claude` seul continue de fonctionner comme avant. Lancez-le une fois après votre premier `ccam add`, puis à nouveau chaque fois qu'un compte commence à partager des serveurs MCP. ## Utilisation ```sh ccam migrate # ~/.claude into group default, checklist on a terminal ccam --dry-run migrate # show the plan, copy nothing ccam migrate --settings --mcp # only these items, no checklist ccam migrate --history --yes # conversation history only, no questions ccam migrate ~/.claude-work --group work ``` Dans un terminal, sans option d'élément et sans `--yes`, ccam affiche d'abord une liste à cocher : ```console Copy into group default From /home/me/.claude ? Choose what to copy (Space to toggle) › [x] MCP servers [x] settings.json [x] global CLAUDE.md [x] agents, commands, skills [ ] conversation history Enter show the plan · Esc cancel ``` Espace (ou `x`) coche ou décoche l'élément sous le curseur, les flèches ou `j`/`k` déplacent le curseur, Entrée affiche le plan, et Échap, `q` ou Ctrl+C affiche `Cancelled.`. Les éléments pour lesquels la source n'a rien sont marqués `not found`. Si vous décochez tout, ccam affiche `Nothing selected.` et s'arrête. ccam affiche ensuite le plan et demande confirmation avant de copier : ```console $ ccam migrate --yes Copy from /home/me/.claude into group default (/home/me/.local/share/ccam/groups/default): mcp ~/.claude.json new: fs, linear sign-ins linear → personal; skipped: work (not logged in yet) settings settings.json new: 61 B memory CLAUDE.md new: 11 B extensions agents/ add 1 file the group lacks (6 B) skills/ add 1 file the group lacks (13 B) not found, skipped: commands/, plugins/, output-styles/, rules/ Conversation history (projects/, history.jsonl) is not included; add --history to copy it. ✓ Copied into group default: 2 MCP servers, settings.json, CLAUDE.md, agents/, skills/, MCP sign-ins for personal MCP sign-ins were not copied to: work (not logged in yet). Sign in to those servers there with /mcp. Accounts that share these through group default: mcp personal, work settings personal, work memory personal, work extensions personal, work ``` Un groupe n'atteint que les comptes qui partagent un élément par son intermédiaire ; le résumé les liste donc par élément. Pour les comptes qui ne le font pas, ccam affiche les commandes `ccam share -- on` qui activent le partage. ## Options | Option | Effet | Par défaut | | --- | --- | --- | | `[folder]` | Le dossier Claude Code à copier | `~/.claude` | | `--settings` | Copier `settings.json` | désactivé | | `--memory` | Copier le `CLAUDE.md` global | désactivé | | `--extensions` | Copier `agents/`, `commands/`, `skills/`, `plugins/`, `output-styles/`, `rules/` | désactivé | | `--mcp` | Copier les serveurs MCP utilisateur (`mcpServers` dans `.claude.json`) | désactivé | | `--history` | Copier l'historique des conversations (`projects/`, `history.jsonl`) | désactivé | | `-g`, `--group string` | Le groupe de partage dans lequel copier | `default` | | `-y`, `--yes` | Copier sans demander ; en cas de conflit, la copie du groupe est conservée | désactivé | | `--dry-run` (globale) | Afficher le plan et s'arrêter avant toute question ou copie | désactivé | Sans option d'élément, la liste à cocher décide dans un terminal. Hors terminal, ou avec `--yes`, ccam copie tout sauf l'historique des conversations. L'historique est exclu par défaut car `projects/` peut être volumineux. `--group on` désigne `default`. `--group off` et `--group local` sont refusés avec `--group takes a group name, not "off"`. `ccam migrate` respecte `--dry-run`, et la liste à cocher apparaît quand même lors d'une simulation, pour que vous puissiez prévisualiser une sélection. ## Fonctionnement `internal/cli/migrate.go` choisit les éléments, puis `migrate.Build` lit la source et le groupe et renvoie un plan. Rien n'est écrit avant `Plan.Apply`, après votre confirmation. 1. **Trouver la source.** `checkSource` refuse un chemin absent, qui n'est pas un dossier ou qui ne contient aucune entrée Claude Code connue. `migrate.ClaudeJSON` trouve le `.claude.json` qui appartient au dossier : à l'intérieur, ou, pour un `~/.claude` qui n'en contient pas, `~/.claude.json` à côté. C'est là que Claude Code le conserve quand `CLAUDE_CONFIG_DIR` n'est pas défini. 2. **Associer les éléments aux chemins.** Chaque chemin vient de `share.Layout`, la même liste d'autorisation que celle de `ccam share`. Les serveurs MCP sont lus dans `.claude.json` avec `mcp.LocalServers`, qui utilise le scanner `profile.TopLevelValue` au lieu d'analyser tout le fichier. 3. **Copier, jamais déplacer.** Les fichiers vont dans `~/.local/share/ccam/groups//` avec `fsutil.AtomicWrite` ou `fsutil.CopyFile` ; les serveurs MCP vont dans le `mcp.json` du groupe. Chaque élément associe un chemin source à un chemin du groupe : Les deux lignes de l'historique sont en pointillés car elles ne sont copiées qu'avec `--history`. `.credentials.json` et `.claude.json` figurent dans `share.Never` et n'atteignent jamais le groupe : `Build` renvoie une erreur interne si l'un d'eux apparaît un jour dans la structure, et le parcours des dossiers les ignore par leur nom. `buildEntry` attribue un état à chaque chemin, et c'est ce que décrit chaque ligne du plan : - **Missing** : absent de la source, ou un fichier là où un dossier est attendu. Listé une fois par élément sous la forme `not found, skipped`. - **Linked** : le chemin source pointe déjà vers la copie du groupe, par exemple quand la source est un dossier de profil ccam. - **Same** : le groupe a déjà un contenu identique. - **New** : le groupe ne l'a pas, il est donc copié en entier. - **Merge** : un dossier présent des deux côtés. `copyMissing` n'ajoute que les fichiers absents du groupe ; les fichiers qui diffèrent restent tels que le groupe les a et le plan indique `group copies kept`. Pour `plugins/`, les registres `installed_plugins.json` et `known_marketplaces.json` sont fusionnés, et les chemins de plugins absolus sont réécrits pour pointer vers le dossier du groupe. - **Conflict** : un fichier présent des deux côtés avec un contenu différent. Vous choisissez fichier par fichier : `keep group`, `use mine`, plus `merge JSON` pour les fichiers `.json` (une fusion profonde où le groupe l'emporte sur les valeurs en conflit) ou `merge by line` pour `history.jsonl`. Un serveur MCP dont la définition diffère est aussi un conflit, avec `keep group` ou `use mine`. Le premier choix listé est celui par défaut quand vous appuyez sur Entrée ; `--yes` conserve toujours la copie du groupe. La liste à cocher elle-même est `tui.MigratePicker`, construite sur le composant `checklist` qu'utilise `ccam add` ; `migrate.Found` marque les éléments absents à l'aide d'appels lstat et de la liste des serveurs MCP. ### Connexions MCP Les serveurs MCP qui se connectent avec OAuth conservent leurs jetons dans le fichier de connexion, `.credentials.json` sous `mcpOAuth`, et non dans la liste des serveurs. Claude Code identifie chaque entrée par `|` suivi des 16 premiers caractères d'un hachage `sha256` des champs `type`, `url` et `headers` du serveur. La clé ne dépend pas du dossier, si bien qu'une entrée copiée fonctionne dans un autre compte tant que la définition du serveur est identique. `buildLogins` dans `internal/migrate/logins.go` ne copie donc que les entrées des serveurs que le groupe aura avec la définition de la source : nouveaux, déjà identiques, ou en conflit quand vous avez choisi `use mine`. Les connexions des serveurs de plugins (clés commençant par `plugin:`) suivent quand vous copiez les extensions et que la source a un `plugins/`. Les entrées vont dans le `.credentials.json` propre à chaque compte destinataire, écrit avec `fsutil.AtomicWrite` en mode `0600`. Elles ne vont jamais dans le groupe. Un compte ne les reçoit que s'il partage `mcp` (ou, pour les serveurs de plugins, `extensions`) par le groupe cible, et seules les clés qui lui manquent sont ajoutées : les entrées qu'il a déjà, peut-être plus récentes, sont conservées. La ligne `sign-ins` du plan liste les serveurs, les comptes destinataires et ceux qui sont ignorés. ccam ignore un compte, et le nomme avec la raison, quand il est : - enregistré sur place avec `ccam import`, puisque `claude` seul peut utiliser son fichier de connexion ; - en cours d'exécution, puisque Claude Code réécrit son fichier de connexion (vérifié à nouveau juste avant l'écriture, signalé par `started meanwhile`) ; - pas encore connecté ; - en train de conserver sa connexion dans le trousseau macOS, dans lequel ccam n'écrit pas. Connectez-vous aux serveurs dans un compte ignoré avec `/mcp`. Un compte qui commence à partager des serveurs MCP plus tard reçoit les connexions quand vous relancez `ccam migrate` ; le résumé l'indique avec ``Then run `ccam migrate` again to give them the MCP sign-ins too.`` ## Sécurité et cas particuliers - La source est seulement lue. Aucun de ses fichiers n'est déplacé, relié ni modifié, et la connexion de la source n'est jamais écrite, y compris sous macOS où elle peut être lue depuis le trousseau. - Avant qu'un fichier du groupe ne soit remplacé, par `use mine`, une fusion ou de nouveaux serveurs MCP dans un `mcp.json` existant, la copie du groupe est enregistrée dans `/.ccam-backup/