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ó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(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:

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

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.

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

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.

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

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 #:

# Sempre use nomes de variáveis descritivos

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:

> /init 

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.