Claude Code e Obsidian: un vault per te e il tuo agente

Perché Claude Code e Obsidian vanno d’accordo

Un vault di Obsidian è una normale cartella di file di testo, senza un database in mezzo. Per questo un agente può lavorarci proprio come te.

Claude Code è un agente IA che gira nel terminale, nel tuo editor o nell’app desktop e lavora nella cartella in cui lo avvii. Legge file, ne crea di nuovi, modifica quelli esistenti ed esegue comandi. Avvialo nel tuo vault e avrà davanti l’intero second brain: riassume i verbali delle riunioni, aggiunge i link mancanti, ordina una raccolta di fonti o trasforma la tua scaletta in una prima bozza che finisce come nuova nota nella cartella giusta.

Non vale solo per Claude Code. Codex, Cursor, Gemini CLI e altri agenti con accesso ai file funzionano allo stesso modo. Una chat nel browser, invece, non vede il tuo vault, a meno che non ci copi dentro dei file.

Configurare Claude Code nel tuo vault

Usa il vault come directory di lavoro

Claude Code lavora nella cartella in cui lo avvii. Se il tuo vault è in iCloud Drive, nel terminale appare per esempio così:

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

Decidi consapevolmente quanto deve vedere l’agente. Per una prima prova è sufficiente una sottocartella, come quella di un progetto. Fai un backup del vault prima di consentire modifiche più ampie: Claude Code può annullare le proprie modifiche ai file, ma non quelle fatte tramite comandi del terminale. Git nel vault o Time Machine colmano questa lacuna.

Dare accesso alle attività in una cartella collegata

Se includi la cartella dati di TandemLoop nel vault con un link simbolico, la sua posizione reale è fuori dalla directory di lavoro e Claude Code chiede il permesso ogni volta che scrive. Dagli quindi accesso anche a quella cartella: all’avvio con --add-dir, in una sessione in corso con /add-dir o in modo permanente in additionalDirectories nelle impostazioni:

claude --add-dir "<cartella TandemLoop>"

Come creare il link e perché funziona solo su Mac lo spiega la guida Collegare second brain e lista di attività.

CLAUDE.md: le regole per il tuo vault

All’inizio di ogni sessione Claude Code legge il file CLAUDE.md nella directory di lavoro e nelle cartelle superiori. Contiene ciò che l’agente deve sapere sul tuo vault e cosa può fare. Esegui /init per creare una prima bozza, poi rifiniscila. Anthropic consiglia di tenere il file breve, idealmente sotto le 200 righe, e di scrivere solo ciò che l’agente non può capire da solo.

# Vault

Vault di Obsidian con note in Markdown. Link come wikilink [[Nota]].

## Cartelle
- Note/: le mie note, modificale solo su richiesta
- Corso online/: materiale e risultati per il corso
- TandemLoop/: cartella dati della mia app di to-do (link)

## Regole
- Non eliminare né rinominare mai una nota senza chiedere.
- Salva i risultati come nuova nota nella cartella adatta.
- Non ristrutturare le proprietà in cima a un file.

## Attività
Per le attività leggi prima TandemLoop/AGENTS.md e seguine le regole.

Gli altri agenti di solito leggono AGENTS.md invece di CLAUDE.md. Claude Code legge da sé un AGENTS.md finché non trova un CLAUDE.md. Se vuoi usarli entrambi, includi un file nell’altro con @AGENTS.md. Come sono strutturati questi manuali per agenti lo spiega la guida Agentic engineering.

Attività in Obsidian: caselle di controllo e plug-in Tasks

Obsidian gestisce le attività come caselle di controllo. Una riga come - [ ] Scrivi il copione della lezione 2 è un’attività aperta; con [x] è completata. Per una lista di attività dentro una singola nota è sufficiente.

Il plug-in della community Tasks ne fa una gestione delle attività estesa a tutto il vault. Scadenza, priorità e ripetizione le scrivi come simboli nella riga, per esempio 📅 2026-10-23 per la scadenza. Quando completi un’attività, il plug-in aggiunge la data; per le attività ricorrenti crea la riga successiva. Le query in un blocco di codice raccolgono le attività da tutte le tue note:

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

Il punto di forza di questo approccio: le attività stanno dove nascono, direttamente nelle note di progetto e nei verbali delle riunioni. Per molte persone che tengono il proprio second brain in Obsidian è sufficiente.

Dove il plug-in Tasks arriva al limite

• Promemoria: il plug-in Tasks da solo non ti avvisa. Le notifiche arrivano da un altro plug-in come Reminder, la cui documentazione dice che le notifiche di sistema non sono possibili su iPhone e Android.
• Annotare in giro: da iOS 26 Obsidian offre Quick Capture dalla schermata di blocco, dal Centro di Controllo e dai widget. Ciò che annoti così finisce come testo in una nota. Data, progetto e responsabile li aggiungi dopo a mano.
• Assegnazione: una riga non ha un campo per il responsabile. Puoi concordare con il tuo agente un tag come #agente, ma non c’è uno stato per “da verificare” né un posto per il suo risultato o per le vostre domande reciproche.
• Le tue note, non quelle dell’agente: per spuntare o integrare un’attività, l’agente deve modificare la riga nella tua nota. Più note contengono attività, più file tocca per farlo.

Attività di Obsidian con Claude Code: assegnale al tuo agente

L’alternativa a una riga è un’attività a sé, con stato, scadenza e assegnatario. Ha una descrizione dell’obiettivo e dei criteri di accettazione, e una cronologia in cui il tuo agente annota cosa ha fatto.

Quando lavori con un agente, questo ha vantaggi concreti:

• L’agente modifica un’attività senza toccare le tue note.
• Responsabilità e stato sono chiari: assegni l’attività al tuo agente e, quando ha finito, l’attività torna a te come “Da verificare”.
• Risultati e domande restano sull’attività invece che in una cronologia della chat che domani non c’è più.

Nessuno vuole mantenere questa struttura a mano. Servono un manuale per l’agente e un’app che trasformi i file in elenchi, viste e promemoria.

Dove aiuta TandemLoop: annotare, viste, promemoria

TandemLoop è un’app di to-do per Mac, iPad e iPhone che funziona proprio così. La sua cartella dati, locale o in iCloud Drive, può essere una sottocartella del tuo vault o comparire lì tramite un link. Il tuo agente lavora allora sull’intero vault, note e attività comprese.

• Annotare: Inserimento rapido, menu Condividi, Centro di Controllo, Comandi rapidi e Siri creano una vera attività, se vuoi subito per il tuo agente.
• Viste: Elenco, Tabella, Bacheca, Agenda, Calendario, Multivista e Dashboard, con filtri, per esempio per assegnatario o scadenza.
• Promemoria: scadenze con orario, notifiche con “Completa”, “Più tardi” e “Domani”, e widget nella schermata Home e nella schermata di blocco.
• Agente: la cartella dati contiene AGENTS.md, il manuale per il tuo agente. L’agente ha accesso a tutto ciò che si trova nella cartella dati: crea attività, progetti, aree e viste, li modifica e li sposta, e lavora alle attività che gli sono assegnate. Con le proposte attive aggiunge direttamente solo nuove voci all’Inbox e salva tutto il resto come proposta.
• Restituzione: quando ha finito o gli serve qualcosa da te, ti restituisce l’attività. L’attività compare sotto Di ritorno dall’agente, su iPhone nella scheda Dall’agente.

Tutto sulla divisione del lavoro con il tuo agente, dalle proposte alle restituzioni, è nella pagina App di to-do per lavorare con gli agenti IA. Tutte le funzioni senza agente sono nella panoramica dell’app di to-do.

Esempio di flusso di lavoro: Inbox → agente → risultato

Un flusso di lavoro dal progetto “Corso online”: la scaletta è una nota in Obsidian e l’agente deve preparare la bozza del copione per la lezione 2.

1. Annotare. Mentre vai al lavoro, digiti “Scrivi il copione della lezione 2” nell’Inserimento rapido e assegni l’attività al tuo agente con la delega Bozza. Finisce nell’Inbox.
2. Istruzione. Sul Mac avvii Claude Code nel tuo vault e scrivi: “Svolgi le tue attività in TandemLoop.” Legge il manuale, trova l’attività e anche la scaletta del corso.
3. Risultato sull’attività. Salva il copione come nota nella cartella Corso online e scrive nella cronologia dell’attività cosa ha fatto, con un link alla nota.
4. Di ritorno dall’agente. Poiché la delega era Bozza, non completa da solo l’attività ma te la restituisce da verificare. Leggi il copione in Obsidian e in TandemLoop scegli Accetta, oppure Fai rielaborare con un commento.
5. Ciò che solo tu puoi fare. Se per il caricamento gli serve un account confermato sulla piattaforma del corso, mette “Conferma l’accesso alla piattaforma del corso” nella tua Inbox invece di citarlo in una lunga risposta.

Se l’agente gira in loop sul tuo Mac, per esempio con lo skill worker di TandemLoop e /loop 10m /tandem-worker in Claude Code, svolge attività come queste anche mentre sei via. Dovrebbe scrivere un solo agente alla volta.

Quale approccio fa per te

Puoi combinare i due: le checklist per le piccole cose restano nelle tue note, e tutto ciò su cui lavora il tuo agente riceve un’attività a sé. Se organizzi le tue attività con Getting Things Done, la guida al metodo GTD mostra quali passaggi può assumersi il tuo agente.