Gerenciar a memória do Claude
Aprenda como gerenciar a memória do Claude Code entre sessões com diferentes localizações de memória e melhores práticas.
O Claude Code pode lembrar suas preferências entre sessões, como diretrizes de estilo e comandos comuns em seu fluxo de trabalho.
Determinar tipo de memória
O Claude Code oferece três localizações de memória, cada uma servindo um propósito diferente:
Tipo de Memória | Localização | Propósito | Exemplos de Casos de Uso |
---|---|---|---|
Memória do projeto | ./CLAUDE.md | Instruções compartilhadas pela equipe para o projeto | Arquitetura do projeto, padrões de codificação, fluxos de trabalho comuns |
Memória do usuário | ~/.claude/CLAUDE.md | Preferências pessoais para todos os projetos | Preferências de estilo de código, atalhos de ferramentas pessoais |
Memória do projeto (local) | ./CLAUDE.local.md | Preferências pessoais específicas do projeto | (Descontinuado, veja abaixo) Suas URLs de sandbox, dados de teste preferidos |
Todos os arquivos de memória são automaticamente carregados no contexto do Claude Code quando iniciado.
Importações do CLAUDE.md
Arquivos CLAUDE.md podem importar arquivos adicionais usando a sintaxe @caminho/para/importar
. O exemplo a seguir importa 3 arquivos:
Tanto caminhos relativos quanto absolutos são permitidos. Em particular, importar arquivos no diretório home do usuário é uma maneira conveniente para os membros da sua equipe fornecerem instruções individuais que não são commitadas no repositório. Anteriormente, CLAUDE.local.md servia um propósito similar, mas agora está descontinuado em favor das importações, pois funcionam melhor em múltiplas worktrees do git.
Para evitar possíveis colisões, as importações não são avaliadas dentro de spans de código markdown e blocos de código.
Arquivos importados podem recursivamente importar arquivos adicionais, com uma profundidade máxima de 5 saltos. Você pode ver quais arquivos de memória estão carregados executando o comando /memory
.
Como o Claude procura memórias
O Claude Code lê memórias recursivamente: começando no cwd, o Claude Code recursa até (mas não incluindo) o diretório raiz / e lê quaisquer arquivos CLAUDE.md ou CLAUDE.local.md que encontrar. Isso é especialmente conveniente ao trabalhar em repositórios grandes onde você executa o Claude Code em foo/bar/, e tem memórias tanto em foo/CLAUDE.md quanto em foo/bar/CLAUDE.md.
O Claude também descobrirá CLAUDE.md aninhados em subárvores sob seu diretório de trabalho atual. Em vez de carregá-los na inicialização, eles são incluídos apenas quando o Claude lê arquivos nessas subárvores.
Adicionar rapidamente memórias com o atalho #
A maneira mais rápida de adicionar uma memória é começar sua entrada com o caractere #
:
Você será solicitado a selecionar em qual arquivo de memória armazenar isso.
Editar diretamente memórias com /memory
Use o comando slash /memory
durante uma sessão para abrir qualquer arquivo de memória no editor do seu sistema para adições ou organização mais extensas.
Configurar memória do projeto
Suponha que você queira configurar um arquivo CLAUDE.md para armazenar informações importantes do projeto, convenções e comandos frequentemente usados.
Inicialize um CLAUDE.md para sua base de código com o seguinte comando:
Dicas:
- Inclua comandos frequentemente usados (build, test, lint) para evitar buscas repetidas
- Documente preferências de estilo de código e convenções de nomenclatura
- Adicione padrões arquiteturais importantes específicos do seu projeto
- Memórias CLAUDE.md podem ser usadas tanto para instruções compartilhadas com sua equipe quanto para suas preferências individuais.
Melhores práticas de memória
- Seja específico: “Use indentação de 2 espaços” é melhor que “Formate o código adequadamente”.
- Use estrutura para organizar: Formate cada memória individual como um ponto de marcação e agrupe memórias relacionadas sob cabeçalhos markdown descritivos.
- Revise periodicamente: Atualize memórias conforme seu projeto evolui para garantir que o Claude sempre use as informações e contexto mais atualizados.