How to Use Claude Code with Obsidian: Build an AI-Powered Knowledge Base (2026)

Obsidian users have been experimenting with AI integrations for a couple of years, but Claude Code changes the setup entirely. Instead of copy-pasting notes into a chat window, you can now point Claude directly at your vault and have it read, write, summarize, and cross-link your notes as part of a natural conversation.

If you've seen the "claude code obsidian" posts going around — from Steph Ango's workflow to the Reddit threads about using Claude as a daily journaling assistant — this guide is the practical setup reference. No plugin required, no API key juggling, works on Mac and Windows.

---

What You Actually Need

Before anything else, the short list:

• Claude Code — Anthropic's terminal-based AI coding assistant. Free tier available; Pro gives you 5× more context and unlimited file reading.
• Obsidian — local markdown note-taking app. Completely free, works on desktop and mobile.
• A terminal — Mac users have Terminal.app; Windows users need Windows Terminal or PowerShell. If you've never opened a terminal before, read our terminal beginner's guide first.
• Node.js — required to run Claude Code. Download from nodejs.org (LTS version is fine).

That's it. You don't need to install any Obsidian plugin, and you don't need a separate API key if you're using Claude Code's built-in Anthropic authentication.

---

Step 1: Install Claude Code

Open your terminal and run:

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

Once it's installed, authenticate:

claude

This opens a browser tab asking you to sign in with your Anthropic account. Accept, return to the terminal, and you're logged in. Claude Code stores your session locally — you won't need to log in again unless you explicitly sign out.

Verify it's working:

claude --version

You should see something like claude-code 1.x.x.

---

Step 2: Find Your Obsidian Vault Path

Your Obsidian vault is just a folder of markdown files on your local machine. To find it:

Mac: Open Obsidian → bottom-left gear icon (Settings) → "About" → look for the vault path, or use Finder to navigate to wherever you created the vault. A typical path looks like /Users/yourname/Documents/MyVault.

Windows: Open Obsidian → Settings → About. Path is typically something like C:\Users\yourname\Documents\MyVault.

Write down or copy that path — you'll use it in the next step.

---

Step 3: Start Claude Code in Your Vault

This is the core step. Instead of running Claude Code in a project folder full of code, you run it in your Obsidian vault:

cd /path/to/your/vault
claude

For example, on Mac:

cd ~/Documents/MyVault
claude

Once Claude Code starts, it can see every file in your vault. You can now ask it things like:

• "Summarize my notes from last week"
• "Find all mentions of 'quarterly review' across my notes and give me a summary"
• "Create a new note called 'AI workflow' that links to my existing notes on automation"
• "I have a note called daily-2026-06-07.md — can you add a summary section at the bottom based on what I wrote?"

Claude reads the actual files in your vault, writes back to them if you ask, and treats your notes as its working context.

---

Step 4: The Most Useful Things to Ask Claude

Once you're set up, here are the commands that actually save time:

Cross-link discovery:

Find notes that should probably link to each other but don't yet. List the pairs.

Obsidian's graph view gets a lot better once your notes are actually connected. Claude can spot the gaps faster than you can.

Daily note expansion:

Read today's daily note and expand the bullet points into full paragraphs I can review later.

If you write quick bullets during the day and want a more readable journal entry by evening, this handles it automatically.

Topic synthesis:

I've written a lot about [topic] across different notes. Write a new note called "[topic]-synthesis.md" that ties everything together.

This is the "second brain" use case that originally made Obsidian popular — Claude does the synthesis work.

Writing from your notes:

Based on everything I've written about [project], draft a one-page summary I can share with someone who hasn't seen my notes.

Works well for catching people up on a project or creating a deliverable from scattered research notes.

Tagging cleanup:

Go through my notes and suggest which ones are missing tags. List them with your suggested tags.

If your vault is a few hundred notes in, the tagging is probably inconsistent. Claude can audit the whole thing quickly.

---

Step 5: Setting Up a Daily Workflow

The most sustainable way to use this setup is with a short daily ritual rather than ad hoc sessions:

1. Morning: Start Claude in your vault, ask it to summarize anything flagged in yesterday's daily note.
2. Throughout the day: Write normally in Obsidian as you always have.
3. Evening: Ask Claude to cross-link anything new you wrote, expand any bullet points, and queue topics for tomorrow.

This takes about 5 minutes per session and keeps your vault genuinely useful rather than just a place where notes pile up.

---

What Claude Code Can and Can't Do with Obsidian

Can do:

• Read any note in your vault
• Write new notes or append to existing ones (with your confirmation)
• Search across all notes for a topic or keyword pattern
• Summarize, synthesize, or restructure content
• Suggest links between notes

Can't do (without extra setup):

• See your Obsidian plugins or plugin data (like Dataview queries or Kanban boards)
• Sync across devices on its own — your vault lives locally
• Access the Obsidian mobile app's notes if they're stored separately
• Use Obsidian's graph view or canvas features directly

For most note-taking workflows, these limitations don't matter. The core value is the ability to read and write plain markdown files in your vault, which is what Claude Code handles well.

---

Running This Without Claude Code Pro

The free tier of Claude Code works fine for a small vault (under a few hundred notes). If you start running into context limits — Claude tells you when it can't fit all the files you've asked about — that's the signal to consider upgrading.

Alternatively, you can scope Claude to a subset of your vault by running it from a subfolder:

cd ~/Documents/MyVault/Projects/CurrentProject
claude

This keeps the working context smaller and often makes responses faster and more focused.

---

A Quick Note on Privacy

Your notes stay local. Claude Code sends only what you actively ask about to Anthropic's servers for processing — it doesn't silently upload your entire vault. If you have notes you'd rather keep fully offline, keep them in a separate folder or vault outside the directory you run Claude Code from.

If local-only processing is a hard requirement, running a local model through LM Studio or Ollama is an alternative, though the quality of responses for document-heavy tasks is currently lower than Claude. We cover that setup in our LM Studio beginner guide.

---

Frequently Asked Questions

Do I need to know how to code to use Claude Code with Obsidian? No. You're just running it as a note-taking assistant, not writing code. The only technical step is installing Node.js and one terminal command. If you can follow the steps above, you're set.

Will Claude Code modify my notes without asking? Claude Code will suggest changes and show you what it would write, but it doesn't make file changes without confirmation unless you explicitly tell it to go ahead. You stay in control.

Can I use this with iCloud-synced Obsidian vaults on Mac? Yes. If your vault is in iCloud Drive, the path is usually ~/Library/Mobile Documents/iCloud~md~obsidian/Documents/VaultName. Run claude from there and it works the same way.

How much does Claude Code cost? The free tier is limited in context and monthly usage. The Pro plan ($20/month) gives you a 5× larger context window and effectively unlimited usage for personal workflows. For a vault of 300–500 notes, free is usually enough for occasional use; Pro makes sense if you're running daily sessions.

Is there an Obsidian plugin that does this without the terminal? There are plugins that connect to AI APIs directly inside Obsidian (Smart Connections and Text Generator are the most used). They work differently — they're better for single-note use cases. Claude Code's advantage is whole-vault awareness and the ability to write and reorganize across notes. Neither approach is strictly better; they're complementary.

Can I use this on Windows? Yes. Install Node.js from nodejs.org, open Windows Terminal or PowerShell, and run the same commands. The only difference is your vault path format (C:\Users\yourname\Documents\MyVault instead of a Mac-style path).