# Riferimento dei comandi > Tutti i comandi e le opzioni di ccam, da ccam add e ccam fino a ccam usage, ccam next e ccam doctor. Source: https://ccam.dev/it/docs/commands/ · Updated 2026-10-19 Metti `--dry-run` prima di un comando per vedere cosa farebbe senza eseguirlo, per esempio `ccam --dry-run work`. Funziona quando avvii Claude Code (`ccam `, `ccam run`, `ccam next`) e con `share`, `migrate`, `shortcut`, `update` e `doctor --fix`. Gli altri comandi che modificano qualcosa lo rifiutano invece di essere eseguiti. | Comando | Cosa fa | | --- | --- | | `ccam` | Apre il selettore degli account | | `ccam [claude arguments]` | Avvia Claude Code con quell'account; gli argomenti vengono passati invariati | | `ccam add [name]` | Aggiunge un account: cartella di configurazione, login e una scorciatoia facoltativa | | `ccam completion bash|zsh` | Stampa il completamento per bash o zsh | | `ccam doctor` | Controlla link, permessi, login e versioni, e ripara | | `ccam import [folder]` | Registra una cartella ~/.claude esistente dove si trova | | `ccam list` | Elenca gli account | | `ccam login ` | Esegue di nuovo il login di un account | | `ccam logout ` | Rimuove il login di un account | | `ccam mcp [command]` | Gestisce i server MCP condivisi | | `ccam migrate [folder]` | Copia una configurazione di Claude Code esistente (~/.claude) in un gruppo condiviso | | `ccam next [--auto] [--continue] [-- claude args]` | Apre l'account successivo; --continue mantiene la conversazione, --auto sceglie quello con più margine | | `ccam remove ` | Rimuove un account; la sua cartella finisce nella cartella del cestino | | `ccam rename ` | Rinomina un account; la sua scorciatoia mantiene il nome | | `ccam share [--mcp on|off|] [--history …]` | Cambia cosa condivide un account, dopo averne mostrato il piano | | `ccam shims [command]` | Ricrea i link delle scorciatoie di tutti gli account | | `ccam shortcut [command]` | Mostra, crea, rinomina o rimuove la scorciatoia di un account, come ccwork | | `ccam statusline` | Mostra l'account e l'utilizzo nella riga di stato di Claude Code | | `ccam update` | Aggiorna ccam all'ultima release dopo averne verificato il checksum | | `ccam usage` | Mostra l'utilizzo su 5 ore e settimanale di tutti gli account | | `ccam use ` | Imposta l'account predefinito | ## Avviare Claude Code `ccam [arguments]` avvia Claude Code con quell'account. ccam non legge gli argomenti che seguono il nome; li passa a `claude` nello stesso ordine, e standard input, codice di uscita e segnali si comportano esattamente come con `claude` stesso. Un `--` dopo il nome è facoltativo. `ccam` con argomenti ma senza nome di account, come `ccam -p "summarise"`, usa l'account predefinito. Impostalo con `ccam use `. Una scorciatoia come `ccwork` avvia il suo account allo stesso modo: `ccwork --resume` fa ciò che fa `ccam work --resume`. Vedi [scorciatoie](https://ccam.dev/it/docs/commands.md#shortcuts). ## Aggiungere e rimuovere account ```sh 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` senza una cartella cerca `~/.claude` e `~/.claude-*` e chiede conferma per ciascuna. Le cartelle importate vengono registrate dove si trovano; ccam non sposta né copia mai un login. `ccam rename`, `ccam remove` e `ccam share` si rifiutano di modificare un account mentre Claude Code è in esecuzione con quell'account. Chiudi prima la sessione. `ccam list --json` stampa ogni account con il suo slot, la scorciatoia, l'email e la cartella. Il suo oggetto `share` associa ogni elemento (`mcp`, `settings`, `memory`, `extensions`, `history`) al nome di un gruppo o a `local`. ## Scorciatoie ```sh ccam shortcut work ccwork # create it, or rename the existing one ccam shortcut work # show it ccam shortcut work --remove ``` Una scorciatoia è un comando a cui dai tu il nome e che avvia Claude Code con un determinato account. Come `ccam work`, passa ogni argomento a Claude Code invariato, quindi `ccwork --resume` e `ccwork -p "hi"` funzionano come ti aspetti. È un link a ccam in `~/.local/bin`. Le scorciatoie sono facoltative. La procedura guidata di `ccam add` chiede se crearne una, `ccam add --shortcut ` ne crea una senza chiedere e `ccam list` mostra la scorciatoia di ogni account, oppure `-` se non ne ha. I nomi usano i caratteri a-z, 0-9, `.`, `-` e `_`. Un nome non può essere un comando di ccam, la scorciatoia di un altro account o il nome di un altro programma nel tuo `PATH`. `ccam rename` mantiene il nome della scorciatoia, e `ccam remove` elimina la scorciatoia insieme all'account. `ccam shims install` ricrea i link di tutti gli account, per esempio dopo che hai spostato ccam. ## Condivisione ```sh ccam share work # show the current state ccam share work --history on --mcp team ccam share work --settings off --fresh ``` Ogni elemento accetta `on` (il gruppo `default`), `off` oppure il nome di un gruppo. Vedi [condivisione](https://ccam.dev/it/docs/sharing.md). ## Copiare una configurazione esistente ```sh 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` copia `settings.json`, `CLAUDE.md`, le estensioni e i server MCP utente da una cartella di Claude Code in un gruppo, così ogni account che condivide quegli elementi li riceve. La cartella viene solo letta. Le opzioni `--settings`, `--memory`, `--extensions`, `--mcp` e `--history` copiano solo gli elementi indicati. Senza di esse, in un terminale una checklist ti permette di scegliere, con tutto selezionato tranne la cronologia delle conversazioni; altrove viene copiato tutto tranne la cronologia delle conversazioni. `-g` o `--group` sceglie il gruppo, e `-y` o `--yes` copia senza chiedere e mantiene la copia del gruppo quando un file è diverso. Copia anche gli accessi salvati dei server nel file di login di ciascun account. Vedi [copiare una configurazione esistente](https://ccam.dev/it/docs/sharing.md#copy-an-existing-setup). ## Server MCP ```sh 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 ` sposta nel suo gruppo i server che ha solo quell'account. Un server il cui nome è già usato dal gruppo per una definizione diversa viene saltato; aggiungi `--force` per sostituire la copia del gruppo, di cui ccam fa prima un backup. ## Utilizzo e cambio di account ```sh ccam usage # also: ccam u ccam usage --watch # refresh every 60 seconds ccam usage --json ccam next --continue ccam next --auto ``` ## Manutenzione ```sh 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` verifica il checksum SHA-256 della release prima di sostituire ccam, e `--version v0.2.0` installa una release specifica. Un ccam installato dal pacchetto `.deb` si aggiorna invece con apt. Vedi [aggiornamento](https://ccam.dev/it/docs/install.md#update). ## File | Percorso | Contenuto | | --- | --- | | `~/.config/ccam/config.toml` | Gli account e cosa condividono | | `~/.local/share/ccam/profiles//` | La `CLAUDE_CONFIG_DIR` di ogni account | | `~/.local/share/ccam/groups//` | Impostazioni, server MCP, estensioni e cronologia condivisi | | `~/.local/state/ccam/` | Cache dell'utilizzo e orari dell'ultimo uso | | `~/.local/bin/` | Scorciatoie come `ccwork`, link a ccam | Le variabili `XDG_CONFIG_HOME`, `XDG_DATA_HOME` e `XDG_STATE_HOME` spostano queste cartelle.