Memory e session
Como o Claude aprende com a experiência e como você retoma de onde parou
⏱ Estim. ~6 min
01 · Ler
Você escreve o CLAUDE.md para dar instruções explícitas ao Claude. Mas o Claude Code também tem auto memory — ele pode salvar anotações sobre coisas que descobre durante a sessão. Peculiaridades de comandos de build, padrões de debug, armadilhas específicas do projeto.
Essas anotações persistem entre sessões, e o Claude aprende com a experiência. A auto memory fica em ~/.claude/projects/<project>/memory/. É local e nunca é sincronizada com o git.
Pontos-chave
- CLAUDE.md = regras que você escreve explicitamente
- Auto memory = anotações que o Claude salva pela experiência
- A memory fica em ~/.claude/projects/<project>/memory/
- Só local — não é compartilhada pelo git
- Use o comando /memory no Claude Code para ligar/desligar
02 · Ler
Cada conversa com o Claude Code é uma session. As sessões ficam salvas localmente e podem ser retomadas depois.
Mas o insight chave: a sessão começa do zero. Você abre um terminal novo e roda claude, e ele não sabe automaticamente o que você fazia ontem. Você precisa retomar a sessão explicitamente, ou contar com o CLAUDE.md e a memory para fornecer contexto.
Nomear sessões é o hábito mais importante para gerenciar contexto com produtividade.
Pontos-chave
- Cada conversa é uma sessão, salva localmente
- Sessões novas começam do zero — sem histórico de conversas anteriores
- Sessões nomeadas são fáceis de encontrar e retomar depois
- CLAUDE.md e memory dão continuidade entre sessões
03 · Exemplo de código
Abaixo, os comandos chave para gerenciar sessões — nomear, retomar e fazer fork.
Nomear a sessão atual
/rename "auth-refactor"
Retomar a sessão mais recente
claude --continue
Escolher entre sessões recentes
claude --resume
Retomar uma sessão nomeada específica
claude --resume auth-refactor
Fork de sessão (novo branch a partir do estado atual)
claude --continue --fork-session
Nomeie a sessão assim que começar o trabalho — /rename "feature-name". Quando voltar ao projeto, claude --resume abre um seletor onde você pode buscar, pré-visualizar e escolher. O fork cria uma sessão nova a partir do estado atual, sem alterar a original.
04 · Passo a passo
1. Comece e nomeie
Abra o Claude Code e nomeie a sessão imediatamente com /rename "o que estou fazendo". Facilita encontrar depois.
2. Faça o seu trabalho
Peça para o Claude implementar funcionalidades, corrigir bugs, escrever testes. O Claude lê automaticamente o CLAUDE.md e a memory.
3. Encerre naturalmente
Quando terminar, feche o terminal ou aperte Ctrl+C. A sessão é salva automaticamente.
4. Retome depois
Quando voltar, rode claude --resume para continuar de onde parou, ou claude --continue para a sessão mais recente.
05 · Quiz
Você trabalhou em uma feature ontem e quer continuar hoje. Qual é o jeito mais rápido de retomar?
- Abrir uma sessão nova e explicar tudo de novo
- Copiar e colar a conversa anterior
- Rodar claude --continue para retomar a sessão mais recente
- Apagar o CLAUDE.md e começar do zero
06 · Combinar
Relacione cada comando com o que ele faz.
(Esta seção é interativa — ative o JavaScript para usar.)
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.