Voltar ao hub
Guia gratuito — passo a passo

Memória Persistente: Claude Code + Obsidian

Toda sessão nova, o Claude Code esquece o projeto inteiro — decisão técnica, convenção, histórico. Dá pra resolver isso conectando um vault do Obsidian que ele lê e escreve sozinho.

1
O problema
amnésia entre sessões
Sem memória entre sessões, você reexplica o mesmo contexto — convenção de código, decisão de arquitetura, histórico do projeto — toda vez que abre uma sessão nova. Isso não é limite do modelo; é falta de um lugar fixo onde a IA guarda o que já aprendeu.
Sem memória persistente
Reexplica tudo de novo. Toda. Santa. Sessão.
Com memória persistente
Abre o Claude Code e ele já chega sabendo.
2
A solução
Obsidian como cérebro externo
Obsidian é um editor de notas em Markdown puro — sem banco de dados proprietário, sem nuvem obrigatória. Isso é o que permite ao Claude Code ler e escrever nessas notas como se fossem código. Um vault (a pasta do Obsidian) guardado localmente vira a memória de longo prazo da IA.
!
Sem instalação: baixe o Obsidian em obsidian.md e crie um vault (Create new vault). É só uma pasta — pode ficar em ~/Documents/Obsidian Vault, por exemplo.
3
O mecanismo
hook de SessionStart
O Claude Code suporta hooks — scripts que rodam em momentos específicos. Um hook de SessionStart roda um script toda vez que uma sessão começa, lê arquivos-chave do seu vault, e injeta esse conteúdo como contexto antes mesmo de você digitar a primeira mensagem.
~/.claude/scripts/load-vault-context.sh
#!/bin/bash VAULT="$HOME/Documents/Obsidian Vault" echo "<vault-context>" cat "$VAULT/brain/North Star.md" 2>/dev/null cat "$VAULT/brain/Memories.md" 2>/dev/null ls "$VAULT/projetos/ativos" 2>/dev/null echo "</vault-context>"
~/.claude/settings.json — registrar o hook
{ "hooks": { "SessionStart": [ { "hooks": [ { "type": "command", "command": "~/.claude/scripts/load-vault-context.sh" } ] } ] } }
!
Depois de configurar: dê permissão de execução com chmod +x ~/.claude/scripts/load-vault-context.sh. A partir da próxima sessão, o Claude Code já chega sabendo o que está no seu vault — sem colar contexto manualmente.
4
Mantendo a memória viva
cresce como subproduto do trabalho
Você não escreve essas notas do zero, sentado. Corrige a IA durante o uso normal ("não faz assim, faz assado") e pede pra ela registrar isso no vault. Decisão importante numa conversa? Pede um resumo pro vault. O cérebro cresce como consequência do trabalho, não como tarefa extra.
5
Sincronizando entre máquinas
vault + .claude via GitHub
Até aqui o cérebro mora numa máquina só. Pra ele te seguir (Mac, Windows, Linux) e ainda servir de backup, use dois repositórios privados no GitHub: um pro vault e outro pra config global do Claude Code (~/.claude). Em toda sessão nova o Claude entra com tudo atualizado: "onde paramos?".
!
Os dois repositórios precisam ser privados. O vault tem sua vida, seus clientes e suas decisões. Confira a visibilidade antes do primeiro push.
5.1 — Vault: crie um repo privado no GitHub (ex: obsidian-vault-mind), sem README, e rode dentro da pasta do vault:
terminal — subir o vault pro GitHub
cd ~/Documents/"Obsidian Vault" git init -b main git remote add origin https://github.com/SEU_USUARIO/obsidian-vault-mind.git git add -A && git commit -m "initial vault" git push -u origin main
.gitignore (raiz do vault) — não subir estado local
.obsidian/workspace.json .obsidian/workspace-mobile.json .obsidian/plugins/*/data.json .DS_Store thinking/session-logs/
Depois, no Obsidian: Settings → Community plugins → Browse, procure Git (plugin Obsidian Git), instale e ative. Config que eu uso:
Obsidian Git — configuração
Auto commit-and-sync interval: 10 min Auto pull interval: 10 min Pull on startup: ligado Pull before push: ligado
!
Escreveu uma nota (você ou o Claude)? Em até 10 minutos ela está no GitHub. Na segunda máquina: git clone do repo em ~/Documents/Obsidian Vault, abra a pasta no Obsidian (Open folder as vault), instale o plugin Git de novo e repita a configuração (as configs do plugin não sobem junto, por causa do .gitignore).
5.2 — Config do Claude Code (~/.claude): essa pasta guarda seu CLAUDE.md global, hooks, skills e scripts. Sincronizar ela faz o mesmo Claude Code aparecer em todas as máquinas. Mas ela também guarda credenciais e histórico, então o .gitignore aqui é uma lista do que pode subir. Todo o resto fica bloqueado:
~/.claude/.gitignore — libera só o que é portátil
# ignora tudo, libera só o portátil * !.gitignore !CLAUDE.md !settings.json !skills/ !skills/** !scripts/ !scripts/** # nunca subir (credenciais e histórico) .credentials.json history.jsonl settings.local.json projects/ sessions/
terminal — subir o ~/.claude pro GitHub
cd ~/.claude git init -b main git add -A git status # CONFIRA: não pode aparecer credencial nem histórico git commit -m "initial claude config" git remote add origin https://github.com/SEU_USUARIO/claude-global.git git push -u origin main
!
Leia o git status antes do primeiro commit. Credencial que vai pro GitHub é difícil de apagar depois, porque fica no histórico. Na outra máquina: git clone do repo em ~/.claude e faça login no claude de novo (a credencial não sobe, de propósito).
5.3 — Pull automático ao abrir a sessão: um script puxa as mudanças do ~/.claude toda vez que o Claude Code começa. Se você tiver alterações locais não commitadas, ele pula o pull pra não gerar conflito.
~/.claude/scripts/sync-claude-config.sh
#!/bin/bash cd "$HOME/.claude" || exit 0 [ -d .git ] || exit 0 # mudança local não commitada? não puxa (evita conflito) if [ -n "$(git status --porcelain)" ]; then echo "AVISO: ~/.claude com mudanças locais, pull pulado." exit 0 fi git pull --ff-only --quiet 2>/dev/null || true
~/.claude/settings.json — adicione como PRIMEIRO hook de SessionStart
{ "type": "command", "command": "~/.claude/scripts/sync-claude-config.sh", "timeout": 10 }
!
Rode chmod +x ~/.claude/scripts/sync-claude-config.sh. No Windows, use o Git Bash. Mudou algo na config (skill nova, hook, regra)? Commit e push no ~/.claude; na outra máquina o pull acontece sozinho na próxima sessão. Evite editar a mesma nota nas duas máquinas ao mesmo tempo.
guia lido não constrói carreira

Pegou o guia. E agora?

Dica solta é só a ponta do iceberg. O que constrói carreira é comunidade, direcionamento e prática real. Na Founding você entra num ecossistema de builders: formação técnica, mentoria, networking e desenvolvimento profissional — tudo aplicado em projetos de verdade, não só em teoria.

Conhecer a Founding →