명령어 레퍼런스

최종 수정 2026년 10월 19일
ccam 0.6.0, Claude Code 2.1.302 기준으로 확인함

명령 앞에 --dry-run을 붙이면 실제로 실행하지 않고 무엇을 할지만 보여 줍니다(예: ccam --dry-run work). Claude Code를 시작할 때(ccam <name>, ccam run, ccam next)와 share, migrate, shortcut, update, doctor --fix에서 쓸 수 있습니다. 무언가를 바꾸는 다른 명령은 실행하지 않고 이 옵션을 거부합니다.

명령	설명
`ccam`	계정 선택 화면 열기
`ccam <name\|number> [claude arguments]`	해당 계정으로 Claude Code 시작(인자는 그대로 전달)
`ccam add [name]`	계정 추가(설정 폴더, 로그인, 원하면 단축 명령)
`ccam completion bash\|zsh`	bash 또는 zsh 자동완성 스크립트 출력
`ccam doctor`	링크, 권한, 로그인, 버전 점검 및 복구
`ccam import [folder]`	기존 ~/.claude 폴더를 옮기지 않고 그대로 등록
`ccam list`	계정 목록 보기
`ccam login <name\|number>`	계정에 다시 로그인
`ccam logout <name\|number>`	계정의 로그인 정보 삭제
`ccam mcp [command]`	공유 MCP 서버 관리
`ccam migrate [folder]`	기존 Claude Code 설정(~/.claude)을 공유 그룹으로 복사
`ccam next [--auto] [--continue] [-- claude args]`	다음 계정 열기(--continue: 대화 이어 가기, --auto: 여유가 가장 많은 계정 선택)
`ccam remove <name\|number>`	계정 삭제(폴더는 휴지통 폴더로 이동)
`ccam rename <name> <new-name>`	계정 이름 변경(단축 명령 이름은 그대로 유지)
`ccam share <name\|number> [--mcp on\|off\|<group>] [--history …]`	계정의 공유 항목 변경(변경 계획을 먼저 표시)
`ccam shims [command]`	모든 계정의 단축 명령 링크 다시 만들기
`ccam shortcut <name\|number> [command]`	계정의 단축 명령(예: ccwork) 보기, 만들기, 이름 바꾸기, 삭제
`ccam statusline`	Claude Code 상태 표시줄에 계정과 사용량 표시
`ccam update`	체크섬을 확인한 뒤 ccam을 최신 릴리스로 업데이트
`ccam usage`	모든 계정의 5시간·주간 사용량 보기
`ccam use <name\|number>`	기본 계정 지정

Claude Code 시작하기

ccam <name|number> [arguments]는 해당 계정으로 Claude Code를 시작합니다. ccam은 이름 뒤의 인자를 해석하지 않고 같은 순서 그대로 claude에 넘기며, 표준 입력, 종료 코드, 시그널도 claude를 직접 실행할 때와 똑같이 동작합니다. 이름 뒤의 --는 넣어도 되고 생략해도 됩니다.

ccam -p "summarise"처럼 계정 이름 없이 인자만 넘겨 ccam을 실행하면 기본 계정을 사용합니다. 기본 계정은 ccam use <name>으로 지정합니다.

ccwork 같은 단축 명령도 같은 방식으로 해당 계정을 시작합니다. ccwork --resume은 ccam work --resume과 똑같이 동작합니다. 자세한 내용은 단축 명령을 참고하세요.

계정 추가와 삭제

ccam add                      # wizard
ccam add work --share history=on
ccam add side --shortcut ccside
ccam add ci --no-login        # log in later with: ccam login ci
ccam rename work job
ccam remove side              # folder moves to ~/.local/share/ccam/trash
ccam import ~/.claude-old --name old

폴더를 지정하지 않고 ccam import를 실행하면 ~/.claude와 ~/.claude-*를 찾아 폴더마다 하나씩 물어봅니다. 가져온 폴더는 원래 위치에서 그대로 등록되며, ccam은 로그인 정보를 절대 옮기거나 복사하지 않습니다.

ccam rename, ccam remove, ccam share는 어떤 계정으로 Claude Code가 실행 중이면 그 계정을 바꾸지 않고 거부합니다. 먼저 세션을 종료하세요.

ccam list --json은 모든 계정의 슬롯 번호, 단축 명령, 이메일, 폴더를 출력합니다. share 객체는 각 항목(mcp, settings, memory, extensions, history)을 그룹 이름이나 local에 대응시킵니다.

단축 명령

ccam shortcut work ccwork     # create it, or rename the existing one
ccam shortcut work            # show it
ccam shortcut work --remove

단축 명령은 직접 이름을 붙여 한 계정으로 Claude Code를 시작하는 명령입니다. ccam work와 마찬가지로 모든 인자를 그대로 Claude Code에 넘기므로 ccwork --resume이나 ccwork -p "hi"도 예상대로 동작합니다. 단축 명령은 ~/.local/bin에 있는 ccam 링크입니다.

단축 명령은 필수가 아닙니다. ccam add 설정 마법사가 만들지 여부를 묻고, ccam add <name> --shortcut <command>는 묻지 않고 바로 만듭니다. ccam list는 계정마다 단축 명령을 보여 주며, 없으면 -로 표시합니다.

이름에는 a-z, 0-9, ., -, _만 쓸 수 있습니다. ccam 명령 이름, 다른 계정의 단축 명령, PATH에 있는 다른 프로그램의 이름은 쓸 수 없습니다.

ccam rename은 단축 명령 이름을 그대로 두고, ccam remove는 계정과 함께 단축 명령도 삭제합니다. ccam shims install은 모든 계정의 링크를 다시 만듭니다. ccam을 다른 위치로 옮긴 뒤에 쓰면 됩니다.

ccam share work                       # show the current state
ccam share work --history on --mcp team
ccam share work --settings off --fresh

항목마다 on(default 그룹), off, 또는 그룹 이름을 지정할 수 있습니다. 자세한 내용은 공유를 참고하세요.

기존 설정 복사하기

ccam migrate                    # ~/.claude into the default group
ccam --dry-run migrate          # show the plan, copy nothing
ccam migrate ~/.claude-work --group work --settings --mcp
ccam migrate --history --yes    # conversation history only

ccam migrate는 Claude Code 폴더에 있는 settings.json, CLAUDE.md, 확장 기능, 사용자 MCP 서버를 공유 그룹으로 복사합니다. 그러면 그 항목을 공유하는 모든 계정이 같은 내용을 쓰게 됩니다. 원본 폴더는 읽기만 합니다. --settings, --memory, --extensions, --mcp, --history 옵션을 주면 지정한 항목만 복사합니다. 옵션이 없으면 터미널에서는 체크리스트가 나타나 직접 고를 수 있으며, 대화 내역을 제외한 모든 항목이 선택되어 있습니다. 터미널이 아니면 대화 내역을 제외한 모든 항목을 복사합니다. -g 또는 --group으로 그룹을 고르고, -y 또는 --yes를 주면 묻지 않고 복사하며 내용이 다른 파일은 그룹의 사본을 유지합니다. 또한 MCP 서버에 저장된 로그인 정보를 각 계정 자체의 로그인 파일로 복사합니다. 자세한 내용은 기존 설정 복사하기를 참고하세요.

MCP 서버

ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
ccam mcp add docs --url https://mcp.example.com/mcp --header "Authorization: Bearer $TOKEN"
ccam mcp add-json db '{"type":"stdio","command":"db-mcp"}'
ccam mcp list
ccam mcp import work gh
ccam mcp remove fs

ccam mcp import <account>는 그 계정에만 있는 서버를 계정의 그룹으로 옮깁니다. 그룹에 같은 이름으로 정의가 다른 서버가 이미 있으면 건너뜁니다. --force를 붙이면 그룹의 서버를 바꾸며, ccam이 먼저 기존 것을 백업합니다.

사용량 확인과 계정 전환

ccam usage           # also: ccam u
ccam usage --watch   # refresh every 60 seconds
ccam usage --json
ccam next --continue
ccam next --auto

유지 관리

ccam doctor          # check
ccam doctor --fix    # repair what is safe to repair, with backups
ccam statusline install
ccam shims install   # recreate the shortcut links
ccam update          # install the latest ccam release
ccam update --check  # only check for a newer release
ccam version         # also: ccam -v, ccam --version

ccam update는 ccam을 교체하기 전에 릴리스의 SHA-256 체크섬을 확인하고, --version v0.2.0을 주면 특정 릴리스를 설치합니다. .deb 패키지로 설치한 ccam은 apt로 업데이트합니다. 자세한 내용은 업데이트를 참고하세요.

파일

경로	내용
`~/.config/ccam/config.toml`	계정 목록과 각 계정의 공유 항목
`~/.local/share/ccam/profiles/<name>/`	계정별 `CLAUDE_CONFIG_DIR`
`~/.local/share/ccam/groups/<group>/`	공유된 설정, MCP 서버, 확장 기능, 대화 내역
`~/.local/state/ccam/`	사용량 캐시와 마지막 사용 시각
`~/.local/bin/<shortcut>`	`ccwork` 같은 단축 명령(ccam 링크)

XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_STATE_HOME 변수로 이 폴더들의 위치를 바꿀 수 있습니다.