ஏற்கெனவே உள்ள அமைப்பை நகலெடுத்தல்

ccam-க்கு முன்பே நீங்கள் Claude Code பயன்படுத்தியிருந்தால், உங்கள் அமைப்பு ~/.claude மற்றும் ~/.claude.json-இல் இருக்கும். ccam migrate அதை ஒரு பகிர்வுக் குழுவுக்குள் நகலெடுக்கிறது, அதனால் அந்த உருப்படிகளைக் குழு வழியாகப் பகிரும் ஒவ்வொரு கணக்கும் உங்களிடம் ஏற்கெனவே உள்ள அமைப்புடன் தொடங்கும். மூலக் கோப்புறை படிக்கப்பட மட்டுமே செய்யும், வெறும் claude முன்பு போலவே வேலை செய்யும். உங்கள் முதல் ccam add-க்குப் பிறகு ஒருமுறையும், ஒரு கணக்கு MCP சர்வர்களைப் பகிரத் தொடங்கும் ஒவ்வொரு முறையும் இதை இயக்குங்கள்.

பயன்பாடு

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

டெர்மினலில், உருப்படி flags இல்லாமலும் --yes இல்லாமலும், ccam முதலில் ஒரு தேர்வுப் பட்டியலைக் காட்டும்:

 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

Space (அல்லது x) cursor-இன் கீழ் உள்ள உருப்படியை மாற்றும், அம்புக்குறி விசைகள் அல்லது j/k நகர்த்தும், Enter திட்டத்தைக் காட்டும், Esc, q அல்லது Ctrl+C Cancelled. என்று அச்சிடும். மூலத்தில் எதுவும் இல்லாத உருப்படிகள் not found எனக் குறிக்கப்படும். எல்லாவற்றையும் தேர்வுநீக்கினால், ccam Nothing selected. என்று அச்சிட்டு நின்றுவிடும்.

பிறகு ccam திட்டத்தை அச்சிட்டு, நகலெடுக்கும் முன் கேட்கும்:

$ 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

ஒரு குழு, அதன் வழியாக ஓர் உருப்படியைப் பகிரும் கணக்குகளை மட்டுமே அடையும், அதனால் சுருக்கம் அவற்றை உருப்படி வாரியாகப் பட்டியலிடுகிறது. பகிராத கணக்குகளுக்கு, பகிர்வை இயக்கும் ccam share <name> --<item> on கட்டளைகளை ccam அச்சிடும்.

Options

உருப்படி flag இல்லாதபோது, டெர்மினலில் தேர்வுப் பட்டியல் முடிவு செய்யும். டெர்மினலுக்கு வெளியே, அல்லது --yes உடன், ccam உரையாடல் வரலாற்றைத் தவிர அனைத்தையும் நகலெடுக்கும். projects/ பெரியதாக இருக்கக்கூடும் என்பதால் வரலாறு இயல்பாக விடப்படுகிறது.

--group on என்றால் default. --group off மற்றும் --group local --group takes a group name, not "off" என்று மறுக்கப்படும். ccam migrate --dry-run-ஐ மதிக்கும், ஒரு தேர்வை முன்னோட்டமாகப் பார்க்க dry run-இலும் தேர்வுப் பட்டியல் தோன்றும்.

இது எப்படி வேலை செய்கிறது

internal/cli/migrate.go உருப்படிகளைத் தேர்ந்தெடுக்கிறது, பிறகு migrate.Build மூலத்தையும் குழுவையும் படித்து ஒரு திட்டத்தைத் திருப்பித் தருகிறது. நீங்கள் உறுதிப்படுத்திய பிறகு Plan.Apply வரும் வரை எதுவும் எழுதப்படுவதில்லை.

1. மூலத்தைக் கண்டறிதல். இல்லாத, கோப்புறை அல்லாத, அல்லது தெரிந்த Claude Code உள்ளீடு எதுவும் இல்லாத பாதையை checkSource மறுக்கிறது. migrate.ClaudeJSON கோப்புறைக்குரிய .claude.json-ஐக் கண்டுபிடிக்கிறது: அதற்குள், அல்லது உள்ளே ஒன்று இல்லாத ~/.claude-க்கு, அதன் அருகில் உள்ள ~/.claude.json. CLAUDE_CONFIG_DIR அமைக்கப்படாதபோது Claude Code அதை வைத்திருக்கும் இடம் அதுவே.
2. உருப்படிகளைப் பாதைகளுடன் பொருத்துதல். ஒவ்வொரு பாதையும் ccam share பயன்படுத்தும் அதே அனுமதிப் பட்டியலான share.Layout-இலிருந்து வருகிறது. MCP சர்வர்கள் .claude.json-இலிருந்து mcp.LocalServers மூலம் படிக்கப்படுகின்றன; அது முழுக் கோப்பையும் parse செய்வதற்குப் பதிலாக profile.TopLevelValue scanner-ஐப் பயன்படுத்துகிறது.
3. நகலெடுக்கும், ஒருபோதும் நகர்த்தாது. கோப்புகள் fsutil.AtomicWrite அல்லது fsutil.CopyFile மூலம் ~/.local/share/ccam/groups/<group>/-க்குச் செல்கின்றன; MCP சர்வர்கள் குழுவின் mcp.json-க்குள் செல்கின்றன.

ஒவ்வோர் உருப்படியும் ஒரு மூலப் பாதையை ஒரு குழுப் பாதையுடன் பொருத்துகிறது:

இரண்டு வரலாற்று வரிசைகளும் --history உடன் மட்டுமே நகலெடுக்கப்படுவதால் கோடிட்டுக் காட்டப்படுகின்றன. .credentials.json மற்றும் .claude.json share.Never-இல் பட்டியலிடப்பட்டுள்ளன, அவை ஒருபோதும் குழுவை அடைவதில்லை: அவற்றில் ஒன்று layout-இல் தோன்றினால் Build ஓர் உள் பிழையைத் திருப்பித் தரும், கோப்புறைத் தேடல் அவற்றைப் பெயரால் தவிர்க்கும்.

buildEntry ஒவ்வொரு பாதைக்கும் ஒரு நிலையைக் கொடுக்கிறது; ஒவ்வொரு திட்ட வரியும் விவரிப்பது அதைத்தான்:

• Missing: மூலத்தில் இல்லை, அல்லது கோப்புறை எதிர்பார்க்கப்படும் இடத்தில் கோப்பு உள்ளது. ஒவ்வோர் உருப்படிக்கும் ஒருமுறை not found, skipped எனப் பட்டியலிடப்படும்.
• Linked: மூலப் பாதை ஏற்கெனவே குழுவின் நகலுக்குத் தீர்க்கப்படுகிறது, எடுத்துக்காட்டாக மூலம் ஒரு ccam profile கோப்புறையாக இருக்கும்போது.
• Same: குழுவிடம் ஏற்கெனவே ஒரே மாதிரியான உள்ளடக்கம் உள்ளது.
• New: குழுவிடம் அது இல்லை, அதனால் முழுமையாக நகலெடுக்கப்படும்.
• Merge: இரு பக்கங்களிலும் உள்ள கோப்புறை. copyMissing குழுவிடம் இல்லாத கோப்புகளை மட்டுமே சேர்க்கிறது; வேறுபடும் கோப்புகள் குழுவிடம் உள்ளபடியே இருக்கும், திட்டம் group copies kept என்று சொல்லும். plugins/-க்கு, installed_plugins.json மற்றும் known_marketplaces.json registries ஒன்றிணைக்கப்படும், absolute plugin பாதைகள் குழுவின் கோப்புறையைச் சுட்டும்படி மாற்றி எழுதப்படும்.
• Conflict: இரு பக்கங்களிலும் வேறுபட்ட உள்ளடக்கத்துடன் உள்ள கோப்பு. கோப்பு வாரியாக நீங்கள் தேர்ந்தெடுப்பீர்கள்: keep group, use mine, அத்துடன் .json கோப்புகளுக்கு merge JSON (மோதும் மதிப்புகளில் குழு முன்னுரிமை பெறும் ஆழமான ஒன்றிணைப்பு) அல்லது history.jsonl-க்கு merge by line. வரையறை வேறுபடும் MCP சர்வரும் முரண்பாடுதான், keep group அல்லது use mine உடன். Enter அழுத்தும்போது பட்டியலின் முதல் தேர்வே இயல்புநிலை; --yes எப்போதும் குழுவின் நகலை வைத்திருக்கும்.

தேர்வுப் பட்டியல் என்பது ccam add பயன்படுத்தும் checklist component-இன் மேல் கட்டப்பட்ட tui.MigratePicker; migrate.Found lstat அழைப்புகள் மற்றும் MCP சர்வர் பட்டியல் மூலம் இல்லாத உருப்படிகளைக் குறிக்கிறது.

MCP உள்நுழைவுகள்

OAuth மூலம் உள்நுழையும் MCP சர்வர்கள் தங்கள் tokens-ஐச் சர்வர் பட்டியலில் அல்ல, உள்நுழைவுக் கோப்பான .credentials.json-இல் mcpOAuth-இன் கீழ் வைத்திருக்கின்றன. Claude Code ஒவ்வொரு உள்ளீட்டின் key-ஐயும் <name>| மற்றும் சர்வரின் type, url, headers ஆகியவற்றின் sha256 hash-இன் முதல் 16 எழுத்துகள் என அமைக்கிறது. key கோப்புறையைச் சார்ந்ததல்ல, அதனால் சர்வர் வரையறை ஒரே மாதிரியாக இருக்கும் வரை, நகலெடுக்கப்பட்ட உள்ளீடு மற்றொரு கணக்கிலும் வேலை செய்யும். அதனால் internal/migrate/logins.go-இல் உள்ள buildLogins, மூலத்தின் வரையறையுடன் குழுவில் இறுதியில் இருக்கும் சர்வர்களின் உள்ளீடுகளை மட்டுமே நகலெடுக்கிறது: புதியவை, ஏற்கெனவே ஒன்றாக உள்ளவை, அல்லது நீங்கள் use mine தேர்ந்தெடுத்த முரண்பாடுகள். நீட்டிப்புகளை நகலெடுக்கும்போது மூலத்தில் plugins/ இருந்தால், plugin சர்வர்களின் உள்நுழைவுகளும் (plugin: என்று தொடங்கும் keys) உடன் செல்லும்.

உள்ளீடுகள் பெறும் ஒவ்வொரு கணக்கின் சொந்த .credentials.json-க்குள் செல்கின்றன, fsutil.AtomicWrite மூலம் 0600 mode-இல் எழுதப்படுகின்றன. அவை ஒருபோதும் குழுவுக்குள் செல்வதில்லை. ஒரு கணக்கு இலக்குக் குழு வழியாக mcp-ஐ (அல்லது plugin சர்வர்களுக்கு extensions-ஐ) பகிர்ந்தால் மட்டுமே அவற்றைப் பெறும், அதனிடம் இல்லாத keys மட்டுமே சேர்க்கப்படும்: அதனிடம் ஏற்கெனவே உள்ள, ஒருவேளை புதிய, உள்ளீடுகள் வைக்கப்படும். sign-ins திட்ட வரி சர்வர்களையும், பெறும் கணக்குகளையும், தவிர்க்கப்பட்டவற்றையும் பட்டியலிடுகிறது. ஒரு கணக்கு பின்வருமாறு இருந்தால் ccam அதைத் தவிர்த்து, காரணத்துடன் பெயரிடும்:

• ccam import மூலம் இருந்த இடத்திலேயே பதிவுசெய்யப்பட்டது, ஏனெனில் வெறும் claude அதன் உள்நுழைவுக் கோப்பைப் பயன்படுத்திக்கொண்டிருக்கலாம்;
• இயங்கிக்கொண்டிருக்கிறது, ஏனெனில் Claude Code அதன் உள்நுழைவுக் கோப்பை மாற்றி எழுதுகிறது (எழுதுவதற்குச் சற்று முன் மீண்டும் சரிபார்க்கப்படும், started meanwhile எனத் தெரிவிக்கப்படும்);
• இன்னும் உள்நுழையவில்லை;
• தன் உள்நுழைவை macOS Keychain-இல் வைத்திருக்கிறது, அதில் ccam எழுதுவதில்லை.

தவிர்க்கப்பட்ட கணக்கில் /mcp மூலம் சர்வர்களில் உள்நுழையுங்கள். பின்னர் MCP சர்வர்களைப் பகிரத் தொடங்கும் கணக்குக்கு, நீங்கள் ccam migrate-ஐ மீண்டும் இயக்கும்போது உள்நுழைவுகள் கிடைக்கும்; சுருக்கம் இதை Then run `ccam migrate` again to give them the MCP sign-ins too. என்று சொல்லும்.

பாதுகாப்பும் விளிம்பு நிலைகளும்

• மூலம் படிக்கப்பட மட்டுமே செய்யும். அதிலுள்ள எந்தக் கோப்பும் நகர்த்தப்படவோ, இணைக்கப்படவோ, மாற்றப்படவோ மாட்டாது, மூல உள்நுழைவு ஒருபோதும் எழுதப்படாது, அது Keychain-இலிருந்து படிக்கப்படக்கூடிய macOS-இலும் கூட.
• use mine, ஓர் ஒன்றிணைப்பு, அல்லது ஏற்கெனவே உள்ள mcp.json-இல் புதிய MCP சர்வர்கள் மூலம் ஒரு குழுக் கோப்பு மாற்றப்படும் முன், குழுவின் நகல் <group>/.ccam-backup/<time>/-இல் சேமிக்கப்படும். கோப்புறைப் பெயர் ஒவ்வோர் இயக்கத்துக்கும் தனித்துவமானது, அதனால் ஒரே வினாடியில் நடக்கும் இரண்டு இயக்கங்கள் ஒன்றின் காப்புப்பிரதியை மற்றொன்று மேலெழுதாது. சுருக்கம் பாதையை அச்சிடும்.
• --yes உடன், ஒவ்வொரு முரண்பாடும் குழுவின் நகலை வைத்திருக்கும், அதற்குப் பதிலாக எப்படித் தேர்ந்தெடுப்பது என்று ccam சொல்லும்: அதே கட்டளையை --yes இல்லாமல் இயக்குங்கள்.
• எதுவும் மாறாது என்றால், ccam Nothing to copy. என்று அச்சிடும்; ஒவ்வொரு முரண்பாடும் குழுவின் நகலை வைத்திருந்தால், Nothing to copy: the group keeps its own copies.
• ஒரு நகல் பாதியில் தோல்வியடைந்தால், ccam The source folder was not changed. Group files replaced so far are saved in என்றும், அதைத் தொடர்ந்து காப்புப்பிரதிக் கோப்புறையையும் சொல்லி நின்றுவிடும்.
• மூலம் இல்லையென்றால் no Claude Code folder at <path>. Give the folder to copy from: ccam migrate <folder> என்று முடியும்.

தொடர்புடையவை

• MCP சர்வர்கள், அமைப்புகள், வரலாற்றைப் பகிர்தல்
• சரிபார்த்தலும் பழுதுநீக்கமும்
• பல Claude Code கணக்குகள்
• CLAUDE_CONFIG_DIR