「ObsidianのVaultの中で、Claudeに直接ノートを読み書きさせたい」——そう思ったのが、今回の出発点でした。結論から言うと、今はコミュニティプラグイン「Claudian」を使い、Vaultの整理からブログ記事の執筆補助まで、かなりの作業をClaudeに任せる運用に落ち着いています。
最初は、軽い作業で導入してみようとAPI従量課金でAgent Client(別プラグイン)を使っていたのですが、思いのほかトークン消費が嵩み、サブスクプランへ移行した経緯があります。今はClaude Pro契約で運用していて、ブラウザとObsidianを行き来する手間からほぼ解放されました。
この記事では、Claudianの導入手順から実際の使い方、サブスクとAPI従量課金どちらを選ぶべきかの判断材料、認証周りで失敗しないための注意点までまとめて紹介します。
- Claudianの導入手順とCLI周りの注意点
- サブスクとAPI従量課金、どちらを選ぶべきか
- 料金・認証で失敗しないためのポイント
- サブで使っていたAgent Clientとの使い分け(→一本化した経緯)
Claudianとは?ObsidianにClaude Codeを組み込むプラグイン
Claudianは、Claude CodeなどのコーディングエージェントをObsidianのサイドバーに組み込み、Vault自体を作業ディレクトリとして扱えるようにするコミュニティプラグインです。作者はYishen Tu氏、ライセンスはMIT、Obsidian 1.13.0以上のデスクトップ版(Windows/macOS/Linux)で動作します。モバイルには対応していません。
主な機能は、単語単位のdiffで変更内容を確認できるInline Edit、サイドバーでの会話形式のSide Chat、スラッシュコマンドや@メンションによるノート参照、MCPサーバー連携などです。2026年10月時点のバージョンは2.3.23で、GitHubスターは15.7kを超えています(Claudian - GitHub)。もとはClaude Code専用でしたが、現在はCodexやOpenCodeなど複数のエージェント・プロバイダーにも対応が広がっています。更新も活発に行われており、この点も安心できるところですね。
注意したいのは、名前がよく似た別プラグイン「ClaudianIA」の存在です。こちらは作者が異なる別物(アーカイブ済み)なので、インストール時は作者名がYishen Tu氏になっているか確認してください。
導入手順:Claude Code CLIが必要になる点に注意
ここで押さえておきたいのは、ClaudianがAPIキーを貼るだけで使えるプラグインではないという点です。自分のPCにClaude Code(CLI)を先に入れておく必要があります。
導入の流れは次の通りです。
- 自分のPCにClaude Code CLIをインストールする
- Obsidianの設定からコミュニティプラグインで「Claudian」を検索してインストール
- プラグインを有効化する
- 設定画面でCLIのパスを指定する
つまずきやすいポイント
私自身、Claudian導入時には特にハマることなくすんなり使い始められました。情報量が多いプラグインなので、その点でも始めやすいと感じています。
ただ、以前Gemini APIを別プラグイン経由で使おうとしたときはCLI周りで手こずり、結局IDEを導入してようやく呼び出せた、という経験があります。エージェント系プラグイン全般に言えることですが、CLIが正しく認識されないトラブルは珍しくありません。nvm・fnm・voltaといったNodeバージョン管理ツールを使っている場合、CLIのパスがうまく見つからないケースがあるようです。見つからないときは、設定画面でCLIパスを手動指定するか、PATHへの追加を試してみてください。
実際の使い方:Vaultの中でできること
実際にClaudianでClaudeへ任せている作業は、思った以上に多岐にわたります。
- Vaultの整理・リンク修正: フォルダ構成の見直しや壊れたリンクの修正など、メンテナンス系の作業を任せています
- 記事執筆の補助: リサーチ・レビュー・校正・公開順の相談まで、ブログ運用のかなりの部分をサポートしてもらっています
- 壁打ち・アイデア出し: 記事に限らず、思いついたことを気軽に相談できる相手になっています
- LLM Wikiへの知識集積: Webクリップや個人メモから、知識ベースへの取り込みも任せています
地味に大きいのが、Inline Editの単語単位diffで変更内容をその場で確認できる点です。「何をどう変えたか」が一目でわかるので、安心して作業を任せられます。許可の仕組みもあり、ファイル操作のたびに勝手に実行されるわけではありません。
一番の違いを感じるのは、ブラウザとObsidianを行き来しなくて済むようになったことでしょうか。手動でやっていた細かい作業がパッと終わるので、Vault管理がかなり楽になりました。もうAIのないObsidianには戻れないな、というのが正直な実感です。
サブスクか従量課金か:料金プランの選び方
ClaudianはClaude Code CLI経由で動くため、認証方法によって課金のされ方が変わります。大きく分けると、月額のサブスク(Claude Pro/Max)と、使った分だけ支払うAPI従量課金の2つの選択肢があります。
| Claude Pro | Claude Max | API従量課金 | |
|---|---|---|---|
| 料金 | $20/月(年払いなら$17/月) | $100/月〜(Proの5倍・20倍の2プラン) | モデルごとの単価×使用量 |
| 上限の仕組み | 5時間のローリング枠+週間上限 | 同左(上限が緩い) | 使った分だけ課金、Spend limitで上限設定も可能 |
| 向いている人 | 使用量を気にせず定額で運用したい人 | かなりヘビーに使う人 | 使用量が少ない・変動が大きい人 |
実体験として、私は最初API従量課金でAgent Clientを使っていました。しかし使い込むほどトークン消費が嵩み、「このままだとサブスク料金と同じ金額になりそう」という状況になったため、Claude Pro(サブスク)へ移行しました。1回ごとの使用料を気にしながら作業する必要がなくなったのは、想像以上に大きな変化です。結果的に、いろいろな作業を気兼ねなく任せられるようになりました。従量課金用のAPIキーは今も残していますが、現在は使っていません。
1点注意したいのが、最上位モデル「Claude Fable」の扱いです。普段使いならOpus・Sonnet・Haikuの範囲で十分なのですが、「サブスクなら全モデル使い放題」と思っていると足りなくなる場面があります。Fableの扱いはPro・Maxで条件が異なります。
- Proプラン: 標準枠に一切含まれず、最初からUsage creditsが必須
- Maxプラン: 標準枠の一部として含まれ、週間上限の50%まではUsage credits不要(超えると同様にUsage creditsが必要)
なお、Free/Team Standardでは利用できません。普段からFableクラスの重いタスクを使う予定があるなら、どちらのプランでも無制限に使えるわけではない点は覚えておいてください。特にProを契約している方は注意が必要です。
API従量課金の主なモデル単価
参考までに、2026年10月時点の主なモデルの単価(入力/出力、100万トークンあたり)は以下の通りです。
| モデル | 入力 | 出力 |
|---|---|---|
| Claude Fable 5.1 | $10 | $50 |
| Claude Opus 5.5 | $4 | $20 |
| Claude Sonnet 5.5 | $2 | $10 |
| Claude Haiku 5.5(10万トークンまで) | $0.10 | $0.50 |
Fableだけ単価が頭1つ抜けているのがわかりますね。サブスク利用時もFableだけはUsage creditsを使う扱いなので、従量課金で使う場合も「他のモデルより高い」という前提で見ておくのが安全です。
エージェント運用は、ツール呼び出しや会話履歴が積み重なるぶん入力トークンが膨らみやすい点にも注意が必要です。プロンプトキャッシュを使うと、キャッシュヒット時の読み出し単価がかなり下がります(Sonnet 5.5では入力単価の5%相当)。繰り返し同じコンテキストを扱う場合は、コスト抑制に効いてきます。最新の単価はClaude 料金・API料金(公式ドキュメント)で確認してください。
料金・認証で失敗しないための注意点
サブスクのつもりで使っていたら、実は従量課金になっていた——という事故はありえます。原因はANTHROPIC_API_KEY環境変数です。これが設定されていると、Claude CodeはAPIキーでの認証を優先してしまいます(初回起動時には確認が入ります)。
意図せず従量課金になっていないか不安なときは、/statusコマンドで現在の認証方法を確認できます。サブスクに戻したい場合は、unset ANTHROPIC_API_KEY(Windowsなら該当する環境変数の削除)でAPIキーを外せばOKです。
従量課金で使う場合は、Claude ConsoleでSpend limit(月間の支出上限)を設定しておくと安心です。上限に達するとリクエストが止まる仕組みなので、気づかないうちに高額請求、という事態を避けられます。
サブスク認証と規約について
ここは断定を避けて、確認できた事実を正直に書きます。Claude Codeの公式ドキュメント(2026-10-14時点で確認)によると、OAuth認証(Pro/Max/Team/Enterpriseでのログイン)は「購入者自身によるClaude Code等ネイティブアプリの通常利用」を想定したものです。サードパーティの開発者が、ユーザーに代わってPro/Maxのクレデンシャルでリクエストを中継することは認められていません。
一方で、「改変されていないClaude Codeバイナリに、ユーザー自身が自分のサブスクでサインインすること」は妨げられていません。Claudianは内蔵のAgent SDK経由でClaude Code CLIを呼び出す仕組みです。ただ、この位置づけについて一次情報での明言はなく、Anthropic側の方針も変わる可能性があります(Agent SDKの課金方針は2026年6月に変更が発表されたものの一時停止され、10月時点でも据え置きのままです)。個人利用の範囲で使う分には大きな心配は不要だと考えていますが、最新の公式規約は都度確認することをおすすめします。
Agent Clientも試したけどClaudianに一本化した話
最初にObsidianへAIを住まわせたのは、実はClaudianではなくAgent Client(RAIT-09作・Apache 2.0)でした。Agent Client Protocol(ACP)準拠で、Claude Code以外にもGemini CLIやCodexなど複数のエージェントに対応できる、汎用性の高いクライアントです。
ただ、Claudianへ移行してからはすっかりそちらの運用に落ち着き、Agent Clientはインストールしたままオフにしています。どちらが優れているという話ではありません。「複数のエージェントを使い分けたい」よりも「1つのエージェントを使い込みたい」という自分のスタイルに、Claudianの方が合っていただけです。汎用性を取るか、1つに絞って使い込むか——複数のコーディングエージェントを試したい人には、Agent Clientも十分選択肢になると思います。
似たプラグインとの違い
Obsidian向けのAI連携プラグインは他にもあります。役割の違いを簡単に整理しておきます。
- Copilot for Obsidian: チャット+エージェント統合型。無料版は自前のアカウント・APIキーで利用可能、有料のPlusプランもあります
- Smart Connections: 関連ノートの発見に特化したプラグインで、役割がそもそも異なります
ざっくり言うと、Claudianはファイルを横断して編集する「エージェント型」、Copilotは「会話型」、Smart Connectionsは「発見型」という整理になります。手動リンクに頼らず関連ノートを見つけたい方は、手動リンクから解放!Similar Notes導入メリット&類似4選比較も参考にしてみてください。
まとめ
ObsidianのVaultの中でClaudeに直接ノートを読み書きさせる運用は、思っていた以上に快適でした。まずは自分のPCにClaude Codeを入れて、Claudianを試してみてください。料金面では、従量課金ならSpend limitで上限管理をしたうえで、自分の使用量を見ながらサブスクへの移行を検討する、という流れがおすすめです。
ブラウザとObsidianの行き来から解放される感覚は、一度味わうと手放せなくなりますよ。
- Obsidianのノート管理を自動化する方法|4つのプラグイン連携ガイド
— Claudian以外の自動化・運用まわりも知りたい方向け - QuickAddとTemplaterって何が違うの?役割を分けて考えるとObsidianが一気に使いやすくなる
— 既存の自動化プラグインとの役割分担を整理したい方向け - 手動リンクから解放!Similar Notes導入メリット&類似4選比較
— 関連ノート発見系のプラグインも気になる方向け
