기존 설정 복사하기

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

터미널에서 항목 옵션과 --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)로 커서 위치의 항목 선택을 바꾸고, 화살표 키나 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은 공유를 켜는 ccam share <name> --<item> on 명령을 출력합니다.

옵션

항목 옵션이 없으면 터미널에서는 체크리스트로 정합니다. 터미널이 아니거나 --yes를 주면 대화 내역을 제외한 모든 항목을 복사합니다. projects/는 클 수 있으므로 대화 내역은 기본적으로 제외합니다.

--group on은 default를 뜻합니다. --group off와 --group local은 --group takes a group name, not "off"로 거부합니다. ccam migrate는 --dry-run을 지원하며, 시험 실행에서도 체크리스트가 나타나므로 선택 결과를 미리 볼 수 있습니다.

동작 방식

internal/cli/migrate.go가 항목을 고르면 migrate.Build가 원본과 그룹을 읽어 계획을 반환합니다. 확인을 받은 뒤 Plan.Apply가 실행되기 전에는 아무것도 기록하지 않습니다.

1. 원본 찾기. checkSource는 없는 경로, 폴더가 아닌 경로, 알려진 Claude Code 항목이 하나도 없는 경로를 거부합니다. migrate.ClaudeJSON은 폴더에 해당하는 .claude.json을 찾습니다. 폴더 안에 있으면 그것을 쓰고, 안에 없는 ~/.claude라면 그 옆의 ~/.claude.json을 씁니다. CLAUDE_CONFIG_DIR가 설정되지 않았을 때 Claude Code가 이 파일을 두는 곳입니다.
2. 항목을 경로에 대응시키기. 모든 경로는 ccam share가 쓰는 것과 같은 허용 목록인 share.Layout에서 나옵니다. MCP 서버는 mcp.LocalServers로 .claude.json에서 읽으며, 이 함수는 파일 전체를 해석하지 않고 profile.TopLevelValue 스캐너를 씁니다.
3. 옮기지 않고 복사만 하기. 파일은 fsutil.AtomicWrite나 fsutil.CopyFile로 ~/.local/share/ccam/groups/<group>/에 복사하고, MCP 서버는 그룹의 mcp.json에 넣습니다.

각 항목은 원본 경로 하나를 그룹 경로 하나에 대응시킵니다.

대화 내역 두 행은 --history를 줄 때만 복사되므로 점선으로 표시됩니다. .credentials.json과 .claude.json은 share.Never에 들어 있어 그룹에 절대 들어가지 않습니다. 레이아웃에 이 파일이 나타나면 Build가 내부 오류를 반환하고, 폴더를 탐색할 때도 이름으로 건너뜁니다.

buildEntry는 모든 경로에 상태를 부여하며, 계획의 각 줄은 이 상태를 설명합니다.

• 없음: 원본에 없거나, 폴더여야 할 자리에 파일이 있는 경우입니다. 항목마다 한 번 not found, skipped로 표시됩니다.
• 링크됨: 원본 경로가 이미 그룹의 사본을 가리키는 경우입니다. 예를 들어 원본이 ccam 프로필 폴더일 때입니다.
• 같음: 그룹에 이미 같은 내용이 있는 경우입니다.
• 새 항목: 그룹에 없으므로 통째로 복사합니다.
• 병합: 양쪽에 모두 있는 폴더입니다. copyMissing은 그룹에 없는 파일만 추가하며, 내용이 다른 파일은 그룹에 있는 그대로 두고 계획에 group copies kept로 표시합니다. plugins/에서는 레지스트리 installed_plugins.json과 known_marketplaces.json을 병합하고, 플러그인의 절대 경로를 그룹 폴더를 가리키도록 다시 씁니다.
• 충돌: 양쪽에 모두 있지만 내용이 다른 파일입니다. 파일마다 keep group과 use mine 중에서 고르며, .json 파일은 merge JSON(값이 겹치면 그룹이 우선하는 깊은 병합), history.jsonl은 merge by line도 고를 수 있습니다. 정의가 다른 MCP 서버도 충돌로 처리하며, keep group이나 use mine을 고릅니다. 맨 처음 나오는 선택지가 Enter를 눌렀을 때의 기본값이고, --yes는 항상 그룹의 사본을 유지합니다.

체크리스트 자체는 ccam add가 쓰는 checklist 컴포넌트로 만든 tui.MigratePicker입니다. migrate.Found는 lstat 호출과 MCP 서버 목록으로 없는 항목을 표시합니다.

MCP 로그인 정보

OAuth로 로그인하는 MCP 서버는 토큰을 서버 목록이 아니라 로그인 파일인 .credentials.json의 mcpOAuth 아래에 보관합니다. Claude Code는 각 항목의 키를 <name>|에 서버의 type, url, headers로 만든 sha256 해시의 앞 16자를 붙여 만듭니다. 키가 폴더와 무관하므로, 서버 정의만 같다면 복사한 항목이 다른 계정에서도 동작합니다. 그래서 internal/migrate/logins.go의 buildLogins는 최종적으로 그룹이 원본의 정의를 갖게 되는 서버의 항목만 복사합니다. 새 항목이거나, 이미 같거나, 충돌에서 use mine을 고른 서버입니다. 플러그인 서버의 로그인 정보(plugin:으로 시작하는 키)는 확장 기능을 복사하고 원본에 plugins/가 있을 때 함께 복사됩니다.

이 항목들은 받는 계정 자체의 .credentials.json에 fsutil.AtomicWrite로 0600 권한을 주어 기록합니다. 그룹에는 절대 들어가지 않습니다. 계정이 대상 그룹을 통해 mcp(플러그인 서버라면 extensions)를 공유할 때만 받으며, 계정에 없는 키만 추가합니다. 이미 있는 항목은 더 최신일 수 있으므로 그대로 둡니다. 계획의 sign-ins 줄에는 서버, 받는 계정, 건너뛴 계정이 나열됩니다. ccam은 다음과 같은 계정을 건너뛰고, 그 이름과 이유를 알려 줍니다.

• ccam import로 제자리에 등록한 계정. 일반 claude가 그 로그인 파일을 쓰고 있을 수 있기 때문입니다.
• 실행 중인 계정. Claude Code가 로그인 파일을 다시 쓰기 때문입니다(기록 직전에 다시 확인하며, started meanwhile로 보고합니다).
• 아직 로그인하지 않은 계정.
• 로그인 정보를 macOS 키체인에 보관하는 계정. ccam은 키체인에 쓰지 않습니다.

건너뛴 계정에서는 /mcp로 서버에 로그인하세요. 나중에 MCP 서버를 공유하기 시작한 계정은 ccam migrate를 다시 실행하면 로그인 정보를 받습니다. 요약에도 Then run `ccam migrate` again to give them the MCP sign-ins too.로 안내합니다.

안전장치와 예외 상황

• 원본은 읽기만 합니다. 그 안의 어떤 파일도 옮기거나 링크하거나 바꾸지 않으며, 원본의 로그인 정보에는 절대 쓰지 않습니다. 키체인에서 로그인 정보를 읽을 수 있는 macOS에서도 마찬가지입니다.
• use mine, 병합, 기존 mcp.json에 새 MCP 서버를 추가하는 경우처럼 그룹의 파일을 바꾸기 전에는 그룹의 사본을 <group>/.ccam-backup/<time>/에 저장합니다. 폴더 이름은 실행할 때마다 고유하므로, 같은 초에 두 번 실행해도 서로의 백업을 덮어쓰지 않습니다. 요약에 그 경로가 출력됩니다.
• --yes를 주면 모든 충돌에서 그룹의 사본을 유지하며, ccam은 직접 고르려면 같은 명령을 --yes 없이 실행하라고 안내합니다.
• 바뀔 것이 없으면 Nothing to copy.를, 모든 충돌에서 그룹의 사본을 유지하면 Nothing to copy: the group keeps its own copies.를 출력합니다.
• 복사가 중간에 실패하면 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