📥 Instalando o Obsidian
O Obsidian é um editor de Markdown local — seus dados ficam no seu computador, não em nuvem. Isso é essencial para o Claude Code acessar o vault via sistema de arquivos.
🔧 Fluxo de Instalação
O Claude Code acessa o vault diretamente pelo sistema de arquivos. Não precisa de API, não tem custo de sincronização, funciona offline.
Após configurar localmente, você pode sincronizar via Git (gratuito) ou Obsidian Sync (pago) para ter acesso em múltiplos dispositivos.
📂 Estrutura de Pastas do Vault
A estrutura de pastas segue diretamente a arquitetura de 3 camadas. Crie exatamente esta estrutura — o CLAUDE.md e o agente de atualização dependem desses caminhos.
Estrutura Completa do Vault
~/meu-cerebro/ # Raiz do vault Obsidian
│
├── CLAUDE.md # Schema do sistema (obrigatório)
├── index.md # Mapa de navegação do vault
├── log.md # Log de compilações
│
├── 📁 raw/ # Captura bruta — nunca editar
│ ├── reunioes/
│ ├── artigos/
│ └── pensamentos/
│
└── 📁 wiki/ # Conhecimento compilado pelo LLM
├── fundamentos/ # Conceitos e teoria
├── projetos/ # Projetos e iniciativas
├── pessoas/ # Contatos e equipes
└── referencias/ # Fontes e recursosCriando via terminal
# Criar estrutura completa com um comando
mkdir -p ~/meu-cerebro/{raw/{reunioes,artigos,pensamentos},wiki/{fundamentos,projetos,pessoas,referencias}}
# Criar arquivos schema
touch ~/meu-cerebro/CLAUDE.md
touch ~/meu-cerebro/index.md
touch ~/meu-cerebro/log.md🔌 Plugins Essenciais
Três plugins transformam o Obsidian básico em um sistema de conhecimento inteligente. Instale-os via Settings → Community Plugins → Browse.
🔌 Ecossistema de Plugins
Consulta suas notas como um banco de dados. Exemplo:
```dataview
TABLE updated, status
FROM "wiki/"
WHERE status = "active"
SORT updated DESC
```Templates com JavaScript. Cria automaticamente o frontmatter:
---
title: <% tp.file.title %>
created: <% tp.date.now("YYYY-MM-DD") %>
status: draft
tags: []
---⚙️ Escrevendo o CLAUDE.md do Vault
O CLAUDE.md é o contrato entre você e o LLM. Ele define as regras de operação — o que o LLM pode e não pode fazer, como organizar o conhecimento e qual o propósito do vault.
Template CLAUDE.md Completo
# CLAUDE.md — Segundo Cérebro de [Nome]
## Propósito
Este vault é o segundo cérebro de [Seu Nome].
Área de atuação: [ex: engenharia de ML, produto, etc.]
Objetivo: capturar, compilar e consultar conhecimento
de trabalho de forma eficiente.
## Estrutura
- raw/ → capturas brutas (NUNCA edite)
- wiki/ → conhecimento compilado (edite aqui)
- CLAUDE.md → este arquivo (regras do sistema)
- index.md → mapa do vault (atualize sempre)
- log.md → histórico de compilações
## Operações Disponíveis
### INGERIR (processar raw/ → wiki/)
Quando solicitado a "ingerir" um arquivo de raw/:
1. Leia o arquivo raw/ completo
2. Identifique o conceito/projeto/pessoa central
3. Crie ou atualize a nota wiki/ correspondente
4. Adicione [[links]] para notas existentes relevantes
5. Atualize index.md se criar nota nova
6. Registre em log.md com data e ação realizada
### CONSULTAR (responder perguntas)
1. Leia index.md para localizar notas relevantes
2. Leia as notas wiki/ identificadas
3. Responda com base apenas no wiki/ (não invente)
### AUDITAR (lint do vault)
1. Verifique notas sem links (órfãos)
2. Identifique notas com status: draft antigo
3. Reporte inconsistências entre notas
## Categorias wiki/
fundamentos/ → conceitos técnicos, teoria
projetos/ → projetos ativos e concluídos
pessoas/ → contatos, equipes, stakeholders
referencias/ → livros, artigos, ferramentas
## Regras Críticas
- NUNCA modifique arquivos em raw/
- SEMPRE crie links [[bidirecionais]] nas notas
- SEMPRE registre ações no log.md
- Notas wiki devem ter frontmatter completo🔗 Conectando Obsidian ao Claude Code
O Claude Code acessa o vault como qualquer diretório local. A integração é simples e direta — você abre o terminal na raiz do vault e usa o claude CLI.
🔗 Arquitetura de Integração
Usando o Claude Code no vault
# Abra o terminal na raiz do vault
cd ~/meu-cerebro
# Claude Code lê CLAUDE.md automaticamente ao iniciar
claude
# Ou passe um prompt direto
claude "ingira o arquivo raw/reunioes/2024-03-20.md"
# Consulta
claude "o que sabemos sobre o projeto alpha?"✅ Checklist de Configuração
Antes de começar a usar o sistema, verifique todos os itens desta lista. Um vault mal configurado vai gerar comportamentos inesperados no LLM.