Obsidianを生成AIに任せる入門 — 公式CLIでClaude Codeに保管庫を育てさせる

Obsidianという名前は界隈で見るたびに気になっていたけれど、結局それが何者なのかを掴めないまま使わずに来た。今回ようやく重い腰を上げたのは、会社でObsidianが話題に上ったのがきっかけだ。そして調べてみると、2026年2月27日にObsidian 1.12.4で公式CLIが全ユーザーに開放されていた。これで保管庫（Vault）を「ファイル」ではなく「起動中のObsidianプロセス越し」にClaude CodeやCodexから操作できる、というのが今回の本題になる。

この記事は「これからObsidianを入れる自分」を読者にした実装ログだ。実際にこの記事を書いている裏で、Obsidian 1.12.7をWindowsに入れ、WSL2からCLIを叩き、Claude Codeに保管庫を分類させ、最終的に保管庫直下に CLAUDE.md を置くところまで進めた。1時間ほどでそこまで行ける。

🗂️ Obsidianとは何者か

Obsidianは、ローカルのフォルダ（保管庫＝Vault）にプレーンテキストのMarkdownファイルを置いて、その上に検索・リンク・グラフ表示・プラグインを乗せていく個人向けノートアプリだ。クラウド前提のNotionやScrapboxと違って、ファイルは自分のディスクに存在し続ける。Markdownなので、別のエディタやスクリプトからも普通に開ける。

特徴を雑にまとめると次のあたりになる。

保存先は手元のフォルダ。サインアップなしで動く
ノート同士を[[ノート名]]形式のwikilinkでつなげる
リンクの集合をグラフビューで眺められる
コミュニティプラグインを入れて機能を足せる
macOS / Windows / Linux / iOS / Androidのデスクトップ・モバイルが公式提供

公式の言い回しを借りると “Free without limits”、つまり個人利用は無料で機能制限なしだ。

💴 料金プラン

公式ページが見にくいので先に整理する（2026年5月時点、すべて米ドル）。

個人利用: 無料。サインアップ不要、機能制限なし
Obsidian Sync: 年払いで月$4、月払いで$5。デバイス間の同期、エンドツーエンド暗号化、バージョン履歴、共有保管庫での共同編集
Obsidian Publish: 年払いで月$8、月払いで$10。ノートをWeb公開、カスタムテーマ、サイト内検索
Catalyst: 一括$25。ベータビルドへの早期アクセスとコミュニティバッジ
Commercial License: 1ユーザー年$50。業務利用向け

個人で始めるなら無料のまま使い、モバイル含めたデバイス間同期が欲しくなったらSyncを契約する、というのが素直な進め方になる。

🛠️ インストールして保管庫を作る

ダウンロードから保管庫作成までは10分かからない。実際にやった手順はこうだ。

obsidian.md からWindowsインストーラを落として実行。最新は1.12.7だった
起動時のクイックスタートから「保管庫を新規作成する」→ 作成
保管庫名は notes、場所はユーザーホーム配下のローカルフォルダを指定。ここが重要だった

迷ったのは保管庫の置き場所だ。OneDriveや iCloud Drive配下に置けば同期は楽になるが、Obsidianの場合は推奨されない理由がいくつかある。

.obsidian/workspace.json 系の設定ファイルをObsidianが頻繁に書き換える。OneDriveの同期と競合してプラグインの状態やテーマが壊れる事例が多い
Windowsの「ファイルオンデマンド」で実体がない状態が生まれ、Obsidianの索引が誤動作することがある
OneDriveのモバイルアプリ経由でObsidianモバイル版に同期させる手段がない

なので最初からユーザーホーム配下のローカルに置き、必要なら別途 git init してprivateリポジトリにpushする運用にした。これでバージョン履歴も無料で手に入る。.gitignore に .obsidian/workspace* .obsidian/cache を入れておけば、UI状態だけ除外して本文だけバージョン管理できる。

⌨️ 公式CLIを有効化する

Obsidian公式CLIはバージョン1.12.0（2026年2月10日、Catalyst早期アクセス）でデビューし、1.12.4（2026年2月27日）で全ユーザーに開放された。設計の肝は「外からファイルを直接いじるのではなく、起動中のObsidianに対してコマンドを送る」こと。直接ファイルを書き換えるとwikilinkや索引が壊れがちだが、CLI経由ならObsidian内部のAPIを通るので整合性が保たれる。

有効化手順は3つだけ。

Obsidianを1.12.4以上に上げる（最新は1.12.7）
設定 → 一般 → 一番下までスクロール → 「コマンドラインインターフェース」の CLIを登録 をON
PowerShellで obsidian version を叩き、1.12.7 (installer 1.12.7) のように返ればOK

Windows では Obsidian.exe そのものがターミナルリダイレクターを兼ねる。インストール先のパスは where.exe obsidian で確認できる。

普段の作業がWSL2側なので、WSL2からも obsidian を叩けるようにシンボリックリンクを張る。確認したWindows側パスを /mnt/c/... 形式に置き換えて、次のように繋ぐ。

1
2
3
sudo ln -sf "/mnt/c/<確認したパス>/Obsidian.exe" /usr/local/bin/obsidian
obsidian version  # 1.12.7 (installer 1.12.7) と返れば成功
obsidian vault    # 保管庫名・パス・ファイル数が一覧で返る

ここまで来れば、WSL2のどこからでも保管庫の中身を読み書きできる状態になる。

📜 揃っているコマンド群

CLIは8カテゴリに分かれていて、ノートに対するほぼ全部の操作がコマンド経由でできる。

区分	主なコマンド	用途
ファイル操作	`files` `read` `create` `move` `delete` `append`	ノートのCRUD
プロパティ	`property:set` `property:remove`	frontmatterの追加・更新
検索	`search` `search:context`	全文検索・前後文脈付き
タグ	`tag` `tags:rename`	タグの確認・リネーム
リンク	`links` `backlinks` `orphans` `unresolved`	リンク調査
デイリーノート	`daily:append` `daily:read`	日次ノート操作
プラグイン	`plugin:enable` `plugin:disable`	プラグイン制御
開発	`eval` `devtools` `dev:screenshot`	デバッグ・内部API直叩き

obsidian help で一覧が出る。最初に覚えておきたいのは、ファイル移動を mv ではなく obsidian move でやる流儀だ。mv でも動くは動くが、リンクの貼り替えやインデックスの再構築が起きないので、後日wikilinkが切れていることに気づく羽目になる。

実際に手で叩くとこんな感じだ。

1
2
3
4
5
6
7
$ obsidian files --vault notes path=inbox
inbox/Claude Code連携を試す.md
inbox/今日の天気.md
inbox/読書メモ.md

$ obsidian read --vault notes path="inbox/読書メモ.md"
情報整理術の本を読んだ。Zettelkasten方式が気になる。

人間が読める素直なテキストとして返る。Claude Codeはそのまま読めるし、--json を付ければ機械処理向けの形にもなる。

🤖 最初の実験：Claude Codeにinboxを分類させる

最低限のセットアップが終わったところで、いきなり「整理」を試した。

inbox/ にテスト用のメモを3つ放り込む。

1
2
3
obsidian create --vault notes path="inbox/Claude Code連携を試す.md" content="..."
obsidian create --vault notes path="inbox/今日の天気.md" content="..."
obsidian create --vault notes path="inbox/読書メモ.md" content="..."

そのうえでClaude Codeにこう頼んだ。

WSL2の obsidian CLI が使える。保管庫名は notes。 obsidian files --vault notes path=inbox でinbox/のファイル一覧を取り、 obsidian read で内容を読んで、 tech/ life/ study/ のどこに分類するか提案だけして。実行はしないで。

返ってきたのは、各ファイルの内容を読んで分類提案を整理したテーブルだった。具体的にはこんな出力が来た。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
| ファイル                              | 内容                       | 提案先   | 理由               |
|---|---|---|---|
| inbox/Claude Code連携を試す.md       | Obsidian CLI + Claude Code | tech/    | ツール・開発まわり |
| inbox/今日の天気.md                  | 晴れ・20度                 | life/    | 日常の記録         |
| inbox/読書メモ.md                    | Zettelkasten              | study/   | 読書・学習メモ     |

実行コマンド（まだ叩いてません）:
obsidian move --vault notes file="inbox/Claude Code連携を試す" to="tech/"
obsidian move --vault notes file="inbox/今日の天気" to="life/"
obsidian move --vault notes file="inbox/読書メモ" to="study/"

提案だけして実行は止まる、ここが安全側に倒れている。納得した分だけ「実行して」と返せばいい。

ファイルを直接動かさず、Obsidianプロセスに「動かしてくれ」と頼んでいるのがポイントだ。これで他のノートからの[[xxx]]リンクは自動で追従し、グラフビューやバックリンクも壊れない。

なお、CLIは「起動中のObsidianに対してコマンドを送る」設計なので、Obsidianアプリが起動していないと叩いても応答しない。WindowsならObsidian.exeを開きっぱなしにしておくのが前提だ。WSL2からCLIだけ叩く運用でも、Windows側でObsidianのウィンドウは閉じずに残しておく必要がある（最小化はOK）。

🧠 Claude Codeの「記憶」を保管庫に書き出す

入り口として面白い使い方が一つある。Claude Codeが今のセッションで頭の中に持っている知識を、Markdownとして保管庫に書き出させる、という発想だ。「あなたが覚えている汎用知識のうち、保管庫に入れた方がいいものは？」と聞いて、テーブルで提案を出させ、承認したものだけ obsidian create で書き込ませる。

意味するところは、Claude Codeの「記憶」をローカルの記憶ファイル（~/.claude/projects/.../memory/MEMORY.md）だけでなく、保管庫という第二の置き場に展開できるということになる。保管庫側は別セッションのClaude Codeも参照でき、人間がGUIで眺めることもでき、グラフビューで関係を可視化でき、Web公開もできる。記憶ファイルにはない自由度がある。

🔓 読み取り系コマンドを常時許可にする

Claude Codeに保管庫を任せるなら、何度も承認ダイアログを出させるのは面倒だ。けれど書き込み系まで自動許可は怖い。なので読み取り系だけ常時許可にする。

~/.claude/settings.json の permissions.allow にこう書く。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
"permissions": {
  "allow": [
    "Bash(obsidian search:*)",
    "Bash(obsidian read:*)",
    "Bash(obsidian files:*)",
    "Bash(obsidian links:*)",
    "Bash(obsidian backlinks:*)",
    "Bash(obsidian orphans:*)",
    "Bash(obsidian unresolved:*)",
    "Bash(obsidian version)",
    "Bash(obsidian vault)",
    "Bash(obsidian help)"
  ]
}

書き込み系（create move delete property:set eval dev:*）は意図的に外している。これで「探索・参照は止まらず、書き換えは必ず承認」というバランスが実現する。

📎 取り込み口を増やす：Obsidian Web Clipper

ここまでで保管庫の中身をAIに操作させる道筋と、AIから新規ノートを書き込ませる道筋は揃った。あとは、Webで読んだ記事を保管庫に取り込む手段が欲しい。これを担うのがObsidian公式のブラウザ拡張、Obsidian Web Clipperだ。

ChromeやEdgeなどに入れる無料拡張
Webページを Markdown に変換して保管庫に保存する
全文／本文だけ抽出／ハイライト箇所だけ／選択範囲だけを選べる
テンプレートで保存先フォルダ・ファイル名・frontmatterを定義できる
メタタグやSchema.orgデータを自動抽出してfrontmatterに詰める

Edgeで入れて、テンプレートの保存先を clippings/（デフォルト）にした。実際にQiitaの「Claude Code × Obsidian 完全連携ガイド」という記事を1本クリップしたら、こんなfrontmatter付きで保管庫に落ちた。

1
2
3
4
5
6
7
8
---
title: "Claude Code × Obsidian 完全連携ガイド｜Vaultを自動で育てるAIメモ術"
source: "https://qiita.com/masa_ClaudeCodeLab/items/..."
author: "[[masa_ClaudeCodeLab]]"
published: 2026-04-16
created: 2026-05-13
tags: [clippings]
---

obsidian read でClaude Codeに本文を読ませて要点を要約させ、用済みになったノートを _archive/ に移動した。これが一連の「Inbox処理」と呼ばれているワークフローの正体だ。音声や写真そのものを Obsidian が処理するわけではなく、別ツールで文字起こし・OCR・転写したテキストを保管庫に流し込んでから、AI が分類・要約・リンクを担当する、という分業になる。

📘 保管庫直下のCLAUDE.md

Claude Code でリポジトリを触るときに <repo>/CLAUDE.md を置くのと同じ発想で、保管庫の直下にも CLAUDE.md を置く。cd ~/notes で claude を起動すれば自動で読まれる。

書く内容はざっくりこれ。

ディレクトリの意味（inbox/ clippings/ tech/ writing/ workflow/ projects/ daily/ _archive/）
wikilink・タグ・frontmatterの記法ルール
ファイル名の禁則文字（: / \ ? * | などは使わない）
AIに任せていい操作と任せない操作の境界
プラグイン依存記法（Dataview / Templater）を禁止する宣言

保管庫が小さいうちに書いておくと、ノートが増えてからの「とりあえずどこに置く？」が消える。

🪤 実際にハマった小さな失敗

スムーズに進んだ部分だけ書くと嘘になるので、1時間ほどの中で詰まった瞬間も並べておく。

保存先フォルダがあると思ってmoveしたら失敗した: obsidian move file="inbox/xxx" to="_archive/" を叩いたら ENOENT: no such file or directory と怒られた。_archive/ フォルダ自体がまだ存在しないせいで、moveが移動先を作ってくれない。プレースホルダとして obsidian create path="_archive/README.md" を先に叩けばフォルダごとできる。新規フォルダにいきなり移すときは要注意
Web Clipperのデフォルト保存先が clippings/ で inbox/ じゃなかった: 「Note locationを inbox/ に変えたい」と設定画面の「一般」を探したが、保存先はテンプレート単位で別タブだった。テンプレート → Default → 「ノートの保存場所」が正解
保管庫名にスペースを含めるとCLI引数のクォートを忘れて死ぬ: obsidian read --vault notes path="inbox/Claude Code連携を試す.md" のように、ファイル名にスペースがあるとパスを必ずクォートする。Claude Codeに任せると割と忘れる

どれも壊滅的ではないが、書いておかないと次に同じ場所で5分溶かす類のやつだ。

⚠️ Obsidian固有の落とし穴

実装ガイド系の記事や、自分でやって気づいたものを混ぜて並べる。

同期競合: Claude Codeが書き換え中にiCloud/Dropbox/Sync の同期が走ると壊れる。一括処理中は同期を一時停止
ファイル名禁則文字: : / \ ? * などはOSレベルでNG。CLAUDE.mdに明記しておく
リネームをAIに任せない: バックリンク更新が漏れることがある。リネームはObsidian UIから手動、移動だけCLIに任せる
プラグイン依存記法に染まらない: Dataview / Templater 前提の記法を生成されると、プラグイン未導入環境で壊れる
巨大保管庫への一括実行: 5,000ノート規模で全読み込みは爆発する。obsidian files path=xxx で範囲を絞る
obsidian eval obsidian dev:* は普段オフ: 内部API直叩きなので、AIに任せると壊しやすい

👥 これがチームに広がるとどうなるか

ここまで個人運用の話だが、Obsidian Syncの「共有保管庫」機能を使うと、複数人で同じ保管庫を持てる。

少人数の知的生産チーム（〜10人）: リサーチャー・ライター・エンジニア
チーム共通のCLAUDE.md: 各メンバーのClaude Codeが同じ規約を読む
Inbox処理を夜間バッチ化: 各人が日中に放り込んだ記事を、夜にAIが要約・分類・既存ノートと結線
知識の複利: 1人の知識が10人分の文脈に乗る

NotionやConfluenceとは違って、ファイルがMarkdownで手元にあること自体がチーム横断のAI処理と相性がいい。Notionは公式APIを叩かないと中身が取れないが、Obsidianは保管庫を共有した時点で各人のローカルにMarkdownが並ぶ。

ただし向き不向きはある。リアルタイム同時編集はNotion・Google Docsほど滑らかではなく、後勝ちの上書きが起きる。権限管理も保管庫単位までで、フォルダ単位で細かく切るのは難しい。100人規模の組織ナレッジベースには無理がある。少人数で個人の知識を持ち寄って共通文脈を育てる用途が一番向いている。

🧭 まとめ

入れて、CLIを有効化して、Claude Codeに inbox/ を分類させるところまでで30分。1時間ほど触って手応えだけ並べると次のあたりになる。

公式CLI経由なら、AIが保管庫を「ファイル直接」ではなく「Obsidianプロセス越し」に触る。wikilinkや索引が壊れないので、安心して任せられる
読み取り系コマンドは常時許可、書き込み系は承認制、という権限の切り分けで運用すれば事故が起きにくい
Web Clipperを取り込み口にすれば、書く側は集中したまま、整理と相互リンクをClaude Codeに渡せる
保管庫直下の CLAUDE.md が、別セッションのAIにも自分の流儀を引き継がせる

触ってみて腑に落ちたのは、保管庫は「書く場所」というより自分が書いたものをAIが読める形で並べておく場所だ、ということだ。AI側がどんどん賢くなっていく前提で、その読み込み元を自分の手で太らせていく営みになる。書けば書くほど、未来の自分とAIの両方が参照できる資産が増える、と言い換えてもいい。

会社でも話題になり始めたObsidianを、個人の生産ツールとして使うか、チームの共通文脈として使うか。どちらにしても、最初に1時間使って公式CLIまで通しておけば、その後の選択肢が一気に広がる。

📚 参考

この記事は Claude Opus 4.7 が執筆しました。