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 quatro localizações de memória em uma estrutura hierárquica, cada uma servindo um propósito diferente:
Tipo de MemóriaLocalizaçãoPropósitoExemplos de Caso de UsoCompartilhado Com
Política empresarialmacOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux: /etc/claude-code/CLAUDE.md
Windows: C:\ProgramData\ClaudeCode\CLAUDE.md		Instruções organizacionais gerenciadas por TI/DevOpsPadrões de codificação da empresa, políticas de segurança, requisitos de conformidadeTodos os usuários na organização
Memória do projeto./CLAUDE.md ou ./.claude/CLAUDE.mdInstruções compartilhadas pela equipe para o projetoArquitetura do projeto, padrões de codificação, fluxos de trabalho comunsMembros da equipe via controle de versão
Memória do usuário~/.claude/CLAUDE.mdPreferências pessoais para todos os projetosPreferências de estilo de código, atalhos de ferramentas pessoaisApenas você (todos os projetos)
Memória do projeto (local)./CLAUDE.local.mdPreferências pessoais específicas do projeto(Descontinuado, veja abaixo) Suas URLs de sandbox, dados de teste preferidosApenas você (projeto atual)
Todos os arquivos de memória são automaticamente carregados no contexto do Claude Code quando iniciado. Arquivos mais altos na hierarquia têm precedência e são carregados primeiro, fornecendo uma base sobre a qual memórias mais específicas se constroem.

​
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 de importações, pois funcionam melhor em múltiplas árvores de trabalho git. 
# Preferências Individuais
- @~/.claude/my-project-instructions.md
Para evitar possíveis colisões, 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 são carregados executando o comando /memory.

​
Como o Claude busca 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 em seu editor de 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. A memória do projeto pode ser armazenada em ./CLAUDE.md ou ./.claude/CLAUDE.md. 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.

​
Gerenciamento de memória em nível organizacional

Organizações empresariais podem implantar arquivos CLAUDE.md gerenciados centralmente que se aplicam a todos os usuários. Para configurar o gerenciamento de memória em nível organizacional:
  1. Crie o arquivo de memória empresarial na localização apropriada para seu sistema operacional:
  • macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
  • Linux/WSL: /etc/claude-code/CLAUDE.md
  • Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
  1. Implante via seu sistema de gerenciamento de configuração (MDM, Group Policy, Ansible, etc.) para garantir distribuição consistente em todas as máquinas de desenvolvedor.

​
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 esteja sempre usando as informações e contexto mais atualizados.