Pular para o conteúdo principal
Claude Code pode lembrar suas preferências em sessões, como diretrizes de estilo e comandos comuns em seu fluxo de trabalho.

​
Determinar tipo de memória

Claude Code oferece quatro locais de memória em uma estrutura hierárquica, cada um servindo a 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 em toda a organização gerenciadas por TI/DevOpsPadrões de codificação da empresa, políticas de segurança, requisitos de conformidadeTodos os usuários da organização
Memória do projeto./CLAUDE.md ou ./.claude/CLAUDE.mdInstruções compartilhadas com a 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 carregados automaticamente no contexto do Claude Code quando iniciado. Os 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 de CLAUDE.md

Os arquivos CLAUDE.md podem importar arquivos adicionais usando a sintaxe @path/to/import. O exemplo a seguir importa 3 arquivos: 
See @README for project overview and @package.json for available npm commands for this project.

# Additional Instructions
- git workflow @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 os membros da sua equipe fornecerem instruções individuais que não são verificadas no repositório. Anteriormente, CLAUDE.local.md servia a um propósito semelhante, mas agora está descontinuado em favor de importações, pois funcionam melhor em múltiplas árvores de trabalho git. 
# Individual Preferences
- @~/.claude/my-project-instructions.md
Para evitar possíveis colisões, as importações não são avaliadas dentro de intervalos de código markdown e blocos de código. 
This code span will not be treated as an import: `@anthropic-ai/claude-code`
Os 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 Claude procura memórias

Claude Code lê memórias recursivamente: começando no diretório atual, Claude Code recursa para cima até (mas não incluindo) o diretório raiz / e lê todos os arquivos CLAUDE.md ou CLAUDE.local.md que encontra. Isso é especialmente conveniente ao trabalhar em repositórios grandes onde você executa Claude Code em foo/bar/, e tem memórias em foo/CLAUDE.md e foo/bar/CLAUDE.md. Claude também descobrirá CLAUDE.md aninhado 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 Claude lê arquivos nessas subárvores.

​
Adicione memórias rapidamente com o atalho #

A maneira mais rápida de adicionar uma memória é começar sua entrada com o caractere #: 
# Always use descriptive variable names
Você será solicitado a selecionar em qual arquivo de memória armazenar isso.

​
Edite memórias diretamente com /memory

Use o comando de barra /memory durante uma sessão para abrir qualquer arquivo de memória no editor de sistema para adições ou organização mais extensas.

​
Configure 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 arquitetônicos importantes específicos do seu projeto
  • As 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 no local apropriado 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 desenvolvedores.

​
Melhores práticas de memória

  • Seja específico: “Use indentação de 2 espaços” é melhor do 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 títulos markdown descritivos.
  • Revise periodicamente: Atualize memórias conforme seu projeto evolui para garantir que Claude esteja sempre usando as informações e contexto mais atualizados.