Claude Codeディレクトリ構成を完全図解｜.claudeフォルダの中身と役割を徹底解説

こんにちは！Renです！

Claude Codeを使い始めると、プロジェクトフォルダにCLAUDE.mdや.claude/といったファイル・フォルダが出現しますよね。

「これ何？触っていいの？」と思いつつ、よく分からないまま使っている人、多いんじゃないでしょうか。

今回は、Claude Codeに関わるディレクトリ構成の全体像を1記事で完全整理します。

この記事を読めば、「どのファイルをどこに置けばいいか」で迷うことはなくなるはずです。

Claude Codeのディレクトリ構成【全体マップ】

まずは全体像を見てみましょう。

Claude Codeに関連するファイル・フォルダは、大きく「プロジェクト配下」と「ホームディレクトリ（グローバル）」の2つの場所に分かれます。

my-project/                      ← プロジェクトルート
├── CLAUDE.md                   ← プロジェクト設定ファイル
├── CLAUDE.local.md             ← 個人用設定（.gitignore推奨）
├── .claude/
│   ├── settings.json           ← 権限・フック設定
│   ├── settings.local.json     ← 個人用権限設定
│   ├── skills/                 ← プロジェクトスキル
│   │   └── review/
│   │       └── SKILL.md
│   ├── rules/                  ← ルール分割ファイル
│   │   ├── code-style.md
│   │   └── testing.md
│   ├── agents/                 ← サブエージェント定義
│   │   └── researcher.md
│   └── commands/               ← カスタムコマンド（※レガシー）
│       └── deploy.md
└── src/
    └── ...

~/.claude/                       ← グローバル設定（全プロジェクト共通）
├── CLAUDE.md                   ← グローバルCLAUDE.md
├── settings.json               ← グローバル権限設定
├── skills/                     ← 個人スキル
│   └── explain-code/
│       └── SKILL.md
├── agents/                     ← 個人サブエージェント
└── commands/                   ← 個人コマンド

CLAUDE.md ― Claude Codeの「社員ハンドブック」

CLAUDE.mdとは？

CLAUDE.mdは、Claude Codeが毎セッション自動で読み込む設定ファイルです。

プロジェクトの概要、コーディング規約、よく使うコマンド、ディレクトリ構成の説明などを書いておくと、Claude Codeがその情報を前提に動いてくれます。

まだCLAUDE.mdを作っていない場合は、Claude Codeの対話モードで/initコマンドを実行すれば自動生成できます。Claude Codeがプロジェクトのコードを読み取って、概要・技術スタック・ディレクトリ構成などをまとめてくれます。

配置場所と読み込み順序

CLAUDE.mdは実は複数の場所に配置可能で、すべてが読み込まれます。

配置場所	スコープ	Git管理	用途
~/.claude/CLAUDE.md	全プロジェクト共通	×	個人のコーディングスタイル
プロジェクトルート/CLAUDE.md	プロジェクト	○	チーム共有の規約・構成
CLAUDE.local.md	プロジェクト	×	個人の追加設定
サブディレクトリ/CLAUDE.md	そのディレクトリ以下	○	モノレポの個別設定

CLAUDE.mdの具体的な書き方・セクション構成については、CLAUDE.mdの書き方完全ガイド｜Claude Codeの出力品質が変わるプロジェクト設定ファイル入門で詳しく解説しているので、あわせてチェックしてみてください。

.claude/フォルダの中身を完全解説

ここからがメインです。

.claude/フォルダの中には、Claude Codeの動作をカスタマイズするための5つの主要な要素が入ります。

settings.json ― 権限とフックの設定ファイル

settings.jsonは、Claude Codeの権限設定とHooks（フック）を定義するファイルです。

権限設定では、Claude Codeがどのツール・コマンドを自動実行してよいか（allow/deny）を定義します。

もう一つの役割がHooks（フック）です。フックとは、Claude Codeが特定のアクション（ファイル編集、コマンド実行など）を行う前後に、自動で別の処理を実行する仕組みです。たとえば「ファイルを保存したら自動でフォーマットをかける」といったことができます。

skills/ ― 専門知識を教えるフォルダ

skills/は、Claude Codeに特定タスクの「やり方」を教えるフォルダです。

各スキルはフォルダ単位で管理します。フォルダの中にSKILL.mdを配置し、YAMLフロントマター（name, description）とMarkdown本文でスキルの内容を定義します。

.claude/skills/
├── review/
│   ├── SKILL.md           ← スキル定義本体
│   └── checklist.md       ← 補助ファイル（任意）
└── test-gen/
    ├── SKILL.md
    └── generate.py        ← スクリプトも同梱可能

スキルの大きな特徴は、Claude Codeが自動で判断して必要なスキルを読み込んでくれること。SKILL.mdのdescription（説明文）をもとに、「今のタスクにはこのスキルが必要だ」と判断して自動適用します。

もちろん、/スキル名で手動で呼び出すこともできます。

スキルの作り方を詳しく知りたい方は、Claude Skillsの作り方｜初心者でも10分で自分専用AIアシスタントが作れるをチェックしてみてください。

rules/ ― ルールを分割管理するフォルダ

rules/は、CLAUDE.mdに書ききれないルールをファイル単位で分割管理するフォルダです。

.claude/rules/
├── code-style.md       ← コーディングスタイルのルール
├── testing.md           ← テスト規約
└── security.md          ← セキュリティ要件

rules/配下のファイルには、YAMLフロントマターで適用条件（glob/pathパターン）を指定できます。

たとえば「テスト関連のファイルを触るときだけtesting.mdを読み込む」「src/components/配下のファイルではcode-style.mdを適用する」といった、きめ細かい制御が可能です。

agents/ ― サブエージェント定義フォルダ

agents/は、専門分野に特化したAIサブエージェントを定義するフォルダです。

サブエージェントとは、メインのClaude Codeとは別のコンテキストウィンドウで動く、専門家のようなAIです。たとえば「コードレビュー専門」「リサーチ専門」「データベース専門」といったサブエージェントを作れます。

.claude/agents/
└── researcher.md       ← リサーチ専門のサブエージェント

エージェントファイルはMarkdown形式で、YAMLフロントマターにモデル名やツール権限、カスタムプロンプトを定義します。

commands/ ― カスタムコマンド（Skillsへの移行推奨）

commands/は、カスタムスラッシュコマンドを定義するフォルダです。

ただし、v2.1.3以降、SkillsとCommandsが統合されています。既存のcommands/ファイルはそのまま動作しますが、新しく作る場合はskills/形式が推奨されています。

カスタムコマンドの詳しい使い方は、Claude Codeカスタムコマンド完全ガイド｜定型タスクをワンコマンド化する手順と使い方で解説しています。

プロジェクト用 vs グローバル用の使い分け

ここまで見てきたファイル・フォルダは、プロジェクト配下（.claude/）とホームディレクトリ（~/.claude/）の両方に置けます。

では、どう使い分ければいいのか。

項目	プロジェクト（.claude/）	グローバル（~/.claude/）
Git管理	○（チーム共有）	×（個人のみ）
適用範囲	そのプロジェクトだけ	全プロジェクト
主な用途	コーディング規約、固有スキル	個人の好み、汎用スキル
具体例	コードレビュー、デプロイ手順	日本語回答設定、コード説明スキル

各要素の役割を比較【一覧表】

ここまで解説した各要素の違いを、1つの表で整理しておきます。

実際のプロジェクトで見るディレクトリ構成例

例1: 個人開発（Webアプリ）

シンプルなWebアプリの個人開発プロジェクトなら、こんな構成が使いやすいです。

my-web-app/
├── CLAUDE.md              ← プロジェクト概要・技術スタック・コマンド
├── .claude/
│   ├── settings.json      ← npm run test の自動許可 など
│   └── skills/
│       └── review/
│           └── SKILL.md   ← コードレビューのチェックリスト
├── src/
├── tests/
└── package.json

個人開発なら最初はCLAUDE.md + settings.json + 1〜2個のスキルで十分です。プロジェクトが大きくなったら、rules/やagents/を追加していきましょう。

例2: チーム開発（モノレポ）

フロントエンドとバックエンドが同一リポジトリにあるモノレポ構成なら、CLAUDE.mdの階層分けが効いてきます。

monorepo/
├── CLAUDE.md              ← 全体方針・共通規約
├── .claude/
│   ├── settings.json
│   ├── rules/
│   │   ├── code-style.md  ← 共通コーディング規約
│   │   └── security.md    ← セキュリティルール
│   └── skills/
│       └── pr-create/
│           └── SKILL.md   ← PR作成手順
├── frontend/
│   ├── CLAUDE.md          ← React固有の規約・コンポーネント設計
│   └── src/
└── backend/
    ├── CLAUDE.md          ← API設計・DB規約
    └── src/

よくある失敗と対策

最後に、ディレクトリ構成に関するよくある失敗を3つ紹介します。

僕自身がハマったものもあるので、先に知っておくと時間を節約できるはずです。

Claude Codeを使うときの構造的な注意点については、非エンジニアがClaude Codeを使うとなぜブラックボックス化するのかの記事も参考になるので、あわせてチェックしてみてください。

まとめ ― ディレクトリ構成は「Claude Codeとの共通言語」

ディレクトリ構成を理解することは、Claude Codeとのコミュニケーションを整理することです。

「何を」「どこに」置くかが整理されていれば、Claude Codeは的確に情報を読み取り、質の高いアウトプットを返してくれます。

Claude Codeの基本的な使い方から知りたい方は、Claude Codeの使い方をゼロから解説｜動かしながら覚える最短ルートから始めるのがおすすめです。

ではまた！