Obsidian + Claude Code: central de comando do zero

O que é o Obsidian

O Obsidian é um aplicativo de notas que funciona com arquivos Markdown guardados no seu computador. Não tem nuvem obrigatória, não tem conta, não tem mensalidade. Você baixa, abre uma pasta, e começa a escrever. Os arquivos são .md — texto puro que abre em qualquer editor, de qualquer sistema operacional.

Isso é o que separa ele de ferramentas como Notion, Google Docs ou Evernote: seus arquivos são seus. Se o Obsidian sumir amanhã, você abre a pasta no Finder, no Explorer, no TextEdit, no VS Code — e tá tudo lá, legível, sem lock-in.

Mas o real poder do Obsidian não é só ser portável. É que ele é extensível. Com plugins da comunidade você adiciona kanban, calendário, templates, queries, gráficos — e, como este tutorial vai mostrar, integração com agentes de IA que operam direto nos seus arquivos.

Instalando o Obsidian

O Obsidian é gratuito pra uso pessoal. Roda em Windows, macOS, Linux, iOS e Android. Pra este tutorial, foco no desktop — é onde o Claude Code vai rodar junto.

Conceitos básicos

Antes de avançar, vale entender o vocabulário mínimo:

Markdown em 30 segundos

O Markdown é o que faz seus arquivos serem portáveis. Aqui vai o mínimo que você precisa:

# Título principal
## Subtítulo
### Sub-subtítulo

Texto normal. **Negrito** e *itálico*.

- Item de lista
- Outro item
  - Sub-item

1. Lista numerada
2. Segundo item

> Citação em bloco

`código inline`

[[Link pra outra nota]]

---
tags:
  - exemplo
  - tutorial
status: rascunho
---

O Obsidian renderiza tudo isso visualmente — você escreve em Markdown e vê formatado. Mas por baixo é sempre texto puro.

O que é o Claude Code

O Claude Code é uma ferramenta da Anthropic que roda no terminal do seu computador. Ele é um agente de IA com acesso direto aos seus arquivos locais — lê, escreve, cria pastas, edita conteúdo. Diferente do ChatGPT ou do Claude na web (onde você copia e cola texto), o Claude Code opera dentro do seu sistema de arquivos.

O que isso significa na prática: você aponta ele pra uma pasta e conversa. "Cria uma estrutura de pastas pra mim", "organiza esses arquivos por data", "lê todos os meus roteiros e adiciona tags automáticas". Ele entende o contexto do que tá naquela pasta e age.

É essa capacidade — ler contexto local e agir nele — que transforma o Obsidian de um app de notas em uma central de operações. O Obsidian cuida da interface, os arquivos são a base de dados, e o Claude Code é o motor que opera em cima.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Obsidian   │     │ Arquivos .md │     │  Claude Code │
│  (interface) │ ←── │   (dados)    │ ──→ │   (agente)   │
└──────────────┘     └──────────────┘     └──────────────┘
       ↑                    ↑                     │
       │                    └─────────────────────┘
       │                     lê, cria, edita
       └── você vê o resultado em tempo real

Instalando o Claude Code

O Claude Code precisa de Node.js 18+ instalado e de uma assinatura do Claude Max (ou créditos da API da Anthropic).

Pré-requisitos

• Node.js 18 ou superior — baixa em nodejs.org (versão LTS recomendada)
• Conta na Anthropic — com assinatura Claude Max ou créditos de API
• Terminal — Terminal.app no macOS, PowerShell/Windows Terminal no Windows, qualquer terminal no Linux

node --version

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

claude

Estruturando a vault com o agente

Aqui é onde a mágica acontece. Em vez de criar pasta por pasta, template por template, manualmente — você pede pro Claude Code fazer isso pra você. Ele entende o que você precisa e monta a estrutura.

cd ~/Documents/Minha-Vault

claude

Cria uma estrutura de vault pro Obsidian pra um
criador de conteúdo no YouTube. Preciso de pastas
pra roteiros, ideias, parcerias comerciais, daily
notes e referências. Cria um template de roteiro
com frontmatter YAML (tags, status, data) e um
template de daily note com seção de tarefas.

Monta uma vault do Obsidian pra freelancer de
design. Preciso de: Projetos (com subpastas por
cliente), Referências visuais, Financeiro (controle
de notas fiscais e recebimentos), Daily Notes e
Templates. Cada projeto deve ter frontmatter com
cliente, valor, prazo e status.

Cria uma vault de estudo no Obsidian. Pastas por
matéria, sistema de flashcards com tags, daily
notes com seção de estudo do dia, template de
resumo de aula com data/professor/matéria no
frontmatter.

Um exemplo concreto: quando eu migrei pro Obsidian, o Claude Code processou mais de 120 roteiros antigos do Google Docs. Pegou cada um, adaptou pro formato Markdown, preencheu tags, criou resumos, organizou em pastas por data. Coisa que levaria semanas pra fazer manualmente, saiu em uma sessão.

CLAUDE.md: o contexto que muda tudo

Esse é o passo que transforma o Claude Code de "assistente genérico" em "assistente que conhece o seu projeto". O CLAUDE.md é um arquivo Markdown que fica na raiz da vault (e opcionalmente em subpastas) e funciona como uma instrução permanente pro agente. Toda vez que o Claude Code abre na pasta, ele lê esse arquivo automaticamente.

O que colocar no CLAUDE.md:

• O que é este projeto — contexto geral da vault
• Estrutura de pastas — o que cada pasta contém e pra que serve
• Convenções — formato de nome de arquivo, padrão de tags, regras de frontmatter
• Regras de negócio — o que o agente pode e não pode fazer

# CLAUDE.md

## O que é esta vault

Vault de produtividade pessoal de um freelancer de design.
Contém projetos por cliente, referências visuais, financeiro
e notas diárias.

## Estrutura

- Projetos/ — um subdiretório por cliente/projeto
- Referências/ — inspiração visual, paletas, tipografia
- Financeiro/ — controle de NFs e recebimentos
- Daily Notes/ — uma nota por dia, formato YYYY-MM-DD.md

## Convenções

| Elemento        | Padrão              |
|-----------------|---------------------|
| Arquivos        | kebab-case           |
| Daily notes     | YYYY-MM-DD.md        |
| Projetos        | NomeCliente - Projeto |

## Regras

- Sempre usar tags do frontmatter em minúscula
- Status possíveis: rascunho, em-andamento, concluído
- Daily notes nunca devem ser deletadas

Você pode criar CLAUDE.md dentro de subpastas também. Por exemplo, um Projetos/CLAUDE.md com regras específicas de como organizar projetos — e o agente respeita as regras da pasta em que está operando.

Na prática, o CLAUDE.md é o que permite que o agente tome decisões boas sem você ter que repetir instrução toda sessão. Você escreve uma vez, e ele sabe.

O Command Center

O Kav Command Center é um plugin custom do Obsidian que eu construí pra centralizar a operação do canal num dashboard só. Ele mostra tarefas do dia, inbox de e-mail, métricas do YouTube, processos de parceria e pipeline editorial — tudo numa tela, sem precisar abrir outra aba.

O design é simples: o plugin só lê e renderiza. Toda a inteligência vem do Claude Code rodando no terminal integrado. O plugin monitora arquivos JSON e Markdown que os comandos do Claude Code atualizam, e re-renderiza automaticamente quando algo muda.

┌─────────────────────────────────────────────┐
│            Kav Command Center               │
│  ┌─────────┬────────┬────────┬────────────┐ │
│  │ OVERVIEW│  HOJE  │  CANAL │  COMERCIAL │ │
│  └─────────┴────────┴────────┴────────────┘ │
│                                             │
│  ┌──────────────────────────────────────┐   │
│  │  Cards: tarefas, inbox, métricas,   │   │
│  │  uploads, pipeline                   │   │
│  └──────────────────────────────────────┘   │
│                                             │
│  ┌──────────────────────────────────────┐   │
│  │  Skill Bar: botões de slash commands │   │
│  └──────────────────────────────────────┘   │
│                                             │
│  ↕ lê arquivos JSON + daily note            │
│                                             │
│  ┌──────────────────────────────────────┐   │
│  │  Terminal integrado com Claude Code  │   │
│  └──────────────────────────────────────┘   │
└─────────────────────────────────────────────┘

5 abas, cada uma com foco diferente

A Skill Bar

Na base do dashboard, uma fileira de botões que disparam comandos no terminal. Um clique em /plan-today e o agente lê sua agenda, seu inbox, suas pendências e escreve o plano do dia na daily note. Um clique em /inbox-brief e ele puxa as threads abertas do Gmail e atualiza o card de inbox. Tudo sem sair do Obsidian.

Como instalar

cp -r kav-command-center .obsidian/plugins/kav-command-center

cd .obsidian/plugins/kav-command-center
npm install
npm run build

Adaptando pro seu caso

O Command Center foi feito pro meu fluxo de criador de conteúdo, mas a arquitetura é adaptável. O plugin lê Markdown e JSON — se a sua vault tem uma pasta de projetos, uma pasta de clientes, daily notes com tarefas, dá pra adaptar os painéis pra mostrar o que faz sentido pro seu contexto. Os parsers de dados ficam em src/data/ e cada painel em src/panels/ — TypeScript direto, sem framework.

Próximos passos

Com Obsidian + Claude Code + Command Center rodando, o sistema já se sustenta sozinho. A partir daqui, vale investir em três direções:

• Criar mais CLAUDE.md por subpasta — quanto mais contexto o agente tem, melhores as decisões que ele toma. Uma pasta de projetos com suas próprias regras, uma pasta de finanças com seus formatos. Cada CLAUDE.md é como treinar o agente numa área específica.
• Explorar plugins da comunidade — Dataview pra queries automáticas, Templater pra templates com lógica, Kanban pra boards visuais, Calendar pra navegar por daily notes. A combinação de plugins certos com o agente certo transforma a vault.
• Montar slash commands — os comandos customizados do Claude Code (arquivos .md em ~/.claude/commands/) automatizam tarefas repetitivas. Um comando pra resumir a semana, outro pra processar inbox, outro pra gerar relatório. É onde o sistema começa a trabalhar pra você.