Referência de comandos

Coloque --dry-run antes de um comando para ver o que ele faria sem fazê-lo, por exemplo ccam --dry-run work. Funciona ao iniciar o Claude Code (ccam <name>, ccam run, ccam next) e com share, migrate, shortcut, update e doctor --fix. Outros comandos que alteram algo recusam a opção em vez de executar.

Iniciar o Claude Code

ccam <name|number> [arguments] inicia o Claude Code como essa conta. O ccam não lê os argumentos depois do nome; ele os repassa ao claude na mesma ordem, e a entrada padrão, o código de saída e os sinais se comportam exatamente como no próprio claude. Um -- depois do nome é opcional.

ccam com argumentos, mas sem nome de conta, como ccam -p "summarise", usa a conta padrão. Defina-a com ccam use <name>.

Um atalho como ccwork inicia a conta dele do mesmo jeito: ccwork --resume faz o mesmo que ccam work --resume. Consulte atalhos.

Adicionar e remover contas

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 sem uma pasta procura ~/.claude e ~/.claude-* e pergunta sobre cada uma. As pastas importadas são registradas no lugar onde estão; o ccam nunca move nem copia um login.

ccam rename, ccam remove e ccam share se recusam a alterar uma conta enquanto o Claude Code estiver em execução com essa conta. Encerre a sessão primeiro.

ccam list --json mostra todas as contas com o número (slot), atalho, e-mail e pasta de cada uma. O objeto share associa cada item (mcp, settings, memory, extensions, history) a um nome de grupo ou a local.

Atalhos

ccam shortcut work ccwork     # create it, or rename the existing one
ccam shortcut work            # show it
ccam shortcut work --remove

Um atalho é um comando que você mesmo nomeia e que inicia o Claude Code como uma determinada conta. Assim como ccam work, ele repassa todos os argumentos ao Claude Code sem alterações, então ccwork --resume e ccwork -p "hi" funcionam como você espera. Ele é um link para o ccam em ~/.local/bin.

Os atalhos são opcionais. O assistente do ccam add pergunta se você quer criar um, ccam add <name> --shortcut <command> cria um sem perguntar e ccam list mostra o atalho de cada conta, ou - quando ela não tem.

Os nomes usam os caracteres a-z, 0-9, ., - e _. Um nome não pode ser um comando do ccam, o atalho de outra conta nem o nome de outro programa no seu PATH.

ccam rename mantém o nome do atalho, e ccam remove exclui o atalho junto com a conta. ccam shims install recria os links de todas as contas, por exemplo depois que você move o ccam.

Compartilhamento

ccam share work                       # show the current state
ccam share work --history on --mcp team
ccam share work --settings off --fresh

Cada item aceita on (o grupo default), off ou o nome de um grupo. Consulte compartilhamento.

Copiar uma configuração existente

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, extensões e servidores MCP de usuário de uma pasta do Claude Code para um grupo, para que todas as contas que compartilham esses itens os recebam. A pasta é apenas lida. As opções --settings, --memory, --extensions, --mcp e --history copiam só os itens que você indicar. Sem elas, em um terminal, uma lista de seleção permite escolher, com tudo marcado exceto o histórico de conversas; fora de um terminal, tudo é copiado, exceto o histórico de conversas. -g ou --group escolhe o grupo, e -y ou --yes copia sem perguntar e mantém a cópia do grupo quando um arquivo é diferente. Ele também copia os logins salvos dos servidores para o próprio arquivo de login de cada conta. Consulte copiar uma configuração existente.

Servidores MCP

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 <account> move para o grupo da conta os servidores que só essa conta tem. Um servidor cujo nome o grupo já usa para uma definição diferente é ignorado; adicione --force para substituir a cópia do grupo, da qual o ccam faz backup antes.

Uso e troca de conta

ccam usage           # also: ccam u
ccam usage --watch   # refresh every 60 seconds
ccam usage --json
ccam next --continue
ccam next --auto

Manutenção

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 o checksum SHA-256 da versão antes de substituir o ccam, e --version v0.2.0 instala uma versão específica. Um ccam instalado pelo pacote .deb é atualizado com o apt. Consulte atualização.

Arquivos

As variáveis XDG_CONFIG_HOME, XDG_DATA_HOME e XDG_STATE_HOME mudam o local dessas pastas.