Claude Code et Obsidian : mon setup pour auditer et écrire

Claude Code dans Obsidian, c’est l’agent terminal d’Anthropic branché directement sur ton vault de notes markdown. Pas un chatbot. Pas un plugin lourd. Un agent qui ouvre ton dossier, lit ton fichier CLAUDE.md et exécute. Concrètement : il audite un site client en 3 minutes, il rédige un article de 2 000 mots à partir de tes notes, il retrouve une idée que tu as eue il y a 6 mois en 8 secondes.

Voici le setup que j’utilise tous les jours pour auditer mes clients SEO et écrire les articles de seo-rank-analyzer.fr. Installation en 10 minutes, quatre workflows concrets, comparatif avec Claude Desktop, Cursor et Copilot, et un fichier CLAUDE.md commenté pour que tu copies-colle ce qui marche.

Points clés

• Le keyword « claude code obsidian » pèse 50 recherches par mois en France et 320 en anglais : marché émergent, concurrence faible.
• Setup complet en 10 minutes : Node.js, CLI Claude Code, terminal pointé sur le vault, fichier CLAUDE.md à la racine.
• Coût d’usage réel pour un solo : 20 à 60 € / mois selon la profondeur des sessions, abonnement Claude Pro recommandé.
• Le vrai différenciateur vs un plugin classique : l’agent peut écrire, déplacer, renommer des fichiers, pas seulement répondre.
• Limite à connaître : tout fichier ouvert ou cité dans le vault peut être envoyé à Anthropic. Vault perso et vault pro doivent rester séparés.

Pourquoi associer Claude Code et Obsidian

Tu as déjà testé un chatbot sur tes notes. Tu lui copies-colles trois paragraphes, tu poses ta question, tu récupères une réponse correcte mais générique. La conversation est jetable. La prochaine fois, tu recommences. C’est exactement le problème que résout Claude Code branché sur Obsidian.

Obsidian n’est pas un éditeur de texte. C’est un graphe de connaissances local en markdown brut. Chaque note est un fichier .md sur ton disque. Les liens internes sont des wikilinks, indexés en temps réel par le moteur du logiciel. Quand tu cherches « canonical e-commerce » dans Obsidian, tu retombes en 200 ms sur les 14 fois où tu as documenté ce sujet en deux ans.

Claude Code de son côté n’est pas un agent dans une fenêtre web. C’est un binaire CLI qui prend en argument un dossier, lit les fichiers, exécute des commandes shell, écrit, supprime, déplace. Quand tu pointes ce binaire sur ton vault Obsidian, tu obtiens un agent qui voit l’intégralité de ta mémoire externe et qui peut la modifier.

Le résultat dépasse l’addition : l’agent ne te donne pas une réponse, il refactorise une note, fusionne deux fiches doublons, génère un brief à partir de douze fragments éparpillés et l’écrit dans le bon dossier. Ton vault devient une équipe d’assistants H24 que tu n’as pas à manager.

Installer Claude Code dans ton vault en 10 minutes

Cinq étapes, aucune dépendance exotique, ça tourne sous macOS, Linux et Windows.

1. Installer Node.js et la CLI Claude Code

Node.js 20 ou plus récent. Vérifie avec node --version. Si la commande échoue, installe Node depuis nodejs.org puis ouvre un nouveau terminal.

Installe ensuite l’agent en une ligne :

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

La commande claude est désormais disponible dans ton shell. Elle ouvre une session interactive ou exécute un prompt unique selon les arguments. La documentation officielle Anthropic détaille les options avancées.

2. Pointer le terminal sur ton vault Obsidian

Ouvre un terminal et déplace-toi dans le dossier qui contient ton vault. Sur macOS :

cd ~/Documents/MonVaultObsidian
claude

L’agent démarre, scanne les fichiers présents, te demande la première instruction. À ce stade, il a accès en lecture-écriture à tout ce qui est dans ce dossier.

3. Premier prompt de vérification

Tape : « Liste les 10 plus gros fichiers du vault et résume en une phrase ce que contient chacun. » En 30 à 60 secondes, tu obtiens un inventaire qui te dit déjà beaucoup sur l’état de ton cerveau externe.

4. Créer un fichier CLAUDE.md à la racine du vault

C’est le fichier d’instructions que Claude Code lit automatiquement à chaque session. Il définit ton style d’écriture, tes conventions de classement, tes interdits. Sans CLAUDE.md, l’agent improvise. Avec, il devient cohérent en 24 heures.

Un exemple commenté plus bas dans cet article. Démarre avec 30 lignes, enrichis-le au fil des semaines.

5. Versionner le vault avec Git (recommandé)

Initialise un dépôt Git dans le dossier : git init && git add . && git commit -m "vault initial". Pas pour partager. Pour annuler en deux secondes une modification que l’agent a faite et qui ne te convient pas. C’est le seul filet de sécurité qui marche vraiment.

Quatre workflows que j’utilise tous les jours

Ces quatre cas d’usage couvrent 80 % de ce que je demande à Claude Code dans le vault Obsidian de seo-rank-analyzer.fr. Chiffres calculés sur trois mois d’utilisation, pas sur une démo.

Audit SEO d’un site client en 3 minutes

Quand Thomas, consultant SEO freelance à Nantes, a testé ce workflow en mars 2026, il préparait ses audits clients en 3 heures avec un crawler desktop et trois outils SaaS ouverts en parallèle. Avec Claude Code dans son vault Obsidian, le même livrable client arrive en 25 minutes.

Le pattern : il garde dans son vault un dossier /clients/ avec une note par site. Il alimente la note avec l’URL, le secteur, le brief commercial. Puis il lance : « Lis la note du client X, fait un crawl mental des 10 pages principales du site, sors les 5 problèmes SEO les plus probables avec preuves. »

L’agent ne crawle pas vraiment, il raisonne sur les données du brief plus ses connaissances. Pour le crawl réel et les scores Core Web Vitals chiffrés, Thomas branche notre audit SEO complet par IA sur le site client puis colle le rapport dans la note. Claude Code synthétise les deux sources et rédige le livrable Word.

Gain réel mesuré : 2 heures par audit. Sur 12 audits par mois, 24 heures récupérées. Le plan PRO de SEO Rank Analyzer à 29 € / mois est largement amorti dès le premier audit du mois.

Rédaction d’un article de 2 000 mots à partir de notes brutes

J’ai 14 mois de notes Obsidian sur le sujet GEO et les crawlers IA. Quand j’écris un article pilier comme notre guide pour améliorer son score SEO, je ne pars pas d’une page blanche. Je dis à l’agent : « Compile tout ce que j’ai écrit sur GPTBot et ClaudeBot dans le vault, sors un brief de 800 mots avec mes opinions tranchées et mes anecdotes terrain. »

L’agent lit littéralement les fichiers, identifie les passages forts, les regroupe par thème, propose un plan, écrit le premier jet en respectant mon style défini dans CLAUDE.md. Je relis, je tranche, je publie. Temps de rédaction d’un article de 2 000 mots : 1 h 30 au lieu de 4 à 5 heures.

Recherche transversale dans 6 mois de notes

Le cas d’usage le plus sous-estimé. Tu te souviens vaguement avoir documenté un retour d’un client sur les schémas Product en 2025. Tu ne sais plus dans quelle note. La recherche full-text d’Obsidian te sort 47 résultats. L’agent te ramène les 3 passages pertinents en deux phrases, avec citation du fichier source.

Génération d’idées de contenu à partir du graphe

« Lis les 30 dernières notes ajoutées et propose 10 angles d’articles que je n’ai pas encore couverts sur seo-rank-analyzer.fr. » En 90 secondes, tu obtiens une liste qui mélange tes obsessions du moment et les gaps de ton calendrier éditorial. Cinq idées sur dix sont jetables. Trois sont bonnes. Une vaut un article pilier. Le ratio est constant.

MCP : passer Claude Code en mode plugin

Le keyword obsidian mcp pèse 1 600 recherches par mois en anglais et 210 en français. Niche, mais en croissance forte. Et pour cause : MCP est ce qui transforme la relation entre Claude Code et Obsidian d’un usage CLI à une intégration native dans l’application.

MCP signifie Model Context Protocol. Standard ouvert publié par Anthropic en septembre 2024, spécifié sur modelcontextprotocol.io. Il définit comment un agent IA se connecte à des sources de contexte externes (fichiers, bases, APIs) sans qu’on hardcode l’intégration. Notre guide du pattern Model Context Protocol détaille la mécanique.

Pour Obsidian, deux approches existent :

• Serveur MCP local pour fichiers : tu lances un petit serveur qui expose le dossier de ton vault à Claude Code via le protocole. L’agent peut lire et écrire sans que tu le lances toujours dans le bon dossier.
• Plugin MCP communautaire pour Obsidian : une extension installée dans Obsidian qui parle directement à Claude Code, sans terminal ouvert. Le mode « plugin » que cherchent ceux qui tapent obsidian claude plugin.

Quand passer en MCP plutôt que rester en CLI ? Quand tu as plusieurs vaults, quand tu veux que d’autres outils (Cursor, IDE) parlent au même contexte que Claude Code, ou quand tu craques sur le fait de toujours devoir cd dans le bon dossier avant de lancer une session.

Pour un solo qui démarre, la CLI seule suffit largement les trois premiers mois. MCP devient pertinent quand tu industrialises.

Claude Code vs Claude Desktop vs Cursor vs Copilot

Quatre options se présentent quand tu veux brancher une IA sur ton vault Obsidian. Aucune n’est universelle. Voici la matrice de décision.

Critère	Claude Code	Claude Desktop	Cursor	Obsidian Copilot
Vault local accessible	Oui (CLI ou MCP)	Oui (MCP filesystem)	Oui (Cursor lit le dossier)	Oui (plugin natif)
Lecture-écriture des fichiers	Oui	Lecture seule par défaut	Oui (édition multi-fichiers)	Limité au fichier actif
Terminal ou plugin	Terminal	App desktop dédiée	Éditeur de code	Plugin Obsidian
Adapté pour la rédaction longue	Oui	Oui	Plutôt code que prose	Oui
Tarif d’entrée	20 $ / mois (Claude Pro)	20 $ / mois (Claude Pro)	20 $ / mois	Gratuit + clé API

Mon usage : Claude Code en quotidien parce que je vis dans le terminal et que j’écris en markdown. Claude Desktop quand je veux glisser une image dans la fenêtre pour que l’agent la voie. Cursor pour le code de l’app SEO Rank Analyzer, jamais pour la rédaction. Le plugin Copilot d’Obsidian si tu n’as pas envie de toucher au terminal du tout : bien fait, mais limité au fichier actif.

Sécurité, données et limites

C’est la question n°1 sur Reddit et la moins bien traitée par les articles existants. Voici les faits, sans hype ni paranoïa.

Ce qui sort du vault : tout fichier que l’agent ouvre, cite ou modifie est envoyé en contexte aux serveurs Anthropic le temps de la session. Selon les conditions du compte, ces données peuvent être retenues 30 jours pour la sécurité ou utilisées pour l’entraînement (les comptes Claude Pro standard ne sont pas par défaut utilisés pour l’entraînement, mais lis les CGU à jour avant de t’engager pour un client).

Ce qui reste local : les fichiers que l’agent ne touche pas dans la session. Si tu as 5 000 notes mais que ta session porte sur 12 fichiers, seuls ces 12 fichiers passent par Anthropic.

Bonne pratique vault pro vs vault perso : deux dossiers distincts, jamais imbriqués. Un vault pro « clients » avec uniquement les briefs anonymisés et les livrables. Un vault perso pour les notes personnelles, journaling, brainstorming brut. Tu pointes Claude Code sur l’un ou l’autre selon le besoin, jamais sur le parent qui contient les deux.

Risques classiques :

• Hallucination sur les chiffres : l’agent peut inventer un volume de recherche ou une métrique CWV s’il n’a pas la donnée. Force-le à citer le fichier source.
• Suppression accidentelle : l’agent peut effacer ou écraser un fichier. Le commit Git initial est ton retour en arrière.
• Permissions terminal : l’agent peut exécuter des commandes shell. Refuse les commandes rm -rf ou les modifications hors du vault. Une commande non comprise se refuse, jamais s’accepte par défaut.

Si tu auditais un agent IA en production avec ce niveau de risques, tu lancerais notre audit d’un agent code sur les 21 patterns. Pour ton propre setup solo, le commit Git suffit.

Mon CLAUDE.md commenté

Le fichier qui change tout. Sans lui, l’agent improvise. Avec lui, il devient cohérent et anticipe ton style. Voici un extrait simplifié de celui que j’utilise pour le vault SEO Rank Analyzer :

# Vault SEO Rank Analyzer

Tu travailles dans le vault de notes personnelles de David Meckler,
fondateur de seo-rank-analyzer.fr.

## Conventions de classement
- /clients/ : notes par client, anonymisées si nécessaire
- /articles/ : drafts d'articles blog, un fichier par sujet
- /audits/ : rapports d'audit SEO réalisés
- /idees/ : carnet à idées brut, ne pas réorganiser sans accord

## Style d'écriture (articles publics)
- Tutoiement, FR natif, accents corrects (é, è, ê, à, ç, ù)
- Pas de franglais paresseux (booster, checker, leverager bannis)
- Chiffres avec sources, jamais d'hallucination
- Espaces insécables avant : ; ? ! % € $

## Interdits
- Ne supprime jamais un fichier sans confirmation explicite
- Ne renomme pas un fichier de /idees/ sans demander
- Ne modifie pas /CLAUDE.md sans m'en parler

## Conventions Git
- Un commit par tâche, message descriptif au présent

Trente lignes. Pas plus la première semaine. Tu enrichis quand tu repères un comportement à corriger.

Foire aux questions

Faut-il un abonnement Claude payant pour utiliser Claude Code dans Obsidian ?

Oui, dans la pratique. La version gratuite a des limites de tokens et de sessions qui rendent l’usage quotidien frustrant. Le plan Claude Pro à 20 $ / mois (environ 19 €) est le minimum viable pour un solo. Au-delà de 100 sessions par mois, le plan Max ou l’API à l’usage devient pertinent.

Est-ce que Claude Code envoie tout mon vault à Anthropic ?

Non. Seuls les fichiers ouverts, cités ou modifiés dans la session sont envoyés en contexte. Si tu lances une session qui ne touche que 8 fichiers, les autres restent en local. Lis les CGU Anthropic à jour pour les politiques de rétention exactes.

Peut-on connecter Claude Code à plusieurs vaults Obsidian ?

Oui. Tu lances une session par vault, pas une session globale. Le pattern recommandé : un vault par contexte (perso, clients, R&D). Si tu veux les exposer à Claude Code sans cd, c’est là que MCP devient utile.

Quelle différence avec le plugin Obsidian Copilot ?

Obsidian Copilot fonctionne dans la note active, comme un assistant d’écriture. Claude Code travaille au niveau du dossier complet : il peut créer, déplacer, renommer, fusionner des fichiers. Copilot est un éditeur, Claude Code est un agent.

Est-ce que ça marche sous Windows ?

Oui. Node.js et la CLI Claude Code tournent sous Windows 10 et 11. WSL fonctionne aussi pour ceux qui préfèrent un shell Linux. Aucune différence fonctionnelle avec macOS.

Combien ça coûte par mois en pratique ?

Pour un solo SEO qui audite 5 à 15 sites par mois et écrit 4 à 8 articles : environ 25 à 50 € par mois entre l’abonnement Claude Pro et l’usage API ponctuel. À comparer aux 130 € minimum d’un Semrush Pro pour un usage qui ne couvre pas la rédaction. Pour la mesure et le suivi, un abonnement à notre catalogue de patterns d’agents IA et notre suite d’audits couvre l’autre moitié du job pour 9 à 29 € / mois.

Ce que je ne fais pas (encore)

Trois usages que ce setup ne couvre pas correctement aujourd’hui, pour cadrer les attentes :

• Publication automatique : l’agent écrit l’article dans le vault, mais c’est moi qui le pousse sur le blog Next.js avec un script de build. Je ne laisse pas l’agent publier seul, le risque éditorial est trop élevé.
• Connexion bases externes en temps réel : l’agent ne se branche pas sur ma DB MySQL ou sur Stripe sans que je l’expose explicitement. Tant mieux.
• Agents multi-comptes ou multi-utilisateurs : ce setup est solo. Pour une équipe, il faut une orchestration au-dessus, sandbox par utilisateur, audit trail. C’est un autre projet.

Ce qu’il faut retenir

Claude Code dans Obsidian n’est pas une astuce de productivité. C’est un changement d’échelle. Ton vault devient une équipe d’assistants à plein temps qui ne dorment pas, qui ne facturent pas en heures, et qui connaissent ton métier mieux que n’importe quel freelance que tu pourrais embaucher demain matin. Le coût d’entrée tient en 10 minutes d’installation et 20 € par mois.

L’angle SEO se révèle au bout de quatre semaines d’usage : le ratio temps passé / livrables produits bouge violemment. Un solo SEO qui sortait 4 articles par mois passe à 8. Un consultant qui livrait 12 audits passe à 25 sans baisser la qualité. Pour mesurer si ton site se positionne bien sur tes nouveaux articles, branche notre audit SEO complet par IA dessus une fois par trimestre.

Lance ton premier audit gratuit en 3 minutes pour vérifier où en est ton site, puis configure ton vault Obsidian + Claude Code dans la foulée. Si tu veux comprendre comment notre IA orchestre ses propres agents pour analyser un site, fais un détour par la page À propos de David Meckler et son retour d’expérience builder.