【2026年最新】Claude Code最強フォルダー構成完全ガイド｜CLAUDE.md・skills・commands・rules徹底解説

Claude Codeを8ヶ月以上本格運用している開発者の間で、フォルダー構成のベストプラクティスが話題になっています。本記事では、X上で共有されている最新の運用知見をもとに、2026年時点で効果的とされるClaude Codeのフォルダー構成と設定ファイルを徹底解説します。

Claude Codeとは？

Claude Code（クロード・コード）は、Anthropic社が提供するターミナルベースのAIコーディングアシスタントです。CLI・デスクトップアプリ・Web・IDE拡張機能として提供されており、自然言語でコードの生成・編集・リファクタリング・テスト・デプロイまでを支援します。

• 提供元：Anthropic
• 提供形態：CLI / デスクトップ（Mac/Windows）/ Web（claude.ai/code）/ IDE拡張（VS Code、JetBrains）
• 対応モデル：Claude Opus 4.6、Sonnet 4.6、Haiku 4.5 など
• 特徴：ファイル編集、Bash実行、Web検索、MCP連携、カスタムスキル、サブエージェントなど

なぜフォルダー構成が重要なのか？

Claude Codeを単発のQ&Aツールとして使うのではなく、継続的にプロジェクトやワークフローを支援させるには、適切なフォルダー構成と設定ファイルが不可欠です。

• コンテキストの永続化 — CLAUDE.mdでプロジェクト知識を毎回読み込み
• 再利用可能なワークフロー — カスタムコマンド・スキルで頻出タスクを自動化
• チームでの共有 — 設定ファイルをGit管理することで全員が同じ環境で作業可能
• トークン効率 — 必要な情報だけを読み込ませてコストを削減

2026年最新・Claude Code推奨フォルダー構成

X上で共有されている運用知見をまとめると、以下のような構成が主流になりつつあります。

project-root/
├── CLAUDE.md                # プロジェクトの全体方針・コーディング規約
├── .claude/
│   ├── settings.json        # 許可コマンド・フック設定
│   ├── commands/            # カスタムスラッシュコマンド
│   │   ├── commit.md
│   │   ├── review-pr.md
│   │   └── deploy.md
│   ├── skills/              # 再利用可能なスキル定義
│   │   ├── pdf-handler/
│   │   ├── db-migration/
│   │   └── test-runner/
│   ├── rules/               # 詳細なルール・ガイドライン
│   │   ├── security.md
│   │   └── naming.md
│   └── agents/              # サブエージェント定義
│       ├── reviewer.md
│       └── tester.md
├── MEMORY.md                # 学習した知見のインデックス
└── memory/                  # 個別メモリファイル
    ├── user_profile.md
    ├── project_context.md
    └── feedback_patterns.md

各ファイル・フォルダの役割

1. CLAUDE.md — プロジェクトの設計図

プロジェクトのルートに置く最重要ファイルです。Claude Codeは起動時に自動でこのファイルを読み込み、その内容を常に意識して作業します。

• プロジェクトの目的・概要
• 使用している技術スタック
• コーディング規約（命名・インデント・エラー処理など）
• 絶対にやってはいけないこと（禁止事項）
• よく使うコマンド・ワークフロー

2. .claude/settings.json — 動作設定

許可するBashコマンド、ツール、フック、環境変数などを定義します。セキュリティと効率の両立に必須のファイルです。

3. .claude/commands/ — カスタムスラッシュコマンド

頻繁に使うプロンプトを/commit、/review-prのような形で呼び出せるようにします。Markdownファイルとして定義するだけで、即座にClaude Code内で使用可能です。

4. .claude/skills/ — 再利用可能なスキル

PDF処理、DBマイグレーション、テスト実行など、特定領域の専門知識や手順をスキルとしてまとめます。複数プロジェクトで使い回せるのが強みです。

5. .claude/rules/ — 詳細ルール集

CLAUDE.mdに書ききれない細かいルール（セキュリティ基準、命名規則、レビュー観点など）を個別ファイルに分けて管理します。

6. .claude/agents/ — サブエージェント

コードレビュー専用、テスト専用、リサーチ専用などのサブエージェントを定義します。メインセッションからタスクを委譲することで、コンテキストを節約しつつ並列処理が可能です。

7. MEMORY.md + memory/ — 永続的な記憶

過去のやり取りから学んだこと（ユーザーの好み、失敗パターン、プロジェクトの背景など）を永続的に記録します。セッションをまたいでも知識が失われないため、長期的にClaude Codeを育てる感覚で運用できます。

実装のポイント5選

ポイント1：CLAUDE.mdは簡潔に、肥大化させない

CLAUDE.mdは毎回のセッションで読み込まれるため、長すぎるとトークンを無駄に消費します。200行以内を目安に、本当に重要な情報だけを残しましょう。詳細は.claude/rules/に分けるのが鉄則です。

ポイント2：settings.jsonで許可コマンドを明示

デフォルトで確認なしで実行できるコマンドを明示的に指定することで、作業効率が大幅に上がります。ただし破壊的コマンド（rm -rf、git push –force など）は必ず確認を挟む設定にしましょう。

ポイント3：カスタムコマンドで反復作業を自動化

例えば/commitコマンドを作成しておけば、「変更内容を確認→適切なコミットメッセージを生成→コミット実行」という一連の流れを1コマンドで実行できます。

ポイント4：メモリ機能で知見を蓄積

ユーザー情報、プロジェクト情報、フィードバック、参照情報などをタイプ別に分類して保存することで、Claude Codeが成長していく実感が得られます。

ポイント5：サブエージェントでコンテキスト節約

大量のファイル検索や調査タスクはサブエージェントに委譲することで、メインセッションのコンテキストウィンドウを節約できます。長いプロジェクトを継続的に進める上で非常に有効です。

よくある失敗パターンと対策

失敗1：CLAUDE.mdが肥大化してコンテキスト圧迫

対策：詳細は.claude/rules/に分離し、CLAUDE.mdには見出しと概要のみ残す。

失敗2：カスタムコマンドが散らかる

対策：コマンド名の命名規則を統一し、README.mdで一覧管理する。

失敗3：メモリが更新されず古い情報が残る

対策：定期的にmemory/ディレクトリを見直し、陳腐化した情報は削除または更新する。

失敗4：セキュリティ設定が甘くて事故発生

対策：settings.jsonの許可コマンドは最小限にし、破壊的操作は必ず確認を挟む。

Claude Code運用のトークン節約術

長期運用ではトークン消費量の管理が重要になります。X上で話題になっている節約テクニックを紹介します。

• 必要な時だけサブエージェント起動 — 常時起動は避け、タスクが発生した時だけ呼び出す
• ファイル読み込みは部分読み — 大きなファイルはoffsetとlimitを指定して必要箇所のみ
• コンテキスト圧縮を活用 — 長くなったセッションは定期的に要約して圧縮
• MCP連携で外部ツール化 — 複雑な処理はMCPサーバー側に移譲
• Haikuの活用 — 軽量タスクは高速なClaude Haikuに委譲してコスト削減

チームで運用する場合のコツ

個人開発ならもちろん、チーム開発でもClaude Codeは強力な武器になります。

• .claudeディレクトリをGit管理 — チーム全員が同じ設定・コマンド・スキルを使える
• CLAUDE.mdにチームルールを記載 — コードスタイルやレビュー基準を明文化
• memory/は個人環境に分離 — 個人の学習記録はGit管理から除外
• レビューフローを自動化 — /review-prコマンドでPRレビュー観点を統一

まとめ

Claude Codeを真価を発揮させるには、適切なフォルダー構成と設定ファイルの整備が何より重要です。

• CLAUDE.mdでプロジェクトの全体方針を共有
• .claude/settings.jsonで許可コマンド・フックを設定
• .claude/commands/でカスタムスラッシュコマンドを整備
• .claude/skills/で再利用可能なスキルを定義
• .claude/agents/でサブエージェントを活用
• MEMORY.mdで永続的な知識を蓄積

最初から完璧な構成を目指す必要はありません。使いながら少しずつ育てていくのがClaude Code運用の正解です。本記事の構成を参考に、あなたのプロジェクトに合った最強フォルダー構成を作り上げてください。

よくある質問（FAQ）

Q. Claude Codeは無料で使えますか？

A. Claude ProやClaude Teamsなどのサブスクリプションが必要です。無料枠もありますが、本格運用には有料プランが推奨されます。

Q. CLAUDE.mdは必ず作る必要がありますか？

A. 必須ではありませんが、プロジェクト規模が大きくなるほど効果が大きくなります。最初は簡単な概要だけでも十分です。

Q. カスタムコマンドとスキルの違いは何ですか？

A. コマンドは「特定のプロンプトの呼び出し」、スキルは「専門知識と手順を持つ再利用可能な能力」です。用途に応じて使い分けます。

Q. サブエージェントを使うと料金は増えますか？

A. 追加料金ではなく、消費トークンが増加します。ただし、メインセッションを圧迫しないため、結果的に効率化できるケースが多いです。

Q. チーム導入の際の注意点は？

A. セキュリティ設定（settings.json）を最小限にすること、機密情報を含むファイルをClaude Codeに読み込ませないこと、個人メモリをGit管理から除外することなどが重要です。