Gestire gli account

Ogni account di ccam è una cartella di configurazione di Claude Code separata, con il proprio login. Questi comandi creano gli account, ne effettuano il login, li elencano, li rinominano e li rimuovono, e registrano le cartelle che hai già.

Utilizzo

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"

Dove un comando accetta <name|number>, puoi indicare il nome dell'account oppure il suo numero di slot, cioè la colonna # di ccam list.

ccam add in un terminale senza opzioni apre una procedura guidata. Chiede il nome, poi mostra una checklist degli elementi condivisi (è tutto selezionato tranne la cronologia delle conversazioni), poi chiede Create a shortcut command for work? [y/N] e, se rispondi y, Shortcut name [ccwork]:. Una qualsiasi tra --share, --shortcut o --no-login, oppure una pipe al posto di un terminale, salta la procedura guidata; in quel caso il nome è obbligatorio e non viene creata nessuna scorciatoia, a meno che --shortcut non ne indichi una.

ccam list mostra lo slot, il nome, la scorciatoia, l'email, gli elementi condivisi e l'ultimo uso, con * davanti all'account predefinito:

$ 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  -

Con --json, ogni account è un oggetto con slot, shortcut, name, email, default, dir, last_used (omesso se l'account non è mai stato avviato) e share. share associa ogni elemento (mcp, settings, memory, extensions, history) al nome del suo gruppo oppure a "local".

Opzioni

ccam login, ccam logout, ccam use e ccam rename non hanno opzioni proprie. ccam completion accetta bash o zsh; qualsiasi altro valore fallisce con only bash and zsh are supported.

I nomi degli account sono lunghi da 1 a 32 caratteri tra a-z, 0-9, - e _, e iniziano con una lettera o una cifra. Un nome non può essere composto solo da cifre, perché ccam 2 indica lo slot 2. Un nome non può nemmeno essere un comando di 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), così ccam <name> non è mai ambiguo. L'elenco è config.Reserved in internal/config.

Come funziona

ccam add work --shortcut ccwork esegue questi passaggi in addProfile (internal/cli/profiles.go):

1. config.ValidateName controlla il nome e shim.Check controlla la scorciatoia prima che venga creato qualsiasi cosa.
2. profile.Add crea ~/.local/share/ccam/profiles/work/ con modalità 0700 e assegna all'account il numero di slot libero più basso (Config.NextSlot), così il numero di un account rimosso viene riutilizzato. Il primo account diventa quello predefinito.
3. applyShare collega la nuova cartella vuota ai suoi gruppi di condivisione con share.Build e poi Apply, per esempio settings.json a groups/default/settings.json. Se questo passaggio fallisce, la nuova cartella viene rimossa, perché una cartella rimasta bloccherebbe ogni nuovo tentativo con folder already exists.
4. L'account viene salvato in ~/.config/ccam/config.toml tramite fsutil.AtomicWrite: un file temporaneo, fsync, poi rename, così un crash non lascia mai una configurazione scritta a metà.
5. runLogin avvia claude auth login con CLAUDE_CONFIG_DIR impostata sulla cartella dell'account. Se il login fallisce, l'account resta e ccam stampa l'errore e ti dice di eseguire ccam login work più tardi.
6. profile.ReadEmail estrae oauthAccount.emailAddress da profiles/work/.claude.json. Quel file può pesare diversi megabyte, quindi TopLevelValue cerca quell'unica chiave invece di analizzare l'intero file.
7. shim.Install collega ~/.local/bin/ccwork al binario di ccam, che all'avvio cerca argv[0] in config.toml.

Un login può richiedere minuti, e nel frattempo un altro ccam potrebbe salvare la configurazione. Per questo i comandi che restano in attesa salvano tramite env.update, che ricarica config.toml, applica l'unica modifica (qui, l'email) e salva. Per lo stesso motivo ccam remove ricarica la configurazione dopo la sua domanda.

ccam login esegue i passaggi 5 e 6 per un account esistente. ccam logout esegue claude auth logout nell'account e cancella l'email salvata. ccam use riscrive solo default in config.toml.

Accedere su una macchina remota

Tramite SSH, la parte di claude auth login che passa dal browser può non funzionare. Claude Code attende il login su un server di callback all'indirizzo http://localhost:<port>/callback sul server, ma il browser che completa il login è in esecuzione sul tuo computer, dove quell'indirizzo non porta da nessuna parte e il browser mostra un errore come ERR_CONNECTION_REFUSED. L'indirizzo contiene comunque il codice monouso, quindi ccam può consegnarlo:

runLogin non cede il tuo terminale a Claude Code. Collega lo standard input di Claude Code a una pipe e relayLogin vi copia ogni riga che digiti, così un codice incollato al prompt Paste code here di Claude Code arriva comunque. Quando una riga è un indirizzo di callback, callbackURL lo accetta solo se l'host è localhost, 127.0.0.1 o [::1], è indicata una porta, il percorso è /callback e sono presenti sia code sia state; http:// si può omettere. deliverCallback richiede poi quell'indirizzo sul server con un limite di 10 secondi e senza seguire i reindirizzamenti, come avrebbe fatto il browser. La richiesta raggiunge il server di callback del claude auth login in attesa (la linea tratteggiata nel diagramma). Claude Code riceve il codice e salva il login, su Linux in .credentials.json nella cartella dell'account. Una riga incollata non può mai far contattare a ccam un altro host.

ccam stampa questo prima che inizi il login:

On a remote machine? If the browser ends on a http://localhost:…/callback page that does not load, paste that address here.

Se riesce, stampa → Passed the sign-in to Claude Code on this machine.

Rinominare, rimuovere e importare

ccam rename e ccam remove agiscono sulla cartella dell'account e su ciò che ccam conserva altrove con il nome dell'account. nameState elenca questi percorsi: ~/.local/state/ccam/last-used/<name>, ~/.local/state/ccam/mcp/<name> e le cache dell'utilizzo ~/.local/state/ccam/usage/<name>.json e <name>.statusline.json. ccam remove work li gestisce in questo ordine:

ccam remove per prima cosa si rifiuta se l'account è in esecuzione, poi chiede conferma. Se l'account condivide le estensioni, RewritePluginPaths riscrive i file installed_plugins.json e known_marketplaces.json del gruppo, perché Claude Code salva percorsi assoluti dei plugin che possono passare per la cartella di questo account. profile.Trash sposta la cartella in ~/.local/share/ccam/trash/<name>-<time>/, l'account esce da config.toml, i percorsi di nameState vengono eliminati, così un account creato in seguito con lo stesso nome non li eredita, e il link della scorciatoia viene rimosso. Per recuperarlo, sposta di nuovo la cartella fuori dal cestino.

ccam rename rinomina la cartella, riscrive i percorsi dei plugin nel suo plugins/ dalla vecchia cartella alla nuova, mantiene l'eventuale impostazione di account predefinito e sposta i percorsi di nameState sul nuovo nome. Il comando scorciatoia mantiene il suo nome. Se la riscrittura dei plugin fallisce, la cartella torna al nome precedente, dato che la configurazione non viene salvata.

ccam import registra una cartella dove si trova, come dir in config.toml. Non la sposta né la copia mai: un refresh token copiato farebbe sì che le copie si disconnettano a vicenda. Senza una cartella come argomento cerca le cartelle ~/.claude e ~/.claude-* non registrate e chiede conferma per ciascuna; i nomi derivano dalla cartella (~/.claude diventa main, ~/.claude-work diventa work, ~/.claude-2 diventa acct2), e una cartella da cui non si ricava un nome viene elencata con il comando --name da usare. Senza CLAUDE_CONFIG_DIR, Claude Code tiene .claude.json nella tua cartella home accanto a ~/.claude, quindi quando importi ~/.claude e non ha un proprio .claude.json, ccam crea il link ~/.claude/.claude.json verso ~/.claude.json. In questo modo claude da solo e ccam main vedono lo stesso account. Gli account importati non condividono nulla finché non esegui ccam share, e non viene creata nessuna scorciatoia.

ccam completion bash|zsh stampa uno script di completamento che completa anche i nomi degli account.

Sicurezza e casi limite

• ccam rename e ccam remove si rifiutano mentre l'account è in esecuzione (refuseRunning), con work is running; quit its Claude Code session first, perché la sessione continua a scrivere nella cartella.
• ccam remove su un account importato si limita ad annullarne la registrazione: ✓ main unregistered (folder ... left in place). La tua ~/.claude non viene spostata nel cestino.
• ccam add rifiuta un nome la cui cartella esiste già in profiles/ e rimanda a ccam import.
• ccam import rifiuta una cartella già registrata, un percorso che non è una cartella e un nome già in uso.
• ccam logout e ccam login non controllano se l'account è in esecuzione.
• Se l'inoltro non riesce a raggiungere Claude Code, per esempio dopo che il login è terminato, stampa ccam: could not pass the sign-in to Claude Code: con il motivo. Un errore HTTP di solito significa che il codice è scaduto; avvia di nuovo il login.

Pagine correlate

• Avviare Claude Code
• Comandi scorciatoia
• Condividere server MCP, impostazioni e cronologia
• Più account Claude Code