ccam 설치

Linux나 macOS 터미널에서 다음 명령을 실행하세요.

curl -fsSL https://ccam.dev/install.sh | sh

스크립트는 시스템에 맞는 릴리스를 내려받아 SHA-256 체크섬을 확인한 뒤 ccam을 ~/.local/bin에 설치합니다. 나중에 ccwork처럼 직접 고른 단축 명령을 ccam이 만드는 곳도 이 폴더입니다. 이 폴더가 PATH에 없으면 스크립트가 ~/.bashrc나 ~/.zshrc에 추가할 줄을 알려 줍니다.

ccam은 Claude Code를 대신 실행해 주는 도구이므로, 먼저 Claude Code를 설치하고 claude --version이 제대로 실행되는지 확인하세요.

지원 시스템

• Linux(x86-64, ARM64): Ubuntu, Debian, Fedora, Arch, Alpine 등 여러 배포판. 정적 바이너리라 별도 의존성이 없습니다.
• macOS(Apple 실리콘, Intel).
• Windows는 직접 지원하지 않습니다. WSL에서는 일반 Linux 시스템과 똑같이 동작합니다.

다른 설치 방법

Debian, Ubuntu 패키지. 릴리스 페이지에서 ccam_<version>_linux_amd64.deb를 내려받아 설치합니다.

sudo apt install ./ccam_*_linux_amd64.deb

패키지로 설치하면 /usr/bin/ccam에 설치됩니다.

소스에서 설치. Go 1.26 이상이 필요합니다.

go install github.com/jhyunwoo/ccam/cmd/ccam@latest

특정 버전 설치. CCAM_VERSION을 지정합니다.

curl -fsSL https://ccam.dev/install.sh | CCAM_VERSION=v0.1.0 sh

셸 자동완성

ccam completion bash > ~/.local/share/bash-completion/completions/ccam
ccam completion zsh > "${fpath[1]}/_ccam"

자동완성은 계정 이름을 포함해 ccam의 모든 명령과 옵션을 지원합니다.

설치 확인

ccam version
ccam doctor

ccam doctor는 Claude Code를 찾을 수 있는지, 모든 계정 폴더와 링크, 로그인이 정상인지 확인합니다. 다음으로 빠른 시작을 읽어 보세요.

업데이트

ccam update --check
ccam update

ccam update --check는 새 릴리스가 있는지 알려 주기만 합니다. ccam update는 시스템에 맞는 릴리스를 내려받아 릴리스의 checksums.txt로 SHA-256 체크섬을 확인한 뒤 ccam 파일을 한 번에 교체합니다. 체크섬이 맞지 않으면 아무것도 바꾸지 않습니다. ccwork 같은 단축 명령은 ccam을 가리키는 링크라서 곧바로 새 버전으로 실행됩니다.

$ ccam update --check
ccam 0.3.0 is available (you have 0.2.0). Run `ccam update`.
$ ccam update
→ downloading https://github.com/jhyunwoo/ccam/releases/download/v0.3.0/ccam_linux_amd64.tar.gz
✓ Updated ccam 0.2.0 → 0.3.0 (/home/me/.local/bin/ccam)
$ ccam update
ccam 0.3.0 is up to date.

ccam은 스스로 업데이트를 확인하지 않습니다. 새 릴리스는 이 명령을 실행할 때만 찾습니다. 이전 버전을 포함해 특정 릴리스를 설치하려면 --version을 지정합니다. ccam --dry-run update는 아무것도 바꾸지 않고, 무엇을 내려받아 어떤 파일을 교체할지만 보여 줍니다.

ccam update --version v0.2.0
ccam --dry-run update

설치 스크립트를 다시 실행해도 ~/.local/bin의 ccam이 업데이트됩니다. go install로 설치했다면 같은 명령을 다시 실행하세요.

Debian, Ubuntu 패키지. apt로 설치한 /usr/bin/ccam은 ccam update가 교체하지 않고, 대신 아래 방법을 알려 줍니다. 릴리스 페이지에서 새 ccam_<version>_linux_amd64.deb를 내려받아 기존 패키지 위에 설치하세요.

sudo apt install ./ccam_*_linux_amd64.deb

제거

ccam이 아직 설치되어 있을 때 계정 단축 명령부터 지웁니다. ccam list의 Shortcut 열에서 단축 명령을 확인하고, 하나씩 ccam shortcut <account> --remove로 지우거나 ~/.local/bin에서 해당 링크를 직접 지우세요. 그다음 ccam 명령을 지우고, 계정이 더 이상 필요 없다면 데이터 폴더도 지웁니다.

ccam list
ccam shortcut work --remove   # once for each account that has a shortcut
rm ~/.local/bin/ccam
rm -r ~/.config/ccam ~/.local/share/ccam ~/.local/state/ccam

~/.local/share/ccam을 지우면 그 안에 저장된 로그인 정보와 대화 내역도 함께 지워집니다. 가져온 ~/.claude 폴더는 원래 위치에 그대로 남습니다.