Claudian｜ObsidianでClaude Codeを動かすプラグイン — チャット・編集・MCP連携の使い方

この記事ではClaude Codeに特化して解説します。Claude Code全般は Claude Code完全ガイド2026：インストールから本番運用まで をご覧ください。

Claudianとは：Obsidian VaultをAIエージェントの作業環境に変えるOSSプラグイン

2026年4月時点でGitHubスター7,700超、Obsidianコミュニティで急速に普及しているプラグインがある。開発者YishenTu氏が公開している Claudian は、Obsidian Vault（ノートのフォルダ）をそのまま Claude Code / Codex CLI の作業ディレクトリとして扱えるTypeScript製プラグインだ。普段メモを書いているフォルダの中で、AIエージェントがファイルを読み書き・検索し、bashコマンドを実行し、マルチステップのワークフローを回す。

これまで Obsidian 内の AI プラグインは「AIで文章生成してカーソル位置に挿入する」が主な用途だった。Text Generator や Copilot for Obsidian は Chat機能や生成機能を提供するが、ファイルシステムへの書き込み・検索・bash実行といった「エージェント」としての挙動はサポートしていない。Claudianの最大の差別化点は、Claude Codeの強みである「ローカルファイルを扱うエージェントランタイム」をそのまま Obsidian に取り込んだ点にある。

Vault配下のMarkdown・画像・スクリプト・PDFに対して、Claudeがファイル編集ツール・Grepツール・Bashツールを使って自律的に動く。 .claude/ や .claudian/ ディレクトリをVault内に持ち、セッションやMCP設定を Vault 単位で管理できるため、研究ノート・技術ブログ・業務手順書といった用途ごとに独立した「AIワークスペース」を持てる。

類似の方向性を目指すツールとしては、ターミナルネイティブの OpenCode や、Everything Claude Code で紹介したClaude Codeエコシステムの派生ツール群がある。ObsidianのノートUIから使えるという点でClaudianは独自のポジションを占める。

なぜ「Obsidian × Claude Code」なのか

ターミナルで動く Claude Code が既に強力なのに、わざわざObsidianに組み込む意味は何か。答えは「編集対象と参照対象が一致する環境にエージェントを置く」ことの価値だ。

Obsidianは知識労働者が使う「第二の脳」として広く採用されている。研究ノート、読書メモ、ブログ下書き、会議録、コードスニペット、タスク管理まですべてがMarkdownファイルとして蓄積される。この Vault に対して従来のAI連携は、次の3パターンに留まっていた。

Claudianは、これらのどれにも属さない「エージェントランタイム型」という第4のカテゴリーを切り開いた。ノートを読み、別のノートに書き、grepで全体を検索し、bashでスクリプトを動かし、複数ステップの作業を自動化する。Claude CodeのReact/Actループがそのままノート作業にマッピングされる。

具体的な変化

• 論文レビュー: PDFからメモした研究ノート群を Claude に渡し、「最近3ヶ月に読んだRAG関連論文を横断して、まだ試していない手法を抽出して新ノートにまとめて」と指示すると、grepで関連ノートを探し、差分を計算し、新規ノートを作成するところまで一貫実行する。
• ブログ執筆: 下書きノートを選択し、インライン編集で「この段落をよりSEO向けに、キーワード Claude Code MCP を自然に含むよう書き換えて」と依頼すると、単語単位のdiffプレビューで提案が表示され、承認/却下/再生成できる。
• タスク管理: Daily Note から「今週やり残したタスクを別のWeekly Noteに集約して、優先度順に並べて」と指示すると、複数ファイルを横断してチェックボックス済み/未済の差分を集計する。

これらはClaude Code Auto Modeで解説したエージェント型実行をObsidianのUIから呼び出す形だ。ターミナルで claude と打つ代わりに、ノートを開いたままサイドバーでエージェントに話しかける。

主要機能の全体像

Claudian の機能は大きく分けると6つのレイヤーで構成される。

READMEで列挙されている主要機能を、実際の操作イメージと対応させて整理する。

1. Chat Sidebar（サイドバーチャット） — Obsidianのリボンアイコンまたはコマンドパレットからチャットを開く。会話はタブで並列管理でき、各タブは独立したセッションとして ~/.claude/projects/ または ~/.codex/sessions/ に保存される。ノートを開いたまま横にチャットを置いておける。

2. Inline Edit（インライン編集） — ノート内でテキストを選択して設定したホットキーを押すと、単語単位のdiffプレビューが表示されるモーダルが立ち上がる。「この段落を丁寧な口調に書き換えて」「このコードサンプルを TypeScript にポーティングして」といった指示で、選択範囲だけをピンポイントに書き換えられる。差分を見てから承認するので、意図しない書き換えを防げる。

3. Slash Commands & Skills（スラッシュコマンドとスキル） — チャット入力で / または $ を入力すると、再利用可能なプロンプトテンプレートやSkillsの一覧が表示される。スコープは「ユーザーレベル（~/.claude/skills/）」と「Vaultレベル（<vault>/.claude/skills/）」の2階層。Claude Skillsの仕組みをそのまま活用できるため、Claude Code本体で育てたスキル資産がObsidianでも使える。

4. @mention（メンション参照） — @ を入力すると、Vault内のファイル、サブエージェント、MCPサーバー、外部ディレクトリのファイルを参照先として選べる。「@daily/2026-04-14.md の内容を要約して @weekly/2026-W15.md に追記して」といった複数ファイル間の処理が自然な表現で書ける。

5. Plan Mode（プランモード） — Shift+Tab でトグル。エージェントが即座にコードや編集を始めるのではなく、まず「何をどう変更するか」を設計し、承認を得てから実装するモード。大きな変更や複数ファイルにまたがる作業で暴走を防ぐ。[Autonomous Claude Code](/2026/03/25/news-claude-code-auto-mode/)のようなフル自動モードの対極にあたる、慎重運転用のUI。

6. Instruction Mode #（指示モード） — チャット入力で # から始まる行は、そのスレッドのカスタムインストラクションとして追加される。「# 常に日本語で答えて。コードコメントは英語」のような指示を、CLAUDE.mdを編集せずにセッション単位で足せる。

7. MCP Servers（MCPサーバー連携） — Model Context Protocol 経由で外部ツールを接続できる。stdio / SSE / HTTP の3方式に対応。Claudianの場合、Vault配下のMCP設定は本体アプリが管理するが、Codexプロバイダー側はCodex CLIが管理するMCP設定をそのまま使う（ここは差分があるので注意）。MCPマネージャーなどの外部ツールと組み合わせると管理が楽になる。

8. Multi-Tab & Conversations（マルチタブと会話管理） — タブごとに独立した会話、履歴、fork（分岐）、resume（再開）、compact（圧縮）が使える。長い議論の途中で別アプローチを試したくなったら fork して並行、飽きたら resume で戻せる。

インストール手順

Claudian は3つの方法でインストールできる。用途と頻度に応じて選ぶ。

方法1: GitHub Release から手動インストール（推奨）

最も安定した方法。本番用途で固定バージョンを使いたいときに選ぶ。

# 1. リリースページから最新の main.js / manifest.json / styles.css をダウンロード
# https://github.com/YishenTu/claudian/releases/latest

# 2. Vault内にプラグインフォルダを作成
mkdir -p /path/to/vault/.obsidian/plugins/claudian

# 3. ダウンロードしたファイルを配置
cp ~/Downloads/main.js /path/to/vault/.obsidian/plugins/claudian/
cp ~/Downloads/manifest.json /path/to/vault/.obsidian/plugins/claudian/
cp ~/Downloads/styles.css /path/to/vault/.obsidian/plugins/claudian/

# 4. Obsidianを起動 → Settings → Community plugins → Claudianを有効化

方法2: BRAT（Beta Reviewers Auto-update Tester）経由

自動アップデートが効くため、常に最新版を追いかけたい場合に便利。

1. コミュニティプラグインから「BRAT」をインストール
2. BRATを有効化
3. BRATの設定を開く → "Add Beta plugin"
4. リポジトリURLを入力: https://github.com/YishenTu/claudian
5. "Add Plugin"をクリック → Claudianが自動インストールされる
6. Settings → Community plugins → Claudianを有効化

BRATは新バージョンがリリースされると通知してくれるため、開発速度の速いプラグインをキャッチアップするのに向く。Claudianは2026年3月から4月にかけてv1.3.71 → 2.0.2までマイナーリリースが10回以上出ており、BRAT運用が現実的だ。

方法3: ソースからビルド（開発者向け）

コードを改変したい、最新のmainブランチで試したい場合に使う。

# Vaultのプラグインフォルダに移動
cd /path/to/vault/.obsidian/plugins

# クローン
git clone https://github.com/YishenTu/claudian.git
cd claudian

# 依存関係インストールとビルド
npm install
npm run build

# 開発モード（ファイル変更を監視）
npm run dev

.env.local.example を .env.local にコピーしてVaultのパスを指定しておくと、ビルド時に自動で配置先までコピーされるように設定できる。

前提条件

• Claude プロバイダー: Claude Code CLI のインストール（native installを推奨）。Anthropic Claude のサブスクリプション/API、または Openrouter、Kimi など互換プロバイダーを使う
• Codex プロバイダー（オプション）: Codex CLI のインストール
• Obsidian: v1.4.5 以上
• プラットフォーム: デスクトップのみ（macOS / Linux / Windows）。モバイル版Obsidianでは動作しない

モバイル非対応は要注意。Obsidian Sync でVaultをモバイルと共有している場合、.claude/ や .claudian/ ディレクトリは同期されるが、モバイル側でClaudian自体は動かない。

Claude Code CLI 単体 vs Cursor vs 他プラグインとの比較

ツール選定の視点で整理する。

Claudianのスイートスポットは、「ノート中心のワークフローを持つユーザーが、ノート資産に対してAIエージェントを走らせたい」ケースだ。純粋なソフトウェア開発なら Claude Code CLI 単体や Cursor の方が馴染む。逆に、研究・ライティング・PKM（Personal Knowledge Management）的な作業にAIエージェントを投入したいなら、Claudianの方がコンテキストが合う。

ちなみに Cursor との比較は Claude Code vs Cursor徹底比較 で詳しく扱っているので、コーディング用途で迷う場合はそちらも参照。

実践ユースケースと具体的な使い方

READMEが網羅している機能を、現実のワークフローにどう組み立てるか。

ユースケース1: 研究ノートを横断して仮説を抽出

Vault内の research/ フォルダに数十本の論文メモがある状態で、次のようにチャットに投げる。

@research/ 配下のMarkdownノートを全てgrepして、
「Retrieval-Augmented Generation」に関する未検証の手法をリストアップ。
結果は @insights/rag-hypotheses-2026Q2.md に箇条書きで新規作成。
各項目には出典ノートへのObsidianリンク[[ノート名]]を必ず添える。

Claudeは Glob と Grep でノートを走査し、新規ノートに結果を書き込む。[[ノート名]] のObsidianリンク記法も認識してくれるため、生成されたノートから出典ノートへジャンプできる。

ユースケース2: 下書きをインライン編集で仕上げる

ブログ下書きを開いて段落を選択、ホットキーを押す。

選択した段落をSEO観点で以下のように書き換えて:
- キーワード「Claude Code MCP」を自然に2回含める
- 冒頭を数字で始める
- 200文字程度
- 常体で

単語単位のdiffが表示されるので、気に入らなければ却下・再生成。気に入れば承認で差し替わる。

ユースケース3: Skills で繰り返し作業を自動化

Vault直下に .claude/skills/daily-review/SKILL.md を作成する。

---
name: daily-review
description: 当日のDaily Noteと作業メモから週次レビュー用サマリーを生成するスキル。"daily review"や"今日の振り返り"と言われたら自動で呼び出す。
allowed-tools: Read, Glob, Write
---

## 手順

1. `daily/$(date +%Y-%m-%d).md` を読む
2. `work-log/*.md` のうち今日のタイムスタンプを持つエントリを grep
3. 完了タスク・未完タスク・学びをそれぞれセクション分け
4. `weekly-drafts/$(date +%Y-W%V).md` に追記（ファイルがなければ新規作成）

チャットで /daily-review と入力、または「今日の振り返り」と話しかけるだけで、Claudeが自動判断して呼び出す。Skillsの詳しい書き方はClaude Skills完全解説を参照。

ユースケース4: MCPサーバーで外部APIと繋ぐ

Vaultに .claude/mcp.json を作成して、外部MCPサーバーを追加する。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-notion"],
      "env": {
        "NOTION_TOKEN": "secret_xxxxxxxx"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxx"
      }
    }
  }
}

これで「Notionのプロジェクトデータベースから未着手タスクを取得して今日のDaily Noteに追記」「GitHubの割り当て済みIssueをVaultの issues/ に同期」といった操作がチャットから呼べる。Codexプロバイダーを使う場合は、CodexCLI 側の設定ファイル ~/.codex/config.toml に書く点に注意。

ユースケース5: Plan Mode で大規模リファクタ

Vault配下のスクリプトをまとめてリファクタしたいとき、Shift+Tab で Plan Mode に入ってから依頼する。

scripts/ 配下のPythonスクリプト全てを、
- requests から httpx に移行
- 型ヒントを全関数に追加
- テストも対応する形で更新

まず計画を提示して承認を得てから実装を始めて。

Claudeはまず Read / Glob で対象を把握し、変更計画を箇条書きで提示する。承認してから実装が走るため、エージェントが意図外のファイルを触るリスクを抑えられる。

トラブルシューティング

READMEに記載された代表的なハマりどころと対処法を整理しておく。

spawn claude ENOENT / Claude CLI not found

Claudianが Claude CLI を自動検出できないときに出る。nvm、fnm、voltaなどNodeバージョン管理ツールを使っている場合に頻発する。

対処: CLIのパスを特定して Settings → Advanced → Claude CLI path に明示的に設定する。

Windowsでは .cmd ラッパーを避ける。claude.exe または cli.js を直接指定する。

npm CLI と Node.js が別ディレクトリ

npmインストール版のCLIを使っている場合、GUIアプリのObsidianが PATH を解決できず Node.js を見つけられないことがある。

# CLIとNodeの位置を確認
dirname $(which claude)
dirname $(which node)

出力が異なる場合、次のどちらかで対応する。

1. 推奨: ネイティブバイナリをインストール（nvm/fnmのNodeを経由しない）
2. Settings → Environment → Custom variables に PATH=/path/to/node/bin を追加

Codex プロバイダーのトラブル

v2.0.0で追加されたCodex統合はまだ「様々なプラットフォーム・インストール方法での検証が継続中」と README に明記されている。動作が不安定な場合は GitHub Issues に報告すると作者が直接対応しやすい。

アーキテクチャ：プロバイダー抽象化の設計

v2.0.0の大きな変更はマルチプロバイダーアーキテクチャへのリファクタだった。src/ の構造を見ると設計思想が明確に読み取れる。

src/
├── main.ts                      # プラグインエントリポイント
├── app/                         # 共通デフォルトとプラグインレベル永続化
├── core/                        # プロバイダー中立のランタイム・レジストリ・型契約
│   ├── runtime/                 # ChatRuntimeインターフェイスと承認型
│   ├── providers/               # プロバイダーレジストリとワークスペースサービス
│   ├── security/                # 承認ユーティリティ
│   └── ...                      # commands, mcp, prompt, storage, tools, types
├── providers/
│   ├── claude/                  # Claude SDKアダプタ、プロンプト符号化、ストレージ、MCP
│   └── codex/                   # Codex app-serverアダプタ、JSON-RPCトランスポート、JSONL履歴
├── features/
│   ├── chat/                    # サイドバーチャット：タブ、コントローラ、レンダラー
│   ├── inline-edit/             # インライン編集モーダルとプロバイダーバックの編集サービス
│   └── settings/                # プロバイダータブ付き設定シェル
├── shared/                      # 再利用可能なUIコンポーネントとモーダル
├── i18n/                        # 国際化（10ロケール対応）
├── utils/                       # 横断ユーティリティ
└── style/                       # モジュラーCSS

core/runtime/ が ChatRuntime インターフェイスを定義し、providers/claude/ と providers/codex/ がそれを実装するという典型的な「戦略パターン」構成だ。新プロバイダーを追加したければ、ChatRuntime を満たすアダプタを書き、providers/registry.ts に登録すればよい。この抽象化のおかげで、ロードマップの「更に多くのプロバイダー追加」が現実的な作業で済む。

i18nが10ロケール対応しているのも興味深い。Obsidianプラグインとしては例外的に国際化に力が入れられており、日本語UIも利用できる。

セキュリティとプライバシー

READMEの “Privacy & Data Use” 節で明記されている通り、Claudianはプラグイン自体にはテレメトリが一切ない。ただし使用中はAPIプロバイダー（Anthropic、OpenAI、または互換先）に通常のClaude Code/Codexと同じデータが送信される点には留意する。

機密情報を含むVaultで使う場合のチェックリスト。

• .gitignore に .claudian/、.claude/ を追加（トランスクリプトがGitに混入しないよう）
• MCPサーバーの env にトークンを直書きしない（.env から読ませる・環境変数を使う）
• Plan Mode を標準で有効にして、承認なしでの bash 実行を止める
• Enterprise 用途では Obsidian Sync よりローカル暗号化ボリューム（VeraCrypt等）の方が安全

Claude Codeのセキュリティ運用と同様、エージェントに強い権限を与える以上、承認フローの設計がそのまま安全性を決める。

類似ツールとの使い分け

Claudianと併用・使い分けを考えたい周辺OSSを挙げる。

• Claude Code CLI本体: ターミナルに閉じた開発作業はCLIのほうが高速。Claudianはノート作業に寄せた拡張として位置付けるのが自然。
• OpenCode: ターミナルベースのClaude Code代替。Obsidianを使わないならこちら。
• RTK (Rust Token Killer): Claude Code呼び出し時のトークン節約プロキシ。Claudianの裏で併用できる。
• Harness Engineering系ツール: エージェント実行環境を強化する周辺ツール群。
• Anthropic公式 Skills: Skills公式リポジトリ。ここにあるSkillsをVaultの .claude/skills/ にコピーすればClaudianから即使える。

Vault を「ナレッジベース × エージェント実行環境」として捉え直すと、単独ツールではなくエコシステムの一部として Claudian を置く発想になる。

いつ Claudian を選ぶべきか、選ばないべきか

選ぶべきケース

• 日常的にObsidianをメインの作業環境として使っている
• 既存のVaultに数百〜数千ノートが蓄積されており、それを活用したい
• コード・設定・文書を同じVaultで管理している
• Claude Codeのエージェント能力をノート作業に持ち込みたい
• Skills や MCP 設定を Vault 単位で管理したい

選ばない方がよいケース

• 純粋なソフトウェア開発ワークフローでターミナルに留まりたい → Claude Code CLI単体
• エディタ中心で進めたい、Pythonコード補完が主 → Cursor、VS Code + Claude拡張
• Obsidian以外（Logseq、Notion等）を使っている → 対応プラグインがない
• モバイル中心でObsidian Mobileを多用する → デスクトップ専用なので不向き
• ノートへの書き込み権限をAIに与えるのが怖い → 従来型の「挿入のみ」プラグインが安全

関連記事: Claude Code完全ガイド2026：インストールから本番運用まで

まとめ：Obsidianエージェント時代の幕開け

Claudianは、Obsidianという「知識の貯蔵庫」を「エージェントの作業環境」へと転換させるプラグインだ。従来のObsidian AIプラグインが「AIに書かせる」だったのに対し、Claudianは「AIに働かせる」を可能にする。

• Vault をそのまま Claude Code / Codex の作業ディレクトリにマッピング
• チャット・インライン編集・Slash/Skills・@mention・Plan Mode・Multi-Tabの6つのUIプリミティブ
• v2.0.0 でマルチプロバイダー（Claude + Codex）に刷新
• MCP、Skills、Subagent といった Claude Code エコシステムを Vault 内で再利用可能

2026年4月時点でスター7,700超、v1.3.72からv2.0.2まで2週間で11リリースと開発ペースが早い。BRATで追いかけながら、Vault の .claude/skills/ にあなた自身のスキルを貯めていけば、ノートが溜まるほどエージェントが賢くなる「複利効果」が得られる。

Claude Code ベストプラクティス2026やClaude Skills完全解説と合わせて読み、Obsidian中心のAIワークフローを組み立ててみてほしい。

参照ソース

• YishenTu/claudian - GitHub
• Claudian Latest Release (v2.0.2)
• Claude Code 公式ドキュメント
• Codex CLI - openai/codex
• Obsidian Plugin API
• Claude Agent SDK - Anthropic
• Model Context Protocol
• BRAT - Obsidian42