Architecture du second cerveau selon la Méthode Karpathy classique

 

Dans la version la plus courante de la méthode, Claude est utilisé via Claude Code, donc côté cloud/terminal. Obsidian est relié à Claude Code, avec des commandes d’ingestion, de requête et de maintenance qui laissent Claude lire, classer et mettre à jour les notes dans le dossier local.

 

Ce que fait Claude

Claude sert à transformer des sources brutes en pages Markdown structurées, à relier les notes entre elles, puis à maintenir le wiki dans le temps. Le workflow du second cerveau est basé sur des couches “sources brutes”, “wiki”, et “fichier de règles”, avec Claude qui génère et met à jour le contenu dans Obsidian.

Par quel canal

Le canal le plus probable est Claude Code, car le setup décrit parle de “relier le vault à Claude Code” et de déclencher des commandes comme ingest, query, lint et save depuis ce contexte.

La documentation Anthropic confirme aussi que l’API Claude donne un accès programmatique aux modèles via la Messages API, et que les agents/sessions gérés existent aussi côté API

L’application web Claude.ai n’est pas le cœur de cette méthode. Elle peut servir ponctuellement pour discuter ou tester, mais le “second cerveau” repose surtout sur une automatisation locale autour d’Obsidian et d’un agent Claude piloté en arrière-plan, pas sur une simple conversation dans le browser.

Pour résumer :

·         Obsidian = stockage local du cerveau.

·         Claude Code / API = moteur qui lit, synthétise, lie et entretient le vault.

 

 

 

 

 

 

 

En pratique

Schéma de l’architecture :

Claude Code + Obsidian est une architecture de connaissance personnelle pilotée par fichiers locaux.

Ici, Obsidian sert de mémoire locale en Markdown, et Claude Code sert d’agent qui lit, organise et enrichit ce vault. Claude Code crée, lie, édite et supprime des notes, avec une structure de type wiki personnel qui s’améliore au fil du temps (grâce aux secondes couches : raw à wiki vivant)

Raw = donnée brute et wiki = donnée structurée

 

Vault Obsidian CLI Mockup

 

Flux type :

·         Tu ajoutes une source, une note ou une capture web.

·         Claude Code l’analyse.

·         Il crée ou met à jour des pages Markdown.

·         Obsidian affiche les liens et le graphe

 

 

 

Différence pratique: Entre Claude API et Claude Code + Obsidian

Le système Claude API est la bonne option si tu veux un système logiciel mais Claude Code + Obsidian est la bonne option si tu veux un système de connaissance personnelle (PKM).

 

Ce que tu contrôles

·         La structure du vault.

·         Les conventions de nommage.

·         Les règles dans CLAUDE.md.

·         Les fichiers sources et les notes synthétiques.

Avantages

·         Très bon pour la mémoire longue durée.

·         Données locales et éditables.

·         Excellent pour la connaissance personnelle, la recherche et le suivi de projets.

Limites

·         Nécessite une discipline de structure.

·         La qualité dépend beaucoup de l’architecture du vault.

 

How Claude API Works infographic


Vocab pour Claude API:

Dans le contexte de ce fichier, l'expression "via la Messages API" fait référence à l'interface de programmation (API) officielle développée par Anthropic pour permettre à des logiciels ou des scripts de communiquer directement avec les modèles de langage Claude (comme Claude 3.5 Sonnet).

Voici les détails techniques et pratiques pour bien comprendre ce terme :

1\. Une interface pour les machines, pas pour les humains

Contrairement à l'interface web (Claude.ai) où vous tapez du texte dans un navigateur, la Messages API est un "canal de communication" structuré. Elle permet à des outils comme Claude Code ou des plugins Obsidian d'envoyer des requêtes et de recevoir des réponses sous forme de données (généralement au format JSON). C'est ce qui permet l'automatisation décrite dans la "méthode Karpathy".

2\. La structure en "Messages"

Cette API porte ce nom car elle impose une structure de conversation organisée par rôles :

System : Les instructions de fond (votre "fichier de règles" mentionné dans la note).

User : Les données brutes ou la question posée par l'utilisateur.

Assistant : La réponse générée par Claude.

Cette structure permet à Claude de comprendre exactement quel est son rôle et quel est le contexte des notes qu'il doit traiter dans votre vault Obsidian.



3\. Pourquoi est-ce central dans la méthode Karpathy ?

Comme l'indique votre fichier, le "second cerveau" repose sur une automatisation locale. L'intérêt de passer par la Messages API plutôt que par le cloud (browser) est triple :

Accès programmatique : Claude peut lire, classer et mettre à jour des fichiers Markdown locaux sans que vous ayez à faire des copier-coller manuels.

Utilisation d'outils (Tool Use) : L'API permet à Claude de déclencher des commandes spécifiques (comme ingest, query, lint) directement sur votre ordinateur.

Précision : L'API offre un contrôle plus fin sur les paramètres du modèle (température, longueur de réponse, etc.) que l'interface grand public.

En résumé : La Messages API est le "moteur sous le capot". C'est le lien technique qui permet à votre dossier local de notes (Obsidian) de devenir "intelligent" en envoyant son contenu à Claude de manière invisible et structurée