Recursos

Contas por pasta

Por jhyunwoo
Última atualização: 20 de outubro de 2026
Verificado com ccam 0.8.0 e Claude Code 2.1.302

Esta página foi traduzida automaticamente do inglês. Correções são bem-vindas. Editar esta página no GitHub

Nesta página

ccam folder work ~/code/company faz com que toda inicialização sem nome de conta dentro de ~/code/company, e em qualquer pasta abaixo dela, inicie o Claude Code como work. Fora dela, a conta padrão inicia como antes. Nomear uma conta, com ccam personal ou com um atalho como ccpersonal, sempre inicia essa conta.

Uso

ccam folder work ~/code/company     # use work in ~/code/company and below
ccam folder personal                # use personal in the current folder
ccam folder                         # list the folders and the account used here
ccam folder --remove ~/code/company # stop using an account there
cd ~/code/company/api && ccam -p "summarise the open issues"   # runs as work
$ ccam folder work ~/code/company
✓ /home/me/code/company → work
  ccam without an account name starts work here and in every folder below.
$ cd ~/code/company/api && ccam folder
/home/me/code/company → work

Here (/home/me/code/company/api): work, set for /home/me/code/company

Estas inicializações usam a conta da pasta:

  • ccam -p "…" e qualquer outra inicialização cujo primeiro argumento seja uma opção para o Claude Code
  • ccam run sem nome, e ccam --dry-run
  • ccam --fallback -p "…" na primeira tentativa
  • o seletor, ccam sozinho, que começa com o cursor na conta da pasta

Opções

Opção O que faz Padrão
<account> Nome ou número da conta a usar
[folder] A pasta, relativa ou absoluta a pasta atual
--remove Remove a entrada exatamente dessa pasta desativado
--dry-run Respeitada: imprime a mudança sem salvá-la desativado

Como funciona

Cada pasta é uma entrada [[folder]] em ~/.config/ccam/config.toml, o arquivo que toda inicialização já lê:

[[folder]]
path = '/home/me/code/company'
account = 'work'
  1. ccam folder resolve a pasta para um caminho absoluto, com os links simbólicos resolvidos, e o salva. Definir uma pasta de novo substitui a conta dela.
  2. Uma inicialização sem nome chama launcher.HereProfile. Sem entradas, ela pega a conta padrão na hora.
  3. Caso contrário, compara o diretório de trabalho com cada path como strings: a própria pasta ou uma abaixo dela, nunca uma pasta que só começa com as mesmas letras (/code/company não cobre /code/companyx). A entrada mais profunda vence, então ~/code pode ser personal enquanto ~/code/company é work.
  4. Só se o diretório de trabalho, como está, não corresponder a nada, o ccam resolve os links simbólicos dele e compara mais uma vez.
  5. No Windows, a comparação ignora maiúsculas e minúsculas, como o Windows faz.

Nenhum arquivo além do config.toml é lido, então uma inicialização dentro de uma pasta não custa tempo mensurável (4,0 ms com ou sem entradas, hyperfine, 300 execuções).

Segurança e casos especiais

  • ccam rename leva as entradas de pasta para o novo nome, e ccam remove exclui as entradas da conta removida.
  • Uma entrada cuja conta não existe mais interrompe uma inicialização sem nome nessa pasta: <folder> is set to account "<name>", which does not exist. Change it with ccam folder. ccam doctor informa essas entradas e as entradas cuja pasta sumiu.
  • ccam folder --remove dentro de uma pasta que recebe a conta de uma pasta acima indica essa pasta em vez de remover alguma coisa.
  • ccam next escolhe por rotação ou por uso e não olha as pastas.