Como transformei Obsidian e Claude Code em meu cérebro de IA
Três meses atrás, fiz uma pergunta a Claude Code sobre um projeto paralelo que estava construindo. Isso me deu uma resposta decente. Genérico, mas decente. Então apontei para meu cofre Obsidian - 847 arquivos de descontos abrangendo dois anos de anotações diárias, especificações de projetos, transcrições de reuniões e ideias incompletas rabiscadas à 1h.
A resposta que me deu em seguida me fez recostar na cadeira.
Ele conectou um conceito de uma nota de produção cinematográfica que escrevi em março de 2024 a uma ideia de startup que abandonei em novembro e, em seguida, mapeou ambos a um padrão em minhas anotações diárias que não havia notado conscientemente. Eu estive circulando pelo mesmo problema em três domínios diferentes por oito meses sem perceber.
Esse momento mudou a forma como penso sobre as ferramentas de IA. Não como secretárias eletrônicas. Como parceiros pensantes que conhecem o seu contexto profundamente o suficiente para mostrar o que estão faltando em suas próprias ideias.
O problema é o seguinte: a maioria dos desenvolvedores usa IA da mesma maneira em todas as sessões: explique o projeto, reafirme as restrições, redescreva o que você já tentou. É como ter um colega brilhante com amnésia. Todas as manhãs, você começa do zero. Cansei desse ciclo e o que construí para substituí-lo se tornou a ferramenta mais valiosa do meu fluxo de trabalho. Mas a configuração requer uma mudança mental para a qual a maioria das pessoas não está preparada, e explicarei por que isso é mais importante do que os detalhes técnicos.
Por que suas conversas sobre IA continuam começando do zero
O problema é universal se você passou algum tempo real com Claude, ChatGPT ou qualquer ferramenta com LLM. Você abre uma nova sessão. Você digita três parágrafos de contexto. Você recebe uma resposta. Amanhã você faz isso de novo. E novamente. E novamente.
As ferramentas de IA baseadas na Web agora têm recursos de “memória”, com certeza. Mas aqui está algo sobre o qual ninguém fala: você não pode controlar totalmente o que está nessa memória. Você não pode inspecioná-lo, editá-lo ou estruturá-lo. A IA decide o que lembrar com base em suas próprias heurísticas. Essa é uma caixa preta entre você e seus projetos mais importantes.
Venho construindo agentes de IA e sistemas de automação há mais de dois anos. O maior desbloqueio de produtividade não foi um modelo melhor ou uma sugestão mais sofisticada. Estava resolvendo o problema de contexto. Quando seu parceiro de IA tem um contexto persistente, estruturado e organizado do seu jeito, a qualidade de tudo que ele faz aumenta em uma ordem de magnitude.
Obsidian e Claude Code resolvem esse problema juntos de uma forma que nada mais que tentei chega perto de igualar. O principal insight é aparentemente simples: seus arquivos markdown tornam-se a memória de longo prazo da IA e você controla cada byte dele.
A integração técnica é direta, mas o verdadeiro poder aparece quando você começa a criar comandos personalizados que aproveitam o gráfico de relacionamento entre suas notas. É aí que as coisas deixam de ser “um truque legal” e passam a ser genuinamente transformadoras.
The Obsidian Foundation — Mais do que um aplicativo para anotações
Se você não está familiarizado com o Obsidian, aqui está a versão resumida: é uma ferramenta de anotações baseada em descontos que gerencia um cofre, que na verdade é apenas uma pasta de arquivos .md em sua máquina local. Você possui os arquivos. Sem aprisionamento na nuvem. Nenhum formato proprietário. Apenas texto.
Comecei a usar Obsidian com ceticismo. Outro aplicativo de anotações, certo? Já passei pelo Notion, Roam Research, Bear, Apple Notes – o cemitério completo de ferramentas de produtividade que prometem mudar a forma como você pensa e acabam como mais uma assinatura abandonada.
O que fez o Obsidian aderir foi um recurso: link bidirecional com um gráfico visual.
Quando você escreve [[project-idea]] dentro de uma nota diária, Obsidian cria um link. Ao abrir project-idea.md, você pode ver todas as notas que fazem referência a ele. A visualização gráfica mostra essas conexões como uma teia interativa — nós e arestas mapeando como suas ideias se relacionam entre si.
Isso parece acadêmico até que você o use por três meses. Então você abre o gráfico e vê que suas anotações sobre "esgotamento do desenvolvedor" se conectam às suas anotações sobre "ansiedade de automação", que se conectam às suas anotações sobre um projeto de cliente que deu errado - e de repente você está vendo um padrão em seu próprio pensamento que você nunca teria identificado ao rolar por uma pasta.
O cérebro humano é péssimo em rastrear essas conexões em centenas de notas escritas ao longo de meses. Obsidiana os torna visíveis. Essa é a base. Mas o cofre por si só ainda é passivo – ele espera que você o explore manualmente.
Isso muda quando Claude Code entra em cena.
Claude Code — Seu computador ouve inglês agora
Claude Code é uma interface de agente que permite controlar seu computador por meio de comandos de linguagem natural em um terminal. Você digita o que deseja em inglês simples e ele é executado.
"Crie um novo arquivo chamado project-spec.md com estas seções." Feito.
"Leia minhas últimas três anotações diárias e resuma os itens de ação." Feito.
"Encontre todas as menções de 'autenticação' em meu cofre e liste os arquivos." Feito.
Este não é um chatbot. É um agente com acesso a ferramentas – ele pode ler arquivos, gravar arquivos, executar comandos e encadear operações. Quanto mais contexto você fornecer, mais sofisticadas serão as tarefas que ele poderá realizar de forma autônoma.
Usei o Claude Code por meses antes de conectá-lo ao Obsidian, principalmente para tarefas de codificação e gerenciamento de arquivos. Útil, mas limitado. O verdadeiro avanço veio quando percebi que o agente poderia consumir todo o meu cofre como contexto — não apenas o texto bruto, mas a estrutura de relacionamento entre as notas.
É aqui que o Obsidian CLI entra na história e onde a maioria dos tutoriais sobre esse tópico deixam de ser úteis porque se concentram na configuração e perdem totalmente o design do fluxo de trabalho. Abordarei ambos, mas o design do fluxo de trabalho é onde reside 90% do valor.
A integração que mudou tudo
A Obsidian lançou o Obsidian CLI — uma ferramenta que expõe seu cofre a interfaces de linha de comando. Quando Claude Code se conecta por meio dele, o agente não vê apenas uma pilha de arquivos de descontos. Ele vê todo o gráfico de links: quais notas fazem referência a quais, o que está conectado a quê, onde os clusters se formam e onde as notas órfãs ficam sozinhas.
Imagine entregar a alguém uma caixa com 800 post-its em vez de entregar um mapa mental com todas as 800 notas já organizadas por relacionamento. Mesma informação, utilidade totalmente diferente. Essa é a diferença que o Obsidian CLI faz.
A primeira vez que executei um comando que pedia a Claude Code para “analisar meu cofre e identificar temas que eu pudesse estar negligenciando”, ele retornou um relatório que incluía:
- 14 notas órfãs — ideias que escrevi uma vez e nunca associei a nada
- 3 links não resolvidos — notas que mencionei, mas nunca criei
- Um conjunto de 23 notas sobre "criatividade assistida por IA" que eu não marquei como categoria
- Uma contradição entre o que escrevi sobre equilíbrio entre vida pessoal e profissional em junho e o que minhas anotações diárias mostraram que eu estava realmente fazendo em julho
Esse último bateu diferente. A IA não estava me dizendo algo que eu não sabia abstratamente – estava me mostrando evidências de meus próprios escritos de que minhas crenças e comportamentos estavam desalinhados. Nenhum aplicativo de produtividade jamais fez isso.
Mas gerar um relatório único não é um fluxo de trabalho. O sistema real surgiu quando comecei a criar comandos personalizados.
Construindo comandos que pensam com você
É aqui que isso passa de “experimento interessante” para “não consigo imaginar trabalhar sem ele”. Os comandos personalizados no Claude Code permitem criar operações reutilizáveis que carregam arquivos específicos, aplicam lógica específica e produzem saídas específicas.
Criei cinco comandos que agora executo quase diariamente. Cada um aproveita o contexto do vault de maneira diferente.
**1. Revisão matinal **
Este comando lê a integração do meu calendário, notas diárias recentes, quaisquer itens de ação não resolvidos e o estado atual dos projetos ativos. Em seguida, ele produz uma lista de tarefas priorizadas – não genérica, mas que explica no que estou trabalhando, o que está paralisado e quais prazos estão se aproximando.
A diferença crucial de qualquer gerenciador de tarefas: ele percebe padrões. "Você tem 'módulo de autenticação de refatoração' em sua lista há 9 dias. Com base em suas anotações, o bloqueador parece ser a migração da API que você mencionou na terça-feira. Devemos resolver isso primeiro?"
Nenhum aplicativo de tarefas conectou esses pontos para mim.
2. Processamento de fim de dia
Antes de fechar meu laptop, este comando verifica as anotações do dia, extrai itens de ação que posso ter enterrado em anotações de reuniões ou sessões de brainstorming, revela quaisquer conexões do vault com o que trabalhei e avalia meu nível de confiança nas decisões que tomei com base em como elas se alinham com meu pensamento documentado.
Essa última parte parece estranha até você experimentá-la. Escrevi uma nota em janeiro dizendo que "microsserviços são um exagero para projetos com menos de 50 mil usuários". Em março, comecei a arquitetar uma configuração de microsserviços para um projeto com 12 mil usuários. O processador do final do dia sinalizou isso. "Seu cofre contém uma opinião forte contra esta abordagem para projetos nesta escala. Alguma coisa mudou ou você deveria reconsiderar?"
Eu reconsiderei. Foi a decisão certa.
3. Desafiador de Crenças
Este é o comando que deixa as pessoas desconfortáveis quando eu lhes mostro. Ele pega uma declaração na qual estou operando atualmente - "Devemos construir o MVP no React Native" - e pesquisa em meu cofre quaisquer notas, decisões anteriores ou experiências registradas que a contradigam.
Às vezes não encontra nada. Isso é construção de confiança. Às vezes surge uma nota de oito meses atrás, onde escrevi sobre os pontos exatos que estou prestes a enfrentar. Isso é inestimável.
Aprendi isso da maneira mais difícil em um projeto de cliente onde defendia uma arquitetura de banco de dados específica. Meu cofre tinha três notas separadas, distribuídas ao longo de cinco meses, documentando problemas com essa abordagem exata em contextos semelhantes. Eu tinha esquecido. A IA não.
**4. Rastreador de evolução de ideias **
Este mapeia como um conceito mudou em meu cofre ao longo do tempo. Pedi para rastrear meu pensamento sobre "agentes de IA em produção" e recebi uma linha do tempo:
- Mês 1: Cético. As notas focaram nas limitações e nos riscos de alucinação.
- Mês 4: Experimentando com cautela. Primeira automação bem-sucedida documentada.
- Mês 7: Construindo diariamente. As notas mudam de "isso pode funcionar?" para "como faço para dimensionar isso?"
- Mês 10: Evangelizando. Escrever sobre isso, ensiná-lo, construir ferramentas em torno disso.
Ver aquela evolução mapeada – com carimbos de data e hora e citações de minhas próprias anotações – foi genuinamente comovente. Você não percebe o quanto seu pensamento muda até que alguém (ou algo) lhe mostre a trajetória.
**5. Localizador de padrões entre domínios **
Meu cofre abrange engenharia de software, segurança cibernética, design thinking, estratégia de negócios e desenvolvimento pessoal. Este comando procura conceitos que aparecem em dois ou mais domínios não relacionados e gera conexões que não fiz explicitamente.
Resultado de exemplo: "Suas notas sobre 'padrões de codificação defensivos' compartilham semelhanças estruturais com suas notas sobre 'consistência de identidade de marca'. Ambos enfatizam o estabelecimento antecipado de limites, a criação de um comportamento previsível e a construção de confiança por meio da confiabilidade. Pode haver uma estrutura que unifique essas ideias."
Eu nunca teria conectado a codificação defensiva à identidade da marca sozinho. Mas a conexão é real e gerou uma postagem no blog e uma nova abordagem sobre como estruturo os projetos dos clientes.
Se você chegou até aqui, já entendeu por que esta não é apenas mais uma integração de ferramentas. A próxima seção cobre a configuração exata para que você mesmo possa construí-la.
Configurando o pipeline completo
Aqui está o passo a passo. Presumo que você tenha o Obsidian instalado com um cofre ativo e familiaridade básica com comandos de terminal.
Etapa 1: Instale o Código Claude
Se ainda não o fez, instale o Claude Code através do canal oficial. Você precisará de uma chave de API Antrópica ou de uma assinatura Claude que inclua acesso CLI. A instalação é simples – siga a documentação na página oficial do Claude Code. Certifique-se de que esteja funcionando executando um comando simples como “liste os arquivos neste diretório”.
Etapa 2: Instalar Obsidian CLI
Obsidian CLI é a ponte. Instale-o seguindo a documentação oficial do Obsidian CLI. Depois de instalado, verifique se ele consegue ver seu cofre executando o comando de listagem de cofres. Você deverá ver o nome e o caminho do seu cofre.
Etapa 3: Crie seu arquivo de contexto
Antes de criar comandos, crie um único arquivo markdown em seu vault chamado _context.md (prefixo com sublinhado para que seja classificado no topo). Este arquivo deve conter:
# Sobre mim – Contexto para agentes de IA
## Função Atual
Engenheiro de software, desenvolvedor de IA. Edifício [projetos atuais].
## Projetos ativos
- Projeto A: [descrição e status em uma linha]
- Projeto B: [descrição e status em uma linha]
## Prioridades atuais
1. [Prioridade com prazo]
2. [Prioridade com prazo]
## Como eu trabalho
- Prefiro [ferramentas, frameworks, abordagens]
- Eu evito [coisas que você aprendeu que não funcionam para você]
## Registro de decisão
- [Data]: Decidiu [X] porque [motivo]
- [Data]: Alterado de [Y] para [Z] depois de [o que aconteceu]
Este arquivo se torna o contexto de base para cada comando que você cria. Atualize-o semanalmente. Cinco minutos de manutenção economizam horas de reexplicação.
Etapa 4: Crie seu primeiro comando
Comece com a revisão matinal. Crie um arquivo de comando que instrua Claude Code a:
- Leia
_context.mdpara seu estado atual - Leia as últimas 3 notas diárias
- Verifique se há notas marcadas como
#action-itemou#todo - Referência cruzada com seus projetos ativos
- Produza uma lista de prioridades com fundamentação
A estrutura de comando será semelhante a esta na configuração do Claude Code:
Leia meu arquivo de contexto em [vault-path]/_context.md e, em seguida, leia meus últimos 3 arquivos diários
notas. Identificar todos os itens de ação, fazer referência cruzada com meus projetos ativos,
e produzir uma lista de tarefas priorizadas para hoje. Sinalize quaisquer itens que tenham
pendente há mais de 5 dias.
Dica profissional: Comece de forma simples. Meu comando de revisão matinal começou com três linhas e cresceu até uma página inteira ao longo de dois meses, à medida que descobri quais informações eram mais úteis. Não exagere na engenharia da primeira versão.
Etapa 5: Iterar com base no que você realmente usa
Aqui está o que a maioria dos tutoriais não lhe dirá: seus primeiros comandos estarão errados. Não quebrado - errado. Você pedirá coisas que acha que deseja e descobrirá que o resultado não é tão útil. Isso é normal.
Após a primeira semana, reescrevi completamente meu processador de final de dia porque a versão original estava resumindo minhas anotações (chato) em vez de desafiá-las (valioso). O ciclo de iteração é o sistema. Não pule isso.
Erros comuns e como corrigi-los:
- "Claude Code não consegue encontrar meu cofre" — Verifique se Obsidian CLI está apontando para o caminho correto do cofre. Execute o comando de listagem do vault para verificar.
- "A saída é muito genérica" — Seu arquivo de contexto precisa de mais detalhes. Entrada vaga produz saída vaga. Adicione detalhes reais do projeto, não texto de espaço reservado.
- "Os comandos demoram muito" — Grandes cofres com milhares de notas tornarão as coisas mais lentas. Use tags ou consultas específicas de pasta para restringir o escopo.
- "A IA alucina conexões que não existem" — Isso acontece ocasionalmente. Adicione uma linha aos seus comandos: "Cite apenas conexões que você possa rastrear em notas específicas. Se não tiver certeza, diga-o." A instrução de honestidade faz uma diferença mensurável.
O que a maioria das pessoas não contará sobre esta configuração
Quero ser honesto sobre as partes que não são mágicas.
A privacidade é uma preocupação real. Você está dando a um agente de IA acesso ao seu segundo cérebro. Notas diárias, especificações de projetos, transcrições de reuniões, reflexões pessoais — tudo o que estiver em seu cofre. Eu mantenho um cofre separado para conteúdo verdadeiramente privado que nunca toca em nenhuma ferramenta de IA. Meu "cofre acessível por IA" contém conteúdo profissional, notas de projeto e reflexões pessoais selecionadas. Nunca as coisas não filtradas.
Você precisa pensar sobre isso antes de começar. Você se sente confortável com o processamento de IA? Onde está sua linha? Não existe uma resposta certa, mas existe uma abordagem errada: fingir que a pergunta não importa.
O hábito de “escrever para pensar” não é negociável. Todo esse sistema desmorona se você não escreve notas regularmente. A IA só pode funcionar com o que existe no seu cofre. Se você fizer anotações esparsas e com marcadores uma vez por semana, as conexões serão tênues e os insights superficiais. A escrita diária - mesmo que seja apenas 200 palavras - é o combustível que faz esse motor funcionar.
Eu costumava pensar que as anotações diárias eram um culto à produtividade. Agora entendo: não se trata de produtividade. O objetivo é criar um registro persistente e questionável de seu pensamento, que se agrava com o tempo. A IA consome o que você produz. Escreva mais, obtenha mais.
Você resistirá a permitir que a IA desafie suas ideias. O comando desafiador de crenças me deixou desconfortável nas primeiras doze vezes que o usei. Ninguém gosta de ver que o seu plano atual contradiz a sua própria experiência documentada. A tentação é rejeitar as descobertas da IA ou parar de usar o comando.
Não. O desconforto é o ponto. Um parceiro pensante que só concorda com você é inútil.
O conteúdo gerado pela IA deve permanecer separado das suas anotações originais. Mantenho uma regra rígida: a saída da IA vai para uma pasta dedicada, nunca misturada com minhas anotações pessoais. Se uma IA gera uma sugestão ou rascunho, eu o edito manualmente antes que ele toque meu cofre principal. O cofre é o meu pensamento, não o da IA. Misturá-los corrompe o sinal com o tempo.
Isso pode parecer paranóico, mas depois de observar o crescimento do cofre por meses, posso lhe dizer: saber que cada nota em seu cofre principal é genuinamente sua cria uma camada de confiança que é impossível de replicar se o texto gerado pela IA estiver espalhado por toda parte.
O que realmente muda quando você trabalha dessa maneira
Após três meses de uso diário, aqui está o que é mensuravelmente diferente.
A velocidade de decisão aumentou. Não porque a IA tome decisões por mim, mas porque traz à tona um contexto relevante que, de outra forma, eu passaria 20 minutos procurando. Quando um cliente pergunta "já lidamos com isso antes?" Posso responder em 30 segundos, em vez de vasculhar notas antigas.
Qualidade da ideia melhorada. O localizador de padrões entre domínios produz consistentemente conexões que eu não teria feito sozinho. Nem todos eles são úteis – talvez 30% levem a algum lugar interessante. Mas 30% das conexões em mais de 800 notas são muitos lugares interessantes.
Menos erros repetidos. O desafiante da crença me pegou caindo na mesma armadilha três vezes diferentes. Todas as vezes, meu cofre tinha evidências de que a abordagem era arriscada. Cada vez, eu esqueci. A IA não esquece.
Escrever tornou-se mais intencional. Saber que minhas anotações alimentam um sistema de IA que as analisará posteriormente mudou a forma como escrevo. Sou mais específico em relação às decisões, mais honesto em relação às incertezas e mais consistente na vinculação de ideias relacionadas. O ciclo de feedback entre a qualidade da escrita e a qualidade da saída da IA é real e motivador.
O tempo economizado é significativo, mas não onde você esperaria. Não economizo muito tempo na interação real da IA — os comandos levam alguns minutos para serem executados. A economia vem de não reexplicar o contexto, de não pesquisar novamente minhas próprias decisões e de não perder ideias que teriam desaparecido em uma nota esquecida.
Ganhos rápidos aparecem na primeira semana. O valor real aumenta ao longo dos meses à medida que o cofre cresce e o gráfico de conexão fica mais denso. O primeiro mês é útil. O sexto mês é transformador.
Visão geral — Arquivos Markdown como seu sistema operacional
Aqui está um pensamento que me mantém acordado à noite da melhor maneira possível.
Seus arquivos markdown são uma representação mais precisa do seu pensamento do que a sua própria memória. A memória humana é reconstrutiva – não nos lembramos dos acontecimentos, nós os reconstruímos, muitas vezes de forma imprecisa, coloridos pelas emoções e crenças atuais. Suas anotações de seis meses atrás capturam o que você realmente pensou naquele momento, não o que você lembra de ter pensado.
Quando um agente de IA tem acesso a esse registro preciso e pode percorrer as conexões entre milhares de notas, ele consegue algo que antes só era possível com um terapeuta ou colaborador de longa data que prestasse atenção há anos. Pode mostrar padrões em seu próprio pensamento. Pode identificar quando suas crenças atuais contradizem suas experiências passadas. Ele pode encontrar o fio que conecta as ideias que você tem circulado sem reconhecer que são a mesma ideia.
Meus arquivos markdown são literalmente as memórias que alimentam meu parceiro de pensamento de IA. Não dados de treinamento. Não é um aviso. Memórias. Contexto persistente, estruturado e interconectado que transforma um modelo de linguagem sem estado em algo que entende meu trabalho, meus padrões e meus pontos cegos.
As pessoas que investem na construção e manutenção deste tipo de sistema de conhecimento pessoal terão uma vantagem acrescida ao longo dos próximos cinco anos. Não porque a tecnologia seja exclusiva – ela está disponível para qualquer pessoa com Obsidian e assinatura Claude. Mas porque o hábito de escrever reflexivamente, fazer anotações consistentes e autodocumentar honestamente é difícil. A maioria das pessoas não fará isso.
Aqueles que o fizerem terão um parceiro de IA que se tornará mais inteligente – não porque o modelo melhore, mas porque o contexto se aprofunda. Cada nota que você escreve torna o sistema mais valioso. Cada conexão que você cria oferece à IA mais com que trabalhar. O cofre cresce. Os insights se multiplicam. E por volta do terceiro mês, você percebe que não está mais apenas fazendo anotações.
Você está construindo uma segunda mente que realmente pensa com você.
Então aqui está o meu desafio: abra o Obsidian esta noite. Escreva uma nota diária. Não é perfeito - apenas um registro honesto do que você trabalhou, do que está preso e de uma ideia que passou pela sua cabeça hoje. Faça isso de novo amanhã. E no dia seguinte.
Em trinta dias, aponte Claude Code para aquele cofre e pergunte quais padrões ele vê.
Eu prometo – o que ele descobrir irá surpreendê-lo.
Vamos trabalhar juntos
Procurando construir sistemas de IA, automatizar fluxos de trabalho ou dimensionar sua infraestrutura tecnológica? Eu adoraria ajudar.
- Fiverr (compilações e integrações personalizadas): fiverr.com/s/EgxYmWD
- Portfólio: mejba.me
- Ramlit Limited (soluções empresariais): ramlit.com
- ColorPark (design e branding): colorpark.io
- xCyberSecurity (serviços de segurança): xcybersecurity.io
