Como configurar o Claude Code na pasta do cofre do Obsidian: passo a passo

Seu cofre do Obsidian já é, na prática, uma pilha de arquivos Markdown em texto puro dentro de uma pasta

E é exatamente por isso que dá pra plugar o Claude Code no Obsidian sem gambiarra: como o cofre são só arquivos .md legíveis por qualquer editor, o agente lê essas notas direto da pasta, sob demanda, sem você precisar copiar e colar contexto nenhum

O Claude Code é uma CLI da Anthropic que roda no terminal e vai lendo os arquivos do diretório atual conforme precisa

Aqui embaixo o passo a passo pra deixar ele operando em cima das suas notas, do zero, só com o que é verificável. Bora?

O que você precisa antes de começar

Nada de PC da Nasa aqui, o setup é bem enxuto. São três coisas:

• Um terminal aberto (o do seu sistema mesmo)
• O cofre do Obsidian localizado, ou seja, você tem que saber em qual pasta ficam os .md. Esse local é o que você escolheu quando criou o cofre, então é você quem sabe onde ele mora
• O Claude Code instalado

Pra instalar via npm, o comando é esse (o pacote npm exige Node.js 18 ou superior):

npm install -g @anthropic-ai/claude-code

Se você está no Windows e não quer depender de Node.js, tem o instalador nativo via PowerShell:

irm https://claude.ai/install.ps1 | iex

Esse instalador do Windows não precisa de Node.js, então é o caminho mais direto pra quem só quer rodar e usar. A referência completa está na documentação de setup do Claude Code

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Passo a passo: apontar o Claude Code para a pasta do cofre

A lógica toda é uma só: o Claude Code lê o diretório em que ele foi aberto. Então o pulo do gato é abrir ele DENTRO da pasta do cofre, e não em qualquer lugar

1. Vá até a pasta do cofre com cd. No terminal, navegue até o diretório onde estão suas notas:

cd caminho/do/seu/cofre

O erro comum aqui é rodar tudo a partir da home ou de uma pasta genérica. Se você não entrar na pasta certa antes, o agente vai olhar pro diretório errado e não vai enxergar suas notas

2. Rode o comando claude. Já dentro da pasta do cofre:

claude

O erro comum: rodar o claude antes do cd. A ordem importa, primeiro você entra na pasta, depois inicia o agente

3. Faça login na primeira execução. Na primeira vez o Claude Code pede login. Depois disso as credenciais ficam salvas e você não precisa logar de novo nas próximas sessões

4. Confira o cabeçalho. Ao iniciar, acima do prompt o Claude Code mostra a versão, o modelo atual e o working directory (o diretório de trabalho). Olhe esse working directory: ele TEM que apontar pra pasta do cofre

O erro comum deste passo é ignorar essa linha. Se o working directory está apontando pro lugar errado, feche, dê cd na pasta certa e abra de novo. Cinco segundos aqui te salvam de confusão depois

5. Use /help pra ver os comandos. Dentro da sessão, digite /help e ele lista os comandos disponíveis. É o seu mapa pra saber o que dá pra fazer sem sair chutando

Gerar o CLAUDE.md do cofre com /init

Com o agente já apontado pro cofre, tem um comando que vale ouro no começo: o /init

Ele faz o Claude Code analisar o diretório e gerar um arquivo CLAUDE.md na raiz da pasta. Esse arquivo guarda instruções de contexto que passam a ser carregadas em TODA conversa

Que diferença isso faz? Pensa assim: em vez de explicar toda vez o que é o cofre, como as notas estão organizadas e o que você quer, esse contexto fica fixo no CLAUDE.md e o agente já começa cada conversa sabendo onde pisa

Dentro da sessão, é só rodar:

/init

O erro comum aqui é esperar que o Claude Code saia editando suas notas sozinho depois disso. Não é o caso: no modo de permissão padrão ele pede aprovação antes de CADA alteração em arquivo. O /init gera o CLAUDE.md, mas mudanças nas suas notas continuam passando pelo seu ok

Se você quer entender melhor esse hábito de deixar o agente planejar antes de mexer em qualquer coisa, dá uma olhada em planejar antes de executar mudanças

Primeiras interações de leitura sobre as notas

Agora a parte gostosa: conversar com o cofre

Como o Claude Code lê os .md sob demanda, você pode simplesmente pedir pra ele ler ou resumir uma nota. Algo do tipo ‘resume a nota X pra mim’ ou ‘me diz o que eu já tenho anotado sobre tal assunto’

Ele vai buscar os arquivos que precisa na pasta e responder a partir do que está escrito ali, sem você ter que colar nada

Lembra do modo de permissão padrão: pra LER ele lê tranquilo, mas na hora de MUDAR qualquer arquivo ele pede aprovação antes. Então pode explorar sem medo, nada é alterado nas suas costas

E se você fechou o terminal no meio de uma conversa boa? Sem problema: quando você abrir uma sessão nova, o /resume permite retomar uma conversa anterior, então dá pra continuar de onde parou

Como isso funciona na prática com um cofre real

No vídeo abaixo eu mostro esse fluxo rodando num cofre de verdade, do começo ao fim

Instalei o Obsidian (instalação padrão, next, next e finish) e criei um cofre novo, escolhendo a pasta na hora. Depois abri o Claude Code apontando exatamente pra pasta desse cofre, igual ao passo a passo aqui de cima

A estrutura que montei separa as coisas em duas pastas: uma pasta RAW, onde entram as fontes brutas, e uma pasta wiki, onde fica o conhecimento já processado e pesquisável. Deixei o próprio Claude Code montar essa estrutura, sem sair criando pasta na mão

Depois abasteci a RAW com alguns artigos (usei a extensão Web Clipper no Chrome pra transformar site em Markdown) e mandei o agente compilar aquilo pra wiki seguindo o esquema

Se liga no resultado: de 4 fontes que eu joguei na RAW e o Claude Code identificou na compilação, ele gerou 19 páginas na wiki, separadas em categorias como fontes, modelos, entidades e conceitos, além de atualizar os arquivos gerais do repositório

Deu pra acompanhar as páginas surgindo em tempo real dentro do Obsidian, e o grafo (graph view) foi conectando os pontos em comum entre as fontes. O legal é que dá pra consultar de dois jeitos: abrindo as páginas no Obsidian ou conversando com o Claude Code

Durante o processo todo, teve que aprovar as permissões que ele pede, aquilo que já falamos do modo padrão. E o uso vira um loop: joga fonte nova na RAW, manda compilar de novo, e a base vai crescendo e se refinando com o tempo

Minha impressão? Muito massa, é 100% markdown local, cresce condensando o conhecimento e não precisa de banco vetorizado, servidor nem infraestrutura. A LLM é o motor, o Obsidian é o banco de dados, e sobra pra você a curadoria

Se você também versiona esse cofre, vale ver como usar o Claude Code com Git pra manter um histórico das mudanças

Conclusão

O resumo da ópera: seu cofre já está pronto pro Claude Code ler

Como as notas são .md em texto puro na pasta, basta abrir o agente dentro dela e ele enxerga tudo sob demanda, sem colar contexto

O próximo passo natural é refinar o CLAUDE.md conforme seu jeito de organizar as notas vai ficando claro, e ir explorando os comandos com /help à medida que o uso cresce

Começa simples, aponta pra pasta certa e vai deixando a base crescer no seu ritmo

até o próximo post! 🙂