Copier une configuration existante

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

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 :

 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 :

$ 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 <name> --<item> on qui activent le partage.

Options

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/<group>/ 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 <name>| 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 <group>/.ccam-backup/<time>/. Le nom du dossier est unique pour chaque exécution, si bien que deux exécutions dans la même seconde n'écrasent pas leurs sauvegardes respectives. Le résumé affiche le chemin.
• Avec --yes, chaque conflit conserve la copie du groupe, et ccam indique comment choisir à la place : relancer la même commande sans --yes.
• Si rien ne changerait, ccam affiche Nothing to copy. ; si chaque conflit conserve la copie du groupe, Nothing to copy: the group keeps its own copies.
• Si une copie échoue à mi-parcours, ccam s'arrête avec The source folder was not changed. Group files replaced so far are saved in suivi du dossier de sauvegarde.
• Une source absente se termine par no Claude Code folder at <path>. Give the folder to copy from: ccam migrate <folder>.

Voir aussi

• Partager les serveurs MCP, les paramètres et l'historique
• Vérifier et réparer
• Plusieurs comptes Claude Code
• CLAUDE_CONFIG_DIR