WHAT IS IT
＝ フォルダ
ディレクトリは専門用語ではない。普段使っているフォルダと同じもの
「フォルダの整理」が、そのままAIの仕事の質になる。チャット型AIとの決定的な違いから、資料の置き方、そしてAI自身の設定を置く .claude/ の全体像まで。プログラミング未経験でも読み切れるように噛み砕いた入門ガイド。
結論から言うと、ディレクトリ＝フォルダ。それ以上でも以下でもない。エンジニアがそう呼んでいるだけで、中身は普段使っているものと1ミリも違わない。
呼び方が違うだけ。ここでつまずく必要はまったくない。
箱の中に箱がある。この入れ子の形が「ディレクトリ構造」。
フォルダの中にフォルダがあり、その中にファイルがある。
このあと出てくる話は、すべてこの「入れ子」をどう設計するかという話にすぎない。
技術的な理解は不要。整理整頓の話だと思ってよい。
ここが本質。いちばん腹落ちしにくいポイントなので、対比で押さえる。
| 観点 | チャット版Claude | Claude Code |
|---|---|---|
| ファイルの参照 | 手渡ししたものだけ | フォルダ内を自分で探索 |
| 成果物の行き先 | 画面に出て、流れて消える | 指定した場所にファイルとして残る |
| 前提の共有 | 毎回、口頭で説明し直す | CLAUDE.md を自動で読む |
| 作業の積み上がり | 1回ごとに切れる | 前回の成果が次回の材料になる |
| 準備の手間 | ゼロ。すぐ使える | 最初にフォルダ設計が要る |
Claude Codeは万能ではなく「初期投資が要る代わりに資産が残る」という性質。だから構造の話が最初に来る。
理由は3つ。どれも「AIの性能を上げる」ではなく「AIの足を引っ張らない」ための話。
Claudeは全部を暗記しているのではなく、依頼を受けてから当たりをつけて必要な場所だけ読む。
違う。人間の新人スタッフと同じで、頼まれてから「これが必要そうだ」と推測して探しに行く。ラベルが読めなければ、外れた資料を掴む。
整理されていれば一発で当たる。散らかっていれば、AIは的外れな資料を根拠に、それらしい嘘を書く。ハルシネーションの多くは構造の問題でもある。
「コンテキスト」＝一度に頭に入れられる情報量。会議室のホワイトボードだと思えばよい。有限で、埋まれば書けなくなる。
構造がぐちゃぐちゃだと、探すだけでホワイトボードが埋まる。長い作業が途中で息切れし、精度も落ちる。整理はAIの集中力を無駄遣いさせないための投資。
放っておくと五十音順・アルファベット順に並ぶ。頭に番号を振れば「使う順・重要な順」に自分で並べ替えられる。
「何をするか」で切ると、作業が終わった瞬間に置き場所を失う。「何についてか」で切れば何年経っても崩れない。
混ぜると、AIが「どれが元ネタで、どれが自分の出力か」を判別できず、自分の出力を材料に再利用する。伝言ゲームと同じ劣化が起きる。
4階層を超えると人間が場所を忘れる。人間が忘れるものはAIも探せない。深く掘るより、上の階層を増やすほうが健全。
Claudeはファイル名を手がかりに検索する。ファイル名は、AIに対する最も安いヒント。
この2問に「はい」と答えられれば、その構造は正しい。
Q1. 名前だけ見て中身が想像できるか
Q2. 半年後の自分が同じ場所に置くか
Claude Codeを使うフォルダには .claude という特別なフォルダを作れる。ここがClaudeの「就業規則」「業務マニュアル」「人事」の置き場になる。
補足：頭に「.」がつくフォルダはPC上で標準では非表示になる。「見えないけれど確かにある」だけで、特別に難しいものではない。
本社の就業規則と、支店独自のルールの関係と同じ。第4章で作った構造が、ここでそのまま効いてくる。
セッションを始めた瞬間に自動で読み込まれる。「毎回同じ指示を書いている」と気づいたら、それはCLAUDE.mdに移すサイン。
同じ仕組みの個人版。チームに共有したくない設定を書く場所。settings.json にも同様に settings.local.json がある。
長くなるほど1行あたりの効きは落ちる。守ってほしいルールほど短く。まずは5行から。
見た目が似ているので必ず質問が出る。違いは「誰が起動するか」の1点だけ。
迷ったら skills/ から作るのがおすすめ。呼び出し名を覚える必要がなく、自然な会話のまま動くため。
症状から編集場所が即決まる。
「口調を変えたい」→ CLAUDE.md
「毎回聞かれて面倒」→ settings.json
「同じ手順を繰り返す」→ skills/
権限とルールが1箇所にまとまっていれば、「なぜこう動いたのか」を後から追える。原因が特定できない状態が、いちばん時間を溶かす。
役割ごとにファイルが分かれているので、全部を作り直さず、効いていない1行だけを直せる。改善のコストが下がる。
全部を最初から作る必要はない。「どこに何があるか」だけ知っていれば、必要になったときに1つずつ足していける。
どれも「AIが悪い」ように見えて、実際は構造の問題。深刻度の高い順に並べた。
AIの視界に無関係なファイルが数千件入る。探索が遅く、精度も落ちる。
AIが自分の出力を元ネタと誤認し、内容が劣化しながら自己増殖する。気づきにくいのが最も危険。
「議事録どこ？」に対してAIが総当たりする。時間とコンテキストの浪費。
検索が効かない。AIが「該当ファイルは無い」と判断し、既存資料を無視して勝手に作り始める。
長すぎて全部が薄まる。守ってほしいルールほど短く、が原則。
前者はどこに置いたか人間が忘れる。後者は効果を実感できず挫折する。まずはCLAUDE.mdから。
いきなり完璧な構造を作る必要はない。フェーズ1で資料の置き場を決め、フェーズ2でAIの設定を足していく。
上から順に。1つずつでいい。
チャット版は「毎回説明する」、Claude Codeは「一度整理すれば、そこが資産になる」。
資料のディレクトリはAIに渡すオフィスの間取り図。
.claude/ はそのオフィスの就業規則と人事である。