Claude + Obsidian Second Brain: Why This Combination Just Works

TL;DR

You can build an Obsidian second brain with ChatGPT, Gemini, or any modern LLM. But Claude wins for this specific job, and the reason isn't model intelligence, it's the surrounding tooling. Claude Code reads CLAUDE.md files from your filesystem automatically. Claude.ai Projects let you persist context across sessions without re-pasting. Claude Skills (introduced 2025) let you compose reusable workflows on top of that context. Together they turn a static Obsidian vault into a living context layer that's loaded the moment you open a session. ChatGPT has Custom GPTs and Memory, but neither matches the directness of dropping a markdown file into a folder and having it auto-load. This post covers the why, the setup, and the three pitfalls that bite people switching from ChatGPT.

Why Claude Specifically

Most "second brain with AI" advice is model-agnostic. That's a mistake, because the tooling around the model is what determines whether the workflow actually sticks day to day.

Claude wins for an Obsidian second brain for three specific reasons:

1. Claude Code reads CLAUDE.md natively. Drop a CLAUDE.md file at the root of any project and Claude Code auto-loads it on every session. Add a CLAUDE.md inside a subfolder and it stacks on top when you work in that area. This is exactly the architecture an Obsidian-based second brain wants: a root identity file plus folder-specific context that activates automatically. ChatGPT's Custom GPTs require manual configuration in a web UI; Claude reads from the filesystem.

2. Claude.ai Projects persist context across chats. Upload your three core files (identity, projects, decisions) once to a Project, and every conversation in that Project inherits them without you re-pasting. ChatGPT has Projects too, but Anthropic's implementation runs cleaner, files stay accessible via the file viewer, and the context budget is generous enough that you can include the full vault when needed.

3. Claude Skills (released 2025) compose on top. Skills let you save a workflow, a prompt + behavior + permissions, and invoke it later. Steph Ango (Obsidian's CEO) published an official Obsidian skill set that adds vault-aware capabilities. Combine your personal second brain (identity/projects/decisions) with reusable skills (capture, retrieve, summarize) and the AI starts behaving like a coworker with shared tooling, not a chatbot with amnesia.

None of these are individually transformative. Together they remove enough friction that the workflow becomes habitual instead of effortful.

The Setup, Step by Step

Assuming you've read the pillar second-brain post and the template breakdown, this is the Claude-specific layer.

Step 1: Pick your loading mode

  • Mostly coding: install Claude Code and keep your three core files at the root of each project as CLAUDE.md + supplementary files. Add per-project CLAUDE.md files inside specific repos that need extra context.
  • Mostly writing/chat: use Claude.ai Projects. Create one Project per major area of your life ("Client work", "Personal writing", "Qobouli"). Upload the core files; add a Project description summarizing what the AI should do.
  • Both: use both. The same markdown files work in both surfaces.

    • Step 2: Mirror your Obsidian vault into Claude

    If you keep your second brain in an Obsidian vault, the question is how to get those files into Claude's context. Three workable options:

  • Git-sync. Check the vault into a private git repo. Open it in Claude Code. Everything just works.
  • Manual paste. For one-off chat sessions, copy file contents at the top of the prompt. Slow but no setup.
  • Claude.ai Projects upload. Drag the three files into a Project. Re-upload when you make significant changes (you don't need to re-upload for every edit).

    • Most people end up using all three depending on the surface and the task.

    Step 3: Add Steph Ango's Obsidian Skills

    If you're already in Claude.ai, install the official Obsidian skill set. They add vault-aware actions (capture, link, retrieve) that compose with your personal context. The combination (your personal files + the official skills) is where most of the leverage lives.

    Step 4: Define your reload trigger

    The discipline that separates a working second brain from a stale one is the reload trigger. Pick one:

  • Friday afternoon weekly review. Open the vault, update active projects, re-upload to Project.
  • End of project milestone. When you ship something, capture the decisions to decisions.md.
  • Start of any new client engagement. Add a folder + CLAUDE.md for the new context.

    • If you don't pick a trigger, the vault decays. Stale context is worse than no context.

    What Claude Does Differently in Practice

    Once the setup is in place, here's what changes about how Claude behaves:

  • It stops re-suggesting options you've already ruled out. Because decisions.md lists rejected paths with reasons, Claude doesn't loop back to them.
  • It matches your stack without asking. "I'm building a thing" → Claude assumes Vite + Supabase + Tailwind because identity.md told it that's the default.
  • It uses your tone. If identity.md says "direct, no fluff, push back when warranted," Claude does. ChatGPT will too, but Claude's defaults match this style more naturally.
  • It pulls cross-project parallels. When projects share patterns ("this client wants what the last client wanted"), Claude notices because projects.md is small enough to reason across.
  • It calls out when context is stale. If projects.md says a project is "in progress" but your message implies it shipped, Claude often asks. ChatGPT tends to just go along.

    • These are small effects individually. Compounding across thousands of interactions, they're the difference between productivity AI and theater AI.

    Three Pitfalls When Switching from ChatGPT

    People moving from a ChatGPT-based workflow consistently hit these:

    Pitfall 1: Treating Custom GPTs and Projects as equivalent. They're not. Custom GPTs are GPT-with-a-system-prompt. Claude Projects are workspaces with persistent file context that any chat inside inherits. Don't try to recreate a Custom GPT in a Project, use the file system, not the system prompt.

    Pitfall 2: Over-stuffing the vault. Claude's context window is generous, which tempts people to upload everything. Don't. The same curation rule applies: every file you include competes for attention. A focused 30-file vault beats a 400-file vault every time.

    Pitfall 3: Skipping CLAUDE.md because it feels redundant. If you use Claude Code at all, name your identity file CLAUDE.md and put it at the root. The auto-load is the single biggest workflow upgrade over manual prompts. People who skip this step keep wondering why their setup feels clunkier than it should.

    When NOT to Use Claude for This

    Honest counterpoint: Claude isn't always the right tool.

  • You're already deep in a ChatGPT Teams or Enterprise workspace: switching surfaces is expensive. ChatGPT's Memory feature has improved enough that a ChatGPT-native second brain is workable, even if Claude is cleaner in isolation.
  • You need image generation or browsing baked into the same surface. Claude has both via tools, but ChatGPT's experience is more integrated.
  • You're testing an open-source model locally for privacy. Ollama + a local model is a different setup; the principles in this post still apply, but the tooling is different.

    • For most working professionals who want AI to remember their context and stop being generic, Claude + Obsidian + the three-file template is the cleanest path.

    Where to Go Next

  • Start with the 3-file template if you haven't yet.
  • Read the pillar second-brain post for the philosophy.
  • Layer in Steph Ango's official Obsidian skills once the basics are in place.

    • The compounding effect is real but it requires the first month of friction. Push through it and the workflow becomes invisible.

    Claude مع Obsidian كدماغ ثاني: لماذا تنجح هذه التركيبة تحديداً

    الخلاصة

    تستطيع بناء دماغ ثاني في Obsidian مع ChatGPT أو Gemini أو أيّ LLM حديث. لكنّ Claude يفوز في هذه المهمّة تحديداً، والسبب ليس ذكاء النموذج, بل الأدوات المحيطة. Claude Code يقرأ ملفّات CLAUDE.md من نظام الملفّات تلقائيّاً. Claude.ai Projects تحفظ السياق عبر الجلسات بلا إعادة لصق. Claude Skills (أُطلِقَت 2025) تتيح تكويم سير عمل قابل لإعادة الاستخدام فوق هذا السياق. مجتمعةً، تحوّل خزنة Obsidian الجامدة إلى طبقة سياق حيّة تُحمَّل لحظة فتح الجلسة. ChatGPT لديه Custom GPTs و Memory، لكن لا أحد منهما يضاهي مباشريّة وضع ملفّ Markdown في مجلّد ليُحمَّل تلقائيّاً. هذا المقال يغطّي السبب، الإعداد، والمزالق الثلاث التي تصطاد المنتقلين من ChatGPT.

    لماذا Claude تحديداً

    معظم نصائح "الدماغ الثاني مع الذكاء الاصطناعيّ" محايدة بين النماذج. هذا خطأ، لأنّ الأدوات حول النموذج هي ما يحدّد ثبات سير العمل يوميّاً.

    Claude يفوز للدماغ الثاني في Obsidian لثلاثة أسباب تحديدية:

    1. Claude Code يقرأ CLAUDE.md أصلاً. ضع ملفّ CLAUDE.md في جذر أيّ مشروع وسيُحمَّل تلقائيّاً في كلّ جلسة. أضف CLAUDE.md داخل مجلّد فرعيّ ليتراكم عند العمل في تلك المنطقة. هذه بالضبط البنية التي يريدها الدماغ الثاني المبنيّ على Obsidian: ملفّ هويّة في الجذر مع سياقات تنشط تلقائيّاً حسب المجلّد. Custom GPTs من ChatGPT يحتاج إعداداً يدويّاً في واجهة ويب؛ Claude يقرأ من نظام الملفّات.

    2. Claude.ai Projects يحفظ السياق عبر الدردشات. ارفع ملفّاتك الأساسيّة الثلاثة (الهويّة، المشاريع، القرارات) مرّةً واحدةً إلى Project، وكلّ محادثة داخل المشروع ترث السياق بلا إعادة لصق. ChatGPT لديه Projects أيضاً، لكنّ تطبيق Anthropic أنظف, الملفّات تبقى متاحةً عبر عارض الملفّات، وحجم السياق سخيّ بما يكفي لتضمين الخزنة كاملةً عند الحاجة.

    3. Claude Skills (أُطلِقَت 2025) تُكَوَّم فوقه. Skills تتيح حفظ سير عمل, موجِّه + سلوك + صلاحيّات, لاستدعائه لاحقاً. Steph Ango (الرئيس التنفيذيّ لـ Obsidian) نشر مجموعة skills رسميّة لـ Obsidian تضيف قدرات تعي الخزنة. ادمج دماغك الثاني الشخصيّ (الهويّة/المشاريع/القرارات) مع skills قابلة لإعادة الاستخدام (التقاط، استرجاع، تلخيص)، وسيبدأ النموذج بالتصرّف كزميل عمل بأدوات مشتركة، لا كبوت دردشة بلا ذاكرة.

    أيّ منها بمفرده ليس تحوّلاً جذرياً. مجتمعةً تُزيل الاحتكاك بما يكفي ليصبح سير العمل عادةً بدل جهد.

    الإعداد، خطوة خطوة

    بافتراض أنّك قرأت المقال الأساسيّ و شرح القالب، هذه الطبقة الخاصّة بـ Claude.

    الخطوة 1: اختر وضع التحميل

  • معظم العمل برمجة: ثبّت Claude Code واحتفظ بالملفّات الأساسيّة الثلاثة في جذر كلّ مشروع كـ CLAUDE.md مع ملفّات تكميليّة. أضف CLAUDE.md خاصّ بكلّ مستودع يحتاج سياقاً إضافيّاً.
  • معظم العمل كتابة/دردشة: استخدم Claude.ai Projects. أنشئ Project لكلّ منطقة كبرى من حياتك ("عمل العملاء"، "كتابة شخصيّة"، "قبولي"). ارفع الملفّات الأساسيّة؛ أضف وصفاً للمشروع يلخّص ما يجب أن يفعله النموذج.
  • كلاهما: استخدم الاثنين. نفس ملفّات Markdown تعمل في الاثنين.

    • الخطوة 2: اعكس خزنة Obsidian إلى Claude

    لو احتفظت بدماغك الثاني في خزنة Obsidian، السؤال كيف تنقل الملفّات إلى سياق Claude. ثلاث خيارات عمليّة:

  • مزامنة git. أدخل الخزنة في مستودع git خاصّ. افتحه في Claude Code. كلّ شيء يعمل.
  • لصق يدويّ. لجلسات دردشة لمرّة واحدة، انسخ محتوى الملفّ في أعلى الموجِّه. بطيء لكن بلا إعداد.
  • رفع لـ Claude.ai Projects. اسحب الملفّات الثلاثة إلى Project. أعد الرفع عند تغييرات مهمّة (لا تحتاج إعادة رفع لكلّ تعديل).

    • أغلب الناس ينتهون باستخدام الثلاثة حسب الواجهة والمهمّة.

    الخطوة 3: أضف Obsidian Skills لـ Steph Ango

    لو كنت في Claude.ai أصلاً، ثبّت مجموعة Obsidian skills الرسميّة. تضيف إجراءات تعي الخزنة (التقاط، ربط، استرجاع) تتكامل مع سياقك الشخصيّ. التركيبة (ملفّاتك الشخصيّة + skills الرسميّة) هنا تكمن معظم القوّة.

    الخطوة 4: حدّد محفّز إعادة التحميل

    الانضباط الذي يفصل دماغاً ثانياً عاملاً عن آخر بائت هو محفّز إعادة التحميل. اختر واحداً:

  • مراجعة الجمعة عصراً الأسبوعيّة. افتح الخزنة، حدّث المشاريع النشطة، أعد الرفع لـ Project.
  • نهاية معلم مشروع. عند تسليم شيء، سجّل القرارات في decisions.md.
  • بدء أيّ ارتباط مع عميل جديد. أضف مجلّداً + CLAUDE.md للسياق الجديد.

    • لو لم تختر محفّزاً، تتحلّل الخزنة. السياق البائت أسوأ من لا سياق.

    ما يفعله Claude بشكل مختلف عمليّاً

    بعد وضع الإعداد، إليك ما يتغيّر في سلوك Claude:

  • يتوقّف عن إعادة اقتراح خيارات رفضتها سابقاً. لأنّ decisions.md يسرد المسارات المرفوضة مع الأسباب.
  • يطابق ستاكك بلا سؤال. "أبني شيئاً" → يفترض Claude Vite + Supabase + Tailwind لأنّ identity.md أخبره أنّ هذا الافتراضيّ.
  • يستخدم نبرتك. لو قال identity.md "مباشر، بلا حشو، اعترض إن لزم"، يفعل Claude. ChatGPT أيضاً، لكنّ افتراضيّات Claude تطابق هذا الأسلوب طبيعياً.
  • يسحب أوجه شبه بين المشاريع. عندما تتشابه المشاريع، يلاحظ Claude لأنّ projects.md صغير بما يكفي للاستدلال عبره.
  • ينبّه عندما يكون السياق بائتاً. لو قال projects.md إنّ مشروعاً "قيد العمل" بينما تشير رسالتك إلى أنّه سُلِّم، يسأل Claude عادةً. ChatGPT يميل إلى المسايرة.

    • تأثيرات صغيرة فردياً. متراكمة عبر آلاف التفاعلات، الفرق بين إنتاجيّة حقيقيّة ومسرحيّة ذكاء اصطناعيّ.

    ثلاث مزالق عند الانتقال من ChatGPT

    المنتقلون من سير عمل ChatGPT يصطدمون باستمرار بـ:

    المزلق 1: معاملة Custom GPTs و Projects كأنّهما متكافئان. ليسا كذلك. Custom GPTs نموذج GPT بـ system prompt. Claude Projects مساحات عمل بسياق ملفّات دائم ترثه أيّ دردشة فيها. لا تحاول إعادة بناء Custom GPT في Project, استخدم نظام الملفّات، لا system prompt.

    المزلق 2: حشو الخزنة. نافذة سياق Claude سخيّة، فيغوي الناس برفع كلّ شيء. لا. نفس قاعدة التنقية تنطبق: كلّ ملفّ تضمّنه ينافس على الانتباه. خزنة مركّزة بـ 30 ملفّاً تتفوّق على خزنة بـ 400 ملفّ في كلّ مرّة.

    المزلق 3: تخطّي CLAUDE.md لأنّه يبدو مكرَّراً. لو استخدمت Claude Code أصلاً، سمِّ ملفّ هويّتك CLAUDE.md وضعه في الجذر. التحميل التلقائيّ أكبر ترقية لسير العمل مقارنةً بالموجِّهات اليدويّة. من يتخطّى هذه الخطوة يبقى يتساءل لماذا يبدو إعداده أكثر فوضويّةً ممّا ينبغي.

    متى لا تستخدم Claude لهذا

    نقطة معاكسة صادقة: Claude ليس دائماً الأداة الصحيحة.

  • أنت غارق أصلاً في ChatGPT Teams أو Enterprise: تبديل الواجهة مكلف. ميزة Memory في ChatGPT تحسّنت بما يكفي ليصبح دماغ ثانٍ مبنيّ على ChatGPT عمليّاً، حتى لو كان Claude أنظف منفرداً.
  • تحتاج توليد صور أو تصفّحاً مضمّناً في نفس الواجهة. Claude لديه الاثنان عبر أدوات، لكنّ تجربة ChatGPT أكثر تكاملاً.
  • تختبر نموذجاً مفتوح المصدر محليّاً للخصوصيّة. Ollama + نموذج محلّيّ إعداد مختلف؛ المبادئ في هذا المقال تنطبق، لكنّ الأدوات مختلفة.

    • لأغلب المحترفين العاملين الذين يريدون من الذكاء الاصطناعيّ أن يتذكّر سياقهم ويتوقّف عن العموميّة، Claude + Obsidian + قالب الملفّات الثلاثة أنظف مسار.

    إلى أين بعد

  • ابدأ بـ قالب الملفّات الثلاثة لو لم تبدأ بعد.
  • اقرأ المقال الأساسيّ للفلسفة.
  • أضِف skills Obsidian الرسميّة لـ Steph Ango بعد إرساء الأساسيّات.

    • الأثر المتراكم حقيقيّ لكنّه يتطلّب شهر احتكاك أوّل. اعبره وسيصبح سير العمل غير مرئيّ.