メインコンテンツへスキップ
見出し画像

【卒論・修論・博論】論文が30分で完成する?|Obsidian × Claude Code × GitHubでつくるAI研究自動化システム|(Mac/Windows対応・コード全文)

    朝、Obsidianを開くと、昨日までに発表された関連論文が要旨つきで並んでいる。
    AIがそれを「読むべき順」に仕分けし、先行研究レビューの下書きをつくってくれる。
    材料が揃えば、論文の初稿まで一緒に書き進められる。

    この記事では、そんな研究環境を自分のパソコンとGitHubだけで構築する手順を、コードと設定ファイルをすべて掲載して解説します。


    この記事で手に入るもの

    • 毎日自動で関連文献を検索・保存するPythonコード全文

    • GitHub Actionsの設定ファイル全文

    • AIに研究上のルールを守らせる設定ファイル(CLAUDE.md)のテンプレート

    • 「文献の仕分け」「先行研究レビュー」「RQ検討」「論文初稿」の4つのAIコマンド

    • Mac・Windowsそれぞれの手順と、つまずきやすいエラーの対処法

    こんな人に向いています

    • 卒論・修論・博論、研究計画書のために先行研究を継続的に追いたい

    • 文献管理がExcelやメモアプリに散らばっている

    • AIを研究に使いたいが、「嘘の文献」や研究倫理が心配

    • プログラミング経験はないが、手順どおりに進めることはできる

    必要なもの・費用・所要時間

    • パソコン:Mac(macOS 13以降)またはWindows 10/11

    • Obsidian:無料

    • GitHub:無料プランで可(Privateリポジトリも可)

    • OpenAlex:無料(無料APIキーを取得します)

    • Claude Code:Claudeの有料プラン(Pro以上)またはAPI契約が必要。無料プランでは使えません

    • 所要時間:初回構築でおよそ60〜90分

    ※料金・プラン条件は変わることがあります。購入前に各公式サイトでご確認ください。


    第1章 「論文が30分で完成する」の本当の意味

    先に、誤解のないようにお伝えします。AIを使っても、研究テーマの設定、調査や実験、分析、論文提出までを30分で終えることはできません。

    この記事が目指すのは、研究に必要な材料がObsidianに揃っている状態から、論文の初稿を短時間でつくれることです。

    例えば、次の情報が整理されているとします。

    • 研究目的とリサーチクエスチョン

    • 精読・確認済みの先行研究

    • 研究方法

    • 調査・実験データと、検証済みの分析結果

    • 考察のメモ

    ここまで揃っていれば、Claude Codeに構成案と各章の初稿をつくらせることができます。「30分」はその作業の目標時間です(実測値や品質を保証するものではありません)。

    逆に言えば、時間がかかるのは「材料を揃えること」です。だからこの記事では、材料が毎日自然に貯まっていく仕組みから作ります。

    AIに研究を丸投げするのではなく、AIに反復作業を任せて、考えるべき問いに時間を使う。そのための環境です。

    第2章 完成する研究環境の全体像

    例として、研究テーマは「睡眠と学習の関係」にします(あとで自分のテーマに変更します)。

    完成後は、毎日次の流れで動きます。

    【自動】
    ① 毎朝7時ごろ、GitHub Actionsがプログラムを起動する
    ② 学術データベースOpenAlexで、登録したキーワードに合う直近の論文を検索する
    ③ タイトル・著者・掲載誌・DOI・要旨をMarkdownファイルとして保存する(重複は自動で除外)

    【自分のタイミングで】
    ④ Obsidianで新着文献を確認する
    ⑤ Claude Codeに「仕分け」を頼み、読むべき論文を決める
    ⑥ 読んだ論文をもとに、先行研究レビューやRQ、論文初稿の草稿をつくる

    フォルダ構成は最終的にこうなります。

    research-automation/
    ├─ 01_Literature/      ← 自動収集された文献ノート(1論文1ファイル)
    ├─ 02_Daily_Review/    ← 日ごとの収集レポート
    ├─ 03_Project/         ← 研究計画・方法・データ・考察メモ(自分で書く)
    ├─ 04_Drafts/          ← AIがつくった草稿の保存先
    ├─ scripts/collect.py  ← 文献収集プログラム
    ├─ .github/workflows/daily.yml ← 毎日の自動実行設定
    ├─ .claude/skills/     ← AIコマンド
    └─ CLAUDE.md           ← AIに守らせる研究ルール
    

    なお、「毎日検索する」ことは「毎日必ず新しい論文が見つかる」ことを意味しません。データベースの収録状況や検索条件によって結果は変わります。

    次章から、実際に構築していきます


    第3章 STEP 1|Obsidianをインストールする

    Obsidianの公式サイトからアプリをダウンロードし、インストールします。
    https://obsidian.md/

    Obsidianでは、ノートを保存するフォルダを「保管庫(Vault)」と呼びます。

    ここではまだ保管庫を作らなくて構いません。後ほどGitHubから取得するフォルダを、そのまま保管庫として開くためです。

    すでにObsidianを使っている人も、今回は既存のノートと混ぜず、新しい保管庫を使ってください。

    ※後で使うプラグイン「Claudian」はObsidian 1.13.0以降が必要です。古いバージョンを使っている人は、アップデートしておきましょう。

    第4章 STEP 2|GitとGitHubを準備する

    Claude Codeより先に、Gitを準備します(WindowsではClaude CodeがGitに含まれる「Git Bash」を使うため)。

    GitHubアカウントを作る

    アカウントがない人は作成してください。
    https://github.com/

    Gitをインストールする

    Macの場合
    「Command + スペース」で「ターミナル」と検索して起動し、次を実行します。

    git --version
    

    バージョンが表示されれば準備完了です。表示されず「開発者ツールをインストールしますか?」と出た場合は、案内に従ってインストールしてください。

    Windowsの場合
    Git for Windowsを公式サイトからインストールします(設定はすべて初期値のままで構いません)。
    https://git-scm.com/downloads/win

    インストール後、スタートメニューから「PowerShell」を起動し、次を実行します。

    git --version
    

    最初に1回だけ、名前とメールを登録する

    Mac・Windows共通で、次の2行を実行します(自分の名前とGitHubに登録したメールアドレスに置き換えてください)。

    git config --global user.name "あなたの名前"
    git config --global user.email "あなたのメールアドレス"
    

    これをしないと、後で自分のメモを保存(コミット)するときにエラーになります。

    第5章 STEP 3|Claude Codeをインストールしてログインする

    Claude Codeは、AIがファイルを読み書きしながら作業を手伝ってくれるツールです。

    Mac(ターミナル)

    curl -fsSL https://claude.ai/install.sh | bash
    

    Windows(PowerShell)

    irm https://claude.ai/install.ps1 | iex
    

    インストールが終わったら、ターミナル(PowerShell)をいったん閉じて開き直し、次を実行します。

    claude --version
    

    バージョン番号が表示されれば成功です。「claudeが見つからない」と出た場合は、第18章のQ1を参照してください。

    続けて、次を実行してログインします。

    claude
    

    ブラウザが開くので、Claudeのアカウントでログインしてください。Claude Codeの利用にはPro以上の有料プランまたはAPI契約が必要です。

    ※公式のインストールスクリプトを実行します。最新の手順は公式ドキュメントで確認してください。
    https://code.claude.com/docs/

    第6章 STEP 4|ObsidianにClaudianを導入する

    ClaudianはObsidianの中でClaude Codeを使えるようにするコミュニティプラグインです。

    1. Obsidianの「設定」を開く

    2. 「コミュニティプラグイン」を開き、制限モードをオフにする

    3. 「閲覧」を押して「Claudian」と検索する

    4. インストールして「有効化」する

    Claude Codeを認識させる

    基本的には自動で検出されます。検出されない場合は、Claude Codeの場所を手動で指定します。

    Mac(ターミナル)

    which claude
    

    Windows(PowerShell)

    where.exe claude
    

    表示されたパスを、Claudianの「設定 → Claudian → Providers → Claude Code」の欄に入力します。

    • Windowsでは、claude.exe で終わるパスを指定します(.cmd や .ps1 は指定しない)

    • 設定を変えたら、Obsidianを再起動します

    • 設定画面の名称はバージョンによって変わることがあります。見当たらない場合は公式READMEを確認してください
      https://github.com/YishenTu/claudian

    動作確認

    Claudianのチャットを開いて、次のように入力します。

    こんにちは。これからObsidianで研究ノートを整理したいです。

    返事が返ってくれば連携は完了です。

    ※Claudianを通じて、保管庫内のノートがAIに送られます。機密資料や個人情報を含む保管庫では使わないでください(第19章で詳しく説明します)。

    第7章 STEP 5|GitHubに研究用リポジトリを作る

    GitHubにログインし、右上の「+」→「New repository」を選びます。

    • Repository name:research-automation

    • 公開範囲:Private

    • 「Add a README file」にチェック

    で作成します。

    Privateにしても、未公開の個人情報や研究協力者のデータはこのリポジトリに入れないでください。

    第8章 STEP 6|文献収集プログラムを作る

    ここが心臓部です。Pythonの知識は不要です。コードをコピーして貼り付けるだけで動きます。

    1. リポジトリの画面で「Add file」→「Create new file」

    2. ファイル名に scripts/collect.py と入力(スラッシュを入れるとフォルダが自動でできます)

    3. 次のコードを貼り付けて「Commit changes」

     
     
    🎓「研究したい」を、研究できるに。 大学院進学・研究計画書・研究方法・論文執筆をサポートする学習メディア「院進ラボ」です。 大学院入試に役立つ知識から、研究の進め方まで、わかりやすく発信します📚 研究をもっと身近に、もっと楽しく。

    あなたへのおすすめ