Claudian完全ガイド｜ObsidianでClaude Code・Codex・Grokを動かす使い方とインストール

Claudian（クローディアン） は、普段メモを書いているObsidianのフォルダの中で Claude Code / Codex を動かすためのOSSプラグインだ。本記事ではインストール手順・使い方・Codex連携まで日本語でまとめる。Claude Code全般の基礎は Claude Code｜2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き をあわせて参照してほしい。

Claudianとは：Vaultをエージェントの作業ディレクトリにするプラグイン

開発者YishenTu氏の Claudian は、Obsidian Vault（ノートのフォルダ）をそのまま Claude Code / Codex CLI の作業ディレクトリとして扱うTypeScript製プラグインだ。2026年7月30日時点でスター14,430・Fork 928。Vault配下のMarkdown・画像・スクリプト・PDFに対して、Claudeがファイル編集・Grep・Bashのツールを使って自律的に動く。.claude/ や .claudian/ をVault内に持ち、セッションやMCP設定をVault単位で管理できるので、研究ノート・技術ブログ・業務手順書といった用途ごとに独立した「AIワークスペース」を持てる。

解決するのはノート中心のワークフローの手作業だ。ターミナルとObsidianを往復すると、開いているノート・カーソル位置・関連ファイルという文脈が毎回途切れる。Claudianならノートを開いたまま横のサイドバーで指示でき、「あのノートを見て、このノートを直して」は @mention 一発で書ける。頻出作業はSkillsとして .claude/skills/ に保存すれば毎回同じ手順を再現でき、Plan Modeで計画を先に見せさせれば意図しないノートの書き換えを防げる。Daily/Weeklyノートの集計、リンク張り直し、フォーマット統一といった雑務スクリプトも自然言語指示で置き換えられる。

似た方向のツールにはターミナルネイティブの OpenCode もあるが、ObsidianのノートUIから使える点でClaudianは独自の位置にある。

Claudianの主要機能とアーキテクチャ

Skillsは Claude Skillsの仕組み と同じものなので、Claude Code本体で育てたスキル資産がObsidianでもそのまま使える。

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 を定義し、各プロバイダーがそれを実装する戦略パターンだ。新プロバイダーは ChatRuntime を満たすアダプタを書いて providers/registry.ts に登録すればよい。i18nは10ロケール対応で、日本語UIも使える。

Claudianのインストール手順と前提条件

モバイル非対応は要注意だ。Obsidian SyncでVaultを共有していても、.claude/ や .claudian/ が同期されるだけで、モバイル側でClaudian自体は動かない。

導入は4通り。最短はSettings → Community plugins → Browseで「Claudian」を検索してInstall → Enable。常に最新を追うならBRAT（Beta Reviewers Auto-update Tester）で、”Add Beta plugin” に https://github.com/YishenTu/claudian を入れる。2026年3〜4月だけでv1.3.71 → 2.0.2まで10回以上リリースが出たので、BRAT運用は現実的だ。版を固定したいときとソースから入れたいときは次のとおり。

# GitHub Release から手動配置（main.js / manifest.json / styles.css を
# https://github.com/YishenTu/claudian/releases/latest から取得）
mkdir -p /path/to/vault/.obsidian/plugins/claudian
cp ~/Downloads/main.js ~/Downloads/manifest.json ~/Downloads/styles.css \
  /path/to/vault/.obsidian/plugins/claudian/

# ソースからビルド（開発者向け）
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のパスを書くと、ビルド時に配置先までコピーされる。

つまずいたとき

spawn claude ENOENT / Claude CLI not found は、nvm・fnm・voltaなどNodeのバージョン管理ツールを使っていると頻発する。CLIのパスを特定し、Settings → Advanced → Claude CLI path に明示する。

Windowsでは .cmd ラッパーを避け、claude.exe か cli.js を直接指定する。npm版のCLIを使っていると、GUIのObsidianがPATHを解決できずNode.jsを見つけられないこともある。

dirname $(which claude)
dirname $(which node)

出力が違えば、ネイティブバイナリを入れる（推奨）か、Settings → Environment → Custom variables に PATH=/path/to/node/bin を足す。

ObsidianでCodexを使う：プロバイダーごとの違い

v2.0.0でCodexプロバイダーが統合され、2026年7月30日時点のREADMEでは Claude Code / Codex / Grok Build / Opencode / Pi の5系統が並ぶ（Claude以外はオプション）。Codex CLI を入れて codex が通ることを確かめ、Settings → Providers で有効化する（必要ならCLIのパスも指定）。プロバイダーはチャットタブごとに切り替えられる。Grok Build・Opencode・Piも同じく、grok / opencode / pi が通る状態にしてから有効化する。

Claudianの使い方：実践ユースケース

研究ノートの横断なら、チャットにこう投げる。Claudeは Glob と Grep でノートを走査し、[[ノート名]] のリンク記法つきで新規ノートを書く。

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

下書きの段落を選んでホットキーを押し、「キーワード『Claude Code MCP』を自然に2回含め、冒頭を数字で始め、200文字程度の常体で」と頼めば、単語単位のdiffを見て承認・却下・再生成できる。繰り返し作業はVault直下のSkillにする。

---
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` に追記（ファイルがなければ新規作成）

.claude/skills/daily-review/SKILL.md に置けば、/daily-review か「今日の振り返り」で呼べる。外部ツールはVaultの .claude/mcp.json に足す。

{
  "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に追記」「割り当て済みIssueを issues/ に同期」がチャットから呼べる。Vault配下のスクリプトをまとめて直すような大きな作業（requests → httpx の移行、型ヒント追加、テスト更新など）は、Shift+Tab でPlan Modeに入ってから「まず計画を提示して承認を得てから実装して」と頼む。

比較・セキュリティと、いつ選ぶべきか

純粋なソフトウェア開発なら Claude Code CLI単体やCursorの方が馴染む（コーディング用途の比較は Claude Code vs Cursor徹底比較）。研究・ライティング・PKMにエージェントを投入したいなら、Claudianの方がコンテキストが合う。Claude Code呼び出しのトークン節約プロキシ（RTK）やAnthropic公式Skillsのリポジトリは、Claudianの裏でもそのまま併用できる。

READMEの “Privacy & Data Use” のとおり、プラグイン自体にテレメトリは無いが、使用中はプロバイダーに通常のClaude Code/Codexと同じデータが送られる。

Enterprise用途なら、Obsidian Syncよりローカル暗号化ボリューム（VeraCrypt等）の方が安全だ。書き込みとbashの権限を渡すツール全般と同じく、承認フローの設計がそのまま安全性を決める。

・選ぶべき：Obsidianがメインの作業環境で、数百〜数千ノートが蓄積されている。コード・設定・文書を同じVaultで管理し、SkillsやMCP設定をVault単位で持ちたい
・選ばない方がよい：ターミナルに留まりたい（→ CLI単体）、エディタ中心（→ Cursor、VS Code + Claude拡張）、Logseq・Notionなど別ツール、モバイル中心、ノートへの書き込み権限をAIに渡したくない（→ 挿入のみのプラグイン）

最新版v2.0.41は2026-07-24で、7月だけで2.0.33〜2.0.41と刻むように更新されている。BRATで追いかけながら、Vaultの .claude/skills/ に自分のスキルを貯めていくのが素直な使い方だ。

参照ソース

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