Mac で Claude Code と Obsidian をつなぐ（前編）

obsidian.md から Mac 版をダウンロードし、 開いたら Obsidian のアイコンを「アプリケーション」フォルダへドラッグします。個人で使うなら無料で、アカウント登録も要りません。

Obsidian を起動すると「新規保管庫を作成」というボタンが出ます。保管庫（英語では Vault＝ボールト）は、 Obsidian がノートを入れておくただのフォルダのことです。名前は何でも構いませんが、この記事では brain とします。

次に、Obsidian の中で新しいノートを1枚作り、名前を 作業記録 にします。中身は1行で構いません。 このノートに、part 3 で AI が書き足します。

いよいよつなぎます。拍子抜けするほど簡単で、part 1 で作った brain フォルダを、Claude Code の作業場所にするだけです。 Claude Code は、開いたフォルダを自分の仕事場だと考えるからです。

アプリ版：Code の画面で、作業するフォルダとして「書類」の中の brain を選びます。

ターミナル版：会話の画面が開いていたら /exit で抜けます。 cd（「このフォルダに移動する」という命令）と半角スペースを打ち、 続けて Finder の brain フォルダをターミナルの窓へドラッグ＆ドロップ（マウスでつかんで、窓の上で離す）します。 フォルダの住所（パス）が自動で入るので、そのまま Enter を押し、claude と打って起動します。

cd ← このあとに brain フォルダをドラッグ＆ドロップして Enter

claude

作業場所を brain にできたら、入力欄にこう頼みます。

作業記録.md の一番下に、今日の日付の見出しと
「Claude Code とつながった」という1行を追記して。
他の行は変えないで。

すると、書き換える前に「このファイルを書き換えていいですか」と許可を求める表示が出ます。 いまは作業場所そのものが brain なので、表示に出てくるファイルが 作業記録.md なら、許可して大丈夫です。 今回は1行を足すだけなので、もし思ったのと違っても、Obsidian でその1行を消せば元どおりです。

Obsidian を開いたままにしておくと、追記された行が画面にそのまま現れます。これが見えたら、つなぐことはもうできています。

※ 初めて brain を開くときは、「このフォルダを信頼しますか」のような確認が出ることがあります。自分で作ったフォルダなので、信頼する側を選びます。 また、初めて「書類」フォルダを触るときに、「“ターミナル”（アプリ版なら“Claude”）が“書類”フォルダ内のファイルへのアクセスを求めています」のような確認が出ることがあります。そのときは「許可」を押します。 ノートが1枚も読めない、見慣れないエラーが出る、というときは part 5 を見てください。

ここは、困ったときや、使い方を広げたいときに読めば十分です。

iPhone と同じノートを見たい（iCloud Drive に置く）

Vault を iCloud Drive に置くと、iPhone の Obsidian からも同じノートを読めます。 ただし、2つの準備が要ります（part 1 の注意のとおり、「書類」フォルダを iCloud と同期している人も同じです）。 どちらも、iCloud Drive に Vault を置いて実際につまずいたところです。

① フルディスクアクセスの許可。 iCloud の中は macOS が特別に守っている場所なので、許可が無いと、Claude Code からノートが1枚も読めません。 errno 81 や system error -81 という見慣れない文字が出たら、ほぼこれが原因です。 プログラムの側からは解決できないので、次の手順で人が設定します。

1. アップルメニュー → システム設定 → プライバシーとセキュリティ → フルディスクアクセス を開く
2. 使っている方をオンにする。ターミナル版なら ターミナル.app、アプリ版なら Claude.app。一覧に無ければ、一覧の下の「＋」ボタンを押して選ぶ（ターミナルは アプリケーション → ユーティリティ の中）
3. Obsidian.app もオンにする（Obsidian 側も同じ許可が要るため）
4. オンにしたそれぞれのアプリを ⌘Q で完全に終了してから開き直す（これを忘れると許可が効きません）

この許可はひとつで後編の STEP 4 にも効きます。ここが抜けていると、後編の STEP 4（MCP）は 「プラグイン（Obsidian に機能を足す部品）が壊れているように見える」という分かりにくい形で失敗するので、iCloud Drive に置く人は先に済ませておきます。

② 「このMacにダウンロードを保持」。 iCloud は、しばらく使っていないファイルの中身をインターネット側に預け、Mac には名前だけを残すことがあります。 その状態のノートに AI が追記すると、本文が消えてしまうことがあります。 Finder で Vault のフォルダを右クリックし、「このMacにダウンロードを保持」を選んでおけば防げます。

※ Dropbox など、ほかの同期サービスに置くこともできますが、同じファイルが2台で書き換えられて2つに分かれる「競合」が起きやすくなります。迷ったら、書類フォルダか iCloud Drive にします。

うまくいかないとき

• ターミナルで command not found と出る：ターミナルをまだ開き直していません。⌘Q で終了して開き直します。それでも出るなら、part 2 の1行をもう一度貼ります。
• ノートが1枚も読めない／errno 81：Vault が iCloud Drive にあるなら、上の①の許可です。
• 追記したら本文が消えた：上の②です。消えた分は、Obsidian のファイル復元の機能か、Time Machine（Mac に最初から入っているバックアップ機能）から戻します。
• brain の外のファイルを触ってくれない：開いたフォルダの外は、ふだんは触りません。part 4 の --add-dir で渡します。

料金のこと

Claude Code には、Claude の有料プラン（Pro・Max など）が必要で、無料プランでは使えません。 Obsidian は個人で使うなら無料です。必要なお金はこれだけで、あとは無料のもので組み立てられます。

後編で扱うこと

後編では、Obsidian に「MCP」（AI とほかのアプリをつなぐための、共通の差込口）を付けて、タグやリンクを使った Obsidian らしい探し方をできるようにします。 また、CLAUDE.md（AI への置き手紙）で、頼まなくても記録を書く状態にします。 どちらも、前編の連携ができていれば、あとから足せます。