Claude Code + Obsidian
Dê ao Claude uma memória permanente com Claude Code e Obsidian
O Obsidian é um aplicativo de notas separado e independente. Este guia é independente e não é afiliado nem endossado pela Anthropic ou pelo Obsidian.
Toda nova conversa com o Claude começa do zero. Ele não lembra do seu trabalho, dos seus projetos em andamento nem da decisão que você tomou com ele ontem, a menos que você digite tudo de novo. Esse é um limite real para quem quer usar o Claude como um assistente permanente, e não só para perguntas pontuais. Este guia monta uma solução que se mantém: um vault em texto puro que o Claude lê e atualiza sempre que você trabalha com ele, para que ele continue de onde você parou em vez de começar do nada. As duas peças são o Claude Code, a ferramenta de linha de comando da Anthropic para programação, e o Obsidian, um aplicativo de notas gratuito que guarda tudo como arquivos de texto comuns numa pasta que você controla. Nenhum dos dois produtos foi feito pensando no outro, e nada aqui exige que você escreva uma linha de código. Você vai instalar o Claude Code, criar um vault pequeno no Obsidian, dar a ele uma estrutura de pastas e alguns arquivos de regras que o Claude lê automaticamente, e depois configurar duas ou três tarefas recorrentes que mantêm essa memória atualizada sozinhas, segundo uma programação, sem você precisar abrir um chat todo dia para fazer isso na mão.
Para dar ao Claude uma memória permanente, instale o Claude Code, a ferramenta de linha de comando da Anthropic para programação, e crie um vault pequeno no Obsidian com uma estrutura de pastas mais um arquivo CLAUDE.md e um STATE.md que o Claude lê no início de cada sessão. Esses arquivos guardam os fatos que vale a pena lembrar: seu papel, seus projetos atuais, as pessoas com quem você trabalha e como as coisas estão. A partir daí, as tarefas agendadas locais do app de desktop do Claude rodam um resumo da manhã e uma revisão semanal dentro desse vault segundo uma programação, no seu próprio computador, para que a memória fique atualizada sem você precisar atualizá-la na mão todo dia.
Publicado em
Aula grátis · sem precisar de contaConheça o ClaudePor Que o Claude?6 minComeçar a aula grátisPrincipais pontos
- O Claude Code, a ferramenta de linha de comando da Anthropic para programação, não tem memória entre conversas por conta própria. Um vault do Obsidian em texto puro que ele lê e atualiza a cada sessão é o que realmente faz uma memória permanente se sustentar.
- Um arquivo de regras CLAUDE.md e um arquivo de status STATE.md, ambos lidos no início de cada sessão, fazem mais pela continuidade do que explicar sua situação no chat de novo e de novo.
- As tarefas agendadas locais do app de desktop do Claude só rodam no seu próprio computador, só enquanto o app está aberto e o computador está ativo, e recuperam exatamente uma execução perdida dentro dos últimos 7 dias.
- O Claude Pro custa US$20 por mês e inclui o Claude Code. O Obsidian é gratuito. Não é preciso comprar nada extra para montar todo esse sistema.
- Três hábitos mantêm o sistema honesto: jogar tudo na Inbox sem organizar na hora, pedir para o Claude encontrar as coisas em vez de procurar você mesmo, e corrigir uma memória errada uma única vez no arquivo de regras em vez de explicar de novo em cada sessão.
Copie e cole
Prompts para usar hoje mesmo
Montar a estrutura de pastas e arquivos do vault
Criei no Obsidian um vault chamado Brain dentro da minha pasta Documentos. Abra-o e monte esta estrutura de pastas dentro dele: Inbox, Projects, People, Decisions, Daily, Reviews, Archive, e uma pasta memory. Depois crie um arquivo CLAUDE.md com regras iniciais sobre como você deve trabalhar comigo, um arquivo STATE.md com menos de 80 linhas sobre como as coisas estão agora, e um arquivo índice memory/MEMORY.md. Antes de escrever qualquer coisa, me entreviste com dez perguntas, uma por vez, sobre meu papel, meus principais projetos, as pessoas com quem mais trabalho, como eu tomo decisões, como quero que as notas diárias sejam registradas, e qualquer outra coisa que te ajude a entender como eu trabalho. Use minhas respostas para escrever CLAUDE.md e STATE.md de forma que realmente me representem, não um modelo genérico.
Cole isso como sua primeira mensagem, na pasta do vault, depois de instalar o Claude Code e criar o vault Brain no Obsidian.
Tarefa agendada de resumo da manhã (dias de semana)
Leia as notas Daily de hoje e de ontem, tudo que estiver agora na Inbox, e o STATE.md neste vault. Escreva um resumo curto no topo da nota Daily de hoje: o que ficou pendente de ontem, o que há de novo na Inbox que precisa de uma decisão, e o que está previsto para hoje segundo Projects e Decisions. Mantenha abaixo de 15 linhas. Se já passou das 17h quando essa tarefa roda, pule totalmente o formato de resumo e publique só uma linha avisando que a janela de hoje foi perdida, para eu não ler um resumo da manhã desatualizado à noite.
Use isso como as instruções de uma tarefa agendada local programada para as manhãs dos dias de semana, apontando para a pasta do seu vault.
Tarefa agendada de revisão semanal (sextas-feiras)
Leia todas as notas Daily desta semana neste vault. Atualize o STATE.md para que ele reflita de fato como as coisas estão, mantendo-o abaixo de 80 linhas ao reescrevê-lo em vez de ficar acrescentando sem parar. Mova para Archive, com data, tudo que foi totalmente resolvido esta semana em Projects ou Decisions. Sinalize, numa lista curta ao final do seu resumo, qualquer coisa em Decisions ou Projects que não é tocada há três semanas ou mais, para eu saber o que ficou parado e precisa de uma decisão real em vez de continuar ali largado.
Use isso como as instruções de uma tarefa agendada local programada para a tarde de sexta-feira, apontando para a pasta do seu vault.
O problema
Por que o Claude precisa de um sistema de memória
Uma conversa com o Claude é, por padrão, uma folha em branco. Você fecha a janela e abre uma nova, e tudo que você explicou sobre seu trabalho, seu time ou o projeto no meio do qual você está desaparece. Para uma pergunta rápida, isso não é problema. Para quem quer usar o Claude como uma assistência capaz que fica por perto, isso significa explicar toda a sua situação de novo e de novo, o que cansa rápido e, sem você perceber, te desanima de usar o Claude para as coisas maiores e contínuas.
A solução não é uma funcionalidade que o Claude já traz. É um hábito, construído em cima de arquivos. O Claude Code, a ferramenta de linha de comando da Anthropic para programação, consegue ler e escrever arquivos de texto puro numa pasta do seu computador, e lê certos arquivos automaticamente no início de uma sessão. Se esses arquivos tiverem os fatos que vale a pena lembrar, escritos em linguagem simples, o Claude na prática também lembra deles, todas as vezes, sem você precisar digitar nada de novo.
O Obsidian é a outra metade. É um aplicativo de notas gratuito construído em torno de uma ideia que importa muito aqui: tudo que você escreve nele é guardado como arquivos de texto comuns numa pasta, não trancado dentro de um banco de dados proprietário em algum lugar. É exatamente o tipo de coisa que o Claude Code consegue abrir, ler e editar direto, e por isso os dois combinam tão bem mesmo sem nenhum ter sido pensado com o outro em mente.
O que vem a seguir é a montagem completa: instalar o Claude Code, criar um vault no Obsidian, construir uma pequena estrutura de pastas e arquivos que o Claude lê a cada sessão, e depois passar a manutenção para algumas rotinas agendadas, para que o sistema fique atualizado sem virar uma tarefa nova na sua lista.
Passo 1
Instale o Claude Code
O jeito mais rápido é o instalador nativo. Acesse a página de configuração do Claude Code da Anthropic em code.claude.com/docs/en/setup e rode o comando de uma linha listado para o seu sistema; a página cobre Mac, Linux e Windows separadamente, então basta copiar a linha do seu sistema. Se preferir Homebrew no Mac ou Linux, `brew install --cask claude-code` faz o mesmo trabalho. De qualquer forma, você não precisa entender exatamente o que o comando está fazendo; você só está rodando um script que coloca o comando claude no seu computador.
Depois de instalar, confira se funcionou rodando `claude --version` na mesma janela do terminal. Para uma checagem mais completa da sua instalação, `claude doctor` roda um diagnóstico rápido e aponta qualquer coisa que precise de atenção.
Depois, rode só o claude e siga o aviso do navegador para fazer login. Você vai precisar de uma conta Claude Pro, Max, Team, Enterprise ou Console; o plano gratuito do claude.ai não inclui o Claude Code. O Claude Pro custa US$20 por mês e inclui o Claude Code, então a maioria de quem lê este guia já tem esse plano ou vai querer ter.
Por último, instale o app de desktop do Claude em `claude.com/download`. Você não vai precisar dele para a instalação nem para o vault em si, mas o passo 4 deste guia roda as rotinas agendadas que mantêm sua memória atualizada pelo próprio agendador de tarefas local do app de desktop, então já instale agora no seu computador e faça login lá também.
Passo 2
Crie um vault do Obsidian chamado Brain
O Obsidian é gratuito para baixar e usar, e criar um vault, que no Obsidian é só a palavra para uma pasta que ele gerencia, leva menos de um minuto. Baixe do site oficial se ainda não tiver, e abra o seletor de vaults. É o ícone pequeno no canto inferior esquerdo do app, ou você chega ao mesmo menu pela paleta de comandos buscando "Open another vault".
Escolha "Create new vault". Vai pedir um nome: digite Brain. Depois use o botão Browse para escolher onde ele vai ficar no seu computador; escolha sua pasta Documentos, para que o vault fique num lugar que você encontra sem pensar. Clique em Create, e o Obsidian abre o vault novo, vazio.
Essa é toda a montagem do lado do Obsidian. Por baixo da interface do app, o vault não é nada além de uma pasta chamada Brain dentro de Documentos, cheia de arquivos de texto .md comuns assim que você começar a adicionar coisas. Essa simplicidade é exatamente o ponto: o Claude Code consegue abrir essa mesma pasta direto e tratá-la como qualquer outra pasta de projeto no seu computador, lendo e editando os arquivos dentro dela do mesmo jeito que faria com código num projeto de software.
Mantenha o vault aberto no Obsidian enquanto você avança pelo resto deste guia, para ver as pastas e arquivos aparecerem conforme o Claude Code os cria no próximo passo.
Passo 3
O sistema de memória: pastas e arquivos
Quatro peças, todas em texto puro, todas dentro do seu vault Brain. O Claude Code constrói isso para você a partir do prompt de montagem abaixo; aqui está para que serve cada uma.
A estrutura de pastas
Inbox, Projects, People, Decisions, Daily, Reviews, Archive, e uma pasta memory. Cada uma é só um lugar para um tipo específico de nota, então nada que você registra precisa ser organizado na hora.
CLAUDE.md
Um arquivo de regras que o Claude Code lê no início de cada sessão nessa pasta, a mesma ideia de instruções permanentes de projeto que o próprio CLAUDE.md de um projeto de software já cumpre, só que direcionada para a sua vida em vez de um código.
STATE.md
Um arquivo curto de "como as coisas estão", mantido de propósito abaixo de 80 linhas. Ele é reescrito quando algo muda, não fica sendo acrescentado sem parar, então nunca se transforma numa lista infinita de atualizações desatualizadas.
memory/MEMORY.md
Um arquivo índice dentro da pasta memory que indica onde ficam fatos específicos, para o Claude achar a nota certa rápido em vez de reler o vault inteiro toda vez que você pergunta algo.
A montagem
Construindo a estrutura com um só prompt
Você não precisa construir nada disso na mão. Com o vault Brain aberto no Obsidian e um terminal aberto nessa mesma pasta, rode claude para começar uma sessão, e depois cole o prompt de montagem abaixo como sua primeira mensagem. Ele diz ao Claude Code exatamente quais pastas e arquivos criar, e instrui o Claude a te entrevistar primeiro em vez de chutar os detalhes.
A entrevista importa mais do que a estrutura de pastas em si. Um CLAUDE.md feito a partir de um modelo é genérico; um escrito a partir de dez respostas honestas sobre seu papel, seus principais projetos, as pessoas com quem você trabalha, como você toma decisões e como quer que as notas diárias sejam registradas é realmente útil desde o primeiro dia.
Responda de forma clara e específica. "Gerencio um time de suporte de cinco pessoas e me reporto à VP de Operações" dá muito mais pro Claude do que "trabalho com gestão". Quanto mais específicas suas respostas, menos o Claude vai precisar chutar depois, que é exatamente o motivo de toda essa montagem existir.
Passo 4
Construa rotinas com o app de desktop do Claude
Arquivos que só são atualizados quando você lembra de atualizar ficam desatualizados rápido. A solução são as tarefas agendadas do app de desktop do Claude, que rodam o Claude Code contra seu vault num horário fixo, sem precisar abrir nenhum chat. Na barra lateral da aba Code do app, procure "Scheduled". Se sua versão ainda mostrar o rótulo antigo "Routines", clique em Routines e depois em "New routine", que abre o mesmo diálogo.
Clique em "New task" para abri-lo. Se oferecer a escolha entre "Create with Claude" e "Set up manually", escolha "Set up manually" para você mesmo escrever as instruções em vez de descrever a tarefa numa frase e torcer para ser interpretada como você quis.
Dê um nome à tarefa e escreva as instruções, usando um dos dois exemplos de prompt mais abaixo neste guia como ponto de partida. Depois expanda "Advanced settings", vá na aba General, e ative "Only on this computer". É isso que transforma a tarefa numa tarefa local: ela ganha acesso direto aos arquivos do seu vault e roda só nesse computador, só enquanto o app de desktop está aberto e o computador está ativo. Escolha seu vault Brain como a pasta local, defina a programação usando as predefinições Daily, Weekdays ou Weekly no card Trigger, escolha o modo de permissão e o modelo, e clique em Create.
Logo depois de criar, clique uma vez em "Run now", e a cada pedido de permissão para ler ou escrever um arquivo, escolha "always allow" em vez de "allow once". Se você pular isso, cada execução futura pode ficar travada no mesmo pedido de permissão sem ninguém para responder, o que anula todo o sentido de agendar.
Um comportamento para planejar: essas tarefas só disparam enquanto o app de desktop está aberto e o computador está ativo, e se uma execução é perdida, o app recupera exatamente uma execução para o horário mais recente que foi perdido, desde que esteja dentro dos últimos 7 dias, e descarta qualquer coisa mais antiga. Se o horário importa numa tarefa, escreva a proteção direto no prompt, do jeito que o exemplo de resumo da manhã abaixo checa o horário antes de decidir o que publicar, em vez de assumir que a programação sempre vai disparar exatamente na hora.
O hábito diário
Três regras que mantêm o sistema honesto
Os arquivos e a programação fazem a maior parte do trabalho. Esses três hábitos evitam que o conjunto todo desvie sem ninguém notar.
Jogue, não organize
Quando algo passar pela sua cabeça, coloque direto na Inbox e siga em frente. Decidir onde aquilo pertence pode esperar a revisão semanal; organizar na hora é a forma mais segura de fazer o registro parar de acontecer de vez.
Pergunte, não procure
Precisa saber o que você decidiu sobre um projeto no mês passado? Peça ao Claude para encontrar em vez de rolar você mesmo por notas Daily antigas. É exatamente por isso que o vault e o arquivo índice existem.
Corrija uma vez
Se a memória do Claude sobre algo estiver errada, corrija uma vez, no CLAUDE.md ou no STATE.md, em vez de corrigir na conversa a cada sessão. Um fato errado deixado só no chat é corrigido apenas para aquele chat.
Por que isso se sustenta
O que uma memória em texto puro te dá
Nada disso depende de uma funcionalidade que pode mudar ou desaparecer. É uma pasta de arquivos de texto que é totalmente sua.
Texto puro, para sempre
Arquivos markdown abrem em qualquer editor, em qualquer computador, enquanto computadores continuarem abrindo arquivos de texto. Nada aqui tranca sua memória dentro do banco de dados de um único app.
Local e privado
O vault fica no seu próprio computador. Uma tarefa agendada local lê e escreve nele diretamente, sem nada das suas notas precisar passar por um servidor para o sistema funcionar.
Cresce com você
Comece com um punhado de notas; a mesma estrutura de Inbox, Projects e Daily se sustenta tanto se você acompanha um só projeto quanto uma dúzia, sem precisar refazer nada.
Nada extra para pagar
O Claude Pro a US$20 por mês inclui o Claude Code, e o Obsidian é gratuito. Todo o sistema descrito neste guia não custa nada além de um plano que a maioria de quem lê já tem.
Continue aprendendo com o Claude
Montar a memória do Claude é só uma habilidade entre várias para tirar um uso real e contínuo do Claude Code. O cadastro gratuito da Nightschool AI te coloca no currículo, e o kit Build Your First Claude Code Project é o próximo passo natural assim que seu vault estiver funcionando.
Perguntas frequentes
O que realmente significa "dar memória ao Claude"?
Significa montar arquivos que o Claude lê automaticamente no início de cada sessão, para que fatos sobre seu papel, seus projetos e suas decisões continuem valendo entre conversas em vez de resetar a cada vez. O Claude em si não ganha nenhuma capacidade nova; você está dando a ele um lugar para guardar notas que ele checa todas as vezes, do mesmo jeito que uma pessoa faria.
Preciso saber programar para montar isso?
Não. Instalar o Claude Code é rodar um único comando copiado, criar o vault do Obsidian é alguns cliques, e a estrutura de pastas junto com os arquivos de regras são construídos para você quando você cola o prompt de montagem deste guia. Tudo que você escreve no CLAUDE.md ou no STATE.md é linguagem simples sobre o seu próprio trabalho, não código.
Quanto custa tudo isso?
O Claude Pro custa US$20 por mês e inclui o Claude Code, então se você já tem Claude Pro, Max, Team, Enterprise ou uma conta Console, não tem nada extra para comprar. O Obsidian é gratuito para baixar e usar. O plano gratuito do claude.ai por si só não inclui o Claude Code, então seria preciso fazer upgrade para essa montagem específica.
Por que usar o Obsidian em vez de uma pasta simples de arquivos de texto?
Você poderia usar uma pasta simples, e a ideia de fundo ainda funcionaria, já que vaults do Obsidian não são nada além de pastas de arquivos markdown. O Obsidian soma uma interface legível para navegar e conectar suas próprias notas, o que torna o vault agradável de usar direto, além dos arquivos que o Claude Code lê e escreve do mesmo jeito de qualquer forma.
Qual é a diferença entre CLAUDE.md e STATE.md?
O CLAUDE.md guarda regras fixas: quem você é, como quer que o Claude se comporte, e contexto que raramente muda. O STATE.md guarda o status atual: o que está em andamento agora, mantido de propósito abaixo de 80 linhas e reescrito em vez de acrescentado, então fica sendo uma foto de hoje em vez de um registro que não para de crescer.
O que é uma tarefa agendada "local", e por que isso importa aqui?
Ativar "Only on this computer" em Advanced settings transforma uma tarefa agendada em local: ela ganha acesso direto a uma pasta da sua máquina, seu vault Brain, e roda só nesse computador, só enquanto o app de desktop do Claude está aberto e o computador está ativo. Uma tarefa não local não tem nenhum acesso a arquivos de uma pasta assim, por isso as rotinas deste guia precisam da configuração local.
O que acontece se meu computador estiver dormindo na hora de uma tarefa agendada?
O app de desktop do Claude recupera exatamente uma execução para o horário mais recente que foi perdido, desde que esteja dentro dos últimos 7 dias, e descarta qualquer coisa mais antiga. Se o horário importa, escreva uma checagem direto no prompt, como pular o formato normal e publicar só uma nota curta se a execução acontecer bem mais tarde do que o planejado.
Este guia é afiliado à Anthropic ou ao Obsidian?
Não. Este é um guia educacional independente, não publicado nem endossado pela Anthropic ou pelo Obsidian. Claude, Claude Code e Obsidian são citados aqui só para descrevê-los com precisão; são, respectivamente, produtos e marcas próprios da Anthropic e do Obsidian.
Posso usar isso na vida pessoal, não só no trabalho?
Sim. A estrutura de pastas (People, Decisions, notas Daily e o resto) funciona igualmente bem para projetos pessoais, logística familiar, ou qualquer outra coisa que você queira ver lembrada entre sessões. Nada nessa montagem assume especificamente um contexto de trabalho; é um sistema de memória geral que você aponta para o que quiser que o Claude acompanhe.
E se a memória do Claude sobre algo estiver errada?
Corrija uma vez, no CLAUDE.md ou no STATE.md, em vez de corrigir dentro de um chat. Uma correção digitada só numa conversa arruma apenas aquela conversa; a próxima sessão relê os arquivos do zero e repetiria o mesmo fato errado até o próprio arquivo ser atualizado.
Transforme essa montagem no seu primeiro projeto Claude Code
Seu arquivo CLAUDE.md é o mesmo hábito que esta lição gratuita ensina, só aplicado a um vault em vez de a um código.