Explore o diretório .claude

Onde Claude Code lê CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules e auto memory. Explore o diretório .claude em seu projeto e ~/.claude em seu diretório home.

Claude Code lê instruções, configurações, skills, subagents e memória do seu diretório de projeto e de ~/.claude em seu diretório home. Confirme arquivos de projeto no git para compartilhá-los com sua equipe; arquivos em ~/.claude são configuração pessoal que se aplica em todos os seus projetos.

No Windows, ~/.claude é resolvido para %USERPROFILE%\.claude. Se você definir CLAUDE_CONFIG_DIR, cada caminho ~/.claude nesta página fica sob esse diretório.

A maioria dos usuários apenas edita CLAUDE.md e settings.json. Se seu repositório já tiver um AGENTS.md para outros agentes de codificação, Claude Code pode lê-lo no lugar de um CLAUDE.md. O resto do diretório é opcional: adicione skills, regras ou subagentes conforme necessário.

Explore o diretório

Clique em arquivos na árvore para ver o que cada um faz, quando carrega e um exemplo.

O que não é mostrado

O explorador cobre arquivos que você cria e edita. Alguns arquivos relacionados vivem em outro lugar:

~/.claude também contém dados que Claude Code escreve conforme você trabalha: transcrições, histórico de prompts, snapshots de arquivos, caches e logs. Veja dados da aplicação abaixo.

Escolha o arquivo certo

Diferentes tipos de personalização vivem em arquivos diferentes. Use esta tabela para encontrar onde uma mudança pertence.

Referência de arquivos

Esta tabela lista todos os arquivos que o explorador abrange. Os arquivos de escopo de projeto ficam no seu repositório em .claude/ (ou na raiz, no caso de CLAUDE.md, .mcp.json e .worktreeinclude). Os arquivos de escopo global ficam em ~/.claude/ e se aplicam a todos os projetos.

[!NOTE]

Várias coisas podem sobrescrever o que você coloca nesses arquivos:

• As configurações gerenciadas implantadas pela sua organização têm precedência sobre todos os arquivos de configurações e valores de --settings, exceto pelas exceções descritas em Precedência de configurações
• Flags da CLI como --permission-mode ou --settings sobrescrevem settings.json naquela sessão
• Algumas variáveis de ambiente têm precedência sobre a configuração equivalente, mas isso varia: consulte a referência de variáveis de ambiente para cada uma

Consulte precedência de configurações para ver a ordem completa.

Clique no nome de um arquivo para abrir esse nó no explorador acima.

Campos de frontmatter por arquivo

Skills, arquivos de comando, subagentes, estilos de saída e regras leem sua configuração do YAML frontmatter no topo do arquivo, e cada um aceita seu próprio conjunto de campos. Esta tabela lista os nomes dos campos para cada arquivo e vincula à referência que os descreve.

Agentes fornecidos em um plugin honram um subconjunto dos campos de subagente.

Solucione problemas de configuração

Se uma configuração, hook ou arquivo não está tendo efeito, veja Debug your configuration para os comandos de inspeção e uma tabela de busca por sintoma.

Dados da aplicação

Além da configuração que você cria, ~/.claude contém dados que Claude Code escreve durante as sessões. Esses arquivos são texto simples. Qualquer coisa que passa por uma ferramenta é escrita em uma transcrição no disco: conteúdo de arquivos, saída de comandos, texto colado.

A transcrição também pode conter o que Claude Code envia ao modelo junto com suas mensagens:

• O system prompt
• Definições de ferramentas
• Parâmetros de requisição
• Os arquivos de instruções que ele carregou, como CLAUDE.md

Limpeza automática

Claude Code deleta os arquivos nos caminhos abaixo uma vez que tenham mais de cleanupPeriodDays de idade, desde que possa determinar com segurança o período de retenção. O padrão é 30 dias e o mínimo é 1; definir 0 falha com um erro de validação. O mesmo limite de idade se aplica à remoção automática de worktrees órfãs.

Arquivos de sessão em sessions/, memória automática, e transcrições de Claude Desktop e Cowork seguem cada uma sua própria regra de retenção:

• sessions/: contém um pequeno arquivo por sessão em execução, usado para detectar sessões simultâneas e crashes. Não faz parte da varredura baseada em idade: Claude Code remove cada arquivo quando sua sessão sai e limpa resíduos de crash no próximo lançamento.

• Memória automática: a varredura não deleta os arquivos de memória no diretório de memória automática de um projeto, projects/<project>/memory/. Claude Code remove esse diretório apenas se ele esteve vazio durante todo o período de retenção. Antes da v2.1.228, a varredura tratava pastas dentro do diretório de memória como dados de sessão e podia deletar arquivos antigos sob ele.

• Transcrições de Claude Desktop e Cowork: Claude Code mantém a transcrição de uma sessão que você iniciou ou continuou mais recentemente em Claude Desktop ou Cowork em qualquer idade. Para dar a essas transcrições um limite de idade, defina desktopSessionCleanupPeriodDays. Requer Claude Code v2.1.248 ou posterior; versões anteriores as deletam após cleanupPeriodDays.

  Em vez disso, Claude Code deleta essas transcrições após cleanupPeriodDays em qualquer um destes casos:

  • Configurações gerenciadas definem cleanupPeriodDays
  • A configuração HIPAA se aplica às suas sessões

Claude Code pula a varredura baseada em idade nestes casos:

• Modo bare: quando você executa claude -p com --bare, Claude Code não executa a varredura nessa sessão.
• Varredura pausada: se Claude Code não conseguir determinar com segurança o período de retenção, ele pausa a varredura de limpeza de retenção; o evento retention_sweep lista cada configuração que a pausa. Quando a causa é um arquivo de configurações que não pode ser lido ou analisado, ou erros de configurações com cleanupPeriodDays ou desktopSessionCleanupPeriodDays explicitamente definidos, Claude Code também mostra um aviso em /status até você corrigir os erros de configurações. Quando configurações gerenciadas fornecem cleanupPeriodDays, Claude Code executa a varredura no valor gerenciado em qualquer caso.

Para verificar se as máquinas da sua organização executam a varredura com o período de retenção que você definiu, consulte Verificar a varredura de retenção.

Diretório de bloco de notas por sessão

O bloco de notas é um diretório por sessão que Claude Code fornece a Claude para arquivos temporários: resultados intermediários, scripts auxiliares e rascunhos que não pertencem ao seu projeto. Quando Claude diz que salvou algo "no bloco de notas", o arquivo está lá. Claude o usa em vez de /tmp, e pode criar, editar e ler arquivos nele sem um prompt de permissão.

O bloco de notas fica sob o diretório temporário de Claude Code em vez de ~/.claude. Encontre o caminho da sessão atual para sua plataforma:

• macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
• Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/, ou a mesma forma sob $TMPDIR quando seu sistema define um
• Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> é o caminho do seu diretório de trabalho com cada caractere que não seja letra ou dígito substituído por -, como -Users-you-my-project. Se você definir CLAUDE_CODE_TMPDIR, a árvore se move sob esse diretório em vez disso. Hooks recebem o caminho da sessão atual como scratchpad_dir.

Arquivos do bloco de notas duram enquanto a transcrição da sessão: a varredura de retenção deleta o diretório quando deleta a transcrição, e claude purge não toca no diretório temporário. Como o diretório fica sob a localização temporária do sistema, seu sistema operacional também pode limpá-lo, como na reinicialização. Para manter algo que Claude escreveu lá, peça a Claude para movê-lo para seu projeto.

Uma sessão tem um bloco de notas apenas quando todos estes se aplicam:

• Você está conectado com uma conta claude.ai em vez de uma chave de API
• A sessão usa a API Anthropic, não Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry
• enableArtifact não está definido como false

Mantido até você deletar

Exceto pelas linhas que indicam o contrário, a varredura de limpeza de retenção não remove os caminhos abaixo, e Claude Code os mantém até você deletá-los.

Arquivos de estado para manter

Dependendo de quais recursos você usa, ~/.claude/ também contém arquivos que as tabelas em Dados da aplicação não listam. Desses, caches e arquivos de lock são seguros para deletar. Mantenha esses arquivos de estado:

• .credentials.json: suas credenciais de login
• agent-memory/: memória de subagent
• jobs/ e daemon/: estado de sessão em segundo plano

Armazenamento em texto simples

Transcrições e histórico não são criptografados em repouso. As permissões de arquivo do SO são a única proteção. Se uma ferramenta ler um arquivo .env ou um comando imprimir uma credencial, esse valor é escrito em projects/<project>/<session>.jsonl. Para reduzir a exposição:

• Reduza cleanupPeriodDays para encurtar quanto tempo Claude Code mantém transcrições
• Defina desktopSessionCleanupPeriodDays para dar também um limite de idade às transcrições de Claude Desktop e Cowork
• Defina a variável de ambiente CLAUDE_CODE_SKIP_PROMPT_HISTORY para pular a escrita de transcrições e histórico de prompt em qualquer modo. Em modo não interativo, você pode passar --no-session-persistence junto com -p, ou definir persistSession: false no TypeScript Agent SDK; o Python SDK não tem opção equivalente.
• Use regras de permissão para negar leituras de arquivos de credenciais

Limpar dados locais

Execute claude purge para deletar o estado que Claude Code mantém para um projeto. Deleta:

• Transcrições e memória automática sob projects/
• Entradas de tasks/, debug/ e file-history/ por sessão
• Linhas de prompt correspondentes em history.jsonl
• A entrada do projeto em ~/.claude.json

Imagens que você colou ou anexou nas sessões do projeto e o bloco de notas de cada sessão são armazenados sob o diretório temporário de Claude Code em vez de ~/.claude, então a limpeza não as remove. A varredura de retenção ainda deleta as imagens uma vez que tenham mais de cleanupPeriodDays de idade; o bloco de notas de uma sessão purgada permanece até você deletá-lo ou seu sistema operacional limpar o diretório temporário.

O comando imprime o plano completo de exclusão e pede confirmação antes de remover qualquer coisa.

Antes da v2.1.288, o comando era claude project purge.

Os exemplos abaixo usam ~/work/my-repo como um espaço reservado. Substitua-o pelo caminho para seu projeto. Se nenhum estado corresponder ao caminho, o comando imprime um erro e sai com status 1.

Visualize o plano sem deletar nada:

claude purge ~/work/my-repo --dry-run

O plano lista cada item correspondente e por que está incluído:

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Delete com um único prompt de confirmação:

claude purge ~/work/my-repo

O comando imprime o mesmo plano, depois pergunta Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] e deleta apenas se você responder y.

Omita o caminho para escolher um projeto de uma lista interativa.

Pule o prompt de confirmação para uso em scripts:

claude purge ~/work/my-repo --yes

Outras opções:

• Passe --all em vez de um caminho para limpar o estado de cada projeto de uma vez, o que deleta history.jsonl completamente em vez de filtrá-lo.
• Passe -i para percorrer o plano de exclusão um item por vez.

O comando deixa shell-snapshots/ e backups/ sozinhos porque não têm escopo de projeto, e avisa sobre eles na saída do plano. Se alguém executou /heapdump na máquina, delete também os arquivos .heapsnapshot que ele escreveu. Um heap snapshot contém a conversa completa e quaisquer credenciais que o processo mantinha, e nem a varredura de retenção nem a limpeza o tocam.

Você também pode deletar qualquer um dos caminhos de dados da aplicação acima manualmente, exceto os arquivos de estado para manter.

Não delete ~/.claude.json, ~/.claude/settings.json ou ~/.claude/plugins/: esses mantêm os detalhes da sua conta, preferências e plugins instalados.

Recursos relacionados

• Gerenciar memória de Claude: escrever e organizar CLAUDE.md, rules e auto memory
• Configurar configurações: definir permissões, hooks, variáveis de ambiente e padrões de modelo
• Criar skills: construir prompts e workflows reutilizáveis
• Configurar subagents: definir agentes especializados com seu próprio contexto