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

> ccam migrate மூலம் ஏற்கெனவே உள்ள ~/.claude-இன் அமைப்புகள், CLAUDE.md, நீட்டிப்புகள், MCP சர்வர்கள், MCP உள்நுழைவுகள் ஆகியவற்றை ஒரு ccam பகிர்வுக் குழுவுக்குள் நகலெடுங்கள்.

Source: https://ccam.dev/ta/features/migrate/ · Updated 2026-10-19

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

## பயன்பாடு

```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
```

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

```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
```

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

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

```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
```

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

## Options

| Option | என்ன செய்யும் | இயல்புநிலை |
| --- | --- | --- |
| `[folder]` | நகலெடுக்க வேண்டிய Claude Code கோப்புறை | `~/.claude` |
| `--settings` | `settings.json`-ஐ நகலெடுக்கும் | off |
| `--memory` | உலகளாவிய `CLAUDE.md`-ஐ நகலெடுக்கும் | off |
| `--extensions` | `agents/`, `commands/`, `skills/`, `plugins/`, `output-styles/`, `rules/` ஆகியவற்றை நகலெடுக்கும் | off |
| `--mcp` | பயனர் MCP சர்வர்களை (`.claude.json`-இல் உள்ள `mcpServers`) நகலெடுக்கும் | off |
| `--history` | உரையாடல் வரலாற்றை (`projects/`, `history.jsonl`) நகலெடுக்கும் | off |
| `-g`, `--group string` | நகலெடுக்க வேண்டிய பகிர்வுக் குழு | `default` |
| `-y`, `--yes` | கேட்காமல் நகலெடுக்கும்; முரண்பாட்டில் குழுவின் நகல் வைக்கப்படும் | off |
| `--dry-run` (global) | திட்டத்தை அச்சிட்டு, எந்தக் கேள்விக்கும் நகலுக்கும் முன் நின்றுவிடும் | off |

உருப்படி 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 சர்வர்கள், அமைப்புகள், வரலாற்றைப் பகிர்தல்](https://ccam.dev/ta/docs/sharing.md)
- [சரிபார்த்தலும் பழுதுநீக்கமும்](https://ccam.dev/ta/features/doctor.md)
- [பல Claude Code கணக்குகள்](https://ccam.dev/ta/guides/multiple-claude-code-accounts.md)
- [CLAUDE_CONFIG_DIR](https://ccam.dev/ta/guides/claude-config-dir.md)