CLAUDE_CONFIG_DIR: o que essa variável faz no Claude Code

O que a variável faz

A referência de variáveis de ambiente da Anthropic descreve CLAUDE_CONFIG_DIR como uma forma de substituir o diretório de configuração, que por padrão é ~/.claude. Todas as configurações, o histórico de sessões e os plugins ficam guardados no caminho que você indicar.

Nada mais muda no Claude Code. O comando claude é o mesmo programa; ele só lê e grava em outra pasta. Inicie-o com um valor e você tem uma configuração. Inicie com outro e você tem uma segunda, independente.

O que fica em um diretório de configuração

Segundo o guia da Anthropic sobre o diretório .claude, quando você define CLAUDE_CONFIG_DIR, todo caminho que normalmente ficaria em ~/.claude passa a ficar no seu diretório. Isso inclui:

Seu CLAUDE.md pessoal, o settings.json, skills, comandos, subagentes e estilos de saída.
As transcrições das sessões em projects/, além da memória automática de cada projeto.
Os snapshots de arquivos usados para restaurar checkpoints, os arquivos de plano e o histórico dos seus prompts.
Atalhos de teclado e temas personalizados.

Os arquivos do projeto não são afetados. O CLAUDE.md, a pasta .claude/ e o .mcp.json do próprio repositório pertencem ao projeto, então todos os diretórios de configuração os veem.

Como os logins ficam separados no Mac

No macOS, o Claude Code guarda as credenciais no Keychain, que é criptografado. As notas sobre gerenciamento de credenciais da Anthropic dizem que, com CLAUDE_CONFIG_DIR definida, o Claude Code associa o item do Keychain a esse diretório, então uma sessão com outro diretório lê outro item. Se o Keychain recusar a gravação, o arquivo alternativo .credentials.json também fica nesse diretório.

Há uma exceção documentada. Diretórios separados não mantêm separados dois logins do Claude Console feitos sem chave de API, porque o Claude Code guarda esse tipo de login fora do diretório de configuração (documentação de autenticação, em outubro de 2026).

Variáveis de ambiente também podem substituir o login em qualquer diretório. Se ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN ou CLAUDE_CODE_OAUTH_TOKEN estiver exportada no seu shell, ela pode prevalecer sobre a conta com que você entrou. Veja como trocar de conta no Claude Code para conhecer a ordem completa.

Onde definir a variável

O jeito mais simples é um alias no shell, que é o exemplo dado pela Anthropic. Adicione-o ao ~/.zshrc e abra uma nova janela do Terminal:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

A primeira execução guia você pelo login e pela configuração do novo diretório. O claude simples continua usando ~/.claude.

Você também pode definir a variável nas configurações de usuário ou nas configurações gerenciadas. Em um arquivo de configuração, escreva o caminho absoluto. O Claude Code a ignora nas configurações de projeto e nas locais, então não dá para defini-la por repositório dessa forma.

Para conferir qual diretório um shell está usando, execute claude auth status. Nas versões recentes, a saída em JSON inclui o campo configDirectory (referência da CLI).

Erros comuns

Esquecer a variável em uma janela. Uma aba do Terminal sem ela usa ~/.claude e o login dessa pasta, o que passa despercebido com facilidade. Aliases evitam isso.
Usar ~ em um arquivo de configuração. Arquivos de configuração precisam do caminho absoluto, como /Users/you/.claude-work.
Copiar uma pasta inteira para criar outra. Isso copia o histórico e o estado de uma conta para a outra. Comece com uma pasta vazia e adicione o que precisar. Compartilhar skills e servidores MCP explica como.
Esperar que as sessões antigas venham junto. As transcrições ficam no diretório que as criou, então claude --resume em outro diretório não as lista. Veja como retomar sessões do Claude Code.
Uma chave de API exportada. Ela substitui o login em todos os diretórios.

Como o Switch usa a variável no Claude Desktop

O Claude Code dentro do Claude Desktop não lê os aliases do seu shell. O Switch cuida desse caso. Cada perfil do Switch abre o próprio app Claude Desktop da Anthropic com sua própria pasta de dados. Com Keep coding preferences separate (manter preferências de código separadas) ativado, que é o padrão para perfis novos, o perfil também recebe sua própria pasta de configuração do Claude Code, e o Switch abre o Claude Desktop desse perfil com CLAUDE_CONFIG_DIR apontando para ela.

O Switch não adiciona nenhum comando ao Terminal, e cada conta mantém seu próprio plano e seus limites de uso. Como o Switch lida com o Claude Code.