Gerenciar contas

Cada conta do ccam é uma pasta de configuração separada do Claude Code, com o próprio login. Estes comandos criam, conectam, listam, renomeiam e removem contas, e registram pastas que você já tem.

Uso

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"

Sempre que um comando aceita <name|number>, você pode informar o nome da conta ou o número do slot dela, a coluna # do ccam list.

ccam add em um terminal, sem opções, abre um assistente. Ele pede o nome, mostra uma lista de seleção dos itens compartilhados (tudo vem marcado, exceto o histórico de conversas), pergunta Create a shortcut command for work? [y/N] e, com y, Shortcut name [ccwork]:. Qualquer uma das opções --share, --shortcut ou --no-login, ou um pipe no lugar de um terminal, pula o assistente; nesse caso o nome é obrigatório e nenhum atalho é criado, a menos que --shortcut indique um.

ccam list mostra o slot, o nome, o atalho, o e-mail, os itens compartilhados e o último uso, com * antes da conta padrão:

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

Com --json, cada conta é um objeto com slot, shortcut, name, email, default, dir, last_used (omitido quando a conta nunca foi iniciada) e share. share associa cada item (mcp, settings, memory, extensions, history) ao nome do grupo ou a "local".

Opções

ccam login, ccam logout, ccam use e ccam rename não têm opções próprias. ccam completion aceita bash ou zsh; qualquer outro valor falha com only bash and zsh are supported.

Os nomes de conta têm de 1 a 32 caracteres entre a-z, 0-9, - e _, começando por uma letra ou um dígito. Um nome não pode ter só dígitos, porque ccam 2 significa o slot 2. Um nome também não pode ser um comando do 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), então ccam <name> nunca é ambíguo. A lista é config.Reserved, em internal/config.

Como funciona

ccam add work --shortcut ccwork executa estas etapas em addProfile (internal/cli/profiles.go):

1. config.ValidateName verifica o nome, e shim.Check verifica o atalho antes que qualquer coisa seja criada.
2. profile.Add cria ~/.local/share/ccam/profiles/work/ com o modo 0700 e dá à conta o menor número de slot livre (Config.NextSlot), então o número de uma conta removida é reaproveitado. A primeira conta se torna a padrão.
3. applyShare vincula a pasta nova e vazia aos grupos de compartilhamento com share.Build e depois Apply, por exemplo settings.json a groups/default/settings.json. Se isso falhar, a pasta nova é removida, porque uma pasta que sobrasse bloquearia todas as novas tentativas com folder already exists.
4. A conta é salva em ~/.config/ccam/config.toml com fsutil.AtomicWrite: um arquivo temporário, fsync e depois rename, para que uma falha nunca deixe uma configuração pela metade.
5. runLogin inicia claude auth login com CLAUDE_CONFIG_DIR apontando para a pasta da conta. Se o login falhar, a conta permanece, e o ccam imprime o erro e pede que você execute ccam login work depois.
6. profile.ReadEmail extrai oauthAccount.emailAddress de profiles/work/.claude.json. Esse arquivo pode ter vários megabytes, então TopLevelValue procura só essa chave em vez de analisar o arquivo inteiro.
7. shim.Install cria o link de ~/.local/bin/ccwork para o binário do ccam, que procura argv[0] no config.toml ao iniciar.

Um login pode levar minutos, e outro ccam pode salvar a configuração nesse meio-tempo. Por isso, os comandos que esperam salvam por meio de env.update, que recarrega o config.toml, aplica a única alteração (aqui, o e-mail) e salva. ccam remove recarrega depois da pergunta pelo mesmo motivo.

ccam login executa as etapas 5 e 6 para uma conta existente. ccam logout executa claude auth logout na conta e apaga o e-mail salvo. ccam use apenas reescreve default no config.toml.

Fazer login em uma máquina remota

Por SSH, a parte do navegador de claude auth login pode falhar. O Claude Code espera o login em um servidor de retorno em http://localhost:<port>/callback no servidor, mas o navegador que conclui o login roda no seu computador, onde esse endereço não leva a lugar nenhum, e o navegador mostra um erro como ERR_CONNECTION_REFUSED. O endereço ainda contém o código de uso único, então o ccam pode entregá-lo:

runLogin não entrega o seu terminal ao Claude Code. Ele conecta a entrada padrão do Claude Code a um pipe, e relayLogin copia para ele cada linha que você digita, então um código colado no prompt Paste code here do Claude Code continua chegando. Quando uma linha é um endereço de retorno, callbackURL só a aceita se o host for localhost, 127.0.0.1 ou [::1], houver uma porta, o caminho for /callback e code e state estiverem presentes; http:// pode ser omitido. Em seguida, deliverCallback solicita esse endereço no servidor com um limite de 10 segundos e sem seguir redirecionamentos, como o navegador teria feito. A solicitação chega ao servidor de retorno do claude auth login que está esperando (a linha tracejada no diagrama). O Claude Code recebe o código e salva o login, no Linux em .credentials.json na pasta da conta. Uma linha colada nunca faz o ccam contatar outro host.

O ccam imprime isto antes de o login começar:

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

Se der certo, ele imprime → Passed the sign-in to Claude Code on this machine.

Renomear, remover e importar

ccam rename e ccam remove atuam na pasta da conta e no que o ccam guarda com o nome da conta em outros lugares. nameState lista esses caminhos: ~/.local/state/ccam/last-used/<name>, ~/.local/state/ccam/mcp/<name> e os caches de uso ~/.local/state/ccam/usage/<name>.json e <name>.statusline.json. ccam remove work os trata nesta ordem:

ccam remove primeiro recusa se a conta estiver em execução e depois pergunta. Se a conta compartilha extensões, RewritePluginPaths reescreve o installed_plugins.json e o known_marketplaces.json do grupo, porque o Claude Code armazena caminhos absolutos de plugins que podem passar pela pasta desta conta. profile.Trash move a pasta para ~/.local/share/ccam/trash/<name>-<time>/, a conta sai do config.toml, os caminhos de nameState são excluídos para que uma conta futura com o mesmo nome não os herde, e o link do atalho é removido. Para recuperar, mova a pasta de volta da lixeira.

ccam rename renomeia a pasta, reescreve os caminhos de plugins em plugins/ da pasta antiga para a nova, mantém a conta como padrão se ela era e move os caminhos de nameState para o novo nome. O atalho mantém o nome. Se a reescrita dos plugins falhar, a pasta volta ao nome anterior, já que a configuração não é salva.

ccam import registra uma pasta no lugar onde ela está, como dir no config.toml. Ele nunca a move nem a copia: um token de renovação copiado faria as cópias desconectarem umas às outras. Sem uma pasta como argumento, ele procura pastas ~/.claude e ~/.claude-* não registradas e pergunta sobre cada uma; os nomes vêm da pasta (~/.claude vira main, ~/.claude-work vira work, ~/.claude-2 vira acct2), e uma pasta cujo nome não pode ser derivado é listada com o comando --name a usar. Sem CLAUDE_CONFIG_DIR, o Claude Code mantém o .claude.json na sua pasta pessoal, ao lado de ~/.claude, então, quando você importa ~/.claude e ela não tem um .claude.json próprio, o ccam cria o link ~/.claude/.claude.json para ~/.claude.json. Assim, o claude simples e o ccam main enxergam a mesma conta. Contas importadas não compartilham nada até você executar ccam share, e nenhum atalho é criado.

ccam completion bash|zsh imprime um script de autocompletar que também completa nomes de contas.

Segurança e casos especiais

• ccam rename e ccam remove se recusam enquanto a conta estiver em execução (refuseRunning), com work is running; quit its Claude Code session first, porque a sessão continua gravando na pasta.
• ccam remove em uma conta importada apenas cancela o registro: ✓ main unregistered (folder ... left in place). O seu ~/.claude não vai para a lixeira.
• ccam add recusa um nome cuja pasta já existe em profiles/ e indica ccam import.
• ccam import recusa uma pasta que já está registrada, um caminho que não é uma pasta e um nome que já está em uso.
• ccam logout e ccam login não verificam se a conta está em execução.
• Se o repasse não conseguir alcançar o Claude Code, por exemplo depois que o login terminou, ele imprime ccam: could not pass the sign-in to Claude Code: com o motivo. Um erro HTTP geralmente significa que o código expirou; comece o login de novo.

Relacionados

• Iniciar o Claude Code
• Atalhos
• Compartilhar servidores MCP, configurações e histórico
• Várias contas do Claude Code