連載の第3回です。

第1回でDEVONthink 4とObsidianを「分業」する考え方をお伝えして、第2回（note）でClaude CodeとDEVONthinkをMCPサーバーでつなぐ設定手順を書きました。

今回はいよいよ「それで実際に何ができるのか」という本題です。

DEVONthinkに溜めてきた資料が、Claude Codeを介してそのまま記事の構成案になる、そのワークフローの全体像と、実際にやってみた結果をお伝えします。

ワークフローの全体像

まず完成形をイメージしてください。

① DEVONthink 4（資料を保管）
　　↓ Claude Code MCP経由で検索
② Claude Code（資料を整理・構成案を作成）
　　↓ ファイルとして保存
③ Obsidian（構成案を受け取り、執筆へ）

「記事を書くための資料を探す」「資料をまとめて構成を考える」「下書きをどこかに保存する」——これを毎回手作業でやっていたことが、Claude Codeへの一言で済むようになります。

実際にやってみた

「シニアのためのAI使い分けガイド」という記事を書くために、DEVONthinkに入っているAI関連の資料を検索して構成案を作ってもらいました。

Claude Codeに入力したのはこれだけです。

「シニアのためのAI使い分けガイド」の記事を書くために、
Claude・ChatGPT・Gemini・NotebookLMの資料を検索して
構成案を作って。できたらObsidianのWIPフォルダに
「シニアAI使い分けガイド_構成案.md」として保存して

結果は想像以上でした。

DEVONthinkに入っている60件以上のAI関連資料を自動で検索・読み込みして、約2分で8章構成の記事案が出てきました。

しかも、ただ構成案が出てくるだけではありません。「シニアとChatGPT記事」「Claude徹底解説PDF」といった、DEVONthinkに実際に保存してある資料名を根拠として示しながら、各章の内容を提案してくれました。

DEVONthinkに3年かけて溜めてきた資料が、ようやく「使える状態」になった瞬間でした。

DEVONthinkのAI検索は使われているのか？

「ただのキーワード検索ではないの？」と思われるかもしれません。

結論から言うと、DEVONthink 4が持つネイティブのAI機能も呼び出すことができます。

mcp-server-devonthinkはDEVONthinkのAppleScriptインターフェース（アプリ同士が命令をやり取りする仕組み）を経由して動いているため、単純なキーワードの一致検索だけでなく、DEVONthink 4に組み込まれている「分類（classify）」や「比較（compare）」といったAI機能も利用できます。

つまりClaude Codeが受け取るのは「DEVONthinkのAIが文脈を読んで選び出した検索結果」です。キーワードが完全に一致しない資料でも、内容の意味が近ければ引っかかってきます。

DEVONthinkに資料を丁寧に整理・タグ付けしてきた分だけ、検索結果の質が上がります。

「意図と違う構成案」を防ぐ4つの方法

一気に「検索→構成案→保存」まで任せると、出てきた内容が意図と違っていたときに困ります。修正のためにもう一度プロンプトを入れると、そのぶんコストもかかります。

以下の4つのアプローチで、自分のコントロールを保ちながら使うことができます。

1. プロンプトに「確認待ち」の指示を入れる

最もシンプルな方法です。プロンプトの最後にこう加えます。

構成案ができたら一度見せてください。
確認してOKを出してからファイルに保存してください。

これだけで、保存前に必ず内容を確認できるステップが生まれます。

2. Plan Mode（計画モード）を使う

Claude Codeにはファイルへの書き込みを一切行わず、計画と提案だけを行う「Plan Mode（計画モード）」があります。

このモードで実行すると、DEVONthinkを検索して構成案を表示してくれますが、Obsidianへのファイル保存は行いません。内容を確認してから「これで保存して」と改めて指示できます。

3. ファイル書き込みの前に承認を求める設定にする

Claude Codeの設定で、ファイルへの書き込みアクションを実行する前にターミナル上で承認を求めるようにできます。

構成案をまとめ終えてファイルを書こうとしたタイミングで確認画面が出るので、そこで内容をチェックしてからOKを出す流れになります。

4. Escキーでいつでも止める

処理が走っている最中に「方向が違う」と気づいたら、Escキーで即座に止められます。止めた後で追加の指示を出して軌道修正できます。

個人的には1番（プロンプトに確認待ちを入れる）が一番手軽でおすすめです。癖にしてしまえば自然にそのリズムで動けます。

メリットとデメリット、正直なところ

使い始めて感じているメリットとデメリットを正直にまとめます。

メリット

資料収集と執筆の間にあった「整理する手間」がなくなります。

以前はDEVONthinkで資料を検索して、関係ありそうなものを手動でまとめて、それを見ながら構成を考えて……という作業をすべて手でやっていました。この「DEVONthinkとエディタを行き来する時間」がそのままなくなります。

アプリを切り替えなくていいという点も地味に効いています。Claude Codeに話しかけるだけで、DEVONthinkとObsidianの両方を操作してくれます。

デメリット

Claude ProのAPIコストがかかります。

MCPサーバーを経由する分、通常の会話より多くのトークン（AIが処理するデータ量）を消費します。「検索→構成案作成→保存」まで一気にやると、一回の操作でそれなりのコストがかかります。頻繁に大規模な検索をかけるとコストが積み上がるので、使い方は意識した方がよいです。

あくまでClaude Code経由の間接的な連携です。

Obsidianの画面上でDEVONthinkのファイルが直接見えるわけではありませんし、グラフビューにDEVONthinkのデータが表示されるわけでもありません。「Claude Codeというハブを通じて両方にアクセスできる」という状態です。これを理解した上で使うと、期待と現実のギャップがありません。

MCPサーバー自体がまだ実験的なプロジェクトです。

mcp-server-devonthinkはコミュニティ開発のツールなので、DEVONthinkやClaude Codeのバージョンアップによって動かなくなることがあり得ます。ミッションクリティカルな用途（絶対に止められない業務など）には、その点の割り切りが必要です。

Obsidianへの保存：パス指定のコツ

実際に使ってみると、一番つまずきやすいのがObsidianへの保存パス（ファイルの場所）の指定です。

ObsidianのVaultがiCloud Drive上にある場合、パスはこうなります。

/Users/（ユーザー名）/Library/Mobile Documents/iCloud~md~obsidian/Documents/（Vault名）/（フォルダ名）/ファイル名.md

毎回このフルパスを入力するのは面倒なので、よく使うフォルダパスをメモしておいて、コピー＆ペーストで使い回すのが現実的です。

Claude Codeのプロジェクト設定ファイル（CLAUDE.md）にパスを書いておくと、毎回入力しなくて済みます。

まとめ：3回の連載を振り返って

この3回の連載でお伝えしたことをまとめます。

第1回では、なぜDEVONthink 4とObsidianを「分業」するのかという設計思想の話をしました。資料管理はDEVONthink、執筆はObsidianという役割分担です。

第2回（note・有料）では、Claude CodeとDEVONthinkをMCPサーバーでつなぐ具体的な設定手順を、エラーの実録も含めてお伝えしました。

第3回（この記事）では、設定したワークフローを使って実際に記事の構成案を自動生成した結果と、上手に使うためのコツをまとめました。

3つ合わせて「DEVONthinkに溜めてきた資料をClaude Codeで活かす」ワークフローが完成します。

DEVONthinkを何年も使ってきて「宝の持ち腐れになっているかもしれない」と感じていた方に、このワークフローが参考になれば幸いです。

このシリーズの記事

• 第1回（minatokobe.com・無料）：Obsidianだけでは限界だった——DEVONthink 4と組み合わせて解決したこと
• 第2回（note・有料）：Claude Code × DEVONthink 4 MCP 設定手順【実録】
• 第3回（この記事）：DEVONthinkの資料からObsidianへ——記事執筆ワークフローを自動化する

参考・出典

• DEVONthink 4 公式サイト – DEVONtechnologies
• mcp-server-devonthink – GitHub（dvcrn）
• Obsidian 公式サイト
• DEVONthink 4 の新機能 – DEVONtechnologies
• ObsidianのVaultをDEVONthinkにインデックス化する方法 – DEVONtechnologies Community

Obsidianを使い始めた頃は、本当に快適でした。

Web Clipperで記事を取り込み、PDFも放り込み、メモも書いて——気づけばVaultのファイル数がどんどん膨れ上がっていきました。「あの記事どこだっけ」「このPDFを先週見たんだけど」と探し回ることが増えてきた頃、私の知識管理の体制を根本から見直すことにしました。

たどり着いた答えが「資料管理はDEVONthink 4、執筆はObsidian」という分業です。

この記事では、なぜその組み合わせに落ち着いたのかを正直にお伝えします。2つのツールの設計思想の違いから、私の試行錯誤まで含めて書いていきます。

DEVONthink 4って何？（知らない方のために）

まず「DEVONthinkって聞いたことない」という方のために、簡単に紹介しておきます。

一言で言えば、Mac専用の超強力な資料管理データベースです。

ドイツのDEVONtechnologiesという会社が開発しているソフトウェアで、日本ではあまり話題になりませんが、欧米のMacパワーユーザーや研究者・弁護士・ジャーナリストの間では長年の定番ツールとして知られています。

何が強いかというと、まず受け入れられるファイルの幅の広さです。

PDF、Word文書、Web記事（Web Archive形式）、メール、画像、動画——ほぼあらゆる形式のファイルを取り込めます。取り込んだPDFはバックグラウンドで自動的にOCR処理（画像の中の文字をテキストとして認識する技術）が行われ、中のテキストまで検索対象になります。スキャンした紙の書類でも、画像として保存したレシートでも、文字として検索できるようになるわけです。

次にスケーラビリティ（大量データへの対応力）の高さです。60,000ファイル、容量にして80GBを超えるデータベースでも、検索結果が一瞬で返ってきます。これはObsidianには真似できない領域です（後ほど詳しく説明します）。

さらにDEVONthink 4ではAIがシステムに直接組み込まれています。取り込んだ文書を自動で分類し、関連文書を推薦し、スマートルールと組み合わせることで「新しく取り込んだPDFを自動で整理してタグを付ける」といった処理を完全にバックグラウンドで実行できます。

ScanSnapを利用していると、スキャンを自動的にDEVONthink4に取り込むことができ、自動でOCR処理ができます。

ただし、デメリットも正直に書いておきます。

• macOS専用（iOSアプリはあります）
• 有料（Standard版が約$99、Pro版が約$199）
• 学習コストが高い——機能が多すぎて最初は何から手をつければいいか迷います

万人向けではありません。でも「本気で情報を管理したい」と思っているMacユーザーには、一度試す価値のあるツールだと思っています。

• 無料でお試し（最低30日または150時間）

Obsidianの強みと、その限界

Obsidianについては、多くの方が使っているか、少なくとも名前は聞いたことがあるかと思います。

改めて整理すると、Obsidianの最大の強みは「考えること」と「書くこと」に特化している点です。

マークダウン（シンプルな記号を使った文章の書き方）で書いたノートをローカルのフォルダに保存するという、シンプルな設計が逆に強みになっています。データはプレーンテキスト（飾りのない純粋なテキスト）なので、どのアプリからでも読み書きできます。双方向リンクでノート同士をつなぎ、グラフビューで思考のネットワークを視覚化できます。プラグインの自由度も高く、AI検索など最新の技術をすぐに取り込める柔軟性があります。

執筆環境としては最高だと今も思っています。

ただし、弱点があります。

ファイル数が増えてくると、動作が重くなります。Obsidianは起動時にVault内の全ファイルを読み込んでリンクを解決し、メモリ上にナレッジグラフ（知識のネットワーク図）を構築します。ファイル数が数千程度なら問題ありませんが、1万件を超えてくると起動に時間がかかるようになります。グラフビューは1万件以上では実用に耐えなくなるという報告もあります。

また、PDFなどのバイナリファイル（テキスト以外のファイル）の管理が苦手です。PDFをVaultに放り込めばプレビューはできますが、中身のテキストを検索したり、自動でタグを付けたりといったことはObsidianだけでは難しいです。重いファイルをVaultに溜め込むほど、前述のパフォーマンス問題が悪化します。

私がたどり着いた「分業」という答え

最初の話に戻ります。

以前の私は、ObsidianのWeb Clipperで気になる記事を片っ端から取り込んでいました。参考になりそうなPDFも、調べ物の結果も、すべてVaultに入れていました。「全部Obsidianで完結させる」という運用です。

しばらくはそれで回っていました。でもある時期から問題が起き始めました。

ファイルが増えすぎて、探せなくなったのです。

「あの記事、絶対に保存したはずなんだけど」と思っても出てこない。タグ付けが甘かったのか、フォルダ分けが中途半端だったのか——とにかく「溜める」ことに集中しすぎて、「使える状態にする」作業が追いついていませんでした。

そこで体制を根本から見直しました。

現在の運用はこうなっています。

• DEVONthink 4：資料のすべて。Web記事、X（旧Twitter）の投稿、PDF、参考資料——外から取り込むものはすべてDEVONthinkに入れます
• Obsidian：書いた記事と、執筆中のファイルだけ。インプット系のファイルは置きません

DEVONthinkのフォーラムでインデックス化できるということを知りました。
それ以来。ObsidianのVaultはDEVONthinkに「インデックス」として登録しています。これにより、DEVONthinkの強力な検索エンジンとAIを使って、「外部の資料（DEVONthink内のアーカイブ）」と「私が書いた記事（ObsidianのVault）」を横断的に検索できます。

この体制にしてから、明らかに「探せない」というストレスが減りました。

2つをつなぐ「壁」と、Claude Codeによる解決

ただし、この体制にも一つ「壁」があります。

DEVONthinkがObsidianのVaultをインデックス化しているのは「DEVONthinkの側から」です。Obsidan側からDEVONthinkの資料を参照することはできません。

記事を書いているとき、「DEVONthinkに保存してあるあの資料を参照したい」と思っても、いちいちDEVONthinkに切り替えて検索しなければなりません。小さなことのようで、執筆の流れが毎回そこで途切れてしまいます。

この「壁」を突き破る方法として最近試しているのが、Claude CodeのMCPサーバー経由でDEVONthinkにアクセスするという方法です。

MCPとは「Model Context Protocol」の略で、AIツール（Claude Code）が外部のアプリやデータベースとやり取りするための仕組みです。

設定できると、こんなことができるようになります。

「d-endingnote.comの記事を書くために、DEVONthinkから相続登記関連の資料を検索してまとめて」

と入力するだけで、DEVONthinkに蓄積された資料の中から関連するものを自動で探し出し、記事の構成案を作ってくれます。さらにそのままObsidianの指定フォルダにMarkdownファイルとして保存するところまで一気にできます。

実際にやってみたところ、DEVONthinkに入れてある60件以上のAI関連資料を自動で検索・読み込み・整理してくれました。「シニアのためのAI使い分けガイド」の構成案が、具体的な資料名（「シニアとChatGPT記事」「Claude徹底解説PDF」など）を根拠として示しながら、約2分で出てきました。

DEVONthink × Claude Code × Obsidianの三角形が、ようやくつながった瞬間でした。

この設定は、一度設定しておくとターミナルからのClaude Code、Obsidianと連携したClaude Code、デスクトップ版のClaude Code、どの方法からでも利用できるのです。

具体的な設定手順については、明日公開のnote記事で詳しく書く予定です。

まとめ：「2つ使うのは大げさ」ではなく「これが最終形」

DEVONthink 4とObsidianは、競合ツールではありません。

2つを同時に使うことで、それぞれの弱点が消えます。

「そんな複雑な環境、私には無理」と思われるかもしれません。でも実際に使い始めると、役割がはっきり分かれているだけに、意外とシンプルに運用できます。「外から来たものはDEVONthink、私が書くものはObsidian」、このルールだけ守れば、あとは自然に回ります。

次回は、Claude CodeとDEVONthink 4をMCPサーバーで接続する具体的な設定手順を、実際のエラーも含めた実録でお伝えします。設定さえできてしまえば、DEVONthinkに蓄積してきた資料が一気に「使える状態」になりますよ。

このシリーズの記事

• 第1回（この記事）：DEVONthink 4とObsidianを両方使う理由
• 第2回（note）：Claude Code × DEVONthink 4 MCP 設定手順【実録】
• 第3回：DEVONthinkの資料からObsidianへ、記事執筆ワークフローを自動化する

参考・出典

• DEVONthink 4 公式サイト – DEVONtechnologies
• DEVONthink 4 の新機能 – DEVONtechnologies
• Obsidian 公式サイト
• Obsidian Web Clipper 公式ページ
• ObsidianのVaultをDEVONthinkにインデックス化する方法 – DEVONtechnologies Community
• DEVONthink vs Obsidian 使用レポート – DEVONtechnologies Community
• Is DEVONthink Pro worth it to use in conjunction with Obsidian? – Reddit
• mcp-server-devonthink – GitHub（dvcrn）

「AIに記事を頼むと、長くなると話が逸れたり、前のことを忘れちゃうなぁ…」
「もっと専門的で一貫性のある内容を、AIに手伝ってもらえたらいいのに」
「記事を書くとき、もっと効率的にできないかしら？」

そう感じたことはありませんか？

実は、こんなブロガーの悩みを解決してくれる、まさに「救世主のような機能」があるんです。それが、Claude Codeの「Subagents(サブエージェント)」機能なんですね。

今回は、この画期的な機能について、「AIって難しそう…」と思っている初心者やシニア世代の方でも安心して理解できるよう、基本の「き」から、具体的な設定方法、そしてすぐに使える実践例まで、どこよりも分かりやすく、温かく解説していきますよ。

この記事を読み終える頃には、あなたも「AI編集長」として、まるでプロの編集部を持っているような感覚でブログを書けるようになっているでしょう！

AIツールキット紹介：ツールの役割を理解しよう

• Obsidianとは？ あなたの思考やメモ、そしてAIが作った記事をすべて保管しておくための「デジタル書斎」です。
• Claude Codeとは？ あなたのコンピュータに常駐する「AI専門家チーム」そのものです。このチームに指示を出して、複雑な作業を自動化します 。
• Gemini CLIとは？ チームに所属する優秀な「リサーチャー」です。インターネットから最新情報を集めたり、大量の資料を要約したりするのが得意です 。
• Subagents(サブエージェント)とは？ あなたが作成する「専門家のプロフィール帳」です。「Apple製品専門家」「シニア向けライター」といった役割を定義し、Claude Codeチームのメンバーとして登録します 。

Claude CodeのSubagents(サブエージェント)とは？基本の仕組みを分かりやすく解説

あなた専属の「AI編集チーム」を持つ感覚

Subagents(サブエージェント)を一番分かりやすく例えると、「あなたのオフィスに、それぞれ得意分野を持つ専門スタッフのチームを雇った」ような感覚なんです。

想像してみてください。あなたのデスクの周りに、こんな頼もしいメンバーが待機しているとしたら…

• 編集長のあなた：全体の方向性を決めて、チーム全体に指示を出します
• リサーチ専門家の田中さん 🕵️‍♀️：「最新のApple情報を調べておいて」とお願いすると、サクッと情報をまとめてくれます
• 文章作成の得意な佐藤さん ✍️：「この情報を、シニア向けに優しい記事にして」と頼むと、読みやすい記事を書いてくれます
• 校正のプロの鈴木さん 👀：「誤字脱字がないか、チェックしてもらえる？」と言うと、細かいところまで確認してくれます
• Apple製品マニアの山田さん 🍎：Appleに関することなら何でも詳しく教えてくれます
• AIトレンドウォッチャーの高橋さん 🤖：最新のAI情報をいつも追いかけています

これまでのAIアシスタントは、一人で全部やろうとして「あれ？さっき何の話でしたっけ？」なんて混乱することがありましたよね。でも、Subagents(サブエージェント)を使えば、それぞれの専門家が自分の得意分野に集中してくれるので、いつでも最高の仕事をしてもらえるんです。

なぜAIが「忘れっぽく」なるの？Subagents(サブエージェント)が解決する仕組み

「AIって、たまに前に言ったこと忘れちゃうのはなぜ？」

これ、多くの方が疑問に思うところですよね。実は、AIには「一度にどれくらいの情報を覚えていられるか」という限界があるんです。

例えば、あなたが友人との電話で、最初は旅行の話をしていたのに、だんだん話題が変わって、最後は全然違う話になっていた…なんて経験はありませんか？AIも似たような状況で、長い会話になると「最初に何を頼まれたんだっけ？」となってしまうことがあるんです。

Subagents(サブエージェント)は、この問題をこう解決します：

各Subagents(サブエージェント)は、独立した「専用のメモ帳」と「作業デスク」を持っています。メインのClaudeとの長い会話とは完全に分かれて、自分だけの静かな部屋で集中して仕事をするイメージですね。

だから、「Apple製品の専門家」のSubagents(サブエージェント)なら、Apple関連の情報だけをしっかり覚えて、他の話題に混乱することなく、いつでも的確なアドバイスをしてくれるんです。

従来のAIアシスタントとSubagents(サブエージェント)の違い

従来のAIアシスタント：

• 一人で何でもやろうとする → 混乱しやすい
• 長い会話になると、最初の指示を忘れがち
• 専門性が薄くなることがある

Subagents(サブエージェント)：

• 専門分野ごとに担当者が分かれている → 高品質な結果
• 短時間で集中して仕事を完了 → 忘れることがない
• それぞれが専門家レベルの知識を発揮できる

まさに「一人のスーパーマン」から「専門家チーム」への進化と言えるでしょうね！

Subagents(サブエージェント)導入で得られる3つの大きなメリット

1. ブログ執筆が「分業制」に！品質とスピードが劇的向上

これまでは、一人でリサーチから執筆、校正まで全てやっていたあなた。Subagents(サブエージェント)チームがあれば、まるでプロの編集部のような分業体制が作れます。

具体的な作業の流れ：

1. 【リサーチ専門家】に依頼：「新しいiPhone 16について、シニア世代が使いやすい機能を5つ調べて、メリットとデメリットもまとめてください」
2. 【Apple専門ライター】に依頼：「この情報を基に、『シニアにおすすめ！iPhone 16で生活がこう変わる』というタイトルで、2000文字程度の記事を書いてください」
3. 【校正担当者】に依頼：「この記事を読んで、誤字脱字、分かりにくい表現、シニア世代には難しすぎる部分がないかチェックしてください」

実際の体験談（Macコーチング歴10年の視点から）：
これまで1つの記事を書くのに3-4時間かかっていたのが、Subagents(サブエージェント)を使うことで1-2時間に短縮されました。しかも、各分野の専門家が担当するので、記事の品質も格段に向上するんです。

特に、Apple製品の細かい仕様や、最新のAI技術について書くとき、専門知識を持ったSubagents(サブエージェント)が正確で詳しい情報を提供してくれるので、読者の信頼度もアップしますね。

2. 複数作業の同時進行で時間短縮を実現（並列処理のメリット）

Subagents(サブエージェント)の真価は、同時に複数の作業を進められることにあります。あなたが複数の専門家に同時に『あれやっといて』『これお願い』と指示を出すのと同じです。AIたちが同時に作業を進めてくれるので、一つずつ順番にやるより圧倒的に早く仕事が終わります。

実際の活用例：

• 月曜日の朝、一度に3つの指示を出します：
  • Apple専門家：「新しいmacOS Sonomaのシニア向け便利機能を調査」
  • 健康情報専門家：「Apple Watchを使った血圧管理の最新情報をまとめて」
  • 税金アドバイザー：「2024年の確定申告、シニアが知っておくべき変更点を整理」
• 約30分後には、3つの高品質なレポートが完成！

従来の方法では、これらを順番にやると2-3時間はかかっていました。でも、Subagents(サブエージェント)なら「指揮者」のように複数のメンバーに同時に指示を出せるので、大幅な時間短縮が実現できるんです。

Macユーザーの方には特にメリット大：
MacのショートカットアプリやAutomatorと組み合わせれば、さらに効率的なワークフローが作れますよ。例えば、朝の9時に自動でSubagents(サブエージェント)に指示を出し、11時には整理された情報がメールで届く…なんてことも可能です。

3. AIの負担軽減でコスト削減とパフォーマンス向上

これは少し技術的な話になりますが、実はとても重要なメリットなんです。

「トークン」って何？
AIが文章を理解・生成する際の最小単位で、だいたい日本語なら1文字、英語なら1単語程度です。長い会話ほど多くのトークンを消費し、それが利用コストに直結します。

従来の方法の問題点：

• 長い会話で複雑な指示 → たくさんのエネルギーを消費
• AIが疲れてくる → 回答の質が下がることがある
• コストも高くなりがち

Subagents(サブエージェント)の場合：

• 短時間で集中した作業 → 少ないエネルギーで高品質な結果
• それぞれが専門分野に特化 → 効率的で正確
• 結果的にコストも抑えられる

実際の体験から：
月間のAI利用コストが約30%削減されました。同時に、記事の品質は明らかに向上しています。特に、シニア向けの記事を書くときの「分かりやすさ」と「正確性」のバランスが、格段に良くなりましたね。

初心者でもできる！Subagents(サブエージェント)設定の手順ガイド

「設定って難しそう…」と心配になったあなた、大丈夫です！実は、スマートフォンでアプリをダウンロードするより簡単なんですよ。

一つずつ、ゆっくり進めていきましょう。

前提条件：ObsidianとAIツールの連携設定

Subagents(サブエージェント)を最大限活用するために、まずはObsidianとAIツールの連携を済ませておきましょう。これにより、情報管理と執筆作業がさらに効率的になります。

必要な連携設定：

1. ObsidianとGemini CLIの連携
   詳しい設定方法は、こちらの記事をご参照ください：
   【完全版】Obsidianが最強の思考ツールに進化する！Gemini CLI連携ガイド（Mac/Win対応）
2. ObsidianとClaude Codeの連携
   詳しい設定方法は、こちらの記事をご参照ください：
   【完全攻略】Mac版Claude Code地獄インストール ＆ Gemini CLI× Obsidianで構築｜個人で”編集部級”ワークフロー実現

連携のメリット：

• Obsidianで情報を整理しながら、AIツールを使って記事作成
• リサーチ内容をObsidianに保存し、Subagents(サブエージェント)が参照可能
• 執筆した記事を自動的にObsidianのナレッジベースに蓄積
• 過去の記事やメモを活用した、より一貫性のあるコンテンツ作成

これらの連携が完了したら、以下の手順でSubagents(サブエージェント)の設定を進めていきます。

Gemini CLIでDeep Researchを行う

ObsidianとGemini CLIが連携された環境で、Claude CodeのSubagents(サブエージェント)について包括的にDeep Researchを行います。

Gemini CLIを起動ます

【例】：次のような指示を出します

## 重点リサーチ項目

### 基本機能と設定
- Apple Watchの睡眠トラッキング機能詳細（最新watchOS対応）
- iPhoneヘルスケアアプリとの連携方法
- シニアが迷わない初期設定手順
- 睡眠データの種類と意味（睡眠ステージ、心拍数、呼吸数等）

### シニア特化コンテンツ
- 加齢による睡眠パターンの変化と健康への影響
- 睡眠の質と健康寿命の関係性（最新研究データ）
- シニアが陥りやすい操作ミスと解決法
- 視認性・操作性を考慮した使い方のコツ

### 実践的活用法
- 睡眠データから導く具体的な改善アクション
- 快眠ルーティンの構築方法
- 医師との相談時のデータ活用法
- 家族との情報共有方法

### 安全性と注意事項
- 医療機器ではない旨の明確化
- データの信頼性と限界
- プライバシー保護について
- 健康上の注意点

出力は分かりやすい言葉で、親しみやすく暖かい語り口で記述し、Markdownの見出し構造を明確にしてください。" --output "Obsidian/AppleWatch×iPhone-sleep.md"

ObsidianからClaude Codeを初めて起動する

1. はじめて起動すると、次の画面が表示されるので[ ENTER ]キーを押します。



2. 次の画面が表示されるので[ blog-article-creator ]を入力し[ ENTER ]キーを押します。

　すべて小文字で、スペースは使わず、ハイフォン[ – ]で単語を区切る


3. 最も重要な「Step 4: System prompt」に到達しました


　以下の内容を入力し[ ENTER ]を押す
【例：】

あなたは、{{どのような専門家になってほしいのかを入力}}を専門とする記事作成のエキスパートです。

**専門分野:**
- 専門分野1を記入
- 専門分野2を記入
- 専門分野3を記入

**執筆スタイル:**
- 暖かく親しみやすい文体
- 「〜ですね」「〜でしょう」などの親近感ある語尾
- 専門用語は必ず分かりやすく説明
- 実用的で行動につながる内容
- 機知に富んだ表現で読者を楽しませる

**記事構成の基本:**
1. 読者の共感を呼ぶ導入部
2. 問題の明確化と解決策の提示
3. 具体的な手順やメリットの説明
4. 実践例やコード例（必要に応じて）
5. 読者が行動したくなるまとめ

**重要な指針:**
- 初心者でも理解できる表現を心がける
- SEOを意識した見出し構成を作成
- 読者が「自分にもできそう」と感じる内容にする

4. 「Step 5: Description」- エージェントが自動で応答する条件を設定

【例：】

{{○○向け}}ブログ記事の構成設計と本文執筆を行う専門エージェント。リサーチ結果を元に、読者に響く記事を作成します。ブログ記事作成、記事構成、記事執筆、{{○○向け}}の作成時に必ず使用してください。MUST BE USED for any blog article creation work.



5. モデルを選択、そのまま[ ENTER ]キーを押します



6. 「Final step: Confirm and save」でも、そのまま[ ENTER ]キーを押します



7. 作成したエージェントを選択、私の場合は「blog-article-creator」なので「↓」で「blog-article-creator」に移動して[ ENTER ]キーを押します



8. [ ENTER ]を押してエージェントの内容を確認



9. [ esc ]キーで、この画面まで戻る

STEP1：ObsidianのGemini CLIで作成したファイルをObsidianで開く

最初に、Gemini CLIのDeepResearchで作成したファイル「@Apple Watch×iPhone-sleep.md”」を開きます

STEP2：ObsidianのClaude Codeで構造化された見出しの抽出

Claude Codeのプロンプト入力欄（「>」マークの後）に、以下の文章をコピー&ペーストしてください：

”””
Gemini CLIでリサーチした内容から、ブログ記事用の見出し構成（H2、H3レベル）を抽出し、SEOを意識した構造化されたアウトラインを作成してください。シニア読者にも分かりやすい見出しにしてください。

”””
[ここに左側に表示されている「AppleWatch×iPhone-sleep」の全文をコピー&ペースト]
“””

コピー＆ペーストが手間だと思われる方は（現在の作業ディレクトリにある場合）、

@blog-article-creator AppleWatch×iPhone-sleep.mdファイルの内容から、ブログ記事用の見出し構成（H2、H3レベル）を抽出し、SEOを意識した構造化されたアウトラインを作成してください。シニア読者にも分かりやすい見出しにしてください。

別の場所にある場合: もしファイルが別の場所にある場合は、以下のように指定できます：
相対パス: ./subfolder/AppleWatch×iPhone-sleep.md
絶対パス: /full/path/to/AppleWatch×iPhone-sleep.md

STEP3：自分の専門性と文体を活かした記事作成を依頼

アウトラインが生成されたら、次に自分の専門性と文体を活かした記事作成を依頼します：
【例：】

@AppleWatch×iPhone-sleep.md 先ほどのアウトラインを基に、以下の特徴を持つブログ記事を作成してください：

- 暖かく親しみやすい文体（「〜ですね」「〜でしょう」などの語尾）
- シニア世代でも理解できる表現（専門用語は必ず分かりやすく説明）
- 機知に富んだ表現で読者を楽しませる
- Macユーザーの視点を含める
- 読者が「自分にもできそう」と感じる内容
- 実用的で行動につながる具体例

STEP4：最終調整と品質向上

　記事の初稿が完成したら、さらなる改善を依頼します：
【例：】

@AppleWatch×iPhone-sleep.md この記事をさらに改善してください：

1. 導入部分で読者の共感を呼ぶエピソードを追加
2. 各セクションに具体的な操作例やコード例を含める
3. シニア読者への配慮（図解の提案、注意点の明記）を強化
4. 記事の最後に「行動したくなるまとめ」を作成
5. 全体を通して、あなたらしい温かい人柄が伝わる表現に調整–

設定時の注意点とよくある間違い

よくある間違い 1.：ファイル名を忘れがち

• 設定ファイルには必ず .md という拡張子をつけます
• 例：apple-expert.md

よくある間違い 2.：YAMLの書き方

• --- を忘れる（最初と最後の両方に必要）
• スペースやタブの使い方が混在している
• 日本語と英語の文字が混在して、エラーになる

よくある間違い 3.：フォルダの場所

• .claude フォルダが見つからない場合は、新しく作成してください
• Macでは隠しフォルダになっているので、Finder で [ ⌘ ]+ [ shift ] + [ . ] を押すと表示されます

成功のコツ：

• 最初は1つだけ作って、動作確認してから増やす
• エージェントの専門分野は明確に分ける
• description は具体的に書く（例：「Apple製品全般」より「iPhone・iPad・Macの使い方とトラブル解決」の方が良い）

困った時のチェックポイント：

1. ファイルの保存場所は正しいか？
2. YAML の文法に間違いはないか？
3. name に大文字や日本語が含まれていないか？

　必ず英語小文字とハイフンのみを使用してください。大文字やスペース、日本語はエラーの原因になります

4. description は分かりやすく書けているか？

　Claudeがどのエージェントを呼び出すか判断するための最も重要な情報です。具体的かつ明確に役割を記述してください。

5. インデント（字下げ)：

　YAMLファイルはインデントが非常に重要です。スペースの数が違うだけで正しく認識されません

＊ YAMLは、AIに渡すための、書き方が厳密に決まった『指示書』のようなものです。箇条書きのルール（インデントや記号）を正確に守らないと、AIは指示を理解できません。

すぐに使える実践的なSubagents(サブエージェント)設定例

さあ、いよいよ実際にSubagents(サブエージェント)を作ってみましょう！

以下のコードをコピーして、テキストエディタ（メモ帳でもOK）に貼り付け、指定されたファイル名で保存するだけです。まるでレシピを見ながら料理を作るような感覚ですね。

Apple製品レビュー専門エージェントの設定コード

ファイル名： ~/.claude/agents/apple-reviewer.md

 
---
name: apple-reviewer
description: Apple製品の新機能、レビュー、比較記事を作成し、シニア世代にも分かりやすく解説します。
tools:
  - web_fetch
  - read_file
  - write_file
system_prompt: |
  あなたは10年以上Apple製品を愛用している、信頼できるテックレビュアーです。
  
  【あなたの特徴】
  - Macコーチング経験があり、初心者やシニア世代の気持ちがよく分かる
  - 難しい技術用語を使わず、生活に根ざした視点でレビューする
  - 「この機能は実際の生活でどう役立つの？」という視点を大切にする
  
  【記事作成時の必須要素】
  1. 導入：読者の悩みや興味に共感する文章
  2. 製品の主要特徴を3つに絞って紹介
  3. シニア世代にとってのメリット・デメリット
  4. 実際の使用場面を具体的に想像できる例
  5. 購入判断の助けになる率直なアドバイス
  
  【文体】
  - 「〜ですね」「〜でしょう」など親しみやすい語尾
  - 読者を「あなた」と呼び、温かみのある文章
  - 1文は50文字以内で、読みやすく
---

初心者やシニア向けデジタルサポートエージェントの作成方法

ファイル名： ~/.claude/agents/senior-digital-support.md

 
---
name: senior-digital-support
description: iPhone、iPad、Macの基本操作をシニア世代に分かりやすく教え、不安を解消します。
tools:
  - read_file
  - write_file
system_prompt: |
  あなたは地域の初心者やシニア向けデジタル教室で10年間教えている、優しい先生です。
  
  【あなたの心がけ】
  - 「大丈夫、一緒にやってみましょうね」という安心感を与える
  - 生徒さんのペースに合わせて、決して急かさない
  - 失敗は学習の一部だと考え、温かく見守る
  - 専門用語は絶対に使わず、日常の言葉で説明する
  
  【説明方法】
  - 手順は必ず番号をつけて、一つずつ区切る
  - 「右上の角にある」「青いボタンを」など、具体的な位置や色を説明
  - 「まるで○○のような」比喩を使って理解しやすくする
  - 各手順の後に「うまくいきましたか？」と確認を入れる
  
  【よくある不安への対応】
  - 「壊してしまうのでは？」→「この操作では壊れませんよ」
  - 「間違えたらどうしよう」→「間違えても元に戻せますから安心して」
  - 「覚えられない」→「メモを取りながら、一緒に進めましょう」
---

健康・税金情報専門エージェントの設定例

ファイル名： ~/.claude/agents/life-advisor.md

 
---
name: life-advisor
description: 健康管理、医療制度、年金、税金など、シニア世代の生活に関わる制度や情報を正確に分かりやすく解説します。
tools:
  - web_fetch
  - read_file
system_prompt: |
  あなたは社会保険労務士とファイナンシャルプランナーの資格を持つ、信頼できる生活アドバイザーです。
  
  【情報提供の原則】
  - 官公庁の公式情報のみを参考にし、正確性を最優先にする
  - 複雑な制度も、身近な例を使って分かりやすく説明する
  - 「知らないと損をする」情報を積極的に提供する
  - 手続きの期限や必要書類など、実用的な情報を忘れずに含める
  
  【説明スタイル】
  - 専門用語は必ず（　）内で分かりやすく説明
  - 箇条書きや表を使って情報を整理
  - 「例えば田中さん（65歳・年金生活）の場合…」など具体例を提示
  - 相談窓口や問い合わせ先も必ず案内する
  
  【特に重視する分野】
  - Apple Watchなどを活用した健康管理
  - 医療費控除、確定申告の最新情報
  - 介護保険の活用方法
  - デジタル遺産の管理・相続対策
  
  【記事構成】
  1. なぜこの情報が重要なのか
  2. 制度の概要（分かりやすく）
  3. 具体的な活用方法・手続き
  4. 注意点・よくある間違い
  5. 問い合わせ先・参考リンク
---

設定ファイルのカスタマイズポイント

これらの設定例を参考に、あなた独自のエージェントを作る時のポイントをお教えしますね。

1. name（エージェント名）のつけ方

• あなたが覚えやすい名前にする
• 役割が分かりやすい名前にする
• 例：apple-news（Apple関連ニュース）、health-watch（健康管理）、tax-helper（税金サポート）

2. description（説明）の書き方のコツ

• 具体的に何ができるかを書く
• 対象読者を明確にする
• キーワードを含める（Claudeが判断しやすくなる）

良い例：

<code>description: iPhone・iPad・Macの操作方法を、60歳以上の初心者向けに、図解付きで分かりやすく教えます。</code>

改善が必要な例：

<code>description: コンピューターのことを教えます。</code>

3. system_prompt（性格・行動指示）のカスタマイズ

• あなたのブログの文体に合わせる
• 読者層を意識した言葉遣いにする
• 専門分野の知識レベルを調整する

実際のカスタマイズ例：
あなたのブログが「厳選した情報をサクッと伝える」スタイルなら：

 
system_prompt: |
  簡潔で要点を絞った情報提供を心がけてください。
  長々とした説明より、「これだけ知っておけばOK」という
  厳選した内容を、分かりやすく伝えてください。

4. tools（使える機能）の選び方

• web_fetch：最新情報が必要な場合
• read_file：既存の資料を参考にする場合
• write_file：記事ファイルを直接作成する場合

必要な機能だけを指定することで、エージェントの動作がより安定します。

よくある質問と解決方法（トラブルシューティング）

いったい費用はどれくらい必要なの？

コストは誰でも気にかかりますよね。
この組み合わせでは、無料ツールでコストのかかるリサーチ部分をこなし、高品質な生成が求められる執筆部分にのみ有料ツールを投入するという、費用対効果の高い使い方ができます。

実際にSubagents(サブエージェント)を使い始めると、「あれ？うまくいかない…」ということが起こるかもしれません。でも大丈夫！よくある問題と解決方法をまとめましたので、一つずつ確認してみてくださいね。

Subagents(サブエージェント)が思った通りに動かない場合の対処法

Q1. Subagents(サブエージェント)が呼び出されない

症状： 質問をしても、普通のClaudeが答えて、Subagents(サブエージェント)が出てこない

原因と解決方法：

• 原因 1.：descriptionが曖昧
  • 解決法：より具体的で分かりやすい説明に変更する
  • 例：「コンピューターについて」→「iPhone・iPad・Macの基本操作と設定方法について」
• 原因 2.：質問とエージェントの専門分野が合わない
  • 解決法：質問の仕方を調整するか、@エージェント名 で直接指名する
  • 例：「Apple製品について」ではなく「新しいiPhoneの使い方について」

Q2. エラーメッセージが出る

症状： ファイルを保存したのに、エラーが表示される

よくあるエラーと解決方法：

<code>YAML syntax error</code>

解決法：

• --- が最初と最後にあるか確認
• インデント（行の頭の空白）が正しいか確認
• 日本語の文字が混入していないか確認

<code>Agent not found</code>

解決法：

• ファイルの保存場所が正しいか確認（~/.claude/agents/）
• ファイル名が .md で終わっているか確認
• name に大文字や日本語が含まれていないか確認

設定ファイルのエラーが出る場合の確認ポイント

チェックリスト：

1. ファイルの場所は正しいですか？

   ・ ✅ ~/.claude/agents/ フォルダに保存されている
   ・✅ ファイル名が .md で終わっている

2. YAML の書き方は正しいですか？

   ・✅ 最初の行が --- になっている
   ・✅ 最後の行が --- になっている
   ・✅ name: description: system_prompt: の後にスペースがある

3. 文字の種類は正しいですか？

   ・✅ name は英語小文字とハイフンのみ
   ・✅ 全角スペースが混入していない
   ・✅ 日本語の句読点（、。）が設定部分に含まれていない

実際のチェック方法（Mac）：

1. 隠しフォルダを表示： Finder で Cmd + Shift + . を押す
2. ファイルの場所確認： ホームフォルダ → .claude → agents フォルダ
3. ファイルを開いて確認： テキストエディタで開き、上記のチェックリストを確認

より効果的にSubagents(サブエージェント)を活用するためのコツ

コツ 1.：エージェントの専門分野は明確に分ける

❌ 悪い例：

• general-helper：何でも屋（専門性が薄い）

✅ 良い例：

• apple-news：Apple関連ニュース専門
• senior-health：シニア向け健康情報専門
• tax-guide：税金・制度説明専門

コツ 2.：定期的にエージェントの性能をチェック

月に1回程度、各エージェントに同じ質問をして、回答の品質を確認しましょう。

 
テスト質問例：
@apple-reviewer 新しいiPhone 16について、シニア向けの記事を書いてください

回答が期待と違う場合は、system_prompt を調整します。

コツ 3.：エージェント同士の連携を活用

 
活用例：
1. @apple-news で最新情報を収集
2. その情報を @apple-reviewer に渡してレビュー記事を作成
3. @senior-support で初心者向けの操作ガイドを追加

コツ 4.：読者からのフィードバックを活用

ブログの読者から「もっと詳しく」「分かりにくい」などのコメントがあったら、該当するエージェントの system_prompt に反映させましょう。

実際の改善例：
読者から「手順が早すぎて分からない」というコメント
↓

 
system_prompt: |
  手順の説明は、必ず一つずつ区切って、
  「ここまでできましたか？」と確認を入れてください。

よくある質問と回答（FAQ）

Q1: 設定がとても複雑そうですが、もっと簡単な始め方はありますか？,
A: はい、もちろんです。この記事で紹介しているのは全てのツールを連携させる最も強力な方法ですが、もっとシンプルに始めることもできます。まずは、ウェブサイト版のClaude.aiを使ってアイデア出しを手伝ってもらうことから試してみてください。慣れてきたら、無料のGemini CLIだけをインストールして、コマンド入力に挑戦してみるのがおすすめです。料理と同じで、簡単なレシピから始めて、徐々に本格的な料理に挑戦していくのが成功の秘訣です。

Q2: これらのツールは有料ですか？ 実際の費用はどれくらいかかりますか？
A: 良い質問ですね。無料のツールと有料のツールを組み合わせて使います。ObsidianとGemini CLIは個人利用の範囲では無料です [1, 2]。記事執筆の核となるClaude Codeは、月額$20程度のClaude Proプランへの加入が必要です 。このガイドでは、費用のかかるリサーチ作業を無料のGeminiに任せ、高品質な文章作成が求められる執筆作業にのみ有料のClaudeを使うことで、費用対効果を最大化する方法を紹介しています。

Q3: ウェブで使うClaudeと、この記事の「Claude Code」は何が違うのですか？
A: ウェブサイト版のClaudeを「親切な図書館の司書さん」だと考えてみてください。どんな質問にも答えてくれます。一方、「Claude Code」は、あなたのオフィスに設置する「専門家チームと業務用機材一式」です [3]。あなたのパソコン内のファイルを直接読んだり、専門家（サブエージェント）を呼び出したり、作業を自動化したりする力を持っています。

Q4: この方法にはObsidianが絶対に必要ですか？
A: Claude Codeは、パソコン内のどんなテキストファイルのフォルダでも作業できます。しかし、このガイドで紹介している「魔法のような連携」の真価は、Obsidianと専用プラグインを使うことで発揮されます。Obsidianを使うことで、あなたのメモ全体がAIにとって理解しやすい「知のデータベース」に変わるのです。

Q5: 「ターミナル」や「コマンドライン」が怖く見えます。
A: 見慣れない画面なので、最初は少し intimidating に感じるかもしれませんね。ですが、これは単にコンピュータと対話する別の方法というだけです。アイコンをクリックする代わりに、命令文を文字で入力する、いわば「コンピュータとテキストメッセージをやり取りする」ようなものです。このガイドでは、コピー＆ペーストするだけで使える具体的な「命令文」を用意していますので、専門家である必要は全くありません。

Q6: 私のプライベートなメモがインターネットに送信されるのですか？プライバシーは大丈夫ですか？
A: 非常に重要なご質問です。はい、AIから回答を得るために、作業対象の文章はAnthropic社（Claude）やGoogle社（Gemini）のサーバーに送信されます。各社のプライバシーポリシーによれば、有料プランユーザーのデータがモデルの学習に使用されることはないとされています。しかし、万全を期すため、パスワードや金融情報、個人を特定できる機密情報など、極めてプライベートな内容にはこれらのツールを使用しないことを強く推奨します。ブログの下書きや公開情報のリサーチ、創作活動などに最適です。

まとめ：AI編集チームと共に、次のレベルのブログ執筆へ

Claude CodeのSubagents(サブエージェント)は、まさに「一人ブロガーから編集部体制への革命」です。

この記事で学んだことを振り返ると：

✅ Subagents(サブエージェント)の本質：専門家チームを持つ感覚で、AIの「忘れっぽさ」を解決
✅ 3つの大きなメリット：品質向上、時間短縮、コスト削減
✅ 具体的な設定方法：YAMLファイルの作成から呼び出し方まで
✅ 実践的な設定例：Apple、シニアサポート、生活情報の専門エージェント
✅ トラブル対処法：よくあるエラーと解決方法

これからのあなたのブログ執筆は：

• もう一人で悩まない：専門家チームがいつでもサポート
• 品質の向上：各分野のプロが担当するから、読者満足度アップ
• 効率的な作業：複数の記事を同時進行で作成可能
• コスト削減：AIの無駄遣いが減り、経済的にも安心

特にMacユーザーの方には：
ショートカットアプリとの連携で、さらに自動化を進められます。朝のコーヒータイムに、自動でSubagents(サブエージェント)が記事の下書きを準備してくれる…そんな未来も夢ではありません。

初心者やシニア世代の読者をお持ちの方へ：
Subagents(サブエージェント)を使うことで、より寄り添った内容、分かりやすい表現、実用的なアドバイスを提供できるようになります。読者の方々の「分からない」「不安」という気持ちに、これまで以上に応えられるでしょう。

最後に…

AIは日々進化していますが、それを使いこなすのは、やはり私たち人間の温かい心と創意工夫です。Subagents(サブエージェント)を使って、あなただけの個性的で読者に愛されるブログを、一緒に育てていきませんか？

あなたのブログが、読者の毎日をちょっと豊かに、ちょっと便利に、そしてちょっと楽しくしてくれることを心から願っています。

さあ、今日からあなたも立派なAI編集長ですよ！🎉

今回は、ちょっと技術的なお話になるのですが、AIとMacの新たな可能性について書かせていただこうと思います。

日々、Macコーチングやシニア向けコンテンツ作成、ブログ執筆などをしているのですが、AIの力をもっと活用できないかなと思ったことはありませんか？私はこれまでObsidianをナレッジベースとして使いながら、Gemini CLIでAIの力を借りてきたのですが、「もっと高度な対話ができないかな」「Obsidianのノートとシームレスに連携できないかな」という思いが日に日に強くなっていました。

特に、シニアの方々に分かりやすいAppleデバイスの使い方を説明する際や、技術的なブログ記事を執筆する際に、より自然で文脈を理解したAIアシスタントが欲しいなと感じていたのです。

同じような思いを持たれている方も結構居られるのではないでしょうか？

そこで目をつけたのが、私が日々一番利用している「Claude Code」。Claude AIの高度な理解力と生成能力を、コマンドライン（CLI）から直接活用できるツールなのですが、このツールをMacにインストールし、Obsidianと連携させるまでには、予想以上の試行錯誤がありました。

この記事では、私が経験した挫折と成功の物語を共有しながら、MacでClaude CodeをインストールしてObsidianと連携させる方法をご紹介したいと思います。同じ悩みを持つ方々の時間を節約し、AI活用の可能性を広げるお手伝いができれば幸いです。

なぜClaude Codeに注目したのか

Claudeの進化と可能性

私がClaude Codeに注目した理由は、まずClaude AIそのものの進化にあります。特にClaude 3シリーズ（Opus/Sonnet/Haiku）、そして2025年に登場した最新のClaude 4は、以下の点でほんまに驚くべき能力を示しています：

• 自然な日本語理解と生成: シニア向けの分かりやすい説明文や、専門的な内容の平易な言い換えが得意
• コード理解と生成: AppleScriptやMac関連のコマンド生成・解説が正確
• 文脈理解の深さ: 長い会話や複雑な指示でも文脈を維持できる
• ファイル操作と分析: ドキュメントを読み込んで分析・編集できる

これまで使っていたGemini CLIの限界

一方、これまで使っていたGemini CLIには、以下のような限界を感じていました：

• 一問一答型: 継続的な文脈の維持が難しい
• ファイル操作の制約: Obsidianのノートとの連携が煩雑
• セッション管理: 長時間の作業で文脈が途切れる
• コード生成: 特にMac関連のスクリプトで精度に課題

Claude CodeとGemini CLIの根本的な違い

この二つが、それぞれ何を目指しているのかを知ると、違いが分かりやすいです：

• Gemini CLI：
  • 「リクエスト・レスポンス」型のワークフロー
  • 単一コマンドでプロンプトを送信し、結果を受け取る
  • 例：
    gemini generate "Macのショートカットキーを3つ紹介して"
• Claude Code：
  • 「対話型セッション」のワークフロー
  • 一度起動すると継続的な会話として進行
  • カレントディレクトリのファイルを認識し、操作できる
  • 例：
    claude
>MacのFinderでよく使うショートカットを3つ教えて
>そのショートカットをシニア向けに説明し直して

この違いを理解した上で、私はClaude Codeの可能性に大きな期待を抱いたということになります。しかし、その導入は想像以上に難儀な道のりだったのです。

試行錯誤の道のり：Claude Codeをインストールするまでの挑戦

第一の壁：ObsidianプラグインでのClaude連携

最初に試みたのは、ObsidianのText Generatorプラグインを使ってClaudeと連携する方法でした。

1, 「Anthropic Legacy」の罠

• プラグイン設定で「Anthropic Legacy」しか選択肢がなく、モデルも「claude-2.1」に限定されていました。



• 「Custom」設定を使って最新のエンドポイントとモデル名を設定しようとしたのですが…

2. モデル名の確認

• Anthropicの公式APIドキュメントで最新のモデル名を確認するとclaude-sonnet-4-20250514またはclaude-opus-4-20250514でした

3. 致命的なエラー

• 設定を終えてテストすると「TG Error: l.text is not a function」というエラーが発生。



• API応答形式とプラグインの期待する形式の不一致が原因と判明しました。
• プラグイン経由では最新のClaudeモデルを使えないという壁にぶつかったということになります。

第二の壁：CLIでの奮闘

プラグインでの連携を諦め、コマンドラインツールを探すことにしました。

1. 既存のclaudeコマンドの発見

• ターミナルでclaudeコマンドを実行すると、なんとセキュリティ確認画面が表示！
• しかし、バージョンが古い（0.2.19）ため、アップデートが必要と表示される状況でした。

2.アップデート地獄

• claude updateコマンドを実行するも、同じメッセージが繰り返し表示される悪循環。
• Homebrewでの更新を試みるも、brew upgrade claudeで「Cask ‘claude’ is not installed.」というエラー。
• which claudeで/opt/homebrew/bin/claudeと表示されるのに、brew list | grep claudeでは何も表示されない謎の状況でした。

3. インストール方法の迷宮

• brew tap anthropic/tapを試みると、GitHubの認証が求められる不可解な状況
• 直接GitHubリポジトリをクローンしようとしても認証を要求される



• curl -fsSL https://raw.githubusercontent.com/anthropic/claude-cli/main/install.sh | bashを実行するも404エラー。

4. npmでの試行錯誤

• npm install -g @anthropic-ai/claude-cliを実行するも「404 Not Found」エラー。
• パッケージが存在しない、または配布終了の可能性が浮上しました。

突破口：正しいパッケージ名の発見

数々の失敗を経て、note記事「【2025年7月最新版】ClaudeCodeをＭacにインストールする方法【超初心者向け】」を発見。そこには最新の情報が書かれていました。

正しいnpmパッケージ名は「@anthropic-ai/claude-code」だったのです！

 # 正しいインストールコマンド
npm install -g @anthropic-ai/claude-code

このコマンドを実行すると、あっさりとインストールが完了。長い試行錯誤の末、ついにClaude Codeを手に入れることができました。

成功への道：正しいインストール手順【決定版】

ここからは、私の試行錯誤から学んだ、最も確実なClaude Codeのインストール方法をご紹介します。

前提条件の確認

まずは以下の条件を満たしているか確認しましょう：

• macOSの最新版：macOS Monterey(12.0)以降推奨
• Node.jsのインストール：バージョン16以上が必要
• Homebrewのインストール：最新のパッケージ管理に必要

ステップバイステップのインストール手順

1. Homebrewの確認・インストール

 
# Homebrewがインストールされているか確認
which brew

# インストールされていない場合は以下を実行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# PATHの設定（表示された指示に従ってください）
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

2. Node.jsのインストール

 
# Node.jsがインストールされているか確認
node --version

# インストールされていない場合は以下を実行
brew install node

3. Claude Codeのインストール

 
# 正しいパッケージ名でインストール
npm install -g @anthropic-ai/claude-code

4. インストールの確認

 
# Claude Codeのバージョン確認
claude --version

バージョン「1.0.24」以上が表示されれば成功です！

Obsidianとの究極連携：Terminalプラグインの設定

Claude Codeをインストールできたら、次はObsidianと連携させましょう。ここが最も重要なポイントです。

Terminalプラグインのインストールと基本設定

1. Terminalプラグインのインストール

1. Obsidianの設定 → コミュニティプラグイン → 参照
2. 「Terminal」を検索してインストール
3. プラグインを有効化

2. プロファイルの作成

1. Terminal設定画面を開く
2. 「Profiles」セクションで新規プロファイルを作成



3. [Prepend]の[(Unselected)]をクリックしドロップダウンメニューから[macOs default: Integrated]を選択します



4. [Prepend]の最上段に新しく設定する項目が表示されるので[編集]アイコンをクリックします



5. プロファイル名を「Claude_code」などに設定

3. 魔法の設定

1. [Arguments]の[編集アイコン]をクリックします



2. [Arguments]の[Prepend]の横の[+]をクリックします



3. [1th]に以下を入力します



 
-c

4. [Prepend]の横の[+]をクリックし以下のコマンドを2thに入力します

もし先程の「-c」が2thに移動したら右横の[↑]を|クリックすると1thに移動します


 
export PATH="/opt/homebrew/bin:$PATH" && cd "/Users/$(whoami)/Library/Mobile Documents/iCloud~md~obsidian/Documents/Obsidian" && exec zsh

5. 最後に右上の[X]をクリックして終了します

設定の技術的解説:

この設定には3つの重要な要素があります：

1. export PATH="/opt/homebrew/bin:$PATH"：

・Homebrewでインストールしたclaudeコマンドへのパスを追加
・どのディレクトリからでもclaudeコマンドを実行可能に

2. cd "/Users/$(whoami)/Library/Mobile Documents/iCloud~md~obsidian/Documents/Obsidian":

・iCloud上のObsidianボルトディレクトリに自動的に移動
・Claude Codeは起動ディレクトリのファイルにアクセスするため、これによりObsidianのノートを直接操作可能に
・iCloudを使うことで、デバイス間同期と自動バックアップの恩恵も

3. exec zsh：

・現在のシェルプロセスを新しいzshセッションに置き換え
・上記の設定（PATHとディレクトリ）を維持したまま新しいシェルを起動

Claude Codeの起動と初期設定

1. 起動方法：

・Obsidianのサイドバーから「Terminal」アイコンをクリック

・プロファイル選択で「Claude_code」を選択

・ターミナルが開いたら、claudeコマンドを実行

2. セキュリティ確認への対応：

    
   Do you trust the files in this folder?
   /Users/yoidore/Library/Mobile Documents/iCloud~md~obsidian/Documents/Obsidian
   
   Claude Code may read files in this folder...
   

   ・「Yes, proceed」を選択（または「1. Yes, proceed」を選択）

3. 基本コマンドの確認：

・/help – 利用可能なコマンドの一覧を表示
・/status – 現在の設定状況を確認
・/init – CLAUDE.mdファイル作成（プロジェクト初期化）
・/terminal-setup – ターミナル統合の設定
・/exit – Claude Codeを終了

効率化のコツ：ワークフローを洗練させる

Claude Codeをさらに効率的に使うためのテクニックをご紹介します。

プロジェクト別ディレクトリ構成

Obsidian内で以下のようなフォルダ構造を作ると整理しやすくなります：

<code>Obsidian Vault/
├── Mac-Coaching/
│   ├── AppleScripts/
│   ├── Shortcuts/
│   └── Tutorials/
├── Senior-Content/
│   ├── Apple-Watch/
│   ├── Mac-Basics/
│   └── Security/
└── Blog-Drafts/
    ├── Published/
    └── WIP/</code>

各フォルダでclaudeを起動すると、そのコンテキストに特化した支援が受けられます。

エイリアス設定で作業を効率化

~/.zshrcまたは~/.bash_profileに以下のようなエイリアスを追加すると、効率的に作業できるかなと思います：

<code># プロジェクト別ディレクトリ + Claude Code起動
alias claude-mac="cd ~/Documents/Obsidian/your-vault/Mac-Coaching &amp;&amp; claude"
alias claude-senior="cd ~/Documents/Obsidian/your-vault/Senior-Content &amp;&amp; claude"
alias claude-blog="cd ~/Documents/Obsidian/your-vault/Blog-Drafts &amp;&amp; claude"</code>

CLAUDE.mdファイルの活用

/initコマンドを実行すると、現在のディレクトリにCLAUDE.mdファイルが作成されます。このファイルにプロジェクトの概要や指示を記載しておくと、Claude Codeがより的確な支援を提供できると思います。

例えば：

<code># プロジェクト：シニア向けApple Watchガイド

## 目的
70代以上のシニア向けにApple Watchの基本機能を分かりやすく解説する

## ガイドライン
- 専門用語は必ず平易な言葉で言い換える
- 具体的な例を多く使う
- 操作手順は細かく分ける
- 安心感を与える表現を心がける

## キーワード
- シニア
- Apple Watch
- 健康管理
- 簡単操作
- 安心</code>

Claude Code × Gemini CLI連携で“最強編集部”を作る

両方のツールを効果的に使い分けることで、より充実したワークフローを構築できると思います。

1. 役割分担をはっきりさせる

• Claude Code
  • クリエイティブな作業全般に特化
  • “編集長・書き手・校正者”の役割
  • 長文記事のドラフト作成、構成案、リライト、トーン調整、SEO用のタイトル・見 出し案、WordPress用の最終HTML化など
  • シニアや初心者にやさしい表現へのリライトにも最適
• Gemini CLI
  • バックエンドのバッチ処理＆リサーチ型作業に特化
  • “リサーチャー・情報整理係・自動化担当”の役割
  • トレンド情報や技術的最新情報の自動収集、ニュース/ブログの一括整理、ファイル整形やタグ付け、コード変換やグラフ化、キーワードの洗い出し、SEOチェックなど
  • コマンド一発で大量処理・定期情報更新が可能

2. ワークフロー例

3. 効果を最大化する

• 役割ごとにシステムプロンプトを明記

　Claude Codeには「編集長」、Gemini CLIには「情報整理係」など自分なりに役割宣言で用途をはっきり分けておくと混乱しなくて済みます。

• 中間ファイルはMarkdownで統一

　どちらのAIも柔軟に加工でき、作業の往復がスムーズに行えます。

• バッチ処理とGit運用の活用

　定期処理（cron＋Gemini CLI）で夜間に最新情報を自動収集・整理、朝起きてObsidianを開くだけでネタや下書きが揃う状態を目指して。

• クリエイティブ作業はClaudeの強みに、機械的処理・大量情報はGeminiに

　たとえば、複雑なコマンドの解説や正確性の検証はGemini、わかりやすい日本語文章やリライトはClaudeに任せる。

4. ポイントまとめ

• 大量・定型作業はGemini CLI、文章作成や校正はClaude Code
• Geminiで下ごしらえ、Claudeで仕上げ
• 自動化＝Gemini、クリエイティブ＝Claude

この使い分けを徹底できれば、個人でも「編集部＋リサーチ＋ウェブマスター」の役割をハイブリッドに効率よくこなせると考えています。

アイデア・企画 → リサーチ・執筆 → 再チェック → 改善のうち、「アイデア出し・リサーチ・構成作成・下書き・校正」など8割程度のタスクをAIで自動化できれば・・・などと夢見ています。

まとめ：AI活用の新たなステージへ

この記事では、Claude CodeのインストールからObsidianとの連携まで、私の試行錯誤から分かったことや、学んだことをお伝えしました。

Claude Codeは単なるAIツールではなく、知的作業を根本から変える可能性を秘めていると思います。

インストールと設定には少し手間がかかりますが、一度環境を整えれば、日々の創作活動や知識労働が飛躍的に効率化されると思います。

私自身、Claude CodeとObsidianの連携によって、コンテンツ制作の質と量が大きく向上しました。特にシニア向けの説明文作成や、技術的な内容の平易な言い換えにおいて、その効果は絶大だったのです。

同じような悩みを持たれている方が居られましたら、ぜひこの記事を参考にClaude CodeとObsidianの連携に挑戦してみてください。そして、あなた自身の活動がどのように変化するか、ぜひ共有していただければ嬉しいです。

私は10年前から愛用しているのですが、ご存知ないかたも多のではと思う、あらゆるデジタル情報を一元的に保存・管理し、AIの支援によって情報間の関連性を見つけ出し、独自の知識データベースを構築できるMac用の高機能なドキュメント管理アプリ「DEVONthink」がバージョン4に最近アップデートしました。

AIを使った強力な全文検索機能が強化されたのと、外部生成AIを使えるようになったのを機会に、Obsidianをインデックス化して、使えるようにしたので、この連携も探っていきたいと思っています。

最後までお読みいただき、ありがとうございました。これからのAI活用が、実り多きものになりますように！お役に立てれば何よりです。

私も同じ悩みを抱えていました。特に、2台のMacでログイン名が異なる環境では、設定が非常にややこしくなってしまいます。しかし、試行錯誤の末、ObsidianのコミュニティプラグインとGemini CLIを組み合わせることで、どちらのMacでもスムーズにAIを活用できる環境を構築できました。

この記事を読み終える頃には、あなたも複数のMac環境で統一されたAI執筆環境を手に入れ、執筆効率が大幅に向上することでしょう。

前提条件と参考リソース

この記事では、Gemini CLIのインストールと基本設定は完了している前提で進めます。まだインストールしていない方は、以下の優れた記事を参考にしてください。

初心者向けリソース

• 【初心者向け】WindowsでGemini CLIを使ってみよう！（Windows環境ですが、手順は参考になります）
• Gemini CLI の簡単チュートリアル – Zenn

技術的な詳細を知りたい方向け

• Gemini CLIを解説 – G-gen Tech Blog
• 【無料】Gemini CLIとは？インストール方法から使い方、料金を徹底解説！

トラブルシューティング

• Gemini CLIの初期設定！超簡単！…と思いきや大苦戦？（Google Workspaceユーザー必見）

なぜObsidianとGemini CLIの連携が必要なのか

Obsidianで長文を書いていると、こんな場面に遭遇することがあります。

• 書いた文章を要約してほしい
• アイデアをもっと広げたい
• 文章の表現を改善したい
• 関連する情報を調べたい

これらの作業で、いちいちブラウザを開いてGeminiにコピペするのは面倒ですよね。ObsidianからダイレクトにGemini CLIを呼び出せれば、思考の流れを止めることなく、AIの力を借りることができます。

iCloud Driveを使った複数デバイス同期について

私のような以前からのObsidianユーザーは、Obsidian Syncサービスが存在しなかった時代から、複数デバイスでの執筆環境を構築する必要がありました。

そこで多くのユーザーが採用したのが、iCloud DriveにVault（保管庫）を置くという方法です。これにより、デスクトップMac、MacBook Pro、iPad、iPhoneといったすべてのAppleデバイスから同じノートにアクセスできるようになりました。

「iCloud Driveは同期が遅い」という声を聞くこともありますが、私の経験では全く不便を感じたことがありません。例えば、移動中にiPadで記事の下書きを書いて、帰宅後にMacでObsidianを起動すると、すでに内容が反映されています。この即座の同期により、デバイスを意識することなく、いつでもどこでも執筆を続けることができるのです。

このiCloud Drive環境があるからこそ、今回紹介する複数Mac環境でのGemini CLI連携設定が重要になってくるのです。

必要なプラグインのインストール

まず、Obsidianのコミュニティプラグインから以下の2つをインストールします。

1. Terminalプラグイン

Obsidian内でターミナルを直接開けるようにするプラグインです。設定画面から「コミュニティプラグイン」を開き、「Terminal」で検索してインストールします。

2. Shell Commandプラグイン

カスタムコマンドを登録し、ショートカットキーで実行できるようにするプラグインです。同様に「Shell Commands」で検索してインストールします。

複数Mac環境での最大の難関：ログイン名の違い

ここが今回の記事の核心部分です。私の場合、デスクトップMacとMacBook Proでログイン名が異なっていたため、設定に非常に手間取りました。

例えば、デスクトップでは「desktop-user」、MacBook Proでは「laptop-user」というログイン名だった場合、Obsidianの保存場所へのパスが異なってしまいます。

デスクトップ: /Users/desktop-user/Library/Mobile Documents/...
MacBook Pro: /Users/laptop-user/Library/Mobile Documents/...

この問題を解決するために、

$(whoami)

というコマンドを使用しました。これは現在ログインしているユーザー名を自動的に取得してくれる便利なコマンドです。

Terminalプラグインの設定：統一プロファイルの作成

ステップ1：新規プロファイルの作成

Terminalプラグインの設定画面を開き、「Profiles」セクションで新規プロファイルを作成します。私は「Obsidian_Gemini」という名前にしました。

ステップ2：Argumentsの設定

ここが最も重要な部分です。以下の設定を行います：

1つ目の引数:
-c

2つ目の引数:

export PATH="/opt/homebrew/bin:$PATH" && cd "/Users/$(whoami)/Library/Mobile Documents/iCloud~md~obsidian/Documents/Obsidian" && exec zsh

この設定の意味を分解して説明します：

1. HomebrewでインストールしたGemini CLIへのパスを通します

export PATH="/opt/homebrew/bin:$PATH"

2. 現在のユーザー名を自動取得してObsidianのディレクトリに移動します

cd "/Users/$(whoami)/Library/Mobile Documents/..."

3. zshシェルを起動します

exec zsh

この設定により、どちらのMacでも同じプロファイルを使用できるようになりました。

Shell Commandプラグインでの自動化設定

Terminalプラグインで基本的な環境は整いましたが、さらに便利にするためにShell Commandプラグインを活用します。

よく使うコマンドの登録例

1. 選択テキストの要約

コマンド名: Summarize Selection
コマンド:

echo "{{selection}}" | gemini -p "この文章を3行で要約してください"

ショートカット: Cmd+Shift+S

2. アイデアの展開

コマンド名: Expand Idea
コマンド:

echo "{{selection}}" | gemini -p "このアイデアをさらに5つの観点から展開してください"

ショートカット: Cmd+Shift+E

3. 文章の改善提案

コマンド名: Improve Writing
コマンド:

echo "{{selection}}" | gemini -p "この文章をより分かりやすく、自然な日本語に改善してください"

ショートカット: Cmd+Shift+I

出力結果の処理

Shell Commandプラグインでは、コマンドの実行結果をどのように扱うかも設定できます。私のおすすめ設定は：

• Ignore；無視
• Notification balloon；通知バルーン
• Current file: caret position；現在のファイル：カーソル位置
• Current file: top；現在のファイル：先頭
• Current file: bottom；現在のファイル：末尾
• Open files；開いているファイル
• Status bar；ステータスバー
• Clipboard；クリップボード
• Assign custom variables；カスタム変数を割り当てる
• Ask after execution；実行後に確認する

これにより、結果を確認してから必要な部分だけをノートに貼り付けることができます。

実践的な活用シナリオ

朝の振り返りノート作成

毎朝、前日の作業内容を振り返るノートを作成しています。箇条書きで書いた内容を選択して、以下のコマンドを実行：

echo "{{selection}}" | gemini -p "この作業内容から、今日優先すべきタスクを3つ提案してください"

ブログ記事の構成作成

記事のアイデアをざっくり書いた後、それを選択して：

echo "{{selection}}" | gemini -p "このアイデアを元に、ブログ記事の見出し構成を作成してください"

技術メモの整理

散らかった技術メモを選択して：

echo "{{selection}}" | gemini -p "この技術メモを体系的に整理し、見出しをつけて構造化してください

トラブルシューティング

Gemini CLIが見つからないエラー

もし「command not found: gemini」というエラーが出た場合、PATHの設定を確認してください。M1/M2 Macの場合、Homebrewのパスが

/opt/homebrew/bin

になっていることが多いです。

日本語が文字化けする

ターミナルの文字コード設定を確認してください。Terminalプラグインの設定で、エンコーディングを「UTF-8」に設定すると解決することが多いです。

iCloud同期の遅延

複数デバイス間でObsidianを同期している場合、iCloudの同期遅延により最新のファイルが反映されないことがあります。重要な作業の前には、同期が完了していることを確認しましょう。

パフォーマンスの最適化

メモリ使用量の削減

Gemini CLIを頻繁に呼び出すと、メモリ使用量が増加することがあります。定期的にターミナルセッションを再起動することで、メモリを解放できます。

レスポンス速度の改善

長文を処理する場合、レスポンスに時間がかかることがあります。文章を適切な長さ（500〜1000文字程度）に分割して処理すると、より快適に使用できます。

さらなる活用のアイデア

テンプレートとの組み合わせ

Obsidianのテンプレート機能と組み合わせることで、さらに効率化できます。例えば、議事録テンプレートに「AI要約欄」を設けておき、会議後にワンクリックで要約を生成できます。

Daily Notesとの連携

Daily Notesプラグインと組み合わせて、毎日の振り返りを自動化することも可能です。その日のノートを丸ごとGemini CLIに渡して、重要なポイントを抽出してもらうことができます。

プラグイン連携の可能性

DataviewプラグインやTemplaterプラグインと組み合わせることで、より高度な自動化も実現できます。例えば、特定のタグがついたノートを自動的に収集し、それらを基にレポートを生成するといったワークフローも構築可能です。

まとめ：AI時代の新しい執筆スタイル

ObsidianとGemini CLIを連携させることで、思考と執筆のプロセスが劇的に変化しました。アイデアが浮かんだらすぐにAIに相談でき、文章の推敲も瞬時に行えるようになりました。

特に複数のMac環境で作業する私にとって、

$(whoami)

を使った統一設定の発見は大きなブレークスルーでした。この設定により、どちらのMacでも同じワークフローで作業できるようになり、生産性が大幅に向上しました。

AIツールは使い方次第で、単なる便利ツールから、思考のパートナーへと進化します。ぜひこの記事を参考に、あなたなりのAI執筆環境を構築してみてください。

きっと、執筆がもっと楽しく、もっと効率的になるはずです。

私もそうでした。アイデアはたくさんあるのに、それを形にする時間が足りない。アプリをいくつも切り替えながら作業しているうちに、集中力が途切れてしまう。そんな日々を送っていました。

しかし、ある方法を試してから、私の知的生産のスタイルは一変しました。それは、Googleの高性能AI「Gemini」をコマンドラインで操作できる「Gemini CLI」と、愛用しているノートアプリ「Obsidian」を連携させることです。

この記事では、AIや黒い画面（ターミナル）に不慣れな方でも、ステップバイステップで以下のことができるように、解説します。

• Gemini CLIをあなたのPC（Mac/Windows）にインストールする方法
• ObsidianとGemini CLIを連携させ、Obsidian内からAIを呼び出す方法
• この連携がなぜ「最強」なのか、そして日々の作業がどう変わるのか
• あなたの作業を自動化し、思考を加速させる応用テクニックの数々
• トラブルシューティングと安全な運用方法

始める前に：必要な環境と前提条件

本題に入る前に、この記事の内容を実践するために必要な環境を確認しましょう。

必要な環境

– OS: macOS 10.15以降 または Windows 10/11
– Obsidian: バージョン1.0以降（最新版を推奨）
– インターネット接続: Gemini APIとの通信に必須
– Googleアカウント: APIキーの取得に必要

Macユーザーの追加要件

– Homebrewがインストールされていない場合は、「公式サイト」から事前にインストールしてください

料金について

– Gemini APIには無料枠があります（1分あたり60リクエストまで）
– 個人利用なら無料枠で十分です
– 有料プランは大量のリクエストが必要な場合のみ検討してください

この記事を読み終える頃には、あなたはObsidianを単なるメモアプリとしてではなく、AIを搭載した「最強の思考の相棒」として使いこなせるようになっているはずです。さあ、一緒に未来の知的生産の世界へ足を踏み入れてみましょう。

そもそもGemini CLIって何？なぜ今、注目すべきなのか

「AIってChatGPTみたいなWebサイトで使うものじゃないの？」「CLIって、あの黒い画面のこと？なんだか難しそう…」と感じる方も多いかもしれません。大丈夫です、一つひとつ丁寧に説明しますね。

Gemini CLIとは、一言で言うと「いつものPCの”黒い画面”から、Googleの高性能AI『Gemini』と直接おしゃべりできるツール」です。

Webサイトを開いてログインして…という手間なく、キーボードだけでサッとAIに質問したり、文章の作成や要約、アイデア出しなどを依頼したりできます。これがなぜ凄いのかというと、他のツールとの「連携」や「自動化」が非常に得意だからです。

Webサイトで使うAIが「接客カウンターにいる優秀な店員さん」だとすれば、Gemini CLIは「工具箱に入っている、どんな機械にも接続できる万能アダプター」のようなもの。

単体でも便利ですが、他の道具と組み合わせることで、その真価を何倍にも発揮するのです。そして、その最高の組み合わせ相手の一つが、私たちが愛用するObsidianなのです。

【初心者歓迎】Gemini CLIインストール完全ガイド

ここからは、具体的な手順に入ります。あなたのPCにGemini CLIをインストールし、AIと初めての会話をするところまでを、詳しく解説します。MacとWindows、両方の手順を載せているので、ご自身の環境に合わせて進めてください。

未来の扉を開く第一歩：APIキーの取得と安全な管理

まず最初に、Geminiと対話するための「鍵」を手に入れる必要があります。これを「APIキー」と呼びます。

1. Google AI Studioにアクセス**: まず、お使いのブラウザで [Google AI Studio]にアクセスし、Googleアカウントでログインしてください。
2. APIキーを作成:

　- 画面の左側にあるメニューから「Get API key」をクリックします。
　- 「Create API key in new project」というボタンが表示されるので、これをクリックします。
　- 少し待つと、英数字の長い文字列が表示されます。これがあなたのAPIキーです。

🔐 APIキーの安全な管理方法

このAPIキーは、あなたの家の鍵やパスワードと同じくらい大切なものです。絶対に他人に見せたり、公開の場所に貼り付けたりしないでください。

推奨される保管方法：

1. パスワードマネージャーを使う（1Password、Bitwardenなど）
2. 環境変数として設定する（後述）
3. 一時的にメモ帳に保存する場合は、必ず作業後に削除する、Macの「メモ」アプリではメモにパスワードでロックをする

万が一APIキーが漏洩した場合：
　- すぐにGoogle AI Studioにアクセスし、古いキーを削除
　- 新しいキーを生成して置き換える

Node.jsバージョン要件

Mac/WindowsともにNode.js 18以上が必要です。

• バージョン確認方法
  

  node -v 

• インストールされていない場合
  
  Macの場合（Homebrewを利用）:

  brew install node 

  Windowsの場合（公式インストーラー）:
  
  Node.js公式サイトから「LTS版」をダウンロードし、インストーラーを実行してください。

　- MacではHomebrew、Windowsでは公式インストーラー利用が最も一般的です。
　- nvmなどのバージョン管理ツールも便利ですが、初心者向けには上記がシンプルです。

Macユーザー向け：Homebrewで驚くほど簡単にインストール

Macユーザーの方で、「Homebrew」というパッケージマネージャーを使っているなら、インストールは本当に一瞬で終わります。

1. ターミナルを開く: まず、「ターミナル」アプリを開きます。LaunchpadやSpotlight検索（command + space）で「terminal」と入力すれば見つかります。
2. インストールコマンドを実行: 以下のコマンドをコピーしてターミナルに貼り付け、Enterキーを押してください。

    brew install google-gemini/gemini/gemini-cli
   

Homebrewが自動的に必要なファイルをダウンロードし、インストールしてくれます。

3. 初期設定を行う: インストールが終わったら、次に以下のコマンドを実行します。

    gemini
   

「Please enter your Gemini API key:」と表示されたら、先ほど取得したあなたのAPIキーを貼り付けてEnterキーを押します。これで設定は完了です。

Homebrewがインストールできない場合：

    npm install -g @google/gemini-cli
   

上記のコマンドでHomebrewをインストールしてから、Gemini CLIのインストールに進んでください。

Windowsユーザー向け：PowerShellを使ったインストール手順

Windowsユーザーの方は、「PowerShell」というツールを使ってインストールします。

1. PowerShellを管理者として実行:

　- スタートメニューを右クリックし、「Windows PowerShell (管理者)」または「Windows ターミナル (管理者)」を選択します。
　- 「このアプリがデバイスに変更を加えることを許可しますか？」と表示されたら「はい」をクリックします。

2. インストールコマンドを実行: 表示された青い画面（PowerShell）に、以下のコマンドをコピーして貼り付け、Enterキーを押してください。

    npm install -g @google/gemini-cli
   

これにより、インストール用のスクリプトが実行されます。

3. 初期設定を行う: インストール完了後、Macと同様に以下のコマンドで初期設定を行います。

    gemini
   

APIキーを尋ねられるので、コピーしておいたキーを貼り付けてEnterキーを押してください。

環境変数として設定する（より安全な方法）

APIキーをより安全に管理したい場合は、環境変数として設定することをお勧めします。

Macの場合：

echo 'export GEMINI_API_KEY="あなたのAPIキー"' >> ~/.zshrc
source ~/.zshrc
   

Windowsの場合（PowerShell）：

[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "あなたのAPIキー", "User")
   

動作確認：Geminiと初めての会話

さあ、いよいよAIと会話してみましょう！MacでもWindowsでも、ターミナル（またはPowerShell）に以下のコマンドを打ち込んでみてください。

gemini "こんにちは！今日の気分はどう？"
   

数秒待って、AIからの返事が表示されれば成功です！「私の気分は最高です！何かお手伝いできることはありますか？」といった返事が来たら、あなたはもうAIとコマンドラインで対話する未来のユーザーの一員です。この小さな成功体験が、大きな変化への第一歩になります。

もしエラーが出た場合は、後述のトラブルシューティングセクションを参照してください。

Obsidianとの連携：思考ツールを「相棒」に進化させる

さて、ここからが本番です。インストールしたGemini CLIを、私たちの第二の脳であるObsidianと連携させていきます。なぜこの連携がこれほどまでに強力なのか、そしてどうやって実現するのかを詳しく見ていきましょう。

なぜObsidianと連携させると凄いのか？そのメリットを解説

この連携の最大のメリットは、思考の流れを一切止めずにAIの力を借りられることです。

普段の私たちの作業を思い返してみてください。Obsidianで記事の下書きを書いている途中で、「この部分、もっと良い表現ないかな？」とか「このテーマについて、もう少しアイデアが欲しいな」と思うことがありますよね。

これまでのやり方だと、

1. ブラウザを開く
2. ChatGPTなどのAIサービスにアクセスする
3. Obsidianからテキストをコピーして、ブラウザに貼り付ける
4. AIからの返事をコピーして、またObsidianに貼り付ける

…というように、何度もアプリを切り替える必要がありました。このコンテキストスイッチが、私たちの集中力を奪い、思考を中断させてしまう大きな原因でした。

しかし、Gemini CLIとObsidianを連携させると、このプロセスが劇的に変わります。Obsidianの画面から一歩も出ることなく、選択した文章を要約させたり、続きを書かせたり、誤字脱字をチェックさせたりすることが可能になるのです。

つまり、Obsidianが単なる「メモを記録する場所」から、「AIアシスタントと壁打ちしながら思考を深める場所」へと進化するのです。これは、単なる時間短縮以上の、思考の質の向上に直結します。

連携の要！コミュニティプラグイン「Shell Commands」の導入

この魔法のような連携を実現するために、Obsidianのコミュニティプラグイン「Shell Commands」を導入します。これは、Obsidianの中からターミナルで使うコマンド（シェルコマンド）を実行できるようにする、非常に強力なプラグインです。

1. コミュニティプラグインを有効化:


　- Obsidianの左下にある歯車アイコン（設定）をクリックします。
　- 左側のメニューから「コミュニティプラグイン」を選び、「コミュニティプラグインを有効にする」ボタンをクリックします。（もし警告が出ても、内容を理解した上で「有効にする」で大丈夫です）


2. Shell Commandsをインストール:


　- 「コミュニティプラグイン」の設定画面で、「閲覧」ボタンをクリックします。
　- 検索窓に「Shell Commands」と入力すると、プラグインが表示されます。
　- 「インストール」ボタンをクリックし、インストールが終わったら「有効化」ボタンをクリックします。

これで、Obsidianの中からGemini CLIを呼び出す準備が整いました。

ステップバイステップで作る！「選択範囲を要約する」コマンド

それでは、記念すべき最初の連携コマンドを作成してみましょう。ここでは、Obsidian上で選択したテキストをGeminiに要約させるコマンドを作ります。

1. Shell Commandsの設定を開く:
　- Obsidianの設定画面に戻り、左側のメニューを下にスクロールすると「Shell Commands」という項目が追加されているので、それをクリックし「>_Shell commands」タブを選択します。
2. 新しいコマンドを追加:
　- 「New Shell command」というボタンをクリックします。

3. コマンドを設定する:
　- いくつかの入力欄が表示されますが、まずは以下の部分を設定します。
　- 「Shell command without alias」の右にある「歯車」をクリックします

　- Command name (for command palette): ここには、コマンドパレット（`command + P` or `Ctrl + P`）で呼び出すときの名前を入力します。「General」タブを選択し、「Alias」欄に、例えば「Gemini: 選択範囲を要約する」と入力しましょう、終わったら右上の「X」で閉じます。

　- 「Gemini: 選択範囲を要約する」の下のEnter your command: ここに、実際に実行するコマンドを入力します。以下の魔法の呪文をコピーして貼り付けてください。

            gemini -p "以下の文章を3行で分かりやすく要約してください。: {{selection}}"
   

– リンクアイコンの横の「+」 をクリックしてショートカットキーを登録しておくとコマンドパレットから選択する事なく実行できます。「歯車」をクリック」の横の「歯車」をクリックします。

解説：
– `gemini -p “…”` は、Geminiに指示（プロンプト）を出すための基本形です。
– `{{selection}}` がShell Commandsプラグインの特別な記法で、これが「Obsidian上で選択しているテキスト」に自動的に置き換わります。

4. 出力設定を調整する:
– 「歯車」をクリックし、「Output」タブを選択し「Output channel for stdout」というセクションがあります。ここで結果の表示方法を選べます：
– 「Ignore」をクリックするとドロップメニューが表示されます
– Current file: caret position: 現在のファイル: カーソル位置
– Current file: top: 現在のファイル: 上部
– Current file: bottom: 現在のファイル: 下部
– Open files: ファイルを開く

5. エラーハンドリングの設定:
「Output channel for stderr」セクションで、エラーが発生した時の動作を設定できます。「Error balloon」を選んでおくと、問題があった時にすぐ気づけます。

6. コマンドを実行してみる！:
– 設定画面を閉じ、Obsidianのどれかのノートを開いて、適当な文章をマウスで選択します。
– コマンドパレットを開き（Mac: `command + P` / Win: `Ctrl + P`）、「Gemini」と入力すると、先ほど作成した「Gemini: 選択範囲を要約する」というコマンドが表示されるはずです。
– それをクリック（またはEnterキーを押下）してみてください。
– 数秒後、画面にGeminiが生成した要約が表示されたら、大成功です！

Windowsユーザー向けの注意点：パス指定

Windowsユーザーの方は、パスの指定に注意が必要です：
– パス区切り文字は`/`（スラッシュ）を使うのが安全です
– 日本語を含むフォルダ名は避けるか、英語のエイリアスを作成することをお勧めします
– スペースを含むパスは`”`（ダブルクォーテーション）で囲む必要があります

どうでしょう？この体験だけでも、今後の可能性にワクワクしてきませんか？同様の手順で、「選択範囲を校正する」「選択範囲を元にブログのタイトルを10個考える」など、アイデア次第で無限のコマンドを作成できます。

Gemini CLI使いこなし術：あなたの作業を自動化する魔法の呪文

基本的な連携ができるようになったら、次はさらに一歩進んで、日々の作業を劇的に効率化するための応用テクニックを見ていきましょう。これらの「魔法の呪文」を覚えれば、あなたはGemini CLIを自由自在に操れるようになります。

プロンプトを制する者はAIを制す：テンプレート機能の活用

先ほど作成した「要約コマンド」は便利ですが、毎回「以下の文章を要約して…」と書くのは少し面倒ですよね。特に、記事作成のように複雑で長い指示を毎回与えるのは非現実的です。そこで活躍するのが、プロンプトのテンプレート化です。

これは、よく使う指示（プロンプト）を別のファイルとして保存しておき、必要な時に呼び出すテクニックです。

1. プロンプト用のフォルダとファイルを作成:


　- ObsidianのVault内に、「_templates」や「プロンプト」といった名前のフォルダを作成します。
　- そのフォルダ内に、例えば「ブログ記事作成.md」という名前で新しいノートを作成します。
　- このノートに、記事を作成させたい時の詳細な指示を書き込みます。例えば：

    
    あなたは優秀なブログライターです。以下の条件に従って記事を作成してください：

    ## 文体・トーン
    - 親しみやすく、読者に語りかけるような文体
    - 専門用語は使わず、初心者にも分かりやすく説明
    - 具体例を多く含める

    ## 構成
    - 導入部で読者の共感を得る
    - 本文は見出しで区切り、読みやすく
    - まとめで行動を促す

    ## SEO対策
    - 適切なキーワードを自然に配置
    - 見出しにもキーワードを含める

    以下のテーマについて、上記の条件で記事を作成してください：
    

2. `@`記号でテンプレートを呼び出す:


　- Shell Commandsで新しいコマンドを作る際に、以下のように `@`記号を使ってテンプレートファイルを指定します。

        # ブログ記事作成.md の指示を読み込み、選択範囲を元に記事を書かせるコマンド
        gemini -p "@プロンプト/ブログ記事作成.md {{selection}}"
   

　- `@`の後にテンプレートファイルへのパスを記述するだけで、Geminiはそのファイルの中身をすべてプロンプトとして読み込んでくれます。

この方法を使えば、「ブログ用」「YouTube台本用」「メール返信用」など、用途に応じた複数のテンプレートを用意しておき、コマンドを切り替えるだけで、一貫した品質のアウトプットをAIに生成させることが可能になります。

コマンドラインの真骨頂：パイプ機能（`|`）で広がる可能性

次にご紹介する「パイプ（`|`）」は、コマンドラインの世界で古くから使われている、非常に強力な機能です。これを例えれば「コマンドのバケツリレー」でしょうか。あるコマンドの実行結果を、次のコマンドにそのまま「はい、どうぞ」と渡すことができるのです。

これとGemini CLIを組み合わせると、Obsidianの外にある情報も簡単に扱えるようになります。

ローカルにあるファイルを丸ごと要約する（より安全な方法）
`cat`というコマンドは、ファイルの中身を表示するコマンドです。ファイルの存在確認も含めた、より安全な例を示します：

    # ファイルが存在する場合のみ実行（Mac/Linux）
    [ -f meeting-memo.txt ] && \
 cat meeting-memo.txt | \
gemini -p "この議事録から、私のアクションアイテムを箇条書きで抽出してください。"
    
    # Windows PowerShellの場合
    if (Test-Path meeting-memo.txt) { Get-Content meeting-memo.txt | \gemini -p "この議事録から、私のアクションアイテムを箇条書きで抽出してください。" }
   

Webサイトの内容を分析する
`curl`というコマンドは、Webサイトの情報を取得するコマンドです。気になるニュース記事やブログ記事のURLを指定すれば、その内容をGeminiに分析させることができます。

    # 指定したURLのWebページの内容を取得し、その要点を3つにまとめさせる
    curl -s https://www.example.com/news/latest | \
gemini -p "この記事で最も重要なポイントは何ですか？3つに絞って教えてください。"
   

このようにパイプ機能を使えば、GeminiはあなたのPCやインターネット上の情報を直接処理できる、真のアシスタントになります。

AIの性格を操る？モデルとパラメータの調整

Gemini CLIでは、AIの「性格」や「能力」を微調整することもできます。ここでは、特に重要な2つのオプションをご紹介します。

モデルの選択 (`–model`):
Geminiにはいくつかのモデルがあり、それぞれに得意なことや性能が異なります。現状では、主に2つを使い分けると良いでしょう。
　- `gemini-1.5-pro`: 非常に高性能で、複雑な指示や長文の理解が得意な万能モデル。普段はこちらを使うのがおすすめです。
　- `gemini-1.5-flash`: Proモデルよりも高速で、コストも低いモデル。素早い回答が欲しいアイデア出しや、簡単なタスクに向いています。

    # Flashモデルを使って、素早くブログのタイトル案を10個出してもらう
    gemini --model gemini-1.5-flash -p \
"「Obsidian 効率化」というテーマで、魅力的なブログタイトルを10個考えて。"
   

創造性の調整 (`–temperature`):
このパラメータは、AIの回答の「創造性」や「ランダム性」を調整するボリュームのようなものです。値は0.0から1.0の間で設定します。
　- 低い値 (例: 0.2): 回答がより事実に忠実で、一貫性のあるものになります。文章の要約や翻訳、データ整理など、正確性が求められる作業に向いています。
　- 高い値 (例: 0.9): 回答がよりクリエイティブで、多様な、時には驚くようなアイデアを出してくれます。ブレインストーミングやキャッチコピーの考案など、発想の広がりが欲しい時に有効です。

    # Temperatureを高めにして、斬新なキャッチコピーを考えさせる
    gemini --temperature 0.9 -p \
"新しいコーヒー豆の、誰も思いつかないようなキャッチコピーを5つ提案して。"
   

これらのパラメータを使いこなすことで、あなたはまるでオーケストラの指揮者のように、AIの能力をタスクに応じて最適に引き出すことができるようになります。

トラブルシューティング：よくある問題と解決方法

連携設定中に問題が発生した場合の対処法をまとめました。

「command not found: gemini」エラー

原因： Gemini CLIが正しくインストールされていない、またはPATHが通っていない

解決方法：
1. インストールが完了しているか確認

# Mac/Linux
which gemini

# Windows
where gemini
   

2. npmのグローバルパスを確認し、PATHに追加

   npm bin -g
　# 例: /usr/local/bin または /Users/ユーザー名/.npm-global/bin など
   

APIキーが認識されない

原因： APIキーが正しく設定されていない

解決方法：

# 再度初期設定
gemini
# 画面の指示に従い、Google認証またはAPIキー入力

# または環境変数を確認
echo $GEMINI_API_KEY  # Mac/Linux
echo $env:GEMINI_API_KEY  # Windows PowerShell
   

文字化けが発生する

原因： 文字エンコーディングの問題

解決方法：
– Windowsの場合、PowerShellで以下を実行：

  chcp 65001
   

– ターミナルの文字エンコーディングをUTF-8に設定

Shell Commandsで結果が表示されない

原因： Output handlingの設定ミス

解決方法：
1. Shell Commandsの設定を開く
2. 該当コマンドの「Output handling」を「Display in modal」に変更
3. 「Error handling」も「Display in notification」に設定

他のプラグインとの連携・代替手段

Shell Commands以外にも、ObsidianとAIを連携させる方法があります。

Templaterプラグインとの併用

Templaterプラグインを使えば、より高度なテンプレート処理が可能です：

<%* 
const selection = tp.file.selection();
const result = await tp.system.shell(`gemini -p "要約して: ${selection}"`);
tR += result;
%>
   

QuickAddプラグインとの比較

QuickAddも外部コマンド実行に対応していますが：
– Shell Commands: より細かい設定が可能、エラーハンドリングが充実
– QuickAdd: マクロ機能が強力、複数の操作を組み合わせやすい

用途に応じて使い分けるのがおすすめです。

セキュリティとプライバシーの考慮事項

機密情報の扱い

• Gemini CLIはローカルで動作するが、プロンプト内容はGoogleサーバーに送信されるので、社内文書や個人情報を含むノートは、AIに送信する前に必ず内容を確認
• 機密情報を含む可能性がある場合は、その部分を削除してから送信
• 認証方法ごとにプライバシーポリシーが異なるので、会社のセキュリティポリシーを確認し、外部AIサービスの利用が許可されているか確認

データの保護

1. 定期的なバックアップ


– Shell Commandsの設定をエクスポート（設定画面の「Export」ボタン）
– プロンプトテンプレートフォルダを定期的にバックアップ


2. APIキーの定期的な更新


– 3-6ヶ月ごとにAPIキーを再生成することを推奨

パフォーマンスの最適化

長文処理時の注意点

– 10,000文字を超える文章は、分割して処理することを推奨
– レート制限（1分あたり60リクエスト）に注意

効率的な使い方

1.よく使うコマンドにホットキーを割り当てる
– Shell Commandsの設定で「Hotkey」を設定可能

2. バッチ処理の活用
– 複数のノートを一度に処理する場合は、シェルスクリプトを作成

ここまで、本当に長い道のりでしたね。しかし、あなたは今、Gemini CLIをインストールし、Obsidianと連携させ、さらにはその能力を最大限に引き出すための応用テクニックまで、その全てを学びました。

振り返ってみましょう。

• 私たちはまず、Gemini CLIをPCに導入し、AIと直接対話する力を手に入れました。
• 次に、Obsidianと連携させることで、思考の流れを断ち切ることなく、AIを「思考の相棒」として迎え入れました。
• そして、テンプレートやパイプ機能、パラメータ調整といった応用術を学び、AIをより自在に、そして深く使いこなすための扉を開きました。
• さらに、トラブルシューティングやセキュリティについても学び、安全で快適な運用方法を身につけました。

この構成がもたらすのは、単なる「作業の効率化」や「時間の節約」だけではありません。それは、「思考の質の向上」です。

アイデアが浮かんだ瞬間にAIと壁打ちできる環境。膨大な資料を瞬時に要約し、エッセンスを抽出できる能力。自分の思考の癖とは違う、新たな視点をいつでも得られる安心感。これらすべてが、あなたの知的生産をより深く、より創造的なものへと導いてくれるはずです。

もちろん、最初からすべてを完璧に使いこなす必要はありません。まずは今日作成した「選択範囲を要約する」コマンドを、日々の情報収集で使ってみてください。そして、慣れてきたら、あなた自身の作業に合わせて、新しいコマンドを一つ、また一つと育てていってください。

次のステップ

1. 基本コマンドを作成する


– 要約、校正、アイデア出しの3つから始める


2. テンプレートを充実させる


– 自分の用途に合わせたプロンプトテンプレートを作成


3. コミュニティと繋がる


– ObsidianフォーラムやDiscordで、他のユーザーの活用事例を学ぶ

さあ、あなたの第二の脳は、最高の相棒を得て、今、新たな可能性に満ちています。
まずはターミナルを開き、あなたの手で、未来の知的生産への第一歩を踏み出してみましょう！

特に、ChatGPTやNotionといった強力なツールをObsidian上で直接表示できれば、作業効率は飛躍的に向上するでしょう。ノートを取りながらAIに質問したり、Notionのデータベースを参照したりと、コンテキストスイッチングによる集中力の低下を防ぐことができます。

本記事では、ObsidianからChatGPTやNotionを直接利用する方法について詳しく解説します。

Obsidianと外部サービスの連携がもたらすメリット

Obsidianは強力なナレッジ管理ツールですが、単体ではカバーしきれない機能があります。例えば、AIによる文章生成や表形式のデータベース管理などは、それぞれChatGPTやNotionが得意とする分野です。これらのツールをObsidian上で統合することで、以下のようなメリットが生まれます。

• アプリケーション間の行き来が不要になるため、作業の流れが途切れることなく、集中力を維持できます。
• ノートを取りながら疑問点が生じたら、すぐにChatGPTに質問できます。
• Notionのデータベースを参照しながらObsidianでノートを作成することも可能になります。
• 画面空間を効率的に活用できるようになります。
• 複数のアプリケーションを別々のウィンドウで開く必要がなくなるため、特に画面サイズが限られたノートパソコンでの作業効率が向上します。
• 一つの画面内ですべての情報にアクセスできることは、思考の整理にも役立ちます。

このような連携を実現するために必要なのが、Custom Framesというプラグインです。このプラグインを使えば、Obsidian上でWebサービスを簡単に利用できるようになります。

Custom Framesプラグインの導入方法

Custom FramesはObsidianのコミュニティプラグインの一つで、Obsidianの画面内にWebページを表示できるようにするためのツールです。インストールは非常に簡単です。

インストール方法

1. Obsidianの「設定（Settings）」を開く
2. 左ペインの「コミュニティプラグイン（Community Plugins）」を選択
3. 検索バーに「Custom Frames」と入力
4. 表示されたプラグインをクリックしてインストール
5. インストール完了後、「有効化（Enable）」ボタンを押してプラグインをアクティブにする
6. 初回起動時には、初期設定を促されることがあります

Custom Framesの設定

Custom Framesプラグインには、以下のような機能があります：

• プリセットとして、Obsidian Forum、Google Keep、Google Calendar、Todoist、Notion、Twitter、Readwiseなどが用意されています
• 自分でカスタムフレームを作成することも可能です
• フレームごとにリボンアイコンの追加、CSSのカスタマイズなどの設定ができます

ChatGPTをObsidian上で表示する詳細設定

ChatGPTをObsidian上で使用するには、Custom Framesプラグインを使って以下の手順で設定します：

1. Custom Framesプラグインの設定画面を開く
2. 「Add Frame」をクリックして新しいフレームを追加
3. 「Show Settings」をクリックして詳細設定を表示
4. URLに「https://chat.openai.com/」を入力
5. 名前を「ChatGPT」などわかりやすい名前に設定
6. 必要に応じて他の設定（アイコン、表示位置など）を調整

設定完了後、コマンドパレット（MacではCmd+P、Windows/LinuxではCtrl+P）を開き、「Custom Frames: Open」と入力します。すると、作成したフレームの一覧が表示されますので、「ChatGPT」を選択します。これで、Obsidian内でChatGPTを使用できるようになります。

ChatGPTを頻繁に使用する場合は、リボンアイコン（左側のサイドバー）に追加しておくと便利です。Custom Framesの設定画面で「Add to ribbon」にチェックを入れることで、リボンアイコンが追加されます。これにより、コマンドパレットを開かなくても、アイコンをクリックするだけでChatGPTを開くことができます。

Notionの表示設定とログイン時の注意点

NotionもChatGPTと同様に、Custom Framesプラグインを使って表示させることができます。設定方法はChatGPTとほぼ同じですが、いくつか注意すべき点があります。

設定方法

1. Custom Framesプラグインの設定画面で「Add Frame」をクリック
2. URLに表示したいNotionのページのURLを入力
3. 名前を「Notion」などわかりやすい名前に設定
4. 必要に応じて他の設定を調整

注意点

まず、Custom Framesプラグインの設定画面で「Add Frame」をクリックして新しいフレームを追加します。URLの欄には、表示したいNotionのページのURLを入力します。これは非常に重要なポイントで、Notionのトップページではなく、実際に表示したい特定のページのURLを入力する必要があります。名前は「Notion」など、わかりやすいものにしておきましょう。

Notionを使用する際の最大の注意点は、ログインに関する制限です。Obsidianのデスクトップアプリ内でNotionを表示させる場合、技術的な制限によりログインプロセスが正常に完了しないことがあります。これは、Webサービスの多くがiframe内でのログイン処理を制限しているためです。

また、モバイル版Obsidianでの使用にも制限があります。モバイルアプリでは、フレーム内での認証が技術的に困難な場合が多いため、Notionの表示がうまくいかないことがあります。

ログインの問題を回避する方法として、Notionの公開ページを利用する方法があります。閲覧のみが目的であれば、表示したいNotionのページを「Webに公開」設定にして、そのURLをCustom Framesに設定することで、ログインなしでページを表示させることができます。ただし、この方法ではページの編集はできないため、参照用途に限られます。

効率的なワークフロー構築のためのその他の連携サービス

Custom Framesプラグインでは、ChatGPTやNotion以外にも様々なWebサービスを表示させることができます。これにより、Obsidianを中心とした効率的なワークフロー構築が可能になります。

例えば、Google Calendarを表示させることで、ノート作成中にスケジュールを確認したり、予定を追加したりすることができます。また、Google Tasksを表示させれば、ノートを取りながらタスク管理も同時に行えます。Wikipediaを表示させておけば、調べものをしながらノートを取ることも可能です。

このように、Obsidianを「知識のハブ」として位置づけ、そこに様々なサービスを統合することで、作業効率を大幅に向上させることができます。特に、以下のようなサービスの組み合わせが効果的です。

まず、Obsidianのメインペインには現在作業中のノートを表示させます。右サイドパネルにはChatGPTを表示させ、文章の作成や情報の整理を支援してもらいます。左サイドパネルにはNotionのデータベースやGoogle Calendarを表示させておくと、必要な情報やスケジュールをすぐに確認できます。

私は、Claudeも利用する事が多いのでClaudeも設定しています。

さらに、長時間の作業では気分転換も重要です。Custom Framesを使えば、YouTubeで音楽を再生しながら作業することも可能です。また、Twitterなどのソーシャルメディアも表示させることができますが、集中力の維持のためには、必要な時だけ表示させるようにすると良いでしょう。

実際の利用シーンと応用例

Custom Framesを活用した実際の利用シーンをいくつか紹介します。これにより、あなた自身のワークフローにどのように取り入れられるかをイメージしやすくなるでしょう。

例えば、研究や論文執筆のシーンでは、Obsidianのメインペインでノートをとりながら、右サイドパネルにChatGPTを表示させて文献の要約や論点の整理をサポートしてもらい、左サイドパネルにはGoogle Scholarを表示させて関連論文を検索するといった使い方ができます。これにより、異なるアプリケーションを行き来する必要がなくなり、思考の流れを維持しやすくなります。

ビジネスシーンでは、プロジェクト管理に活用できます。Obsidianでプロジェクトの概要や進捗をノートとして記録しながら、Notionでチームメンバーとのタスク共有を行い、Google Calendarでミーティングスケジュールを確認するといった使い方が考えられます。

学習シーンでは、Obsidianで学習ノートを取りながら、WikipediaやYouTubeの教育コンテンツを参照し、ChatGPTで理解が難しい概念について質問するといった使い方が効果的です。

日常的な知識管理においては、ObsidianとNotionを併用することで、Notionの構造化されたデータベース機能と、Obsidianのグラフビューや双方向リンク機能を組み合わせた強力な知識管理システムを構築できます。

Custom Framesプラグイン利用時のパフォーマンスと注意点

Custom Framesプラグインを使用する際には、いくつかのパフォーマンス上の注意点があります。これらを理解し、適切に対処することで、快適な環境を維持できます。

まず、同時に多くのフレームを開くと、Obsidianのパフォーマンスが低下する可能性があります。特に、リソースを多く消費するWebサービス（動画サイトやAIツールなど）を複数開くと、メモリ使用量が増大し、アプリケーション全体が遅くなることがあります。必要なフレームだけを開き、使わないフレームはこまめに閉じるようにしましょう。

また、フレーム内でのキーボードショートカットがObsidianのショートカットと競合することがあります。例えば、保存コマンド（Cmd+SまたはCtrl+S）や検索コマンド（Ctrl+FCmd+FまたはCtrl+F）などは、フレーム内とObsidian本体の両方で機能します。この問題は、Custom Framesの設定で「Keyboard propagation」のオプションを調整することで解決できる場合があります。

セキュリティ面でも注意が必要です。Custom Framesは基本的にiframeを使用してWebコンテンツを表示するため、Webサイト側のセキュリティ設定によっては、正しく表示されないことがあります。また、機密性の高い情報を扱うサービスを表示する場合は、情報の漏洩リスクについても考慮する必要があります。

さらに、モバイル環境での使用には制限があります。Obsidianのモバイルアプリ（iOSやAndroid）でCustom Framesを使用する場合、デスクトップ版と比べて機能が制限されることがあります。特に、ログイン処理やタッチ操作の対応が不完全な場合があるため、モバイルでの使用を主目的とする場合は、事前にテストしておくことをお勧めします。

INDEX

• Markdownエディタの「Obsidian」から「ChatGPT」を利用する
  • 「Obsidian」とはどのようなアプリケーションなのか
  • 「Obsidian」から「ChatGPT」を利用するメリット
• OpenAIからAPIキーを取得
• Macでプラグインをインストール
  • Macで実行できるように
• iPhone、iPadでプラグインをインストール
  • iPhone、iPadで実行できるように
• Macでの使用方法
• iPhone、iPadでの使用方法
• Markdownエディタの「Obsidian」の入手先

Markdownエディタの「Obsidian」から「ChatGPT」を利用する

以前、「 iPhoneやApple WatchでChatGPTを使用する方法」を投稿しましたがショートカットで利用すると全文を表示できませんでした

しかし、Markdownエディタの「Obsidian」でプラグインを利用することで、Mac、iPhone、iPadで利用できるようになります

「Obsidian」とはどのようなアプリケーションなのか

Obsidianは、プレーンテキストファイルを使用してノートを作成および管理できる人気のMarkdownエディタおよびノート作成アプリです。このアプリはグラフベースのインターフェイスを特徴としており、ユーザーはノートを非線形にリンクさせ、相互に関連したアイデアや概念のWebを作成することができます

また、特定のノートにリンクしているすべてのノートを表示するバックリンクや、アプリの機能を拡張するプラグインなど、高度な機能もサポートしています

全体として、Obsidian はナレッジワーカー、研究者、ライター、そしてアイデアや情報を柔軟かつ効率的に整理してつなげることを望むすべての人にとって、強力なツールとなります

「Obsidian」から「ChatGPT」を利用するメリット

「ChatGPT」を利用すると以下のようなことが出来るようになります

• アイデアの創出
• ライティングプロセスのスピードアップ
• ライティングスキルの向上
• ライティング時間の短縮
• 効率的な編集
• 新しい切り口を見つけることができる
• 編集時間を短縮

これらをMarkdownエディタの「Obsidian」で「ChatGPT」を利用することによって、Webサイトの「ChatGPT」にブラウザーを利用して行き来することなく「Obsidian」内で完結することが出来、効率があがり執筆がはかどります

ただし、ショートカットの時と同様にOpenAIからAPIキーを取得する必要があります

OpenAIからAPIキーを取得

すでにブラウザ経由でChatGPTを使用している場合は、ここにログインしてAPIキーを生成するだけです

サイドメニューの 「USER」 に移動すると、すでに実行しているAPIリクエストの数と、空きクォータが使い果たされているかどうかを確認できます

キーは 「sk-」 で始まり、「Obsidian」で設定するときに必要になります

ただし、作成したAPIキーをOpenAIアカウントから再度表示することは出来ず、紛失した場合は、新しいキーを生成する必要があります、Macのメモにコピーなどしておくと良いでしょう

Macでプラグインをインストール

1. Obsidianを起動します
2. 歯車のアイコンをクリックしサイドバーの「コミュニティープラグイン」を選択します
3. 「コミュニティープラグイン」の横の「閲覧」をクリックします
4. 検索窓に「Text Generator」と入力します
5. 「Text Generator」をインストールします
6. サイドバーの「Text Generator」をクリックします
7. API Keyの項目に先程取得した「sk-」 で始まるキーをコピー＆ペーストして横のボタンをスライドしてオンにします
8. API documentationのMax tokensのデフォルトの160を1,000にします、これで回答の文字数の制限にひかからないようになります

Macで実行できるように

1. Obsidianの左サイドの項目で「コマンドパレットを開く」をクリックします
2. Text Generator:Generate Text!にショートカットを設定します（デフォルトは⌘J」です

iPhone、iPadでプラグインをインストール

1. Obsidianを起動します
2. 歯車のアイコンをタップし「Community plugins」を選択します
3. 「Browse」をタップします
4. 上部の検索窓に「Text Generator」と入力します
5. 「Text Generator」をインストールします
6. SettingsのCommunity Pluginsの項目の下の「Text Generator」をタップし設定を表示します
7. API Keyの項目に先程取得した「sk-」 で始まるキーをコピー＆ペーストして横のボタンをスライドしてオンにします
8. API documentationのMax tokensのデフォルトの160を1,000にします、これで回答の文字数の制限にひかからないようになります

iPhone、iPadで実行できるように

1. SettingsのOptionsの項目から「Mobile」を選択します
2. Manage toolbar optionsの項目のMore toolbar optionsにある、筆記具を手に持ったアイコンのText Generator:Generate Text!の横の「+」をタップして利用可能にします

Macでの使用方法

1. Obsidianで新規ファイルを選択
2. 質問を入力します
3. Text Generator:Generate Text!に設定したショートカットキーを入力します
4. 全文表示されない場合は「続けて」と入力し
5. ショートカットキーを入力します

iPhone、iPadでの使用方法

1. Obsidianで新規ファイルを選択
2. 質問を入力します
3. 仮想キーボード上部のスライドして、筆記具を手に持ったアイコンをタップします
4. 全文表示されない場合は「続けて」と入力し
5. 仮想キーボード上部のスライドして、筆記具を手に持ったアイコンをタップします

ChatGPTをWebサイトから利用したのと同じように、Obsidianのファイルとしてすべて保存されますので、簡単に2次利用が出来ます

Markdownエディタの「Obsidian」の入手先

• iPhone、iPadは、App Storeより無料で
• Mac版は、オフィシャルサイトより無料で
]]> https://minatokobe.com/wp/os-x/mac/post-87945.html/feed 0