빠른 시작

ccam add로 계정을 하나씩 추가한 뒤, ccam <name> 또는 ccwork처럼 직접 이름을 붙인 단축 명령으로 Claude Code를 시작합니다. 대부분은 이것만으로 충분합니다.

1. 첫 번째 계정 추가하기

ccam add

설정 마법사가 personal이나 work 같은 계정 이름, 이 계정이 다른 계정과 공유할 항목, 그리고 단축 명령을 만들지 여부를 묻습니다(4단계 참고). 이어서 claude auth login이 실행되어 브라우저가 열리면 로그인하면 됩니다. 원격 컴퓨터에서는 브라우저가 로드되지 않는 http://localhost:…/callback 페이지에서 멈출 수 있습니다. 그 주소를 터미널에 붙여 넣으면 ccam이 로그인을 마칩니다. 완료되면 다음과 같이 표시됩니다.

✓ personal (me@example.com) added
  no shortcut (add one with `ccam shortcut personal ccpersonal`)

2. 기존 설정 가져오기

이전에 Claude Code를 써 왔다면 설정, CLAUDE.md, 확장 기능, MCP 서버가 ~/.claude에 있습니다. 이것을 공유 설정으로 복사하면 모든 계정이 같은 설정을 쓰게 됩니다.

ccam migrate

ccam은 무엇을 복사할지 먼저 보여 주고 확인을 받습니다. ~/.claude는 읽기만 하고, 로그인 정보는 복사하지 않으며, 대화 내역은 --history를 붙였을 때만 복사합니다. 자세한 내용은 기존 설정 복사하기를 참고하세요.

3. 두 번째 계정 추가하기

ccam add work

브라우저에서 다른 계정으로 로그인합니다.

4. 계정 전환하기

ccam work를 실행하면 work 계정으로 Claude Code가 시작됩니다. 더 짧게 쓰고 싶다면 ccwork처럼 계정 전용 단축 명령을 만드세요. 공유할 항목을 고르고 나면 설정 마법사가 다음과 같이 묻습니다.

 Create a shortcut command for work? [y/N]
 A command such as ccwork that opens Claude Code as this account.

y를 누른 뒤 이름을 입력하거나, Enter를 눌러 제안된 이름을 그대로 씁니다.

 Shortcut name [ccwork]: █
 a-z, 0-9, '.', '-' and '_'; Enter alone uses ccwork

로그인을 마치면 ccam이 단축 명령을 알려 줍니다.

✓ work (work@example.com) added
  shortcut: ccwork

이 질문을 건너뛰었더라도 단축 명령은 언제든 추가할 수 있습니다.

$ ccam shortcut work ccwork
✓ shortcut for work: ccwork

이제 다음 중 어느 명령을 실행해도 work 계정으로 Claude Code가 시작됩니다.

ccwork
ccam work
ccam 2

ccam만 실행하면 계정 선택 화면이 열립니다. 화살표 키와 Enter로 고르거나 계정 번호를 누르세요.

단축 명령이나 계정 이름 뒤에 쓴 내용은 모두 그대로 Claude Code에 전달되므로, 평소 쓰던 옵션을 그대로 쓰면 됩니다.

ccwork --resume
ccam work -p "fix the failing test" --output-format json
cat error.log | ccwork -p "what caused this?"

5. 공유할 항목 고르기

기본적으로 MCP 서버, settings.json, 전역 CLAUDE.md, 그리고 에이전트, 명령, 스킬, 플러그인은 계정 간에 공유됩니다. 대화 내역은 공유되지 않습니다. 계정을 오가며 대화를 이어 가려면 두 계정 모두 대화 내역 공유를 켜세요.

ccam share personal --history on
ccam share work --history on

ccam은 변경하기 전에 무엇을 옮길지 먼저 보여 줍니다. 자세한 내용은 공유를 참고하세요.

6. 계정이 한도에 도달했을 때

ccam usage
ccam next --continue

ccam usage는 모든 계정의 5시간 사용량과 주간 사용량을 보여 줍니다. ccam next --continue는 다음 계정에서 같은 대화를 엽니다. 자세한 내용은 사용량 한도를 참고하세요.

이미 ~/.claude를 쓰고 있다면

다시 로그인하지 말고 기존 폴더를 등록하세요.

ccam import

폴더는 원래 위치에 그대로 있고, claude를 그냥 실행해도 이전과 똑같이 동작합니다.