# Installare ccam

> Installa ccam su Linux o macOS con un solo comando, da un pacchetto .deb o dai sorgenti, e tienilo aggiornato con ccam update. Claude Code deve essere già installato.

Source: https://ccam.dev/it/docs/install/ · Updated 2026-10-19

Esegui questo comando in un terminale su Linux o macOS:

```sh
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](https://docs.claude.com/en/docs/claude-code/overview) 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](https://github.com/jhyunwoo/ccam/releases) e installalo:

```sh
sudo apt install ./ccam_*_linux_amd64.deb
```

Il pacchetto installa `/usr/bin/ccam`.

**Dai sorgenti.** Con Go 1.26 o successivo:

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

**Una versione specifica.** Imposta `CCAM_VERSION`:

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

## Completamento della shell

```sh
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

```sh
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](https://ccam.dev/it/docs/quick-start.md).

## Aggiornamento

```sh
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.

```console
$ 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.

```sh
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](https://github.com/jhyunwoo/ccam/releases) e installalo sopra quello vecchio:

```sh
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:

```sh
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](https://ccam.dev/it/docs/commands.md) resta dove si trova.