Duas tribos chegaram na mesma arquitetura por caminhos opostos: markdown local, pastas e um agente por cima. A gente pesquisou threads do Reddit, posts virais no X e os repos que surgiram em cima disso pra entender onde elas convergem, onde divergem e quando vale usar cada uma.
Tem duas ondas acontecendo ao mesmo tempo, e elas começaram a se cruzar nos últimos dois meses.
A primeira onda veio do lado do PKM (Personal Knowledge Management). Obsidian cruzou 1,5 milhão de usuários em 2026, crescendo 22% ao ano, e a galera que já usava ele pra organizar conhecimento começou a plugar IA por cima. Primeiro via plugin (Smart Connections, Copilot), depois via MCP (Model Context Protocol), e agora montando o Claude Code direto na vault.
A segunda onda veio do lado dos agentes de código. Devs que começaram a usar o Claude Code pra programar perceberam que o mesmo padrão (CLAUDE.md, pastas, arquivos markdown, skills) servia pra tocar qualquer coisa, não só código. Brand voice, cliente, tarefa, tráfego pago, conteúdo. Um post do @akshay_pachaar explicando a pasta .claude/ como "sistema operacional do projeto" viralizou com 12 mil likes e 2 milhões de views.
No início de abril de 2026, o Karpathy publicou o tweet da "LLM Wiki" que a gente já cobriu neste report. Ele não inventou nada novo. Ele nomeou o padrão que os dois lados já estavam convergindo: material bruto numa pasta, wiki compilada pela IA em outra, regras num arquivo de schema. Ingest, query, lint. O tweet bateu 54 mil likes porque os dois lados se olharam no espelho e disseram "é isso mesmo que eu faço".
Desde então, o buzzword "segundo cérebro com Claude Code" explodiu. A gente quis entender: isso é a mesma coisa que usar o Claude Code como OS do negócio, só com nome diferente? Ou tem diferença real?
Essa é a frase que resume tudo. E ela apareceu, com variações, em praticamente todas as threads que a gente leu.
A arquitetura de ambos é igual:
.md locaisA unidade básica é o arquivo de texto. Nada de banco, nada de formato proprietário, nada de API.
Cada pasta é um "escopo". O agente entende por hierarquia e proximidade.
CLAUDE.md ou equivalente. Define regras, tom, papel, onde salvar, como escrever.
Claude Code, Gemini CLI, Codex. Todos falam markdown nativamente.
Não tem "memória da sessão". Tem arquivo novo salvo. O agente lembra porque tu escreveu.
A diferença é só qual editor tu abre pra olhar os mesmos arquivos. Obsidian te dá graph view, mobile, plugins, backlinks visuais. VS Code com Claude Code te dá explorer, terminal, git, deploy, integração nativa com código.
O insight que mais apareceu no Reddit (122 upvotes, primeira resposta na thread de 150 votos "Alguém pode me explicar o benefício de usar Obsidian com Claude Code?") explica isso melhor:
Os dois casos são o mesmo sistema de arquivos, visto por dois editores diferentes.
Os dois stacks, lado a lado, com os papéis de cada componente.
Nos dois, o que muda é o ponto de entrada e o que tu enxerga na tela. Os arquivos embaixo são os mesmos. Se tu abrir a mesma pasta no Obsidian e no VS Code ao mesmo tempo (dá pra fazer, a gente testou), o Claude lê e escreve no mesmo lugar. Se tu quiser usar os dois juntos, nada impede. A vault do Obsidian vira o "leitor bonito" e o VS Code com Claude Code vira o "painel de controle". É o mesmo sistema de arquivos com duas janelas abertas.
Mix de entusiasmo e cabeça fria. A comunidade não é unânime, e isso é bom.
"Markdown e local-first funcionam bem pra agentes porque a maioria dos LLMs foi treinada em markdown. É um salto natural."
"Sou engenheiro de IA numa fintech startup. Construí um vault Obsidian que vira meu workspace operacional, com o Claude Code de copiloto. Não é sobre plugins ou graph view. É sobre um sistema estruturado de arquivos markdown que o Claude Code lê, escreve e raciocina em cima."
"A pasta .claude/ é o sistema operacional do projeto. O CLAUDE.md é o manual. A pasta rules/ é a política interna. Isso é infraestrutura, não configuração."
"Obsidian com Claude Code virou o jeito definitivo de montar um segundo cérebro que se mantém sozinho, roda briefings diários e compõe conhecimento usando o padrão do Karpathy."
"Não tô tentando ser babaca, mas: vocês tão usando isso como um zelador, certo? Pra mover coisa de lugar e criar documentos de resumo? Ainda tô esperando ver o caso de uso de IA + PKM que seja transformador de verdade."
"Vou ser sincero: se as conexões, as sínteses e os resumos são feitos por uma IA ao invés de mim, eu tô realmente aprendendo alguma coisa ou só acumulando arquivo?"
"Eu uso o Obsidian como suporte pra minha memória degradante. A ideia de abrir uma nota escrita na minha voz mas que não fui eu que escrevi me apavora."
"Tava esperando há tempos uma skill oficial da Anthropic pra Obsidian, e não veio. Mas com o CLI do Claude Code tu transforma o Obsidian num sistema de memória e lógica muito poderoso. Parou de fazer sentido reinventar o que já funciona na caixa."
"Gastei 9 meses usando o Claude Code como assistente pessoal dentro da vault. A dica que eu dou: cria uma skill pra escrever preferências num arquivo (preferences.md), vocaliza tuas preferências, e coloca 'read preferences.md' no teu CLAUDE.md. Fica devastadoramente eficiente com o tempo."
Nenhum banco, nenhum vector DB, nenhum formato proprietário. Os agentes leem o que foram treinados pra ler. A conclusão óbvia é: a memória deles também deveria estar nesse formato. Obsidian e Claude Code chegaram na mesma conclusão por caminhos opostos.
Obsidian, VS Code, Cursor, Zed. Não importa qual tu usa. Os arquivos são os mesmos. Tu pode mudar de editor amanhã sem perder nada. É o oposto de Notion, ClickUp, Roam, onde migrar custa suor e sangue.
A definição clássica de second brain (PARA, Zettelkasten, Tiago Forte) era sobre organizar conhecimento. A nova definição é sobre fazer. O agente lê as tuas notas, entende o contexto e executa a tarefa. Não precisa mais traduzir "o que eu sei" em "o que eu vou fazer". O intermediário sumiu.
Eu uso Obsidian há algum tempo como second brain clássico (notas, projetos, clientes), e faz uns seis meses que eu migrei praticamente tudo pro Claude Code rodando em cima das mesmas pastas. Posso dizer com bastante convicção: é a mesma coisa com roupa diferente.
A diferença que importa não é entre "Obsidian + Claude" e "Claude Code OS". É entre quem usa isso pra pensar e quem usa isso pra fazer. Se tu só quer um lugar bonito pra ler e linkar notas com IA ajudando a costurar, Obsidian ganha no conforto, no mobile, no graph view. Se tu quer um sistema que lê tua pasta, escreve, deleta, roda comando, faz deploy, manda email, edita planilha, atualiza o CRM, o Claude Code ganha sem discussão, porque ele nasceu pra agir e o Obsidian nasceu pra ler.
Na prática, atualmente eu raramente abro o Obsidian. Toco 99% do tempo tudo direto no VS Code com o Claude Code. Os arquivos que seriam a "vault" são as mesmas pastas do workspace, e quando eu preciso ler algo mais tranquilo eu só abro o próprio VS Code em modo preview. O Obsidian ainda tá instalado, mas virou mais um "visualizador ocasional" do que um ambiente de trabalho. A graph view é bonita, mas eu não preciso dela pra tomar decisão.
O ponto que a comunidade mais acerta, e que vale repetir, é o do @Sightless_Bird: se a IA faz as conexões por ti, tu não tá aprendendo, só acumulando. Isso é verdade. A resposta honesta é que tem coisa que eu quero aprender, e pra essa eu escrevo eu mesmo. E tem coisa que eu só quero executar, e pra essa o agente serve. Saber diferenciar as duas é mais importante do que escolher ferramenta.
Se eu tivesse que dar uma recomendação prática: começa pelo lado que tu já usa. Se tu já tem Obsidian, plugue o Claude Code nele (tu não precisa nem instalar plugin, abre o VS Code na mesma pasta e pronto). Se tu nunca usou Obsidian mas já brinca com Claude Code, não perde tempo instalando, o VS Code faz 80% do que tu precisa. A arquitetura é a mesma, o que muda é o cockpit.
No Claude Code OS a gente ensina a configurar memória persistente, skills, CLAUDE.md hierárquico e workflows completos pra qualquer área do teu negócio. Sem plugin de Obsidian necessário. Funciona com VS Code aberto.
Conhecer o Ratos OS