Claude Code e Obsidian: um vault para você e seu agente

Por que o Claude Code e o Obsidian combinam

Um vault do Obsidian é uma pasta comum de arquivos de texto, sem banco de dados no meio. Por isso, um agente pode trabalhar nele assim como você.

O Claude Code é um agente de IA que roda no terminal, no seu editor ou no app para desktop e trabalha na pasta em que você o inicia. Ele lê arquivos, cria novos, altera os existentes e executa comandos. Inicie-o no seu vault, e todo o seu segundo cérebro está diante dele: ele resume atas de reunião, acrescenta links que faltam, organiza uma coleção de fontes ou transforma seu esboço em um primeiro rascunho, que vira uma nova nota na pasta certa.

Isso não se limita ao Claude Code. Codex, Cursor, Gemini CLI e outros agentes com acesso a arquivos funcionam do mesmo jeito. Já um chat no navegador não vê seu vault, a menos que você copie arquivos para ele.

Configure o Claude Code no seu vault

Use o vault como diretório de trabalho

O Claude Code trabalha na pasta em que você o inicia. Se o seu vault estiver no iCloud Drive, no terminal fica assim, por exemplo:

cd ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/Vault
claude

Decida de propósito quanto o agente deve ver. Para um primeiro teste, basta uma subpasta, como a pasta de um projeto. Faça backup do vault antes de permitir mudanças maiores: o Claude Code consegue desfazer as próprias edições de arquivos, mas não as alterações feitas por comandos no terminal. Git no vault ou Time Machine fecham essa lacuna.

Dê acesso às tarefas em uma pasta vinculada

Se você integra a pasta de dados do TandemLoop ao seu vault com um link simbólico, o local real dela fica fora do diretório de trabalho, e o Claude Code pede permissão toda vez que escreve. Por isso, dê acesso também a essa pasta: na inicialização com --add-dir, em uma sessão em andamento com /add-dir ou de forma permanente em additionalDirectories nos ajustes:

claude --add-dir "<pasta do TandemLoop>"

Como criar o link e por que ele só funciona no Mac está explicado no guia Conectar seu segundo cérebro e sua lista de tarefas.

CLAUDE.md: as regras do seu vault

No início de cada sessão, o Claude Code lê o arquivo CLAUDE.md no diretório de trabalho e nas pastas acima dele. Ali fica o que o agente precisa saber sobre o seu vault e o que ele pode fazer. Execute /init para criar um primeiro rascunho e depois o refine. A Anthropic recomenda manter o arquivo curto, de preferência com menos de 200 linhas, e anotar só o que o agente não consegue descobrir sozinho.

# Vault

Vault do Obsidian com notas em Markdown. Links como wikilinks [[Nota]].

## Pastas
- Notas/: minhas notas, alterar só quando eu pedir
- Curso Online/: material e resultados do curso
- TandemLoop/: pasta de dados do meu app de tarefas (link)

## Regras
- Nunca apague nem renomeie uma nota sem perguntar.
- Salve resultados como nova nota na pasta correspondente.
- Não reestruture as propriedades no topo de um arquivo.

## Tarefas
Para tarefas, leia primeiro TandemLoop/AGENTS.md e siga as regras dele.

Outros agentes costumam ler o AGENTS.md em vez do CLAUDE.md. O Claude Code lê um AGENTS.md por conta própria enquanto não encontra um CLAUDE.md. Se quiser usar os dois, inclua um arquivo no outro com @AGENTS.md. Como esses manuais para agentes são estruturados está no guia Agentic engineering.

Tarefas no Obsidian: caixas de seleção e o plugin Tasks

O Obsidian trata tarefas como caixas de seleção. Uma linha como - [ ] Escrever o roteiro da aula 2 é uma tarefa aberta; com [x], está concluída. Para uma lista de tarefas dentro de uma única nota, isso basta.

O plugin da comunidade Tasks transforma isso em gestão de tarefas no vault inteiro. Você escreve vencimento, prioridade e repetição como símbolos na linha, como 📅 2026-10-23 para o vencimento. Quando você conclui uma tarefa, o plugin acrescenta a data; em tarefas recorrentes, ele cria a próxima linha. Consultas em um bloco de código reúnem tarefas de todas as suas notas:

```tasks
not done
due next week
```

A força dessa abordagem: as tarefas ficam onde surgem, direto nas notas de projeto e nas atas de reunião. Para muita gente que mantém o segundo cérebro no Obsidian, isso basta.

Onde o plugin Tasks chega ao limite

• Lembretes: O plugin Tasks em si não notifica você. As notificações vêm de outro plugin, como o Reminder, e a documentação dele diz que notificações do sistema não são possíveis no iPhone e no Android.
• Capturar na rua: Desde o iOS 26, o Obsidian oferece captura rápida pela Tela Bloqueada, pela Central de Controle e por widgets. O que você captura assim vira texto em uma nota. Data, projeto e responsável você acrescenta depois, à mão.
• Atribuição: Uma linha não tem campo para o responsável. Você pode combinar com seu agente uma etiqueta como #agent, mas não há status para “para avaliação” nem lugar para o resultado dele ou para as perguntas de um ao outro.
• Suas notas, não as do agente: Para concluir ou complementar uma tarefa, o agente precisa alterar a linha na sua nota. Quanto mais notas contêm tarefas, mais arquivos ele mexe para isso.

Tarefas do Obsidian com o Claude Code: atribua-as ao seu agente

A alternativa à linha é uma tarefa própria, com status, vencimento e responsável. Ela vem com uma descrição do objetivo e critérios de aceitação, além de um histórico em que seu agente registra o que fez.

Quando você trabalha com um agente, isso traz vantagens concretas:

• O agente altera uma tarefa sem mexer nas suas notas.
• Responsável e status ficam claros: você atribui a tarefa ao seu agente e, quando ele termina, a tarefa volta para você como “Para Avaliação”.
• Resultados e perguntas ficam na tarefa, e não em um histórico de chat que amanhã já sumiu.

Ninguém quer manter essa estrutura à mão. Para isso, são precisos um manual para o agente e um app que transforme os arquivos em listas, visualizações e lembretes.

Onde o TandemLoop ajuda: captura, visualizações, lembretes

O TandemLoop é um app de tarefas para Mac, iPad e iPhone que funciona exatamente assim. A pasta de dados dele, local ou no iCloud Drive, pode ser uma subpasta do seu vault ou aparecer lá por um link. Seu agente então trabalha no vault inteiro, notas e tarefas incluídas.

• Captura: Captura Rápida, menu Compartilhar, Central de Controle, Atalhos e Siri criam uma tarefa de verdade, já para o seu agente, se você quiser.
• Visualizações: Lista, Tabela, Quadro, Agenda, Calendário, Multicolunas e Painel, com filtros, por exemplo por responsável ou vencimento.
• Lembretes: Vencimentos com horário, notificações com “Concluir”, “Mais Tarde” e “Amanhã” e widgets na Tela de Início e na Tela Bloqueada.
• Agente: A pasta de dados contém o AGENTS.md, o manual para o seu agente. O agente tem acesso a tudo na pasta de dados: cria tarefas, projetos, áreas e visualizações, altera e move esses itens e trabalha nas tarefas atribuídas a ele. Com as propostas ativadas, ele só adiciona itens novos diretamente à Caixa de Entrada e guarda todo o resto como proposta.
• Devolução: Quando termina ou precisa de algo de você, ele devolve a tarefa. Ela aparece em De Volta do Agente e, no iPhone, na aba De Volta.

Tudo sobre dividir o trabalho com seu agente, das propostas às devoluções, está na página App de tarefas para trabalhar com agentes de IA. Todos os recursos sem agente estão na visão geral do app de tarefas.

Fluxo de exemplo: Caixa de Entrada → agente → resultado

Um fluxo do projeto “Curso Online”: o roteiro do curso é uma nota no Obsidian, e o agente deve rascunhar o texto da aula 2.

1. Capturar. A caminho do trabalho, você digita “Escrever o roteiro da aula 2” na Captura Rápida e atribui a tarefa ao seu agente com a delegação Rascunho. Ela vai para a Caixa de Entrada.
2. Instrução. No Mac, você inicia o Claude Code no seu vault e digita: “Trabalhe nas suas tarefas no TandemLoop.” Ele lê o manual, encontra a tarefa e também o roteiro do seu curso.
3. Resultado na tarefa. Ele salva o roteiro como nota na pasta Curso Online e escreve no histórico da tarefa o que fez, com um link para a nota.
4. De Volta do Agente. Como a delegação era Rascunho, ele não conclui a tarefa por conta própria, mas a devolve para avaliação. Você lê o roteiro no Obsidian e escolhe Aceitar no TandemLoop, ou Pedir Ajustes com um comentário.
5. O que só você pode fazer. Se ele precisar de uma conta confirmada na plataforma do curso para o upload, coloca “Confirmar o acesso à plataforma do curso” na sua Caixa de Entrada, em vez de mencionar isso em uma resposta longa.

Se o agente roda em ciclo no seu Mac, por exemplo com o skill de worker do TandemLoop e /loop 10m /tandem-worker no Claude Code, ele trabalha em tarefas assim mesmo enquanto você está fora. Só um agente deve escrever por vez.

Qual abordagem combina com você

Você pode combinar os dois: checklists para coisas pequenas ficam nas suas notas, e tudo em que seu agente trabalha ganha uma tarefa própria. Se você organiza suas tarefas com Getting Things Done, o guia do método GTD mostra quais etapas seu agente pode assumir.