# Referência de comandos > Todos os comandos e opções do ccam, de ccam add e ccam a ccam usage, ccam next e ccam doctor. Source: https://ccam.dev/pt-br/docs/commands/ · Updated 2026-10-19 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 `, `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. | Comando | O que faz | | --- | --- | | `ccam` | Abrir o seletor de contas | | `ccam [claude arguments]` | Iniciar o Claude Code como essa conta; os argumentos são repassados sem alterações | | `ccam add [name]` | Adicionar uma conta: pasta de configuração, login e um atalho opcional | | `ccam completion bash|zsh` | Imprimir o preenchimento automático para bash ou zsh | | `ccam doctor` | Verificar links, permissões, logins e versões, e corrigir | | `ccam import [folder]` | Registrar uma pasta ~/.claude existente no lugar onde ela está | | `ccam list` | Listar as contas | | `ccam login ` | Fazer login em uma conta novamente | | `ccam logout ` | Remover o login de uma conta | | `ccam mcp [command]` | Gerenciar servidores MCP compartilhados | | `ccam migrate [folder]` | Copiar uma configuração existente do Claude Code (~/.claude) para um grupo compartilhado | | `ccam next [--auto] [--continue] [-- claude args]` | Abrir a próxima conta; --continue mantém a conversa, --auto escolhe a que tem mais espaço | | `ccam remove ` | Remover uma conta; a pasta dela vai para a pasta de lixeira | | `ccam rename ` | Renomear uma conta; o atalho dela mantém o nome | | `ccam share [--mcp on|off|] [--history …]` | Alterar o que uma conta compartilha, depois de mostrar o plano | | `ccam shims [command]` | Recriar os links dos atalhos de todas as contas | | `ccam shortcut [command]` | Mostrar, criar, renomear ou remover o atalho de uma conta, como ccwork | | `ccam statusline` | Mostrar a conta e o uso na linha de status do Claude Code | | `ccam update` | Atualizar o ccam para a versão mais recente depois de verificar o checksum | | `ccam usage` | Mostrar o uso de 5 horas e o uso semanal de todas as contas | | `ccam use ` | Definir a conta padrão | ## Iniciar o Claude Code `ccam [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 `. Um atalho como `ccwork` inicia a conta dele do mesmo jeito: `ccwork --resume` faz o mesmo que `ccam work --resume`. Consulte [atalhos](https://ccam.dev/pt-br/docs/commands.md#shortcuts). ## Adicionar e remover contas ```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` 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 ```sh 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 --shortcut ` 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 ```sh 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](https://ccam.dev/pt-br/docs/sharing.md). ## Copiar uma configuração existente ```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`, 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](https://ccam.dev/pt-br/docs/sharing.md#copy-an-existing-setup). ## Servidores 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 ` 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 ```sh ccam usage # also: ccam u ccam usage --watch # refresh every 60 seconds ccam usage --json ccam next --continue ccam next --auto ``` ## Manutenção ```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 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](https://ccam.dev/pt-br/docs/install.md#update). ## Arquivos | Caminho | Conteúdo | | --- | --- | | `~/.config/ccam/config.toml` | As contas e o que elas compartilham | | `~/.local/share/ccam/profiles//` | O `CLAUDE_CONFIG_DIR` de cada conta | | `~/.local/share/ccam/groups//` | Configurações, servidores MCP, extensões e histórico compartilhados | | `~/.local/state/ccam/` | Cache de uso e horários do último uso | | `~/.local/bin/` | Atalhos como `ccwork`, links para o ccam | As variáveis `XDG_CONFIG_HOME`, `XDG_DATA_HOME` e `XDG_STATE_HOME` mudam o local dessas pastas.