3行でいうと

  • 公式の資料には、ObsidianをClaude CodeやCodexなどの外部AIにつなぐ手順は書かれていません。フォルダとして読み書きさせる方法は、この記事の案で、動作は確かめていません。
  • AIが書き込める状態にする前に、Vaultのバックアップを取ります。公式は、同期は変更を全端末に広げるのでバックアップではないと書いています。
  • 権限は4段階で考えます（0：渡さない、1：読み取り専用のコピー、2：書いてよいフォルダを1つだけ、3：本物のVaultに書かせる）。読み取り専用にする案は3つです。①Vaultのコピーを作り、書き込み権限を外して読ませる。②Headless Syncの「pull-only」で別の場所に複製する。③CLIのうち読み取り系の命令だけを通す。
  • AIツールに読ませた内容は、そのAIの提供元に送られます。コミュニティプラグインは、Obsidianと同じ権限で動くと公式が書いています。
  • 本物のVaultに書かせるときは、同期を止め、Gitで作業前の状態を残し、作業後に差分を見ます。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はObsidianを入れていますが、使い心地はこの記事には書いていません。手順は「公式の手順を順に並べたもの」、設定例は「公式の例の写し」か「公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）」と、そのつど書き分けています。この記事の中心は、後者の「この記事の案」です。ClaudeやCodexなど、Obsidian以外のAIツール側の公式資料は、この記事では読んでいません。そちらの設定の名前や許可の仕組みは、各ツールの公式で確かめてください。公式が用意する連携は07にあります。

先に結論

前提：用語をそろえる

案の本体：Vaultをフォルダとして、Claude CodeやCodexなどのAIに読み書きさせる（この記事の案）

公式の資料と、この記事の案の境目

公式の資料に書かれているのは、次のことです。

「Claude CodeやCodexのようなAIに、Vaultのフォルダを読ませたり書かせたりする」という組み合わせは、公式の資料には書かれていません。ここから先は、上の事実を材料に、この記事で組んだ案です。動作は確かめていません。

AIに渡る範囲（この記事の整理）

権限の段階（この記事の案）

段階 状態 向くとき 守り方
0 渡さない 機密のノート 機密のVaultと、AIを試すVaultを分ける
1 読み取り専用のコピーを読ませる 要約、質問、整理案づくり コピーを作り、書き込み権限を外す（手順A）
2 書いてよいフォルダを1つだけ作る 下書き、要約メモの置き場 AI専用フォルダだけ書き込み可にして、結果は人が見てから本物に移す（手順B）
3 本物のVaultに書かせる まとめて直す作業 作業前にGitでコミット、同期を止める、作業後に差分を見る（手順C）

手順A：読み取り専用のコピーを作る（LinuxとMacの例。Windowsのファイルの属性やアクセス権は、この記事では確かめていないので、OSの公式資料で確かめてください）

  1. 元のVaultのバックアップを取る（05の6-4）。
  2. AIに見せる場所へコピーする。.obsidian と、見せたくないフォルダ（例：Private）は外す。公式のバックアップのページは、Linuxの rsync を挙げています。
rsync -a --delete --exclude '.obsidian/' --exclude 'Private/' "$HOME/Vaults/Notes/" "$HOME/ai-view/Notes/"
  1. コピーの書き込み権限を外す。
chmod -R a-w "$HOME/ai-view/Notes"
  1. AIのツールを、$HOME/ai-view/Notes を作業の場所にして起動する。

  2. 更新したいときは、2を再実行する（3で権限が外れているため、先に chmod -R u+w "$HOME/ai-view/Notes" が要る場合があります）。

  3. rsync の --delete は、コピー先にあって元にないファイルを消します。向きを逆にすると、元のVaultを消すおそれがあります。実行前に、元とコピー先の順番を確かめてください。

  4. 書き込み権限を外しても、管理者権限のプロセスや、権限を戻せる人は書けます。完全な保証ではありません（この記事の見立て）。

手順B：AIが書いてよい場所を、1フォルダに限る

  1. 手順Aのコピーに、AI-Inbox フォルダを作る。
  2. AI-Inbox の中だけ、書き込みを許す。
mkdir -p "$HOME/ai-view/Notes/AI-Inbox"
chmod -R u+w "$HOME/ai-view/Notes/AI-Inbox"
  1. AIには、「書くのは AI-Inbox の中だけ」と指示ファイルに書く（後述の例）。
  2. 作業後、AI-Inbox の中身を人が読み、よいものだけを、本物のVaultの適切なフォルダへ手でコピーする。

この形は、AIに本物のVaultを触らせず、結果を人が確かめて取り込む方法です。Obsidianは、外で増えたファイルを自動で拾います（公式）。

手順C：本物のVaultに書かせる場合の下準備

  1. 同期を止める。 Obsidian Syncなどの同期は、AIの誤った変更も、全端末に広げます（公式）。作業の間、同期を止めるか、同期していないコピーで作業します。公式のCLIには sync on|off があります。
  2. Gitで、作業前の状態を残す。 公式の同期のページには、Gitの基本の命令が載っています。次は、この記事で組んだ例です。
cd "$HOME/Vaults/Notes"
git init                       # すでにあるなら不要
printf '.obsidian/workspace.json\n.obsidian/workspaces.json\n' >> .gitignore
git add -A
git commit -m "AI作業の前"
  1. AIに作業させる。
  2. 差分を見る。
git status
git diff
  1. 戻すとき。
git restore .              # 追跡中のファイルの変更を、コミットの状態に戻す
git clean -n               # 新しく増えたファイルの一覧（-n は一覧だけ。実際に消すのは -f）

AIへの指示ファイルの例（この記事の例。動作は確かめていません）

AIのツールが読む指示ファイルの名前は、ツールごとに違います。名前は各ツールの公式で確かめてください。中身は、公式の書き方に合わせて、たとえば次のようにします。

# このVaultでの作業ルール
- 書いてよいのは AI-Inbox フォルダの中だけ。それ以外のファイルは変更・削除・移動しない。
- ノートの先頭のプロパティは YAML で書く。日付は YYYY-MM-DD、複数の値は「- 」で始まる行にする。
- 内部リンクを値に入れるときは "[[ノート名]]" のように引用符で囲む。
- リンクは [[ノート名]] の形（Wikilink）を使う。ブロック参照（^識別子）は作らない。
- .obsidian フォルダと、Private フォルダは読まない。
- ファイル名に # | ^ : %% [[ ]] を使わない。

Obsidianに取り込んだあとの確認

Obsidianの「Excluded files」について： Settingsの説明では、検索やグラフなどに出すファイルを除く設定として書かれています。ほかのAIツールからの読み書きを止める仕組みとは、公式に書かれていません。止めるのは、OSの権限とフォルダの分け方です（この記事の見立て）。

案：CLIの読み取り系の命令だけを通す小さなスクリプト

公式のCLI（07の連携2）を、AIのツールが動かすターミナルから呼ばせる場合の案です。公式ヘルプ「Obsidian CLI」が書いているのは、ターミナルからObsidianを操作すること、スクリプトによる自動化や外部ツールとの連携のため、ということです。AIから使えるかどうかを、開発者向けの命令以外について、公式は書いていません。公式の命令の一覧と、delete・sync・plugins:restrict の引数は、07の連携2にあります。

命令を、影響の大きさで分ける（この記事の整理）

公式のコマンド一覧の名前から、この記事が分けたものです。公式がこの分類を示しているわけではありません。

区分 公式の一覧にある命令（抜粋）
読み取り系（と、名前から思われるもの） help、version、vault、vaults、files、folders、read、search、search:context、backlinks、links、unresolved、orphans、deadends、outline、tags、tag、properties、property:read、aliases、tasks、templates、template:read、daily:read、daily:path、wordcount、bookmarks、plugins、history、base:query
書き込み系 create、append、prepend、daily:append、daily:prepend、property:set、property:remove、move、rename、delete（permanent フラグつき）、task（toggle）、template:insert、history:restore、unique、base:create、bookmark
影響が大きいもの eval（アプリの中でJavaScriptを実行）、dev:cdp、devtools、dev:debug、command（コマンドIDを指定して実行）、plugin:install、plugin:enable、plugins:restrict（制限モードのオン・オフ）、theme:install、sync・sync:restore、publish:add・publish:remove、reload、restart

この記事で組んだ例（動作は確かめていません）

AIのツールに、obsidian そのものではなく、次のような自作の小さなスクリプトだけを実行させる、という考え方です。許可するサブコマンドを列挙し、それ以外は断ります。

#!/usr/bin/env bash
# obsidian-ro.sh : 許可した読み取り系の命令だけを obsidian に渡す（この記事の案）
set -eu
VAULT="Notes"   # 対象のVault名に直す
case "${1:-}" in
  search|search:context|read|backlinks|links|unresolved|orphans|deadends|outline|tags|tag|properties|property:read|files|folders|wordcount|tasks)
    exec obsidian vault="$VAULT" "$@" ;;
  *)
    echo "許可していない命令です: ${1:-}" >&2
    exit 1 ;;
esac

案：Headless Syncで、AI用の複製を別の場所に作る

公式のHeadless Syncの条件・オプション・食い違いは、07の連携3にあります。ここでは、その pull-only を、AIに見せる複製に使う案だけを書きます。条件は、07のとおり、有効なObsidian Syncの購読、先にバックアップ、同じ端末でデスクトップのSyncと併用しないことです。つまり、普段パソコンでObsidianとSyncを使っているなら、AI用の複製は、別の端末に置く形になります（公式の警告からの、この記事の整理）。

手順（公式の手順に、この記事の案の設定を足したもの。動作は確かめていません）

npm install -g obsidian-headless
ob login
ob sync-list-remote
mkdir -p ~/ai-view/Notes && cd ~/ai-view/Notes
ob sync-setup --vault "Notes" --device-name "ai-view"
ob sync-config --mode pull-only --excluded-folders "Private" --configs ""
ob sync

渡るデータと外し方： 07の連携3のとおりです。

案：URIで、AIの出力を AI-Inbox に新しいノートとして置く

公式のURI（07の連携4）を使う案です。

この記事で組んだ例（動作は確かめていません）。 AIや他のアプリが作った文を、AI-Inbox に新しいノートとして置く形です。

obsidian://new?vault=Notes&file=AI-Inbox%2F2026-10-25-summary&content=%23%20Summary%0A-%20point1&silent=true

つまずきの一覧

症状 確認すること
AIが書いたリンクが壊れる 指示ファイルの書き方（Wikilink、ファイル名に使わない文字）と、CLIの unresolved の出力
外から入れたファイルが読み込まれない 「Files and links」で、メタデータキャッシュを作り直す（公式）
コピーを更新できない 手順Aの chmod -R u+w を先に実行したか。rsync の元と先の順番
本物のVaultが意図せず変わった 手順Cで作業前にコミットしてあれば、git diff で差分を見て git restore . で戻す
Headless Syncの複製が衝突する 同じ端末でデスクトップのSyncと併用していないか（07）
止めたい命令を、AIが直接呼べてしまう AIツール側の許可の設定で、スクリプトだけを許しているか（設定の名前は、各ツールの公式で確かめる）

気をつけること

出典