Claude Code セットアップ & Obsidian 連携ガイド

00 このガイドの使い方 — Claude Code に丸投げできます

このガイドは自分で読みながら進めてもいいですが、手順書ごと Claude Code に渡して作業してもらうのが一番ラクです。Claude Code のチャットにこう送ってください:

https://cc-obsidian-guide.pages.dev
この手順書を読んで、ObsidianとClaude Codeの連携（方式B）をセットアップして。
コマンド実行や設定ファイルの作成はやってほしい。
わたしが手でやる必要がある操作は、その都度指示して。

ただし全自動にはなりません。役割分担はこうなります:

01 前提準備

Obsidian（オブシディアン）とは

Obsidian は自分のパソコンにデータを保存する無料のメモアプリです。「保管庫（Vault）」という単位でノートを管理し、プラグインを追加することで Claude などの AI と連携できます。Notion がクラウド型のチームツールなのに対し、Obsidian はローカル保存かつAI 連携のカスタマイズ性が最高峰という点が最大の強みです。

Obsidian のインストール

1. 公式サイト obsidian.md にアクセスし、お使いの OS 向けのインストーラーをダウンロードする。
2. macOS: ダウンロードした .dmg を開き、Obsidian アイコンを Applications フォルダにドラッグする。
   Windows: Obsidian-Setup-x.x.x.exe をダブルクリックして実行する。
3. Obsidian を起動し、言語設定を日本語にする（後述）。

Obsidian の初期設定

1. 起動後、左下の歯車アイコン（設定）をクリックする。
2. 「General（ジェネラル）」→「Language（ランゲージ）」→「日本語」を選択する。
3. Obsidian を一度終了して再起動する（言語変更を反映するため）。

保管庫（Vault）の新規作成

1. 起動画面で「新規作成」を選ぶ。
2. 保管庫名を英数字で入力する（例: MyVault、takahashi）。日本語名はプラグインのトラブル原因になるため避ける。
3. 保存場所はデスクトップが無難。iOS との同期を優先するなら iCloud Drive 下を選ぶ。OneDrive や外付けドライブ（Bridgeフォルダ等）の中には置かない（Windows はデスクトップが OneDrive 配下になっていることがあるので注意。その場合は C:\Users\ユーザー名\Documents 直下など OneDrive 外を選ぶ）。
4. 「作成」を押す。ウェルカム画面が表示されれば完了。

Claude デスクトップアプリのインストール

1. claude.com/download からデスクトップアプリをダウンロードする（macOS 12.0 以上、約 308MB）。
2. DMG（macOS）または exe（Windows）を実行してインストールする。
3. Claude.ai アカウントでサインインする。

02 Claude Code の初期設定

インストール

ターミナルを使う方法と、デスクトップアプリからターミナルなしで使う方法があります。初心者にはデスクトップアプリ版が簡単です。

macOS（ターミナル）:

# 公式インストーラー（自動アップデートあり・推奨）
curl -fsSL https://claude.ai/install.sh | bash

# インストール確認
claude --version
claude doctor

Windows（PowerShell）: スタートメニューで「PowerShell」を検索して開き（管理者権限は不要）、以下を実行します。

# 公式インストーラー（自動アップデートあり・推奨）
irm https://claude.ai/install.ps1 | iex

# PowerShell を一度閉じて開き直してから確認（PATH 反映のため）
claude --version
claude doctor

インストール先は C:\Users\ユーザー名\.local\bin です。

初回起動と CLAUDE.md の自動生成

1. ターミナル（Windows は PowerShell）を開き、作業フォルダに移動する: cd /path/to/your/project（Windows 例: cd C:\Users\ユーザー名\Desktop\MyVault）
2. claude を実行する（初回はブラウザが開いて OAuth 認証を求められる）。
3. 起動後、/init コマンドを実行するとフォルダを解析して CLAUDE.md を自動生成してくれる。

CLAUDE.md — Claude への「説明書」

CLAUDE.md は Claude に対してプロジェクトのルール・フォルダ構成・命名規則などを伝えるファイルです。ここに書いたことを Claude は作業時に参照します。200行以内を目安に簡潔にまとめるのがコツです。

配置場所と適用範囲:

Obsidian Vault で使う場合の記述例:

# Obsidian Vault ルール

## フォルダ構成
- 調査メモ → Brain/調査/
- 会議録   → 議事録/YYYY/MM/
- 広告データ → マーケ/広告/YYYY-MM/

## 命名規則
- ファイル名は英数字とハイフンのみ（日本語ファイル名禁止）
- 日付は YYYYMMDD 形式

## 禁止事項
- .obsidian/ フォルダは変更しない
- APIキー・パスワードはノートに記載しない

settings.json — 動作設定

~/.claude/settings.json（個人共通。Windows: C:\Users\ユーザー名\.claude\settings.json）または .claude/settings.json（プロジェクト）で Claude Code の動作を細かく制御できます。

{
  "permissions": {
    "defaultMode": "acceptEdits",
    "allow": [
      "Bash(npm *)",
      "Bash(git commit *)"
    ],
    "deny": [
      "Bash(git push --force *)",
      "Bash(rm -rf /)"
    ]
  },
  "autoMemoryEnabled": true,
  "autoCompactEnabled": true,
  "model": "claude-sonnet-4-6"
}

Permissions（許可設定）

評価順序は deny → ask → allow の順です。deny が最優先で、allow より広い deny があれば allow は無視されます。

03 Obsidian 連携

Claude Code と Obsidian を連携させる方法は主に 2 つあります。

方式 A: Vault を作業ディレクトリとして直接使う

追加のプラグインや設定は不要です。ターミナルで Vault フォルダに移動して claude を起動するだけです。

1. ターミナルを開き、Vault フォルダに移動する:
   cd ~/Desktop/MyVault
2. claude を実行して起動する。
3. Vault のルートに CLAUDE.md を作り、フォルダ構成・命名規則を記述する（前章の例を参考に）。
4. あとは自然言語で指示するだけ。例：「デスクトップの散らかったファイルを整理して Brain/調査/ に分類して」

方式 B: MCP 経由の連携（Local REST API プラグイン）

Obsidian 内で HTTP サーバーを立ち上げ、Claude Code が API 経由でノートを読み書き・検索する方法です。インデックスに即時反映されるのが大きな利点です。

ステップ 1: 4つのプラグインをインストール

1. Obsidian の左下歯車アイコン（設定）→「コミュニティプラグイン」→「有効化」を押す（初回のみ制限解除）。
2. 「閲覧」をクリックして検索画面を開く。
3. 以下の 4 つを順番に検索→インストール→「有効化」まで実行する。インストールだけでは動かないので必ず有効化まで行う。

ステップ 2: Local REST API の API キーを取得

1. 設定 →「コミュニティプラグイン」→「Local REST API」の歯車アイコンを押す。
2. 「Enable（有効化）」をオンにする。
3. 画面に表示された API キー（英数字の文字列）をコピーして手元に控えておく。

ステップ 3: Claude Code に MCP を登録

ターミナル（Windows は PowerShell）で以下を実行します（<your-api-key> を控えたキーに置き換える）。Windows の PowerShell では \ による行の折り返しが使えないため、コマンドは 1 行で入力してください:

# HTTP 版（証明書エラーが起きにくいためこちらを推奨）
claude mcp add --transport http obsidian http://127.0.0.1:27123/mcp/

# または HTTPS 版（Authorization ヘッダーに API キーを渡す）
claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ \
  --header "Authorization: Bearer <your-api-key>"

あるいは .mcp.json ファイルを手書きする方法もあります（プロジェクト固有設定向け）:

{
  "mcpServers": {
    "obsidian": {
      "type": "http",
      "url": "https://127.0.0.1:27124/mcp/",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

ステップ 4: 接続確認

claude mcp list    # 登録されているか確認
claude doctor      # 設定ファイルの場所と診断情報を表示

ステップ 5: 両アプリを再起動して動作確認

1. Claude Code と Obsidian を完全終了する。macOS: Dock のアイコンを右クリック→「終了」（Cmd+Q）。ウィンドウを閉じるだけでは動いたままになる。Windows: 「×」で閉じたあと、タスクトレイ（画面右下の ∧ マーク）に常駐アイコンが残っていれば右クリック→「終了（Quit）」。
2. 両アプリを再び開く。
3. Claude Code に「Vault の中のファイル一覧を見せて」と指示する。Obsidian の左サイドバーにファイルが増えていれば連携成功。

Chat モードと Code モードの切り替え

Claude Code には「Chat」と「Code」の 2 つのモードがあります。MCP 連携設定など、ファイル操作を伴う作業を行う際は右上の切り替えで Code モードに変更してください。

04 運用 Tips・よくあるハマりどころ

実践的な活用パターン

YouTube 動画を Obsidian に自動保存するフロー

1. Google Chrome に YouTube 字幕取得の拡張機能をインストールする（Chrome 専用のため、他ブラウザから乗り換えを推奨）。
2. YouTube の動画を開き、拡張機能で文字起こしを取得する。
3. テキストを ChatGPT などに貼り付け、「省略せずにまとめて」と指示する（「省略せずに」が重要。AI はデフォルトで要約を省略するため）。
4. まとめた内容を Obsidian のノートに保存する。タイトルだけ自分で変更すればよい。
5. 蓄積されたノートは Claude Code から「〇〇について過去のメモを検索して」と指示するだけで参照できる。

広告データ・業務データの管理

• PDF やスプレッドシートをまとめた内容を日付フォルダに蓄積しておく。
• 「CPA が先月と今月でどう変わったか」と Claude に聞くだけで即回答が出る。
• 過去データを覚えさせておくことで「忘れる」という概念がなくなる。

2 画面作業のすすめ

• 左画面に Obsidian、右画面に Claude Code を並べると変化をリアルタイムで確認できる。
• macOS では Command + -（マイナス） で Claude Code のサイドパネルを開いて横並び表示にできる。Windows では Windowsキー + ←/→ でウィンドウを左右にスナップできる。
• Claude Code をすぐ開けるようにしておく: macOS は Dock に追加（アイコン長押し→オプション→Dock に追加）、Windows はタスクバーにピン留め（アイコン右クリック→タスクバーにピン留めする）。

よくあるハマりどころと解決策

イレギュラー対応の基本姿勢

05 参考リンク集

Claude Code 公式ドキュメント

• Advanced setup — code.claude.com
• Configure permissions — code.claude.com
• How Claude remembers (CLAUDE.md) — code.claude.com
• Settings reference — code.claude.com
• Use Claude Code with Pro/Max plan — support.claude.com
• Desktop application — code.claude.com

Obsidian 公式

• Obsidian 公式サイト（日本語）
• Obsidian インストール方法 — obsidian.md
• コミュニティプラグイン — obsidian.md

Local REST API プラグイン

• obsidian-local-rest-api — GitHub (coddingtonbear)
• Local REST API インタラクティブドキュメント

Obsidian × Claude 連携 参考記事

• Obsidian MCP Complete Guide 2026 — mcp.directory
• Obsidian + Claude MCP 構築記 — blog.yamk.net
• Obsidian Vaults and Claude Code — kennethreitz.org
• Claude Desktop + Obsidian MCP ガイド — Zenn
• Claude Code × Obsidian 連携メモ — Zenn
• Connect Claude Code with Obsidian — Medium
• Claude MCP for Obsidian using REST API — Obsidian Forum