Claude Codeの前に知っておきたいディレクトリ超入門

「Claude Codeを使い始めたけど、ディレクトリ、MDファイル、コンテキスト……横文字だらけで何が何だか分からない…」

そんな状態になっていませんか。

Claude Codeを触り始めると専門用語が次々と登場しますが、それらはすべて、日常的に使い慣れた概念に言い換えられるものです。

正しく理解するだけで、Claude Codeをより迷わず、より高品質に使いこなせるようになります。

今回は、利用者数No.1*のAI活用コミュニティ「SHIFT AI」で開催された会員向けオンラインウェビナー「Claude Codeの前に知っておきたいディレクトリ超入門」の内容の一部を特別公開します。

※ GMOリサーチ&AI株式会社調べ ■調査項目/調査時点（2025年2月）における累計登録者数 ■調査対象/企業が運営するAI活用事例や実践ノウハウなど、ビジネス目的でのAI活用に関する講義を提供するコミュニティサービスを対象とし、講義を行わないネットコミュニティや個人運営のコミュニティ、ビジネス目的以外のコミュニティサービスは対象外とする

【※このウェビナーは終了しました。最新の参加案内はコミュニティ説明会でご案内しています。】

ウェビナー概要

このウェビナーの内容は以下のとおりです。

• ディレクトリ（フォルダ構造）の基本的な考え方
• AIにとって読みやすい「マークダウン（MD）ファイル」の重要性
• AIに前提情報を伝える「コンテキスト」の概念
• ファイルの住所を示す「パス」の読み解き方
• 「グローバル」と「プロジェクト」の使い分け

それでは、AIを自由自在に操るための第一歩となる、ディレクトリの基礎知識を見ていきましょう。

そもそも「ディレクトリ」とは何か？

「ディレクトリ」という言葉を聞くと難しく感じるかもしれませんが、これは私たちが普段使っている「フォルダ」と全く同じ意味です。

AIに特定の仕事を依頼する際、どの情報をどこに置くかを整理しておくことは、作業の正確性に直結します。

パソコン上の住所を理解する

ディレクトリとは、ファイルがどこにあるのかを示す「住所」のような役割を果たしています。

AIにファイルを読み込ませる際、この「パス（住所）」を正しく指定することで、AIは迷わずに必要な情報へアクセスできるようになります。

階層構造で情報を整理する

フォルダの中にさらにフォルダを作ることで、情報を階層的に管理できます。

AIツールを使う際も、この階層構造を意識して整理することが、複雑なタスクをスムーズに実行させるための鍵となります。

なぜ「MDファイル」が重要なのか？

Claude CodeなどのAIエディタでは、「.md」という拡張子のマークダウンファイルが頻繁に使用されます。

これは、単なるメモ帳以上の役割を持っており、AIと人間をつなぐ共通言語として機能します。

AIにとって読みやすい構造で記述する

マークダウン形式は、見出しや箇条書きなどが明確に区別されているため、AIが情報を構造的に理解しやすくなります。

適切なマークダウン記法を用いることで、AIへの指示の精度が格段に向上します。

前提情報となるコンテキストを蓄積する

自分の業務ルールや個人的な設定をMDファイルに書き留めておくことで、AIはそれを「コンテキスト（文脈）」として学習します。

自分専用の指示書をMDファイルで作ることにより、AIはよりあなたに最適化された回答を出せるようになります。

「グローバル」と「プロジェクト」を使い分けるコツ

AIの設定をどこに保存するかによって、その影響範囲が変わります。

全ての作業に適用したい共通ルールと、特定の案件だけで使いたい個別ルールを明確に切り分けて管理することが重要です。

全体で共通して使うルールを設定する

「グローバル」な場所に設定ファイルを置くと、どのフォルダで作業をしていてもAIはそのルールに従います。

自分自身のプロフィールや基本的な好みを登録することで、常に一貫したサポートを受けられます。

特定の案件ごとに指示を出し分ける

プロジェクト（案件）ごとのフォルダに個別の設定を置くと、その範囲内だけで有効なルールになります。

業務内容に合わせてルールを最適化することで、他の作業に影響を与えることなく、高度な自動化を実現できます。

まとめ：ディレクトリ構造をマスターしてAIを味方につける

ディレクトリの構造を理解し、適切にファイルを配置できるようになれば、Claude CodeなどのAIツールはあなたの最強のパートナーになります。

まずは簡単なフォルダ作成とMDファイルの配置から始めてみましょう。

今回のウェビナーでは基礎的な概念を中心にご紹介しましたが、SHIFT AIの会員限定本編では、さらに踏み込んだ「エラーを防ぐルール」や「具体的なフォルダの構造」など、より実践的で応用的なテクニックが詳しく解説されています。

AIを業務の核として使いこなしたい方は、ぜひコミュニティでの学びを深めてみてください。