Mevcut bir kurulumu kopyalama

Claude Code'u ccam'den önce kullandıysanız kurulumunuz ~/.claude ve ~/.claude.json içindedir. ccam migrate bunu bir paylaşım grubuna kopyalar; böylece bu öğeleri grup üzerinden paylaşan her hesap, zaten sahip olduğunuz kurulumla başlar. Kaynak klasör yalnızca okunur ve düz claude eskisi gibi çalışmaya devam eder. İlk ccam add komutunuzdan sonra bir kez, bir hesap MCP sunucularını paylaşmaya başladığında da yeniden çalıştırın.

Kullanım

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

Terminalde, öğe seçenekleri ve --yes olmadan ccam önce bir kontrol listesi gösterir:

 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 (veya x) imlecin altındaki öğeyi değiştirir, ok tuşları veya j/k hareket ettirir, Enter planı gösterir; Esc, q veya Ctrl+C ise Cancelled. yazdırır. Kaynakta karşılığı olmayan öğeler not found olarak işaretlenir. Her şeyin işaretini kaldırırsanız ccam Nothing selected. yazdırır ve durur.

Ardından ccam planı yazdırır ve kopyalamadan önce onay ister:

$ 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

Bir grup yalnızca bir öğeyi o grup üzerinden paylaşan hesaplara ulaşır; bu yüzden özet, hesapları öğe öğe listeler. Paylaşmayan hesaplar için ccam, paylaşımı açan ccam share <name> --<item> on komutlarını yazdırır.

Seçenekler

Öğe seçeneği yoksa terminalde kontrol listesi karar verir. Terminal dışında veya --yes ile ccam, konuşma geçmişi dışındaki her şeyi kopyalar. projects/ büyük olabileceği için geçmiş varsayılan olarak dışarıda bırakılır.

--group on, default anlamına gelir. --group off ve --group local, --group takes a group name, not "off" ile reddedilir. ccam migrate, --dry-run seçeneğini dikkate alır; kuru çalıştırmada da kontrol listesi görünür, böylece bir seçimi önizleyebilirsiniz.

Nasıl çalışır

internal/cli/migrate.go öğeleri seçer, ardından migrate.Build kaynağı ve grubu okur ve bir plan döndürür. Siz onaylayıp Plan.Apply çalışana kadar hiçbir şey yazılmaz.

1. Kaynağı bulma. checkSource; eksik olan, klasör olmayan veya bilinen hiçbir Claude Code girdisi içermeyen bir yolu reddeder. migrate.ClaudeJSON, klasöre ait .claude.json dosyasını bulur: klasörün içinde ya da içinde olmayan ~/.claude için yanındaki ~/.claude.json. CLAUDE_CONFIG_DIR ayarlı olmadığında Claude Code onu orada tutar.
2. Öğeleri yollara eşleme. Her yol, ccam share komutunun kullandığı izin listesinin aynısı olan share.Layout içinden gelir. MCP sunucuları, dosyanın tamamını ayrıştırmak yerine profile.TopLevelValue tarayıcısını kullanan mcp.LocalServers ile .claude.json dosyasından okunur.
3. Taşımadan kopyalama. Dosyalar fsutil.AtomicWrite veya fsutil.CopyFile ile ~/.local/share/ccam/groups/<group>/ içine gider; MCP sunucuları grubun mcp.json dosyasına gider.

Her öğe bir kaynak yolu bir grup yoluna eşler:

İki geçmiş satırı kesikli çizgiyle gösterilir, çünkü yalnızca --history ile kopyalanırlar. .credentials.json ve .claude.json, share.Never içinde listelenir ve hiçbir zaman gruba ulaşmaz: bunlardan biri düzende görünürse Build dahili bir hata döndürür ve klasör taraması bunları adlarına göre atlar.

buildEntry her yola bir durum verir; her plan satırı bunu açıklar:

• Missing: kaynakta yok veya klasör beklenen yerde bir dosya var. Öğe başına bir kez not found, skipped olarak listelenir.
• Linked: kaynak yol zaten grubun kopyasına çözümlenir; örneğin kaynak bir ccam profil klasörü olduğunda.
• Same: grupta zaten aynı içerik var.
• New: grupta yok, bu yüzden bütünüyle kopyalanır.
• Merge: her iki tarafta da bir klasör. copyMissing yalnızca grupta olmayan dosyaları ekler; farklı olan dosyalar gruptaki haliyle kalır ve plan group copies kept der. plugins/ için installed_plugins.json ve known_marketplaces.json kayıtları birleştirilir ve mutlak eklenti yolları grubun klasörünü gösterecek şekilde yeniden yazılır.
• Conflict: her iki tarafta da farklı içerikli bir dosya. Dosya başına seçersiniz: keep group, use mine, ayrıca .json dosyaları için merge JSON (çakışan değerlerde grubun kazandığı derin bir birleştirme) veya history.jsonl için merge by line. Tanımı farklı olan bir MCP sunucusu da keep group veya use mine seçenekleriyle bir çakışmadır. Listelenen ilk seçenek, Enter'a bastığınızda varsayılandır; --yes her zaman grubun kopyasını korur.

Kontrol listesinin kendisi, ccam add komutunun kullandığı checklist bileşeni üzerine kurulmuş tui.MigratePicker bileşenidir; migrate.Found eksik öğeleri lstat çağrıları ve MCP sunucu listesiyle işaretler.

MCP oturum açmaları

OAuth ile oturum açan MCP sunucuları tokenlarını sunucu listesinde değil, giriş dosyasında, .credentials.json içinde mcpOAuth altında tutar. Claude Code her girdinin anahtarını <name>| artı sunucunun type, url ve headers değerlerinin sha256 hash'inin ilk 16 karakteri olarak oluşturur. Anahtar klasöre bağlı değildir; bu yüzden kopyalanmış bir girdi, sunucu tanımı aynı olduğu sürece başka bir hesapta da çalışır. Bu nedenle internal/migrate/logins.go içindeki buildLogins, yalnızca grubun sonunda kaynaktaki tanımla sahip olduğu sunucuların girdilerini kopyalar: yeni olanlar, zaten aynı olanlar veya use mine seçtiğiniz çakışmalar. Eklenti sunucularının oturum açmaları (plugin: ile başlayan anahtarlar), uzantıları kopyaladığınızda ve kaynakta plugins/ varsa birlikte gider.

Girdiler, alan her hesabın kendi .credentials.json dosyasına fsutil.AtomicWrite ile 0600 modunda yazılır. Hiçbir zaman gruba gitmez. Bir hesap bunları yalnızca mcp (eklenti sunucuları için extensions) öğesini hedef grup üzerinden paylaşıyorsa alır ve yalnızca hesapta olmayan anahtarlar eklenir: hesabın zaten sahip olduğu, belki daha yeni girdiler korunur. sign-ins plan satırı sunucuları, alan hesapları ve atlananları listeler. ccam bir hesabı şu durumlarda atlar ve nedeniyle birlikte adını verir:

• ccam import ile yerinde kaydedilmişse, çünkü düz claude onun giriş dosyasını kullanıyor olabilir;
• çalışıyorsa, çünkü Claude Code giriş dosyasını yeniden yazar (yazmadan hemen önce yeniden kontrol edilir, started meanwhile olarak bildirilir);
• henüz giriş yapılmamışsa;
• girişini ccam'in yazmadığı macOS Anahtar Zinciri'nde tutuyorsa.

Atlanan bir hesapta sunuculara /mcp ile oturum açın. MCP sunucularını sonradan paylaşmaya başlayan bir hesap, ccam migrate komutunu yeniden çalıştırdığınızda oturum açmaları alır; özet bunu Then run `ccam migrate` again to give them the MCP sign-ins too. ile belirtir.

Güvenlik ve uç durumlar

• Kaynak yalnızca okunur. İçindeki hiçbir dosya taşınmaz, bağlanmaz veya değiştirilmez; kaynak girişi, Anahtar Zinciri'nden okunabildiği macOS dahil, hiçbir zaman yazılmaz.
• Bir grup dosyası use mine, bir birleştirme veya mevcut bir mcp.json içindeki yeni MCP sunucuları ile değiştirilmeden önce grubun kopyası <group>/.ccam-backup/<time>/ içine kaydedilir. Klasör adı her çalıştırmada benzersizdir; böylece aynı saniyedeki iki çalıştırma birbirinin yedeklerinin üzerine yazmaz. Özet yolu yazdırır.
• --yes ile her çakışmada grubun kopyası korunur ve ccam bunun yerine nasıl seçim yapılacağını söyler: aynı komutu --yes olmadan çalıştırın.
• Hiçbir şey değişmeyecekse ccam Nothing to copy. yazdırır; her çakışmada grubun kopyası korunuyorsa Nothing to copy: the group keeps its own copies. yazdırır.
• Bir kopyalama yarıda başarısız olursa ccam The source folder was not changed. Group files replaced so far are saved in ve ardından yedek klasörüyle durur.
• Eksik bir kaynak no Claude Code folder at <path>. Give the folder to copy from: ccam migrate <folder> ile biter.

İlgili

• MCP sunucularını, ayarları ve geçmişi paylaşma
• Kontrol etme ve onarma
• Birden fazla Claude Code hesabı
• CLAUDE_CONFIG_DIR