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 quatro localizações de memória em uma estrutura hierárquica, cada uma servindo um propósito diferente:

Tipo de Memória	Localização	Propósito	Exemplos de Caso de Uso	Compartilhado Com
Política empresarial	macOS: /Library/Application Support/ClaudeCode/CLAUDE.md Linux: /etc/claude-code/CLAUDE.md Windows: C:\ProgramData\ClaudeCode\CLAUDE.md	Instruções organizacionais gerenciadas por TI/DevOps	Padrões de codificação da empresa, políticas de segurança, requisitos de conformidade	Todos os usuários na organização
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	Membros da equipe via controle de versão
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	Apenas você (todos os projetos)
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	Apenas 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 incluídas 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 á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 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 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 do 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 ao 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

2. 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.