これは、私が学術研究者向けに行っている Claude Code チュートリアルシリーズの第2部です。
このチュートリアルは、400 万回以上の再生回数で話題となった最初のチュートリアル「Claude Code 101」を基にしています。以下からご覧いただけます：
私はこれらのチュートリアルを、シンプルでわかりやすい言葉で書いています。これらのチュートリアルや Claude Code を使用するために、技術的なスキルは一切必要ありません。英語で文章が書けるなら、Claude Code を使うことができます。
Claude Code 101 の簡単な復習
最初のチュートリアルでは、単一のフォルダを開き方を学びました。そのフォルダを開き、PDF を追加し、Claude Code に指示を含む CLAUDE.md ファイルを提供する方法を学びました。このような設定は、短いプロジェクトや Claude Code を使い始めたばかりのときに適しています。
しかし、学術研究者として、私たちのプロジェクトは数ヶ月から数ヶ月、場合によっては数年にもわたり、数百もの論文や複数の草稿をの草稿が蓄積されます。
このチュートリアルでは、Claude Code を活用して、より長期的な学術プロジェクトを構造化する方法を学びます。
パート 1: 長期プロジェクトのプロジェクトを構造化する
学位論文、モノグラフ、研究論文などのプロジェクトに取り組んでいるとします。このようなプロジェクトを、1 つの CLAUDE.md ファイルのみを持つ 1 つのフォルダに整理すると、Claude は常に同じような結果を返すことになります。あなたの作業に適した、正確でカスタマイズされた結果を提供することはできません。
次のように考えてみてください。あなたの（人間の）リサーチアシスタントに、論文のセクションを起草してもらいたい、データセットをクリーニングしてもらいたい、記事に注釈を付けてもらいたい場合、それぞれのタスクに対して異なる指示を与えるでしょう。
Claude Code でも、サブフォルダを作成することで、まったく同じ整理スキームを使用できます。
1.1 整理のためのサブフォルダ
「私の学位論文」というメインの学位論文」というメインフォルダがあるとします。メインフォルダ内に、次のようなサブフォルダを作成します：
- Literature（文献）：出版された学術研究に関する PDF とノート用
- Chapters（章）：各章の草稿用
- Data（データ）：データセット用
- Notes（ノート）：ミーティングノートやアイデア用
- Correspondence（連絡）：アドバイザーとのメール、共著者とのやり取り、レビュアーレポート用
このような整理は、あなたと Claude Code の両方に役立ちます。章の草稿に取り組む必要がある場合は、Chapters 場合は、Chapters フォルダに直接アクセスできます。
Claude Code も同様です。特定のデータポイントについて質問すると、Data フォルダを探すべきことがわかります。
1.2 サブフォルダ用の CLAUDE.md ファイル
101 のチュートリアルでは、Claude Code がセッションを開始するたびに読み取る一連の指示である CLAUDE.md ファイルを作成しました。
メインの学位論文フォルダに、あなたとあなたのプロジェクトについて概略的に説明する CLAUDE.md ファイルを作成します。これを「グローバル」CLAUDE.md ファイルと呼びます。
曖昧にしろという意味ではありません。正確に記述しつつ、全体像を把握できる。具体的な指示は後で追加します。この CLAUDE.md をプロジェクトの憲法として扱ってください。
各サブフォルダ内に、そのサブフォルダにのみ適用される別の CLAUDE.md ファイルを配置します。これらを「ローカル」CLAUDE.md ファイルと呼びます。サブフォルダ内のローカル CLAUDE.md ファイルの目的は、メインの CLAUDE.md を肥大化させることなく、Claude Code にこれらのタスクに関する具体的な指示を与えることを目的とを目的としています。
例えば、Chapters サブフォルダ内の CLAUDE.md ファイルには、次のように記述するかもしれません：
私の草稿を批評するよう依頼した場合、次の構造に従ってください：議論、証拠、文献、反論。特に指定がない限り、常に MLA 第9版の引用スタイルを使用してください。
Data サブフォルダ用の CLAUDE.md には、次のような指示を含めることができます：
特に指定がない限り、すべての CSV ファイルと Excel シートを生データとして扱ってください。生ファイルを上書きしないでください。クリーニングしたバージョンは、ファイル名の末尾に _clean を追加して保存してください。
そして、Correspondence フォルダ用の CLAUDE.md ファイルには、次のように記述するかもしれません：
レビューレポートと共著者とのやり取りに共通するポイントを常に優先してください。
1.3 ネストされた CLAUDE.md ファイル
Claude Code がサブフォルダで動作するとき、2 つの CLAUDE.md ファイルを読み取ります。1 つはサブフォルダ内にあり、もう 1 つはメインフォルダ内にあります。
これらのネストされた CLAUDE.md ファイルにより、Claude Code はプロジェクト全体の概要と、特定の質問に正確に応答する方法を明確に理解できます。
1.4 ローカル CLAUDE.md ファイルの出力スタイル
各ローカル CLAUDE.md ファイルに、出力スタイルに関する簡単な指示を追加することも検討すべきです。
例えば、Literature サブフォルダでは、論文を要約するよう依頼したときに、議論、証拠、プロジェクトとの関連性を列挙げたテーブルを表示するよう Claude Code に指示できます。同様に、Notes サブフォルダでは、箇条書きで応答するよう指示できます。
これらの指示は後でいつでも修正できます。
1.5 実践的な例/演習
Claude Code でメインの学位論文フォルダを開き、次のプロンプトを入力します：
今日 Literature サブフォルダに追加した 5 つの論文を読み、Chapters サブフォルダ内の「Chapter 3 – Outline.md」における私の議論を支持するものと反駁するものを教えてください。
Claude Code は、グローバル CLAUDE.md ファイルと、Literature および Chapters サブフォルダ内の 2 つのローカル CLAUDE.md ファイルを読み取り、どの論文があなたの議論を支持または反駁するかを教えてくれます。
1.6 ～してはいけないこと
グローバルとローカルの CLAUDE.md ファイルで指示を重複させないでください。不必要であり、Claude Code がより多くのトークンを処理することになります。
サブフォルダ内のローカル CLAUDE.md ファイルは、グローバル CLAUDE.md ファイルの指示と矛盾してはなりません。矛盾がある場合、Claude Code はより具体的な指示に従いますが、あなたは混乱することになります。
パート 2: プランモードとカスタムスラッシュコマンド
学位論文や研究論文のような長期的な学術プロジェクトには、特定の反復タスクが伴います。例えば、文献レビューのために論文を繰り返しスクリーニングするかもしれません。章の起草を始めるたびにアウトラインを書く必要があります。ゼロドラフト（フリーライティングとも呼ばれます）を書く場合、ほぼ毎日それらを「クリーンアップ」する必要があります。
しかし、複雑で反復的でないタスクもあります。例えば、レビュアーのフィードバックに対応するには、彼らの批判的なフィードバックに真剣に取り組み、その後原稿を書き直す必要があります。
Claude Code は、両方のタイプのタスクを支援できます。複雑な単発のタスクには Plan Mode を、反復的なタスクには Custom Slash Commands を提供しています。
2.1 Plan Mode
通常、Claude Code にタスクを与えると、すぐに作業を開始します。小さな、リスクの低いタスクでは問題なく機能します。例えば、Literature サブフォルダ内のすべての PDF を、タイトルと著者名を使用して名前を付けて変更するよう Claude Code に依頼すると、すぐに実行します。
しかし、このアプローチは複雑なタスクには望ましい結果をもたらしません。例えば、35 の研究論文に関する生のノートがあり、それらを統合するよう Claude Code に依頼したとします。何らかの理由で Claude Code が指示を誤解した場合、タスクが完了して初めて気づくことになります。
Plan Mode Plan Mode は、Claude Code に対する制御を強化します。すぐに実行する代わりに、これから行うことのステップごとの計画を書き出します。あなたはその計画を読み、同意できない点があれば、それに応じて計画を修正するよう依頼できます。
Plan Mode は、チャットバーの下にある権限メニューから見つけることができます。また、Ctrl + Shift + M を使用して開くこともできます。あるいは、何かを実行する前に、プロンプトで Claude Code に計画を表示するよう依頼することもできます。
2.2 Plan Mode を使用するタイミング
Plan Mode は、3 つ以上のステップを含む複雑なタスク、複数のサブフォルダに関わるタスク、または長い出力を生成するタスクに最適です。例としては、ノートの統合、ノートの統合、系統的レビューのための研究のスクリーニング、データセットのクリーニングとコードブックの作成などが挙げられます。
あなたは（人間の）リサーチアシスタントに、計画を尋ねもせずに「第 3 章を起草して」とは依頼しないでしょう。Claude Code の Plan Mode も同じように機能します。
2.3 カスタムスラッシュコマンド
スラッシュコマンドはショートカットです。Claude Code にはいくつかの組み込みスラッシュコマンドがあります。Claude Code を開き、フォワードスラッシュを入力すると、組み込みスラッシュコマンドのリストが表示されます。例えば、組み込みスラッシュコマンドの /schedule を入力すると、Claude Code はオンデマンドまたは自動的に実行できるスケジュールされたタスクを作成します。
スラッシュコマンドは、Claude Code が従う平な英語で書かれた一連の指示にすぎません。反復的なタスクに使用するたびに入力する必要のない、長いプロンプトと考えることができます。
101 のチュートリアルのパート 5 で、手動と自動の両方でスキルを作成する方法を学びました。自動的にスキルを作成すると、カスタムスラッシュコマンドが提供されます。
カスタムスラッシュコマンドを作成すると、Claude Code はコンピュータの .claude/commands フォルダに .md ファイルを作成します。このパスを知っておく必要があります。.md ファイルを編集する必要がある場合に、どこにあるかわかるようにするためです。
2.4 最初のカスタムスラッシュコマンドを作成する
カスタムスラッシュコマンドを作成する最も簡単な方法は、Claude Code に作成を依頼することです。例えば、Claude Code を開き、次のように入力します：
/firstdraft というスラッシュコマンドを作成してください。これは、Notes フォルダ内の私の生のノートを、冗長な言葉やフレーズなしで、まとまりのある首尾一貫した段落に変換します。
Claude Code は、.md ファイルに一連の指示を書き、それを .claude/commands フォルダに配置します。Claude Code がスラッシュコマンドの作成を完了したら、セッションを再起動し、フォワードスラッシュを入力します。メニューに /firstdraft が表示されます。
プロジェクト専用に作成されたカスタムスラッシュコマンドのライブラリを構築できます。
2.5 ～してはいけないこと
6 ヶ月に 1 度しか行わないタスクのためにスラッシュコマンドを書かないでください。それらのコマンドはスラッシュメニューを乱雑にし、プロジェクトの進化に伴って古くなる可能性があります。
スラッシュコマンドファイルに、複数のステップからなる長い指示を追加しないでください。1 つのスラッシュコマンドは、1 つの特定の反復タスクにしてください。指示が 15 行を超える場合は、おそらく 2 つのスラッシュコマンドが必要です。
長く複雑なタスクでは、Plan Mode をスキップしないでください。
パート 3: 並列研究タスクのためのサブエージェント
これまでは、単一の Claude Code セッション内で Plan Mode またはカスタムスラッシュコマンドを使用して実行できるタスクのみを見てきました。メインパネルで作業する 1 つの AI アシスタントがいます。
しかし、学位論文や研究論文のような長期的なプロジェクトでは、複数の AI アシスタントが必要になる場合があります。そこでサブエージェントの出番です。
3.1 ～1 つのアシスタントでは不十分な理由
長期的なプロジェクトでは、Claude Code のような AI エージェントを使用する際に 2 つの問題に直面します。
Literature フォルダ内の 20 の PDF を読むよう Claude Code に依頼すると、すべての論文のすべてのページが Claude Code が Claude Code の会話の一部になります。あなたはいくつかの質問をし、Claude Code はそれに答えます。
これで、論文内のすべてのテキストとあなたの会話は、そのセッションの Claude Code のメモリの一部になります。ここで、学位論文の第 4 章のアウトラインを起草するよう依頼すると、コンテキストが多すぎるために応答が遅くなり、明確さを欠く欠けるようになります。これを「コンテキストクラッター」と呼びます。
第二に、単一のセッションでは、Claude Code にタスクを順次的にしか割り当てることができません。原稿に対して 3 つの異なる批評（理論家からのもの、情報専門家からのもの、レビュアー 2 からのもの）が必要な場合、コンテキストクラッターのために各批評が原因で各批評に影響を与えるため、単一のセッションでそれらを順次的に実行することはできません。
このようなタスクには、3 つの独立したセッションが必要です。
3.2 サブエージェントとは？
サブエージェントは、独自の指示と、さらに重要なことに、独自のコンテキストウィンドウを持つ、Claude Code の専門バージョン版と考えてください。コンテキストウィンドウは、単一の会話における Claude Code のワーキングメモリです。Claude Code が任意の時点で「見る」ことができるすべてのもの（ファイル、プロンプト、自身の応答、CLAUDE.md の指示）は、コンテキストウィンドウ内にあります。質問をすると、Claude Code はコンテキストウィンドウを使用して回答します。
カスタムスラッシュコマンドと同様に、サブエージェントも .md ファイルとして存在します。しかし、コンテキストウィンドウを持たないスラッシュコマンドとは異なり、サブエージェントはコンテキストウィンドウを持っています。
スラッシュコマンドとサブエージェントのもう 1 つの重要な違いは、サブエージェントは CLAUDE.md ファイルを読み取らないことです。サブエージェントは .md ファイルに独自の指示を持っているだけで、それだけです。
サブエージェントは、例えば「引用チェッション」や「クリエイター」や「クリティカルレビュアー」といった、非常に具体的な役割を持ちます。各エージェントは独自のコンテキストを持っています。メインのセッションからサブエージェントにタスクを委任すると、その読み取りと推論はサブエージェント内に留まります。あなたは最終的な回答のみを受け取ります。これにより、メインのセッションがコンテキストクラッターになるのを防ぐことができます。
3.3 研究者のためのサブエージェント
必要なサブエージェントの正確なタイプはプロジェクトによって異なりますが、以下にいくつかの一般的な例を示します。
- Literature Reviewer サブエージェント：Literature フォルダに追加されたすべての新しい PDF を読み、あなたの議論に関連する構造化された要約を提供します。
- Citation Checker サブエージェント：草稿の章を受け取り、引用されたすべての情報源を Literature フォルダ内の論文と照合し、欠落している参考文献を指摘します。
- Methodology Auditor サブエージェント：実証プロジェクトの場合、方法論のセクションがデータおよび分析と一致しているかチェックします。
- Reviewer 2 サブエージェント：敵対的なレビュアーとしてあなたの草稿を批評します。
3.4 サブエージェントを作成する
カスタムスラッシュコマンドを作成するのと同様に、サブエージェントを作成する最も簡単な方法は、Claude Code に作成を依頼むことです。セッションを開き、次のように入力します：
Citation Checker というサブエージェントを作成してください。Chapters フォルダから草稿を受け取り、すべての文中引用をリストアップし、それぞれを Literature フォルダ内の論文と照合します。次に、欠落している参考文献を含むマークダウンファイルを作成します。サブエージェントは草稿を編集したり変更したりしてはなりません。
Claude Code は citation-checker.md というファイルを作成し、.claude フォルダ内の Agents フォルダに配置します。
セッションを再起動すると、サブエージェントを使用する準備が整います。サブエージェントを展開するには、Claude Code に使用を依頼するだけです。例えば、「Chapters フォルダ内の chapter_4.md に対して Citation Checker を使用してください。」
必要に応じて、サブエージェントの .md ファイルを編集して要件に合わせて編集することもできます。
3.5 例：並列批評の例
章の草稿が完成し、スーパーバイザーや同僚に送る前にフィードバックが欲しいとします。セッションを開き、次のように入力します：
並行して、Methodology Auditor と Reviewer 2 に Chapters フォルダ内の chapter_4 を読んで批評させ、レビューレポートを提供させてください。2 つのレポートを、同じフォルダ内にサブエージェント名で chapter_4_critiques として保存してください。
両方のサブエージェントは、それぞれのコンテキストを使用してあなたの草稿を読み、評価します。完了すると、2 つの批評が別々のファイルとして作成されます。メインのセッションは、草稿や関連するものをコンテキストウィンドウに追加する必要はありませんでした。
使用しているモデルによっては、これに数分かかる場合があることに注意してください。
3.6 ～してはいけないこと
小さなタスクのためにサブエージェントを作成しないでください。
サブエージェントに重複する責任を与えないでください。
サブエージェントに草稿を編集させないでください。サブエージェントは常に別々のファイルとしてレポートを生成する必要があります。
パート 4: Claude Code を他のアプリに接続する
これまで、あなたのプロジェクトは Claude Code 内に留まり、他のアプリとの統合もありませんでした。Claude Code が読み取り、編集、書き込みするものはすべて、プロジェクトフォルダ内に存在します。
しかし、学位論文や研究論文のような学術プロジェクトには、複数のアプリケーションに分散した複雑な組織的および構造的プロセスが含まれます。例えば、引用は Zotero、草稿は Google Drive、ミーティングノートは Zoom にあります。
これらのアプリを Claude Code を Claude Code と統合するにはどうすればよいでしょうか？
2024 年、Anthropic は Model Context Protocol (MCP) と呼ばれる方法を導入しました。これにより、Zoom や Google Drive などのアプリを Claude Code と統合できます。
MCP が何であり、どのように機能するかを気にする必要はありません。MCP を使用して異なるアプリを接続する方法だけを知っていれば十分です。
4.1 Claude Code にアプリを接続する方法
Claude Code を開き、左上隅に「カスタマイズ」オプションがあります。それをクリックし、次の画面で「アプリを接続」を選択します。
これにより、Claude Code で使用するために Anthropic が承認したアプリのリストである「コネクタ」が表示されます。Zoom や Google Drive などのアプリを探し、次の画面で「接続」をクリックします。
Claude Code に権限を付与するよう求められます。付与すると、アプリが Claude Code に接続されます。
4.2 実践例
Zoom を Claude Code に接続し、セッションを開いて次のように入力します：
同僚と行った最近行った 3 回の通話の文字起こしを取得してください。Drafts 内の第 4 章に関連するすべてのコメントを抽出してください。抽出したすべてのコメントを、今日の日付を付けて Correspondence フォルダ内の新しいファイルに新しいファイルに保存してください。
4.3 コネクタとサブエージェント
プロジェクトが進化するにつれて、コネクタとサブエージェントを組み合わせてプロセスを効率化できます。
例えば、コネクタのリストで利用可能な PubMed や arxiv データベースを使用する Literature Reviewer というサブエージェントを設定できます。
4.4 ～してはいけないこと
あまり多くのコネクタをインストールしすぎないでください。選択的に、プロジェクトに関連するものだけをインストールしてください。
AI と共有したくない機密情報を含む可能性のあるアプリを接続しないでください。例えば、Slack に未公開の機密データを含むメッセージがある場合は、接続しないでください。
パート 5: フックとスケジュールされたタスク
研究プロジェクトの最も重要な部分の部分の 1 つは、すべてのファイルのバックアップを取ることです。学位論文の唯一のコピーを、最終審査の 3 日前にクラッシュするコンピュータに保存しておきたくはないでしょう。
5.1 フックとは？
Claude Code のフックは、バックアップ作成プロセスを自動化できます。フックは、Claude Code で特定のイベントが発生したときに自動的に起動する、短い一連の指示です。フックを設定すると、使用を覚えておぼえておく必要はありません。Claude Code が自動的に使用します。
5.2 最初のフックを作成する
フックを作成する
フックを作成する最も簡単な方法は、Claude Code に作成を依頼することです。Claude Code セッションを開き、次のように入力します：
編集前の安全フックを設定してください。これは、章をコピーし、編集を開始する前に現在のバージョンを保存します。
このフックは、Claude Code に編集を依頼した章のバックアップバージョンを作成します。
フックの準備ができたら、Claude Code に次のように依頼します：
今日の Zoom ミーティングの文字起こしのコメントに基づいて、Drafts 内の Chapter_4.md を編集してください。
Claude Code は元のファイルのバックアップを作成し、バックアップフォルダに配置し、Drafts フォルダ内のコピーを編集します。
5.3 スケジュールされたタスクとは
長期的な学術ライティングプロジェクトには、定期的に実行する必要があるタスクが含まれます。例えば、最新の出版物を把握するために毎週文献スキャンを実行したい場合などです。
Claude Code では、フックと同様にスケジュールされたタスクジュールされたタスクを設定できます。何をいつ実行すべきかを説明するだけで、Claude Code がそのルーチンを記述します。スケジュールされたタスクは、以前のパートで説明したコネクタとサブエージェントを使用します。
5.4 スケジュールされたタスクのユースケース
研究者として、草稿の定期的なバックアップをスケジュールしたいでしょう。Claude Code に、Drafts フォルダ内のすべてをコピーし、日付スタンプを付けてバックアップフォルダに保存する Draft Backup タスクを作成するよう依頼できます。
5.5 例
Claude Code セッションを開き、次のように入力します：
< 毎週月曜日の午前 9 に実行されるスケジュールされたタスクを作成してください。PubMed MCP を使用して、先週公開されたソーシャルメディアとメンタルヘルスに関する新しい論文を取得します。次に、その論文を Literature Review サブエージェントに渡してスクリーニングさせます。スクリーニングテーブルを、Literature フォルダ内の Weekly Scans というサブフォルダに保存してください。
5.6 ～してはいけないこと
ファイルの削除を含むフックやスケジュールされたタスクを設定しないでください。
覚えきれなくなるほど多くのフックを作成しないでください。または、フックのリストを別途管理して思い出せるようにしてください。
少なくとも 4 回は手動で行ったことがないことに対して、フックやスケジュールされたタスクを設定しないでください。
