O que aprendi estruturando um Hub Editorial no Obsidian para trabalhar com Claude Code — quando a ferramenta gera valor real, quando vira apenas mais um aplicativo e qual critério utilizar para decidir.
Eu não precisava de mais um aplicativo de notas. Precisava parar de perder contexto entre projetos com inteligência artificial.
Se você trabalha com inteligência artificial em mais de um projeto, provavelmente conhece esse problema.
As conversas com a IA produzem decisões boas que morrem dentro delas. As pesquisas ficam em uma ferramenta, os textos em outra, as referências em uma terceira. Quando o contexto não está estruturado ou disponível, uma nova sessão pode exigir que você reexplique o projeto, reconstrua decisões anteriores e tente recuperar o que ficou pendente. Foi para atacar esse problema — não por empolgação com mais um aplicativo — que decidi montar um hub de conhecimento no Obsidian e testá-lo trabalhando com o Claude Code. A pergunta que guiou o teste foi simples: essa combinação realmente reduz a perda de contexto ou apenas muda o lugar onde a informação fica acumulada?
1. O problema não é falta de ferramenta. É perda de contexto.
Quem trabalha com IA em vários projetos acumula um tipo específico de desperdício. Decisões importantes ficam presas em conversas antigas, difíceis de achar semanas depois. As fontes consultadas se espalham entre abas, favoritos e mensagens. Informações do mesmo projeto moram em vários aplicativos ao mesmo tempo — e nenhum deles é o oficial.
O sintoma mais claro aparece na retomada. Para continuar um trabalho, você precisa reexplicar à IA o que é o projeto, o que já foi decidido, o que ficou pendente e por quê. A ferramenta pode responder bem, mas, sem o contexto necessário, você precisa reconstruir decisões, restrições e pendências. O custo não é só tempo. É inconsistência: sem memória organizada, a mesma pergunta recebe direções diferentes em semanas diferentes, e ninguém percebe.
Demorei a levar a sério uma diferença que hoje considero central: armazenar informação não é o mesmo que recuperar contexto útil. O problema aparece quando você não consegue responder rapidamente a perguntas como "o que já decidimos sobre isso?" ou "em que ponto está este trabalho?". Foi atrás dessa capacidade que eu fui.
O Obsidian gera valor quando resolve problemas concretos de contexto, memória, recuperação de decisões, organização de fontes e continuidade entre sessões de trabalho com inteligência artificial.
O valor não está apenas no aplicativo, mas no sistema de trabalho construído ao redor dele.
Sem rotina, fontes de verdade e participação na execução real, o Obsidian pode virar apenas outro lugar cheio de notas.
2. O que o Obsidian realmente é
O Obsidian é um editor de notas que trabalha sobre uma pasta comum do seu computador. Essa pasta é chamada de cofre, e as notas são arquivos Markdown — texto simples, aberto, legível por qualquer editor. A documentação oficial do Obsidian descreve exatamente isso: notas armazenadas como arquivos de texto em Markdown, dentro de uma pasta no sistema de arquivos do usuário.
Isso muda bastante a forma de trabalhar. Seus arquivos não ficam trancados dentro do aplicativo: qualquer ferramenta com acesso à pasta e suporte a arquivos de texto ou Markdown consegue trabalhar sobre as mesmas notas. Dentro do Obsidian, dois recursos transformam notas soltas em rede de conhecimento — os links internos, que conectam uma nota à outra, e as propriedades, campos estruturados no topo de cada arquivo para registrar estado, datas e classificações. Dá para usar tudo isso gratuitamente, inclusive no trabalho; sincronização entre dispositivos e publicação na web são serviços opcionais e pagos, e o essencial funciona sem eles.
No sistema que montei, o Obsidian não é a fonte de verdade para tarefas, código ou colaboração de equipe. Essas funções continuam em ferramentas próprias. O papel do cofre é organizar contexto, pesquisas, decisões e conhecimento editorial. Ele também não substitui processo, disciplina nem a escolha de onde mora a versão oficial de cada informação. Entrega arquivos e pastas. O que você constrói em cima continua sendo responsabilidade sua.
3. A conexão com o Claude Code
O Claude Code é a ferramenta da Anthropic que executa trabalho sobre arquivos. Segundo a documentação oficial do Claude Code, ele lê os arquivos do diretório em que é iniciado, edita e executa comandos — sempre conforme as permissões que você concede. O Claude Code utiliza um sistema de permissões para controlar leitura, edição e execução de comandos. O comportamento depende das configurações e autorizações utilizadas na sessão; a documentação de segurança do Claude Code explica esse modelo e os limites aplicáveis ao diretório de trabalho.
A ponte com o Obsidian está no formato. Como o cofre é uma pasta de arquivos Markdown, o Claude Code trabalha direto sobre ele: lê várias notas relacionadas, cruza informações, encontra inconsistências entre arquivos e atualiza notas seguindo regras. E existe um detalhe que faz muita diferença na prática: o arquivo CLAUDE.md. Segundo a documentação de memória do Claude Code, esse arquivo é lido no início de cada sessão e funciona como instrução persistente do projeto. É onde ficam as regras do cofre — o que pode ser alterado, o que exige autorização, onde mora cada informação. A cada sessão, a ferramenta parte desse ponto, em vez de partir do zero.
Aqui existe um cuidado importante. Os arquivos do cofre ficam no seu computador, e o Claude Code opera sobre o diretório local. Mas, segundo a documentação de uso de dados da Anthropic, prompts, instruções e conteúdos usados durante a sessão são enviados à infraestrutura da Anthropic para processamento pelo modelo, criptografados em trânsito. "Local" não significa que nenhum dado deixa o computador. Dados de clientes, contratos e segredos comerciais exigem cuidado, regras claras e controle sobre o que entra em cada sessão.
Também não dá para exagerar a autonomia do Claude Code. Ele faz o que as permissões e as instruções permitem, e a qualidade do que produz depende da qualidade do contexto que encontra. Um cofre desorganizado não vira organização ao passar pela IA — vira desorganização processada mais rápido.
4. O que aconteceu no primeiro teste real
Meu primeiro teste real dessa combinação foi o Hub Editorial IA | Ivan Andrade — o sistema que organiza a produção de conteúdo da minha marca, incluindo este artigo. Vou registrar apenas o que de fato aconteceu, porque isso é uma implantação em andamento, não um caso encerrado.
Criei o cofre no Obsidian com toda a operação editorial em arquivos Markdown locais: direção editorial, pipeline de conteúdos, calendário, registro de decisões, pesquisas e fontes. Escrevi um CLAUDE.md com as regras do jogo: o que o Claude Code pode fazer, o que exige minha autorização, qual nota é a fonte oficial de cada informação. Definir isso por escrito — decidir onde mora cada dado — foi o trabalho mais importante e o menos glamouroso de todos.
Com tudo pronto, pedi ao Claude Code uma auditoria completa do cofre. Ele leu todas as notas, comparou com as regras do CLAUDE.md e me devolveu um relatório: links internos apontando para notas que não existiam, informações duplicadas em vários painéis, um arquivo com grafia inconsistente. Autorizei uma rodada controlada de correções, que ele executou e validou. Depois disso, este artigo virou o primeiro conteúdo a percorrer o pipeline completo — briefing, pesquisa com fontes oficiais, estrutura aprovada e redação, cada etapa registrada no cofre.
O que isso prova? Menos do que a empolgação sugere. Eu ainda não tenho histórico suficiente para dizer que fiquei mais produtivo. Não medi economia de tempo. Não tenho nenhum número comprovado para mostrar. A implantação ainda é recente e não possui histórico suficiente para uma avaliação quantitativa. O que já consigo afirmar é outra coisa, e não é pouco: as regras permaneceram disponíveis entre as sessões, inconsistências que eu não havia percebido foram encontradas e este conteúdo avançou por etapas sem que eu precisasse reconstruir todo o contexto a cada retomada. Se isso vai virar ganho sustentado é a hipótese que estou testando agora, enquanto incorporo tudo à rotina.
5. O risco: mais um aplicativo cheio de notas
Seria desonesto contar essa história sem contar o outro lado — até porque ele apareceu dentro do meu próprio teste.
No uso que estou testando, o principal risco do Obsidian não é técnico. É comportamental. A ferramenta pode estimular a criação de pastas, plugins e estruturas cada vez mais detalhadas. Isso parece organização. Mas não é execução. Notas sem função definida, plugins sem necessidade, painéis que repetem o que já existe em outros painéis — nada disso trabalha. Quando a empolgação passa, sobra um aplicativo bonito e abandonado.
Eu não escapei desse padrão, mesmo começando com método. A auditoria encontrou o comportamento em formação no meu próprio cofre: o painel principal repetia informações que já tinham notas próprias; os dados da próxima edição da newsletter apareciam em vários locais ao mesmo tempo; havia links apontando para notas inexistentes. Várias notas tentavam ser fonte do mesmo dado — o que, na prática, significa que nenhuma era. A correção foi na direção contrária à da empolgação: o painel virou um índice de navegação, e cada informação ganhou um único lugar oficial de atualização.
A lição cabe em uma frase: uma ferramenta não se torna útil porque está bem organizada. Torna-se útil quando participa do trabalho real.
6. Obsidian ou Notion? A pergunta está incompleta.
Sempre que esse assunto aparece, a comparação com o Notion vem junto. Ela é útil — desde que feita por finalidade, não por preferência pessoal.
O Obsidian trabalha com arquivos locais em Markdown. Isso entrega portabilidade (os dados já nascem em formato aberto), integração direta com ferramentas que leem arquivos — como o Claude Code — e controle total sobre a estrutura. É uma escolha natural para conhecimento individual e fluxos de trabalho locais.
O Notion parte de outra premissa. Segundo a documentação oficial dos bancos de dados do Notion, eles são coleções de páginas, com propriedades que classificam cada item e múltiplas visualizações — tabela, lista, calendário. Somam-se a isso permissões por página e por pessoa e a colaboração como núcleo do produto. Para equipes, organização compartilhada e processos que várias pessoas alimentam, a finalidade é essa. No Notion, a base não nasce como uma pasta local de arquivos Markdown. A portabilidade depende dos recursos de exportação oferecidos pela plataforma, com formatos e limitações descritos na documentação de exportação do Notion.
Ou seja: não existe vencedor universal. As duas ferramentas podem coexistir na mesma operação, cada uma dona do que faz melhor. A decisão depende da função que precisa ser cumprida. Duas ressalvas de honestidade: minha experiência é com o Obsidian; o que escrevi sobre o Notion vem da documentação oficial, não de um teste comparativo que eu tenha feito neste projeto.
7. Uma fonte de verdade por tipo de informação
O que evitou que o meu cofre virasse um acúmulo de notas foi um princípio simples: uma informação pode ser mencionada em vários lugares, mas deve ter apenas um lugar oficial de atualização.
No Hub Editorial, a divisão ficou assim:
- Obsidian (o cofre): contexto editorial, pesquisas, decisões e conhecimento transversal;
- repositório técnico do site: código, testes, componentes, páginas, build e publicação;
- pipeline: estado de cada conteúdo;
- calendário: datas de publicação;
- nota da newsletter: dados da próxima edição;
- registro de decisões: decisões permanentes;
- notas de fontes: referências verificadas, com data de acesso;
- notas de pesquisa: análise e conclusão de cada investigação.
Quando outra nota precisa mencionar um desses dados, ela aponta para a fonte — não reproduz o formulário. Parece burocracia, mas é o contrário: é o que permite confiar no que está escrito. Se duas notas dizem coisas diferentes sobre o mesmo assunto, uma está errada e você não sabe qual. Com fonte única, essa dúvida deixa de existir.
Essa é a arquitetura do meu caso — uma operação editorial individual trabalhando com IA. Não é modelo obrigatório para ninguém. O princípio, porém, viaja bem: antes de adotar qualquer ferramenta nova, decida o que ela será dona de guardar e o que continua morando onde já está.
8. Quando o Obsidian vale a pena
Com o teste em andamento e os riscos mapeados, este é o critério que eu usaria. O Obsidian tende a valer a pena quando várias destas condições estão presentes:
- você trabalha com vários projetos ao mesmo tempo;
- perde contexto entre sessões de forma recorrente;
- tem dificuldade para recuperar decisões já tomadas;
- suas fontes e referências estão espalhadas;
- precisa relacionar pesquisas, projetos e conteúdos entre si;
- utiliza ferramentas que leem arquivos locais, como o Claude Code;
- valoriza portabilidade e propriedade dos próprios dados;
- consegue definir fontes de verdade por tipo de informação;
- está disposto a manter uma rotina mínima de revisão e uso.
Repare que a lista quase não fala do aplicativo. Fala do problema e da disposição para construir um sistema ao redor dele. Essa é a ordem certa: a decisão nasce do problema, não da ferramenta.
9. Quando não vale a pena
A resposta honesta para muita gente é: você não precisa adotar o Obsidian. A adoção tende a adicionar complexidade — em vez de resolver — quando:
- há poucas informações em jogo;
- existe apenas um projeto, e ele é simples;
- não há perda relevante de contexto no dia a dia;
- a necessidade principal é colaboração em equipe, não memória individual;
- não existe rotina que sustente o uso;
- a tendência é organizar mais do que executar;
- a expectativa é que o aplicativo organize tudo sozinho;
- não está claro o que seria armazenado ali;
- a estrutura não teria integração com o trabalho real.
Nesses cenários, instalar o Obsidian só muda o endereço da desorganização. O problema que ele resolve — contexto disperso entre projetos e sessões — precisa existir de verdade para que a adoção se pague.
10. Ganho real ou mais uma ferramenta? Depende do que vem antes dela.
Volto à pergunta do título com a resposta que o teste me deu até aqui. O Obsidian pode ser ganho real: no meu caso, ele já preservou regras entre sessões, encontrou inconsistências e conduziu este artigo por um processo completo. E o mesmo Obsidian pode ser só mais uma ferramenta — como quase aconteceu no meu próprio cofre antes da auditoria.
A diferença não está no aplicativo. Está no que vem antes dele: problema antes da ferramenta; contexto antes da automação; fonte de verdade antes da quantidade de notas; rotina antes da complexidade; execução antes da organização excessiva. Vale para o Obsidian, vale para o Notion e vale para a próxima ferramenta que aparecer prometendo organizar seu trabalho com inteligência artificial.
Antes de instalar o Obsidian ou qualquer outra ferramenta, liste tudo que você precisou reexplicar à inteligência artificial na última semana.
Se essa lista for recorrente, talvez o problema não seja falta de ferramenta. Seja falta de uma memória operacional organizada.