跪拜 Guibai
← Back to the summary

Obsidian Notes Now Run Your Existing Claude Code and Codex Subscriptions Directly

Don't Spend an Extra Cent on API Fees: Build an AI Personal Knowledge Base with Your Existing Claude Code / Codex / Cursor

Many developers already subscribe to Claude Code, Cursor, or Codex for writing code, but when building a local AI personal knowledge base, they either end up copying and pasting between a web chat window and local Markdown files, or they have to set up a separate API key for their note-taking software and pay extra.

If you use Obsidian (a free, fully local Markdown double-link knowledge base software) to keep project notes or reading notes, or are planning to set up a local personal knowledge base, try the open-source plugin Oh My Claudian. It doesn't require you to re-add a card or buy an extra notes-AI membership. It directly reuses the Claude Code, Codex, Cursor Agent and 8 other coding agents already configured on your machine (using each tool's existing subscription or account quota): you can use @ in the sidebar to reference multiple notes in conversation, expand cards to view file modification diffs, do inline edits on selected paragraphs, and also call Obsidian's native interfaces to maintain double-links and Frontmatter properties.

Obsidian 中的 Oh My Claudian：左侧为笔记，右侧为对话与展开的文件修改 Diff

Image: Oh My Claudian's actual interface: on the left is the note body, on the right you can @-reference notes directly and view Diff cards for file modifications.

The 4 handiest features

1. Directly reuse the 8 Agent CLIs already on your machine

Many AI plugins require you to fill in a separate API key and Base URL. Oh My Claudian directly reuses the Agent CLIs already on your computer. It currently supports 8 providers:

As long as these tools work with your normal terminal login, the plugin can directly reuse their existing authentication, model catalog, permission policies, /commands (slash commands), Skills, and MCP services. The plugin settings also include a Readiness (status check) that automatically verifies whether the CLI is available and the model catalog is loaded. Supported CLIs can even be installed or updated directly from the interface.

2. See diffs when files change, and save chat conclusions to notes in one click

When you put an Agent inside note software, the biggest fear is it silently messes up your existing layout or content. Oh My Claudian provides three controlled interaction methods:

3. Natively understands Obsidian double-links and properties

If you let a plain command-line tool rename or move Markdown files directly in the folder, Obsidian's [[double links]] break easily.

In Claude Code, Codex, DeepSeek Harness, OpenCode, and Pi, Oh My Claudian integrates Obsidian's native repository operations: the Agent can inspect a note's backlinks, add or modify Frontmatter properties at the top of notes (set-property), move or rename files through Obsidian's interface and automatically update all library links (move), and move files to Obsidian's trash (trash).

4. Collapse the sidebar and it becomes a floating Zen Mode window

When you find the sidebar takes up too much space, just collapse the sidebar where Oh My Claudian lives. The current conversation automatically becomes a lightweight floating panel above your note (Zen Mode). You can keep reading long documents and asking questions. Streaming replies, input drafts, and pending permission approvals stay in the same session. Double-click the bottom handle or press the Home key to pin it back to the bottom center.

Get started in 3 steps

Before using, confirm your Obsidian desktop version is ≥ 1.7.2, and that you have installed and logged in at least one supported CLI in your terminal (e.g., claude or codex works in conversation).

  1. Install the plugin: open Obsidian Settings → Third-party plugins → Browse, search for Oh My Claudian, click install, and enable it (or go directly to the Obsidian plugin store page).
  2. Enable a provider: open Settings → Oh My Claudian → Providers, turn on the tool you use (e.g., Claude Code or Codex), click Readiness to check the environment, and select the models you want to show in the chat box from the model list.
  3. Send your first message: run Oh My Claudian: Open chat view from the left ribbon or the command palette, type @ to attach a note, and send a read-only instruction first:
Please summarize this note in three points, attach source note links, and suggest a next step. Do not modify any files first.

Once you confirm you get a reply with [[note links]] correctly, you can let it write action items into the target note.

Two common configuration pitfalls

1. claude / codex runs in the terminal, but the plugin says it can't find the CLI?

Obsidian launched from a desktop icon often gets a different PATH than your terminal. Run which claude in the terminal (Windows uses where.exe claude) to get the absolute path, then fill it into the plugin's corresponding provider setting under Absolute path to CLI executable.

2. Claude Code works with subscription login in the terminal, but the plugin reports authentication_failed?

This is usually because there is a leftover ANTHROPIC_API_KEY or ANTHROPIC_AUTH_TOKEN in your system environment variables that overrides the CLI's own subscription login. Open Settings → Oh My Claudian → Providers → Claude Code → Environment → Custom variables, and give the conflicting variable an empty value (this only affects Claude Code inside the plugin, not other system tools):

ANTHROPIC_API_KEY=

Project address

Oh My Claudian is forked from Yishen Tu's Claudian and independently maintained. It is open source under the MIT license, local-first, sends no plugin telemetry, and its interface includes Simplified Chinese plus 9 other languages (10 total).

If you heavily use Obsidian and already subscribe to Claude Code, Codex, or Cursor, give it a try; if it feels handy, you are welcome to give the project a star on GitHub.