まいど、酔いどれです。

Macのファイル管理をしていると、「このフォルダにあるはずのファイルが見えない」という場面があります。アプリの設定ファイルをバックアップしようとしたとき、GitHubのリポジトリを整理しているとき、特定のキャッシュを削除したいとき——そういう場面で必要になるのが隠しファイルの表示です。

以前はターミナルコマンドを使うしか方法がありませんでしたが、今はCmd+Shift+.（ピリオド）を押すだけで隠しファイルの表示と非表示を切り替えられます。ターミナルを開く必要はありません。

隠しファイルとは何か

Macのファイルシステムには、通常のFinderに表示されないファイルとフォルダが多数存在します。名前がピリオド（.）から始まるファイルは自動的に非表示扱いになります。たとえば.DS_Store（Finderの表示設定を記録するファイル）、.gitignore（Gitの除外設定ファイル）、.sshフォルダ（SSH認証鍵の格納場所）などがこれにあたります。

また「/Library」のようなシステムレベルのフォルダも通常は非表示になっています。これらはシステムの安定性を保つために誤って操作されないよう隠されています。中級者以上が設定ファイルやバックアップを扱うときに初めて必要になる領域です。

Finderで表示を切り替える

Finderがアクティブな状態でCmd+Shift+.（ピリオド）を押します。

すると、それまで見えていなかったファイルやフォルダが薄いグレーで表示されます。もう一度同じショートカットを押すと元の状態に戻ります。完全にトグル動作なので、用が済んだら元に戻せます。

隠しファイルは常に表示したままにするより、必要なときだけ表示して作業後は非表示に戻す使い方をおすすめします。普段から表示したままだとシステムファイルをうっかり操作してしまうリスクが増えます。

ファイルの保存・開くダイアログでも使える

このショートカットはFinderだけでなく、アプリの「開く」「保存」ダイアログでも機能します。

たとえばテキストエディタで隠しフォルダ内の設定ファイルを開きたいとき、ダイアログが表示されている状態でCmd+Shift+.を押すと、隠しファイルが選択肢に現れます。Finderを経由しなくても直接開けるので、アプリと隠しファイルを組み合わせた作業がスムーズになります。

ターミナルコマンドとの違い

以前から使われてきた方法として、ターミナルで以下のコマンドを入力する方法があります。

defaults write com.apple.finder AppleShowAllFiles YES

このコマンドはFinderを再起動するまで設定が維持されます。一方、Cmd+Shift+.はFinderを再起動しても表示のままになります。どちらも同じ結果を得られますが、ショートカットのほうが即効性があり、元に戻すのも簡単です。ターミナルに慣れていない場合はショートカットだけ覚えておけば十分です。

よく使う場面

中級者が隠しファイルを必要とする場面をいくつか挙げます。

アプリの環境設定ファイルをバックアップするとき、「~/Library/Application Support/」や「~/Library/Preferences/」の中を確認したい場合があります。このLibraryフォルダは通常非表示なので、ショートカットで表示してから移動します。

GitHubやGitLabを使っている場合、リポジトリのルートにある.gitignoreや.githubフォルダをFinderで確認したい場面があります。テキストエディタからは見えていても、Finderでは非表示になっていることが多いです。

SSH接続の設定を確認したいときも、~/.sshフォルダへのアクセスにこのショートカットが必要になります。

Claude Codeを使っている場合は、Skillsフォルダへのアクセスにも必要です。Claude Codeの設定やSkillファイルは~/.claudeという隠しフォルダの中に格納されています。Finderから直接確認・編集したいときは、このショートカットで表示してからアクセスします。AIツールを使い込んでいる方ほど、この隠しフォルダに用事が増えます。

まとめ

FinderでCmd+Shift+.（ピリオド）を押すだけで隠しファイルの表示と非表示が切り替わります。ダイアログ内でも機能します。作業が終わったら同じショートカットで元に戻す習慣をつけておくと安全です。

ターミナルを使わなくていい、という点だけでもこのショートカットを覚える価値があります。

おおきに。

この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活用が、実り多きものになりますように！お役に立てれば何よりです。