# 계정 관리 > ccam add, ccam login, ccam list, ccam rename, ccam remove, ccam import로 Claude Code 계정을 추가하고, 로그인하고, 확인하고, 이름을 바꾸고, 삭제하고, 가져옵니다. Source: https://ccam.dev/ko/features/accounts/ · Updated 2026-10-19 ccam 계정은 각각 자체 로그인 정보를 가진 별도의 Claude Code 설정 폴더입니다. 다음 명령으로 계정을 만들고, 로그인하고, 목록을 보고, 이름을 바꾸고, 삭제하며, 이미 있는 폴더를 등록할 수 있습니다. ## 사용법 ```sh ccam add # wizard on a terminal: name, shared items, shortcut, login ccam add work --shortcut ccwork # no wizard: log in, then create the ccwork command ccam add side --no-login --share history=team ccam login side # run claude auth login inside the account ccam logout side # remove the login token ccam list # table of accounts; ccam ls is the same ccam list --json # machine-readable ccam use 2 # make slot 2 the default account ccam rename side personal ccam remove personal # asks, then moves the folder to the trash ccam import # find ~/.claude and ~/.claude-* and ask about each ccam import ~/.claude-ops --name ops ccam completion zsh > "${fpath[1]}/_ccam" ``` 명령이 ``를 받는 곳에는 계정 이름이나 슬롯 번호(`ccam list`의 `#` 열)를 줄 수 있습니다. 터미널에서 옵션 없이 `ccam add`를 실행하면 설정 마법사가 열립니다. 이름을 묻고, 공유 항목 체크리스트를 보여 준 다음(대화 내역을 제외한 모든 항목이 선택되어 있음), `Create a shortcut command for work? [y/N]`를 묻고 `y`를 입력하면 `Shortcut name [ccwork]:`를 묻습니다. `--share`, `--shortcut`, `--no-login` 중 하나라도 주거나 터미널 대신 파이프로 실행하면 마법사를 건너뜁니다. 이때는 이름이 필요하며, `--shortcut`으로 이름을 지정하지 않으면 단축 명령을 만들지 않습니다. `ccam list`는 슬롯, 이름, 단축 명령, 이메일, 공유 항목, 마지막 사용 시각을 보여 주며, 기본 계정 앞에는 `*`가 붙습니다. ```console $ ccam list # Name Shortcut Email Shared Last used * 1 work ccwork user@example.com mcp settings md ext - 2 personal - me@side.dev settings md ext history@team - ``` `--json`을 붙이면 각 계정이 `slot`, `shortcut`, `name`, `email`, `default`, `dir`, `last_used`(한 번도 시작하지 않은 계정에서는 생략), `share`를 가진 객체로 출력됩니다. `share`는 각 항목(`mcp`, `settings`, `memory`, `extensions`, `history`)을 그룹 이름이나 `"local"`에 대응시킵니다. ## 옵션 | 옵션 | 동작 | 기본값 | | --- | --- | --- | | `ccam add --no-login` | 로그인하지 않고 계정을 만듭니다. 나중에 `ccam login `으로 로그인합니다 | 꺼짐 | | `ccam add --share ` | 항목을 그룹과 공유합니다. `item=local`이면 공유하지 않습니다. 여러 번 지정할 수 있습니다 | `mcp`, `settings`, `memory`, `extensions`는 `default`, `history`는 로컬 | | `ccam add --shortcut ` | `~/.local/bin`에 이 단축 명령도 만듭니다 | 없음 | | `ccam list --json` | 계정을 JSON으로 출력합니다 | 꺼짐 | | `ccam remove -y`, `--yes` | 묻지 않고 삭제합니다 | 꺼짐 | | `ccam import --name ` | 지정한 폴더의 계정 이름 | 폴더 이름에서 만듦 | | `ccam import -y`, `--yes` | 찾은 폴더를 모두 묻지 않고 가져옵니다 | 꺼짐 | | `--dry-run` | 아무것도 바꾸지 않는 `ccam list`와 `ccam completion`에서 지원합니다. `add`, `login`, `logout`, `use`, `rename`, `remove`, `import`는 `` --dry-run is not supported by `ccam add`; nothing was changed ``(해당 명령 이름이 들어감)를 출력하고 거부합니다 | 꺼짐 | `ccam login`, `ccam logout`, `ccam use`, `ccam rename`에는 자체 옵션이 없습니다. `ccam completion`은 `bash`나 `zsh`를 받으며, 그 밖의 값은 `only bash and zsh are supported`로 실패합니다. 계정 이름은 `a-z`, `0-9`, `-`, `_`로 이루어진 1~32자이며, 문자나 숫자로 시작해야 합니다. `ccam 2`는 슬롯 2를 뜻하므로 숫자로만 된 이름은 쓸 수 없습니다. ccam 명령 이름(`add`, `list`, `ls`, `run`, `use`, `next`, `usage`, `u`, `share`, `mcp`, `login`, `logout`, `rename`, `remove`, `rm`, `import`, `migrate`, `doctor`, `shims`, `shortcut`, `completion`, `help`, `version`, `statusline`, `update`)도 쓸 수 없으므로, `ccam `이 모호해지는 일은 없습니다. 이 목록은 `internal/config`의 `config.Reserved`입니다. ## 동작 방식 `ccam add work --shortcut ccwork`는 `addProfile`(`internal/cli/profiles.go`)에서 다음 단계를 실행합니다. 1. 무엇이든 만들기 전에 `config.ValidateName`이 이름을, `shim.Check`가 단축 명령을 검사합니다. 2. `profile.Add`가 `0700` 권한으로 `~/.local/share/ccam/profiles/work/`를 만들고, 비어 있는 가장 낮은 슬롯 번호(`Config.NextSlot`)를 계정에 줍니다. 그래서 삭제한 계정의 번호가 다시 쓰입니다. 첫 번째 계정은 기본 계정이 됩니다. 3. `applyShare`가 `share.Build`와 `Apply`로 새 빈 폴더를 공유 그룹에 링크합니다(예: `settings.json`을 `groups/default/settings.json`에). 이 단계가 실패하면 새 폴더를 삭제합니다. 폴더가 남아 있으면 이후의 모든 재시도가 `folder already exists`로 막히기 때문입니다. 4. 계정을 `fsutil.AtomicWrite`로 `~/.config/ccam/config.toml`에 저장합니다. 임시 파일에 쓰고 `fsync`한 뒤 `rename`하므로, 도중에 비정상 종료되어도 설정이 절반만 남지 않습니다. 5. `runLogin`이 `CLAUDE_CONFIG_DIR`를 계정 폴더로 설정하고 `claude auth login`을 시작합니다. 로그인이 실패해도 계정은 남으며, ccam은 오류를 출력하고 나중에 `ccam login work`를 실행하라고 안내합니다. 6. `profile.ReadEmail`이 `profiles/work/.claude.json`에서 `oauthAccount.emailAddress`를 꺼냅니다. 이 파일은 수 MB가 될 수 있으므로, `TopLevelValue`는 파일 전체를 해석하지 않고 그 키 하나만 찾습니다. 7. `shim.Install`이 `~/.local/bin/ccwork`를 ccam 실행 파일에 링크합니다. ccam은 시작할 때 `config.toml`에서 `argv[0]`을 찾습니다. 로그인에는 몇 분이 걸릴 수 있고, 그동안 다른 ccam이 설정을 저장할 수도 있습니다. 그래서 기다리는 명령은 `env.update`로 저장합니다. 이 함수는 `config.toml`을 다시 읽고, 바꿀 내용 하나(여기서는 이메일)만 적용해 저장합니다. 같은 이유로 `ccam remove`도 확인 질문 뒤에 설정을 다시 읽습니다. `ccam login`은 기존 계정에 대해 5단계와 6단계를 실행합니다. `ccam logout`은 계정 안에서 `claude auth logout`을 실행하고 저장된 이메일을 지웁니다. `ccam use`는 `config.toml`의 `default`만 다시 씁니다. ### 원격 머신에서 로그인하기 SSH로 접속했을 때는 `claude auth login`의 브라우저 쪽 과정이 실패할 수 있습니다. Claude Code는 서버의 `http://localhost:/callback`에 콜백 서버를 띄워 로그인을 기다리지만, 로그인을 마치는 브라우저는 내 컴퓨터에서 실행되므로 그 주소로는 아무 데도 연결되지 않고 `ERR_CONNECTION_REFUSED` 같은 오류가 표시됩니다. 그래도 주소에는 일회용 코드가 들어 있으므로 ccam이 대신 전달할 수 있습니다. `runLogin`은 터미널을 Claude Code에 그대로 넘기지 않습니다. Claude Code의 표준 입력을 파이프에 연결하고, `relayLogin`이 입력한 줄을 하나씩 그 파이프로 복사합니다. 그래서 Claude Code의 `Paste code here` 프롬프트에 붙여 넣은 코드도 그대로 전달됩니다. 입력한 줄이 콜백 주소이면 `callbackURL`이 검사합니다. 호스트가 `localhost`, `127.0.0.1`, `[::1]` 중 하나이고, 포트가 있고, 경로가 `/callback`이며, `code`와 `state`가 모두 있을 때만 받아들입니다. `http://`는 생략해도 됩니다. 그다음 `deliverCallback`이 브라우저가 했을 것처럼 서버에서 그 주소로 요청을 보냅니다. 제한 시간은 10초이고 리디렉션은 따라가지 않습니다. 요청은 기다리고 있던 `claude auth login`의 콜백 서버에 도착합니다(그림의 점선). Claude Code가 코드를 받아 로그인 정보를 저장하며, Linux에서는 계정 폴더의 `.credentials.json`에 저장됩니다. 붙여 넣은 줄 때문에 ccam이 다른 호스트에 접속하는 일은 절대 없습니다. ccam은 로그인을 시작하기 전에 다음을 출력합니다. ```text On a remote machine? If the browser ends on a http://localhost:…/callback page that does not load, paste that address here. ``` 성공하면 `→ Passed the sign-in to Claude Code on this machine.`를 출력합니다. ### 이름 변경, 삭제, 가져오기 `ccam rename`과 `ccam remove`는 계정 폴더와, ccam이 다른 곳에 계정 이름으로 보관하는 파일을 함께 다룹니다. `nameState`가 그 경로들을 나열합니다. `~/.local/state/ccam/last-used/`, `~/.local/state/ccam/mcp/`, 사용량 캐시 `~/.local/state/ccam/usage/.json`과 `.statusline.json`입니다. `ccam remove work`는 이들을 다음 순서로 처리합니다. `ccam remove`는 먼저 계정이 실행 중이면 거부하고, 그다음 확인을 받습니다. 계정이 확장 기능을 공유하면 `RewritePluginPaths`가 그룹의 `installed_plugins.json`과 `known_marketplaces.json`을 다시 씁니다. Claude Code는 플러그인의 절대 경로를 저장하는데, 그 경로가 이 계정의 폴더를 거칠 수 있기 때문입니다. `profile.Trash`가 폴더를 `~/.local/share/ccam/trash/-