Współdzielenie serwerów MCP, ustawień i historii

Każde konto ma własny login. Wszystko inne można współdzielić element po elemencie: ccam linkuje plik lub folder konta do współdzielonego folderu grupy, więc zmiana wprowadzona na jednym koncie pojawia się na wszystkich kontach tej grupy.

Co można współdzielić

Nowe konta współdzielą wszystko oprócz historii rozmów.

Pliki logowania .credentials.json i .claude.json nigdy nie są współdzielone. ccam linkuje tylko ścieżki ze stałej listy, a tych dwóch na niej nie ma.

Grupy

on oznacza grupę default. Możesz też podać nazwę, żeby tylko niektóre konta współdzieliły dany element:

ccam share work --history team
ccam share side --history team

work i side współdzielą teraz rozmowy ze sobą, ale nie z pozostałymi kontami.

Włączanie współdzielenia

Gdy konto zaczyna współdzielić element, ccam:

1. wypisuje plan wszystkich plików, które przeniesie, skopiuje lub podlinkuje, i pyta o zgodę przed rozpoczęciem;
2. przenosi pliki konta do folderu grupy, jeśli grupa jest jeszcze pusta, albo dodaje pliki, których grupa jeszcze nie ma;
3. gdy ten sam plik się różni, pyta, czy zachować wersję grupy, użyć twojej, czy scalić JSON;
4. zachowuje oryginał w .ccam-backup/<time>/ w folderze konta;
5. zastępuje oryginał linkiem do grupy.

Pliki rozmów mają nazwy według identyfikatora sesji, więc historie z kilku kont łączą się bez konfliktów.

ccam nie zmienia współdzielenia, gdy Claude Code działa jako to konto, bo sesja dalej zapisuje do przenoszonych plików. Najpierw ją zakończ.

Wyłączanie współdzielenia

ccam share work --history off

Link zostaje usunięty, a konto dostaje własną kopię bieżącej zawartości grupy. Dodaj --fresh, żeby zamiast tego zacząć od pustego folderu. Grupa zachowuje swoją zawartość dla pozostałych kont.

Kopiowanie istniejącej konfiguracji

Jeśli używałeś Claude Code przed ccam, twoje ustawienia są w ~/.claude. ccam migrate kopiuje je do grupy, żeby dostało je każde konto współdzielące te elementy:

ccam migrate

W terminalu ccam najpierw pokazuje listę elementów do zaznaczenia. Zaznaczone jest wszystko oprócz historii rozmów; naciśnij Spację, żeby zmienić element, i Enter, żeby zobaczyć plan. Elementy, dla których folder nic nie zawiera, są oznaczone jako not found.

Co jest kopiowane:

• settings.json i globalny CLAUDE.md;
• rozszerzenia agents/, commands/, skills/, plugins/, output-styles/ i rules/;
• twoje serwery MCP użytkownika, czyli wpis mcpServers z ~/.claude.json, do pliku grupy mcp.json;
• zapisane logowania (OAuth) kopiowanych serwerów MCP, do własnego pliku logowania każdego konta;
• historia rozmów (projects/ i history.jsonl), ale tylko gdy dodasz --history.

Folder źródłowy jest tylko odczytywany: nic w nim nie jest przenoszone, linkowane ani zmieniane, a zwykłe claude działa jak dotąd. Pliki logowania .credentials.json i .claude.json nigdy nie są kopiowane do grupy.

Serwery MCP logujące się przez OAuth przechowują swoje tokeny w loginie, a nie na liście serwerów. Żebyś nie musiał logować się do nich ponownie, ccam kopiuje te logowania do pliku logowania każdego konta, które dostaje serwery przez grupę, chyba że konto ma już własne. Pomija konta, które są uruchomione, nie są jeszcze zalogowane, zostały zarejestrowane w miejscu poleceniem ccam import albo przechowują login w pęku kluczy macOS, i podaje ich nazwy; zaloguj się tam do serwerów przez /mcp. Konto, które zacznie współdzielić serwery MCP później, dostanie logowania, gdy ponownie uruchomisz ccam migrate.

Zanim cokolwiek skopiuje, ccam wypisuje plan i pyta o zgodę:

$ ccam migrate
Copy from /home/me/.claude into group default (/home/me/.local/share/ccam/groups/default):
  mcp         ~/.claude.json  new: context7, fs
  settings    settings.json   new: 80 B
  memory      CLAUDE.md       new: 31 B
  extensions  agents/         add 1 file the group lacks (17 B)
              commands/       add 1 file the group lacks (15 B)
              skills/         add 1 file the group lacks (32 B)
              not found, skipped: plugins/, output-styles/, rules/
  Conversation history (projects/, history.jsonl) is not included; add --history to copy it.
Copy these into group default? [y/N] y
✓ Copied into group default: 2 MCP servers, settings.json, CLAUDE.md, agents/, commands/, skills/
Accounts that share these through group default:
  mcp         personal
  settings    personal
  memory      personal
  extensions  personal

Na końcu ccam wypisuje konta, które współdzielą każdy element przez grupę. Jeśli niektóre konta tego nie robią, podaje polecenia ccam share, które włączają dla nich współdzielenie.

Gdy grupa ma już inną kopię pliku, ccam pyta tak samo jak przy włączaniu współdzielenia: zachować kopię grupy czy użyć twojej. settings.json i inne pliki JSON można też scalić, a history.jsonl scalić wiersz po wierszu. Poprzednie kopie grupy są zapisywane w .ccam-backup/<time>/ w folderze grupy.

Umieść --dry-run przed poleceniem, jak w ccam --dry-run migrate, aby zobaczyć plan bez kopiowania czegokolwiek. Aby skopiować z innego folderu, podaj go: ccam migrate ~/.claude-work --group work.

Serwery MCP

Claude Code przechowuje serwery MCP w .claude.json razem z loginem, więc tego pliku nie można współdzielić. ccam trzyma współdzielone serwery w mcp.json grupy i uruchamia Claude Code z --mcp-config=<group>/mcp.json. Twoje własne opcje --mcp-config nadal obowiązują i są stosowane dodatkowo.

ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
ccam mcp list

Serwer dodany w trakcie sesji przez claude mcp add jest zapisywany tylko dla tego konta. Przy następnym uruchomieniu tego konta ccam poda nazwę serwera i polecenie, które przeniesie go do grupy:

ccam mcp import work gh

Jeśli grupa ma już inny serwer o tej nazwie, ccam go pomija i o tym informuje. --force zastępuje serwer grupy i zachowuje stary mcp.json w folderze .ccam-backup/ grupy.

Serwery MCP logujące się przez OAuth przechowują swoje tokeny razem z loginem konta, więc autoryzuj je raz na każdym koncie albo skopiuj logowania z ~/.claude poleceniem ccam migrate.

Jeśli wolisz, żeby serwery pojawiały się w claude mcp list i /mcp jako zwykłe serwery użytkownika, ustaw mcp_strategy = "sync" w ~/.config/ccam/config.toml. ccam zapisuje je wtedy w .claude.json każdego konta przed startem, z użyciem blokady pliku samego Claude Code i z kopią zapasową.

Dwa konta w tym samym folderze

Konta, które współdzielą historię rozmów, zapisują do tych samych plików. Jeśli uruchomisz drugi Claude Code w folderze, w którym działa już inne konto z tej samej grupy, ccam ostrzeże cię i zapyta, czy kontynuować.

Gdy coś się zepsuje

ccam doctor
ccam doctor --fix

Jeśli współdzielona ścieżka stała się zwykłym plikiem, na przykład po ręcznym przywróceniu kopii zapasowej, ccam zatrzymuje się przed uruchomieniem Claude Code i wskazuje ccam doctor --fix, które scala plik z grupą i zachowuje kopię zapasową.