Installare ccam

Esegui questo comando in un terminale su Linux o macOS:

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

Lo script scarica la release per il tuo sistema, ne verifica il checksum SHA-256 e mette ccam in ~/.local/bin, dove ccam crea anche le scorciatoie che scegli in seguito, come ccwork. Se quella cartella non è nel tuo PATH, lo script stampa la riga da aggiungere a ~/.bashrc o ~/.zshrc.

ccam avvia Claude Code per te, quindi installa prima Claude Code e verifica che claude --version funzioni.

Sistemi supportati

• Linux su x86-64 e ARM64: Ubuntu, Debian, Fedora, Arch, Alpine e altre distribuzioni. Il binario è statico e non ha dipendenze.
• macOS su Apple silicon e Intel.
• Windows non è supportato direttamente. All'interno di WSL, ccam funziona come su qualsiasi sistema Linux.

Altri modi per installare

Pacchetto per Debian e Ubuntu. Scarica ccam_<version>_linux_amd64.deb dalla pagina delle release e installalo:

sudo apt install ./ccam_*_linux_amd64.deb

Il pacchetto installa /usr/bin/ccam.

Dai sorgenti. Con Go 1.26 o successivo:

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

Una versione specifica. Imposta CCAM_VERSION:

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

Completamento della shell

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

Il completamento copre tutti i comandi e le opzioni di ccam, compresi i nomi degli account.

Verificare l'installazione

ccam version
ccam doctor

ccam doctor controlla che Claude Code venga trovato e che ogni cartella di account, link e login sia in ordine. Prosegui con la guida rapida.

Aggiornamento

ccam update --check
ccam update

ccam update --check ti dice solo se esiste una release più recente. ccam update scarica la release per il tuo sistema, ne verifica il checksum SHA-256 confrontandolo con il file checksums.txt della release e poi sostituisce il file ccam in un solo passaggio. Se il checksum non corrisponde, non viene modificato nulla. Le scorciatoie come ccwork sono link a ccam, quindi usano subito la nuova versione.

$ 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 non controlla mai gli aggiornamenti da solo: cerca una nuova release solo quando esegui questo comando. Per installare una release specifica, anche una precedente, passa --version. ccam --dry-run update mostra cosa verrebbe scaricato e sostituito, senza modificare nulla.

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

Anche eseguire di nuovo lo script di installazione aggiorna la copia in ~/.local/bin. Se hai compilato ccam con go install, esegui di nuovo lo stesso comando.

Pacchetto per Debian e Ubuntu. ccam update non sostituisce un /usr/bin/ccam installato con apt e al suo posto stampa questi passaggi. Scarica il nuovo ccam_<version>_linux_amd64.deb dalla pagina delle release e installalo sopra quello vecchio:

sudo apt install ./ccam_*_linux_amd64.deb

Disinstallazione

Rimuovi prima le scorciatoie degli account, finché ccam è ancora installato. ccam list le mostra nella colonna Shortcut; rimuovile una per una con ccam shortcut <account> --remove, oppure elimina tu quei link da ~/.local/bin. Poi rimuovi il comando e, se non ti servono più gli account, le cartelle dei dati:

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

Eliminare ~/.local/share/ccam elimina anche i login e la cronologia delle conversazioni salvati lì. Una cartella ~/.claude che hai importato resta dove si trova.