O Claude Code pode lembrar suas preferências entre sessões, como diretrizes de estilo e comandos comuns em seu fluxo de trabalho.

​
Determinar o tipo de memória

O Claude Code oferece três locais de memória, cada um servindo a um propósito diferente:

Tipo de MemóriaLocalizaçãoPropósitoExemplos de Casos de Uso
Memória do projeto./CLAUDE.mdInstruções compartilhadas pela equipe para o projetoArquitetura do projeto, padrões de codificação, fluxos de trabalho comuns
Memória do usuário~/.claude/CLAUDE.mdPreferências pessoais para todos os projetosPreferências de estilo de código, atalhos de ferramentas pessoais
Memória do projeto (local)./CLAUDE.local.mdPreferências pessoais específicas do projeto(Obsoleto, 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 CLAUDE.md

Arquivos CLAUDE.md podem importar arquivos adicionais usando a sintaxe @caminho/para/importar. O exemplo a seguir importa 3 arquivos:

Veja @README para visão geral do projeto e @package.json para comandos npm disponíveis para este projeto.

# Instruções Adicionais
- fluxo de trabalho git @docs/git-instructions.md

Caminhos relativos e absolutos são permitidos. Em particular, importar arquivos no diretório home do usuário é uma maneira conveniente para que os membros da sua equipe forneçam instruções individuais que não são registradas no repositório. Anteriormente, o CLAUDE.local.md servia a um propósito semelhante, mas agora está obsoleto em favor das importações, já que elas funcionam melhor em várias árvores de trabalho git.

# Preferências Individuais
- @~/.claude/my-project-instructions.md

Para evitar possíveis colisões, as importações não são avaliadas dentro de trechos de código markdown e blocos de código.

Este trecho de código não será tratado como uma importação: `@anthropic-ai/claude-code`

Arquivos importados podem importar recursivamente arquivos adicionais, com uma profundidade máxima de 5 saltos. Você pode ver quais arquivos de memória sã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 sobe recursivamente até / e lê quaisquer arquivos CLAUDE.md ou CLAUDE.local.md que encontrar. Isso é especialmente conveniente ao trabalhar em grandes repositórios 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á arquivos CLAUDE.md aninhados em subárvores sob seu diretório de trabalho atual. Em vez de carregá-los na inicialização, eles só são incluídos quando o Claude lê arquivos nessas subárvores.

​
Adicione rapidamente memórias com o atalho #

A maneira mais rápida de adicionar uma memória é começar sua entrada com o caractere #:

# Sempre use nomes de variáveis descritivos

Você será solicitado a selecionar em qual arquivo de memória armazenar isso.

​
Edite diretamente as memórias com /memory

Use o comando barra /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.

​
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 item de lista e agrupe memórias relacionadas sob títulos markdown descritivos.
  • Revise periodicamente: Atualize as memórias conforme seu projeto evolui para garantir que o Claude esteja sempre usando as informações e o contexto mais atualizados.