---
title: CLAUDE.mdの書き方と設計パターン｜規模別の分割・階層設計とチーム運用
description: CLAUDE.mdは、規模に応じて置き場所を分けて設計します。小規模はルート1ファイル、中規模は@記法のインポートと.claude/rules/のpaths指定で分割、モノレポはディレクトリごとに階層化します。個人設定とチーム共有の使い分け、ミスを起点にルールを育てる運用、スキルへの切り出しまで解説します。
image: https://start-link.jp/hubfs/blog/screenshots/generated/kv_claude-code-claudemd-patterns.jpg
---

[![StartLink](https://start-link.jp/hs-fs/hubfs/logo/%E6%9C%80%E7%B5%82Start%20Link%20(500%20x%20150%20px)%20(%E8%83%8C%E6%99%AF%E3%81%82%E3%82%8A).png?width=130&height=39&name=%E6%9C%80%E7%B5%82Start%20Link%20(500%20x%20150%20px)%20(%E8%83%8C%E6%99%AF%E3%81%82%E3%82%8A).png "StartLink")](https://start-link.jp)

- [会社情報About](https://start-link.jp/about)
- [サービスService](https://start-link.jp/service)
- [プロダクトProducts](https://start-link.jp/sync)
- [YoutubeYoutube](https://start-link.jp/about/sns)
- [ブログBlog](https://start-link.jp/hubspot-ai)
- [業界別ガイドIndustry guides](https://start-link.jp/case)
- [採用情報Recruit](https://start-link.jp/recruit)

[資料DL](https://start-link.jp/download/service) [無料相談 →](https://start-link.jp/contact)

[会社情報](https://start-link.jp/about) [サービス](https://start-link.jp/service) [プロダクト](https://start-link.jp/sync) [Youtube](https://start-link.jp/about/sns) [ブログ](https://start-link.jp/hubspot-ai) [業界別ガイド](https://start-link.jp/case) [採用情報](https://start-link.jp/recruit)

[資料ダウンロード](https://start-link.jp/download/service) [無料相談 →](https://start-link.jp/contact)

- [トップ](https://start-link.jp)
- [会社情報](https://start-link.jp/about)
- [サービス](https://start-link.jp/service)
- [Youtube](https://start-link.jp/about/sns)
- [ブログ](https://start-link.jp/hubspot-ai)
- [Contact](https://start-link.jp/contact)
- [個人情報保護方針](https://start-link.jp/privacy-policy)
- [個人情報取り扱い規定](https://start-link.jp/personal-information-processing-agreement)

[ホーム](https://start-link.jp) › [ブログ](https://start-link.jp/hubspot-ai) ›[AI活用](https://start-link.jp/hubspot-ai/ai) ›[Claude Code実践](https://start-link.jp/hubspot-ai/ai/claude-code-practice) ›CLAUDE.mdの書き方と設計パターン｜規模別の分割・階層設計とチーム運用

# CLAUDE.mdの書き方と設計パターン｜規模別の分割・階層設計とチーム運用

- 2026年3月17日
- 最終更新: 2026年10月24日

![](https://start-link.jp/hubfs/blog/screenshots/generated/kv_claude-code-claudemd-patterns.jpg)

この記事の結論

CLAUDE.mdは、Claude Codeにプロジェクトの前提・ルール・作法を教える設定ファイルです。1ファイルに詰め込まず、プロジェクト規模に応じて「常に読ませるもの」と「必要なときだけ読ませるもの」を分けて設計します。

ブログ目次

もっと見る ▼

**CLAUDE.mdは、Claude Codeにプロジェクトの前提・ルール・作法を教える設定ファイルです。1ファイルに詰め込まず、プロジェクト規模に応じて「常に読ませるもの」と「必要なときだけ読ませるもの」を分けて設計します。**

「CLAUDE.mdを書き始めたが、どこまで細かく書くべきか分からない」「プロジェクトが大きくなるにつれてCLAUDE.mdが肥大化し、Claude Code自体の動作が重くなってきた」「チームの誰かが書き足したルールと、別の人のルールが食い違っている」——CLAUDE.mdを使い込むほどに直面する設計上の悩みです。

CLAUDE.mdの設計とは、ルールを「全体に効くもの」「特定の領域にだけ効くもの」「特定の作業のときだけ効くもの」に分け、それぞれを適切な置き場所に配置することです。小規模ならルートの1ファイル、中規模なら`.claude/rules/`とpaths指定による分割、モノレポならディレクトリごとの階層化が基本の型になります。

Claude Codeの使い方・コマンド・並列実行・料金の全体像は[Claude Code完全ガイド（ハブ）](https://start-link.jp/hubspot-ai/ai/claude-code-practice)で目的別に整理しています。

## この記事でわかること

CLAUDE.mdの設計パターンを学び、プロジェクトに最適化したい開発リーダーに向けた記事です。規模別の置き場所の決め方から、チームでルールを育てていく運用までを順に解説します。

- **読み込みタイミングと階層構造** — Claude Codeは複数の設定ファイルを階層的に読み込みます。どこに書いたルールがどの範囲に、いつ効くのかを整理します。
- **インポートと.claude/rules/による分割** — 外部ファイルの取り込みと、pathsフロントマターで特定のファイルパスにだけルールを適用する方法を解説します。
- **モノレポでの階層設計** — 複数プロジェクト・複数チームが同居するリポジトリで、ルールをどう分けるかを実例で示します。
- **個人設定とチーム共有の使い分け** — ユーザー設定（`~/.claude/CLAUDE.md`）、プロジェクト共有のCLAUDE.md、個人用の`CLAUDE.local.md`に、それぞれ何を書くかを整理します。
- **スキル・サブエージェント時代の置き場所** — 長い手順をスキルへ切り出す判断や、サブエージェントのモデル固定の考え方を解説します。

## CLAUDE.mdとは｜AIに渡すオンボーディングドキュメント

CLAUDE.mdは、Claude Codeに「このプロジェクトではどう振る舞うべきか」を教えるための設定ファイルです。まずは役割と、なぜ設計の考え方が要るのかを整理します。ここを押さえておくと、後半の分割パターンを選ぶ基準がぶれにくくなります。

### プロジェクトのルールをAIに伝える仕組み

Claude Codeは、プロジェクトのルートに配置された`CLAUDE.md`を読み込み、その内容に基づいて応答スタイル、コーディング規約、禁止事項、ワークフローなどを適用します。人間のチームにおける「オンボーディングドキュメント」に相当し、新しいメンバーが入社したときに渡す「このプロジェクトのルール集」と同じ役割を、AIエージェントに対して果たします。

ゼロから書くのが負担な場合は、`/init`コマンドでコードベースを読ませて最初のCLAUDE.mdを生成できます（出典：[Manage Claude's memory](https://code.claude.com/docs/en/memory)）。AIに叩き台を作らせ、チームの実情に合わない記述を人間が削って整えるという進め方が、取っ掛かりとしてはやりやすいと考えています。なお、`AGENTS.md`が既にあるリポジトリでは、作業ディレクトリとその上位ディレクトリに`CLAUDE.md`・`.claude/CLAUDE.md`・`CLAUDE.local.md`がない場合に限り、既定で`AGENTS.md`が読まれます。これらがひとつでもあると`CLAUDE.md`側だけが読まれるため、併用したい場合は`CLAUDE.md`から`AGENTS.md`をインポートします。`AGENTS.md`を直接読むにはClaude Code v2.1.277以降が必要で、セッションによっては読めないこともあります（出典：[Manage Claude's memory](https://code.claude.com/docs/en/memory)の「AGENTS.md」）。

### 1ファイルへの詰め込みが破綻する理由

プロジェクトの初期は、ルールをすべてルートの`CLAUDE.md`に書いても問題なく回ります。ところがチームが増え、フロントエンド・バックエンド・インフラと担当領域が分かれてくると、ある領域にしか関係しないルールまで毎回すべて読み込まれるようになります。内容が長くなるほど、関係のないルールがコンテキストを占め、ルール同士の矛盾も見つけにくくなります。

これは、スプレッドシートで顧客管理をしていて、シートとタブが増えるほど「どれが最新の情報か」が分からなくなる状況とよく似ています。ルールが複数の会話や個人のメモ、口頭の申し送りに散らばっている状態も同じです。置き場所を決めて一元管理し、読み込ませる範囲を仕組みで絞ることが、CLAUDE.md設計の出発点になります。

### README.mdとの役割の違い

README.mdは人間の開発者向けのドキュメントで、セットアップ手順や使い方を記載します。CLAUDE.mdはAIエージェント向けの設定ファイルで、コーディング規約や禁止事項を記載します。

| 観点 | README.md | CLAUDE.md |
| --- | --- | --- |
| 読み手 | 人間の開発者 | Claude Code |
| 主な内容 | セットアップ手順・使い方・概要 | コーディング規約・禁止事項・作業の進め方 |
| 書き方 | 説明的な文章 | 具体的で判断に迷わない指示 |

両者は目的が異なるため、どちらか一方に統合するのではなく、それぞれ独立して管理することをおすすめします。

## 設定ファイルの読み込みタイミングと階層構造

Claude Codeは複数の設定ファイルを階層的に読み込みます。どのファイルがどの範囲に効き、いつ読み込まれるのかを把握すると、「全体に適用するルール」と「特定の領域にだけ適用するルール」を無駄なく設計できます。ここでは配置場所と読み込みタイミングの一覧と、設計への生かし方を解説します。

### 配置場所と読み込みタイミングの一覧

公式ドキュメントによると、見つかったファイルは互いを上書きするのではなく、すべてコンテキストへ連結されます。ルートに近いものから作業ディレクトリに近いものの順に並び、作業ディレクトリに近い指示ほど後に読まれます。同じディレクトリでは`CLAUDE.local.md`が`CLAUDE.md`の後ろに追加されます。なお、矛盾する指示があった場合にどちらが従われるかは保証されておらず、Claudeがどちらかを任意に選ぶことがあります（出典：[Manage Claude's memory](https://code.claude.com/docs/en/memory)の「How CLAUDE.md files load」）。

| ファイル | 読み込みタイミング | スコープ | 用途 |
| --- | --- | --- | --- |
| `~/.claude/CLAUDE.md` | 起動時 | 全プロジェクト共通（ユーザー設定） | 個人の好み・全プロジェクト共通の個人ルール |
| `CLAUDE.md`（プロジェクトルート）、`.claude/CLAUDE.md` | 起動時（作業ディレクトリとその上位ディレクトリの分） | プロジェクト全体 | プロジェクト固有のルール・アーキテクチャ（2つの置き場所はどちらも使える） |
| `CLAUDE.local.md` | 起動時（同じ階層の`CLAUDE.md`の後ろに追加） | 個人用・そのプロジェクトのみ | 検証用のURLなど、コミットしない個人メモ |
| `{サブディレクトリ}/CLAUDE.md` | Claudeがそのディレクトリのファイルを読む・書く・編集したとき | 特定ディレクトリ | ディレクトリ固有のルール |
| `.claude/rules/*.md`（`paths`なし） | 起動時 | プロジェクト全体 | 領域を分けて書く常時ルール |
| `.claude/rules/*.md`（`paths`あり） | 一致するファイルをClaudeが操作したとき | パスマッチング | ファイルパス条件付きルール |

範囲が狭いものほど強く効く、という上書き関係はありません。全員に共通する原則は広いファイルに、領域固有の作法は狭いファイルや`paths`付きのルールに置くことで、必要な場面でだけ読み込まれる状態にするのが基本です。

### 読み込みタイミングを設計に生かす考え方

読み込みタイミングを理解したうえで、ルールを書く前に「このルールは誰のどの作業に効くべきか」を決めてから置き場所を選びます。判断の分かれ目は次の通りです。

| ルールの性質 | 置き場所 |
| --- | --- |
| 自分だけの好み（応答言語・コメントの書き方） | `~/.claude/CLAUDE.md` |
| チーム全員・全領域で守る原則 | ルートの`CLAUDE.md` |
| 特定ディレクトリの中だけで通用する作法 | そのディレクトリの`CLAUDE.md` |
| 特定の拡張子やパターンのファイルにだけ効く規約 | `.claude/rules/`（paths指定） |

同じルールを複数の階層に書くと、片方だけ更新されたときに矛盾が生まれ、どちらが従われるかも保証されません。1つのルールは1か所にだけ書き、下位のファイルでは上位と矛盾しない範囲で、その領域固有の点だけを書き足す形にしておくと、メンテナンスの負担が小さくなります。

## 規模別の基本パターン｜個人開発からチーム開発まで

CLAUDE.mdは、プロジェクトの規模によって適した構成が変わります。ここでは個人開発向けの最小構成と、チーム開発向けの中規模構成を示し、どのタイミングで次の構成に移るかの判断基準をまとめます。いきなり完成形を目指すのではなく、今の規模に合う構成から始めることをおすすめします。

### 最小構成（個人開発・小規模プロジェクト）

個人開発やファイル数が少ないプロジェクトでは、ルートの`CLAUDE.md`1ファイルで十分です。

```
# プロジェクトルール

## 技術スタック
- Next.js / TypeScript / Supabase / Tailwind CSS

## コーディング規約
- 関数はアロー関数で統一
- コンポーネントはfunction宣言
- 型はinterface優先（typeは複合型のみ）
- エラーハンドリングはtry-catchで明示的に

## 禁止事項
- any型の使用禁止
- console.logを残さない（console.errorは可）
- .envファイルへの直接値書き込み禁止

## テスト
- テストフレームワーク: Vitest
- 新規関数にはユニットテストを作成する
```

この段階では、技術スタック・コーディング規約・禁止事項・テストの4つが書けていれば十分です。ルールが増えてきたら分割を検討します。

### 中規模構成（チーム開発）

チーム開発では、CLAUDE.mdの責務を分割して管理性を高めます。ルートには全体の地図と共通ルールだけを置き、領域ごとの詳細は`.claude/rules/`に分けます。

```
プロジェクトルート/
  CLAUDE.md              全体ルール（簡潔に）
  .claude/
    rules/
      frontend.md        フロントエンド固有ルール
      backend.md         バックエンド固有ルール
      testing.md         テスト規約
      security.md        セキュリティルール
    settings.json        Hooks・権限設定
    agents/              カスタムエージェント
      reviewer.md
  src/
    app/
    components/
```

ルートCLAUDE.mdの記述例は次の通りです。詳細を書き込まず、「どこに何があるか」と「詳細ルールの参照先」に絞っている点がポイントになります。

```
# プロジェクト概要

ECサイトのリニューアルプロジェクト。Next.js + Supabase構成。

## アーキテクチャ
- フロントエンド: Next.js App Router
- バックエンド: Supabase Edge Functions
- DB: Supabase PostgreSQL
- 認証: Supabase Auth

## ディレクトリ構造
- src/app/ → ページ・ルーティング
- src/components/ → UIコンポーネント
- src/lib/ → ユーティリティ・ヘルパー
- supabase/functions/ → Edge Functions
- supabase/migrations/ → DBマイグレーション

## 共通ルール
- TypeScript strict mode
- ESLint + Prettier準拠
- 詳細ルールは .claude/rules/ を参照
```

### 次の構成に移るタイミングの見極め方

構成を切り替える基準は、ファイル数よりも「ルールの効き方」で判断するほうが実態に合います。次のシグナルが出たら、1段階先の構成に移るタイミングです。

| 現れたシグナル | 移る先の構成 |
| --- | --- |
| 特定の領域でしか使わないルールが増えてきた | `.claude/rules/`に分け、pathsで適用範囲を絞る |
| ルートのCLAUDE.mdを開いても目的のルールが探せない | ルートを地図に絞り、詳細をインポートで外に出す |
| 1つのリポジトリに複数のアプリ・チームが同居している | ディレクトリごとのCLAUDE.mdで階層化する |
| 特定の作業のときだけ使う長い手順が載っている | スキルに切り出す（後述） |

どのシグナルも出ていないうちは、分割しないほうが見通しを保てます。分割は目的ではなく、読み込む範囲を絞るための手段です。

## インポートと.claude/rules/による分割設計

ルールが増えてきたときの分割には、2つの道具があります。1つはCLAUDE.mdから別ファイルを取り込むインポート、もう1つは`.claude/rules/`に置いたファイルをpaths指定で条件付きに適用する方法です。前者は「長いファイルを読みやすく割る」道具、後者は「関係のない場面では読み込ませない」道具と考えると使い分けやすくなります。

### インポートの基本構文

CLAUDE.mdでは、`@`に続けてファイルパスを書くと、外部のMarkdownファイルを取り込めます。相対パスと絶対パスのどちらも使え、取り込んだファイルからさらに別のファイルを取り込むことも可能です。ただし再帰的なインポートは最大4ホップまでと公式ドキュメントに記載されており、コードブロックの中に書いた`@`は取り込みの対象になりません（出典：[Manage Claude's memory](https://code.claude.com/docs/en/memory)）。

```
# プロジェクトルール

@.claude/rules/coding-standards.md
@.claude/rules/api-guidelines.md
@.claude/rules/deployment.md
```

Claude Codeが`CLAUDE.md`を読み込む際に、参照されたファイルの内容がその位置に挿入されます。インポートの階層が深くなるほど、どのルールがどこから来たのかを追いにくくなります。取り込みはルートから1段までにとどめ、入れ子にしない運用をおすすめします。

### インポートの分割パターン

分割の切り口は、チームの体制とルールの更新頻度で選びます。

| パターン | 構成 | メリット |
| --- | --- | --- |
| 機能別分割 | coding.md / testing.md / deploy.md | 担当領域ごとに独立して更新可能 |
| レイヤー別分割 | frontend.md / backend.md / infra.md | 技術スタック別にルールを管理 |
| 重要度別分割 | critical.md / standard.md / nice-to-have.md | 守るべきルールと推奨ルールを明確に区別 |

重要度別分割を使う場合、ルートのCLAUDE.mdは次のような形になります。

```
# CLAUDE.md

## 最優先で守るルール
@.claude/rules/critical.md

## コーディング規約
@.claude/rules/coding-standards.md

## テスト規約
@.claude/rules/testing.md

## デプロイ手順
@.claude/rules/deployment.md
```

ただし、インポートしたファイルは結局すべて読み込まれます。読み込む量そのものを減らしたい場合は、次に紹介するpaths指定か、後述するスキルへの切り出しを使います。

### pathsフロントマターによるスコープ制御

`.claude/rules/`配下のMarkdownファイルには、`paths`フロントマターを指定することで、特定のファイルパスに対してのみルールを適用できます。pathsを書かないルールファイルは、条件なしでプロジェクト全体に読み込まれます（出典：[Manage Claude's memory](https://code.claude.com/docs/en/memory)）。

```
---
paths:
  - "src/components/**"
  - "src/app/**/page.tsx"
---

# フロントエンドコンポーネントルール

## コンポーネント命名
- PascalCase（例: UserProfile.tsx）
- ページコンポーネントは page.tsx 固定

## スタイリング
- Tailwind CSSのユーティリティクラスを使用
- カスタムCSSは components.css にまとめる
- !important 禁止
```

バックエンド側は、対象のディレクトリを変えて同じように書きます。

```
---
paths:
  - "supabase/functions/**"
  - "src/lib/api/**"
---

# バックエンドAPIルール

## Edge Functions
- レスポンスはJSON形式で統一
- エラーレスポンスは { error: string, code: number } 形式
- レートリミット: 設定ファイルから取得（ハードコード禁止）
```

### pathsの動作原理

Claude Codeがファイルを操作（読み取り・書き込み・分析）する際、そのファイルパスが`paths`の条件に一致する`.claude/rules/`ファイルのルールが適用されます。

```
ユーザー: 「src/components/Header.tsx を修正して」
Claude Codeの内部処理:
  1. CLAUDE.md（全体ルール）を読み込み
  2. src/components/** にマッチする rules/ をスキャン
  3. frontend.md のルールが追加適用
  4. 修正を実行
```

この仕組みにより、フロントエンド担当のルールがバックエンドのコードに誤って適用される——といった事故を防げます。globの書き方を誤ると、ルールがどのファイルにも当たらないまま気づかれずに残ります。paths付きのルールを追加したら、対象ディレクトリのファイルを1つ修正させ、そのルールに沿った出力になったかを見てからコミットする流れにしておくと、効いていないルールを早い段階で見つけられます。

## モノレポの階層設計パターン

複数のプロジェクトが1つのリポジトリに同居するモノレポでは、CLAUDE.mdの階層設計が特に重要になります。全体共通のルールと、アプリやチームごとのルールが混ざると、ある領域の作法が別の領域に漏れ出すためです。ここでは階層の組み方と、実際の設計例を紹介します。

### モノレポのCLAUDE.md階層

モノレポでは、ルートに全プロジェクト共通のルールを置き、各アプリ・パッケージのディレクトリにそれぞれのCLAUDE.mdを置きます。

```
monorepo/
  CLAUDE.md                 全プロジェクト共通ルール
  .claude/
    rules/
      git-workflow.md       Git運用ルール（全体共通）
      security.md           セキュリティルール（全体共通）
  apps/
    web/CLAUDE.md           Webアプリ固有ルール
    api/CLAUDE.md           APIサーバー固有ルール
    admin/CLAUDE.md         管理画面固有ルール
  packages/
    ui/CLAUDE.md            UIライブラリ固有ルール
    shared/CLAUDE.md        共有ユーティリティのルール
  marketing/
    blog/CLAUDE.md          ブログ制作ルール
    website/CLAUDE.md       Webサイト管理ルール
```

Git運用やセキュリティのように、どのアプリでも同じ基準で守るものはルートに寄せます。反対に、UIライブラリの命名規則やブログの文体ルールのように、その領域の外では意味を持たないものは各ディレクトリに閉じ込めます。

### 実例: Webサービスのモノレポでの設計

架空の例として、フロントエンド・バックエンド・ドキュメントを1つのリポジトリで管理するWebサービスを考えます。ルートのCLAUDE.md、サブディレクトリのCLAUDE.md、`.claude/rules/`のpaths指定ルールを、それぞれ次のように使い分けます。

```
webservice/
  CLAUDE.md                 全体共通（技術スタック・ディレクトリの地図・共通の禁止事項）
  .claude/
    rules/
      git-workflow.md       ブランチ運用・コミットの作法（paths指定なし・全体共通）
      security.md           秘密情報の扱い（paths指定なし・全体共通）
      testing.md            テスト規約（paths: **/*.test.ts, **/*.test.tsx）
  apps/
    web/CLAUDE.md           フロントエンド固有ルール
    api/CLAUDE.md           バックエンドAPI固有ルール
  docs/
    CLAUDE.md               ドキュメント固有ルール（文体・用語・図の置き場所）
```

ポイントは、「ディレクトリで区切れるもの」はサブディレクトリのCLAUDE.mdに、「ディレクトリをまたいでファイルの種類で決まるもの」は`.claude/rules/`のpaths指定に、「どこで作業しても守るもの」はルートに置いている点です。

**ルートCLAUDE.md**（全体共通）:

```
# Webサービス リポジトリ

## 技術スタック
- フロントエンド: Next.js / TypeScript
- バックエンド: Supabase Edge Functions
- ドキュメント: Markdown（docs/ 配下）

## 全体共通ルール
- TypeScript strict mode
- 秘密情報（APIキー・トークン）をコードやドキュメントに書かない
- 日本語のドキュメントは、です・ます調で統一

## ディレクトリマップ
- apps/web/ → ユーザー向けWebアプリ
- apps/api/ → APIサーバー
- docs/ → ヘルプ記事・API仕様書
- 詳細ルールは .claude/rules/ と各ディレクトリのCLAUDE.md を参照
```

**apps/web/CLAUDE.md**（フロントエンド固有）:

```
# フロントエンドルール

## コンポーネント
- 命名はPascalCase
- スタイルはTailwind CSSのユーティリティクラスで書く

## 確認手順
- 画面を変更したら、ローカルで表示を確認してから完了とする
```

**apps/api/CLAUDE.md**（バックエンド固有）:

```
# バックエンドAPIルール

## レスポンス形式
- JSON形式で統一
- エラーは { error: string, code: number } 形式で返す

## データベース
- マイグレーションは supabase/migrations/ に追加し、既存ファイルを書き換えない
```

**.claude/rules/testing.md**（ファイルの種類で適用）:

```
---
paths:
  - "**/*.test.ts"
  - "**/*.test.tsx"
---

# テスト規約

- 新規関数にはユニットテストを追加する
- テスト名は「何を入力したら何が返るか」が分かる日本語で書く
```

この構成では、Claude Codeが`apps/web/`配下のファイルを読み書きしたときにフロントエンドのルールが、`apps/api/`配下のときにバックエンドのルールが読み込まれます。サブディレクトリのCLAUDE.mdは起動時ではなく、そのディレクトリのファイルをClaudeが操作したタイミングで読み込まれる点が、ルートのCLAUDE.mdとの違いです（出典：[Manage Claude's memory](https://code.claude.com/docs/en/memory)の「How CLAUDE.md files load」）。`testing.md`は、どのディレクトリにあってもテストファイルを触るときに限って読み込まれます。

なお、これらのファイルはすべてコンテキストへ連結されるだけで、下位のファイルが上位のファイルを上書きするわけではありません。ルートとサブディレクトリで同じ項目に別の指示を書くと、どちらが従われるかは保証されません。サブディレクトリ側には、ルートと重ならないその領域固有の内容だけを書きます。Claude Codeを活用した[経営データの可視化](https://start-link.jp/service/claude-code/business-intelligence)や[コンテンツマーケティングの支援](https://start-link.jp/service/claude-code/content-marketing)についても、具体的な取り組みをご紹介しています。

### 階層設計で迷いやすいポイント

モノレポで迷いやすいのは、「複数のアプリで使うが全体共通ではない」ルールの置き場所です。判断は次の順で進めると整理できます。

1. そのルールがすべてのディレクトリで成り立つかを考え、成り立つならルートに置く
2. 成り立たない場合、対象がディレクトリで区切れるなら各ディレクトリのCLAUDE.mdに置く
3. 対象がディレクトリをまたいでファイルパターンで決まる（例: すべてのテストファイル）なら、`.claude/rules/`にpaths付きで置く

どの形が合うかは、リポジトリの切り方やチームの体制によって変わります。汎用的な型をそのまま当てはめるより、自社のディレクトリ構成と担当範囲に沿って階層を決めることが、結構ミソになってくると考えています。

## ユーザー設定とプロジェクト共有CLAUDE.mdの使い分け

CLAUDE.mdには、自分だけに効く個人設定と、チーム全員に効くプロジェクト設定があります。両者を混ぜると、個人の好みがチームのルールとしてGitに入り込んだり、逆にチームの約束事が一部の人の手元にしか無かったりします。ここでは、それぞれに何を書くかを整理します。

### スコープの違い

公式ドキュメントでは、CLAUDE.mdの置き場所を次の4つのスコープに分けています（出典：[Manage Claude's memory](https://code.claude.com/docs/en/memory)）。本記事では、個人で使う`~/.claude/CLAUDE.md`を「ユーザー設定」、リポジトリにコミットしてチームで使う`CLAUDE.md`を「プロジェクト共有」と呼びます。

| スコープ | 配置場所 | Git管理 | 対象 |
| --- | --- | --- | --- |
| マネージドポリシー（組織管理） | OSのシステム領域（macOSは`/Library/Application Support/ClaudeCode/CLAUDE.md`など） | IT・管理者が配布 | 組織全体 |
| ユーザー設定 | `~/.claude/CLAUDE.md` | しない | 自分だけ（全プロジェクト共通） |
| プロジェクト共有 | `./CLAUDE.md` または `./.claude/CLAUDE.md` | する | チーム全員に適用するルール |
| ローカル（個人用） | `./CLAUDE.local.md` | しない（`.gitignore`に追加） | 自分だけ（そのプロジェクトのみ） |

マネージドポリシーは組織の管理者が配布するもので、自分の手元で管理する個人設定とは別物です。個人の好みは、全プロジェクト共通なら`~/.claude/CLAUDE.md`、特定のプロジェクトでだけ使う個人メモ（検証用のURLやテストデータなど）なら`CLAUDE.local.md`に分けると整理できます。

### ユーザー設定（~/.claude/CLAUDE.md）に書く内容

ユーザー設定には、プロジェクトをまたいで変わらない自分の好みだけを書きます。

```
# 個人設定

## 応答スタイル
- 日本語で応答
- コードコメントも日本語
- 省略せず正式名称で記述

## エディタ設定
- インデント: スペース2つ
- 行末: LF
- エンコーディング: UTF-8

## 好みの設定
- テスト作成時はエッジケースを多めに
- エラーメッセージは具体的に（何が・どこで・なぜ失敗したか）
```

インデントや行末のように、プロジェクト側でフォーマッターが決めている項目と重なる場合は、個人設定側には書かず、プロジェクト側に合わせます。個人設定がプロジェクトの規約と食い違うと、どちらの指示が従われるか保証されず、その人のPRだけ差分が崩れるおそれがあるためです。

### プロジェクト共有CLAUDE.mdに書く内容

プロジェクト共有のCLAUDE.mdには、誰が作業しても同じ結果にそろえたい事柄を書きます。

```
# プロジェクト固有ルール

## アーキテクチャ（チーム共有）
- ディレクトリ構造と各フォルダの責務
- 使用ライブラリとバージョン
- APIの設計方針

## コーディング規約（チーム共有）
- 命名規則
- エラーハンドリング方針
- コメント規約

## 禁止事項（チーム共有）
- 破壊的変更の禁止ファイル
- 直接変更禁止のブランチ
```

書くべきかどうか迷ったら、「新しく入ったメンバーが知らないと事故になるか」で判断します。事故になるならプロジェクト共有のCLAUDE.mdに書き、好みの問題ならユーザー設定か`CLAUDE.local.md`に回します。

## CLAUDE.mdを育てる運用パターン

CLAUDE.mdは、書いて終わりの設定ファイルではありません。プロジェクトの成長とAIの振る舞いに合わせて、少しずつ育てていくものです。ここでは、段階的な拡張、ミスを起点にしたルール追加、コードレビューという3つの運用パターンを紹介します。

### パターン1: 段階的に育てる

CLAUDE.mdは最初から完璧に書く必要はありません。プロジェクトの成長に合わせて段階的に拡充していくのが現実的です。

| フェーズ | CLAUDE.md | 分割先 |
| --- | --- | --- |
| プロジェクト開始 | 技術スタックと基本ルール数個 | なし |
| チーム拡大 | ディレクトリ構造とコーディング規約を追加 | `.claude/rules/testing.md`にテスト規約を分離 |
| 本番運用 | 概要と地図のみに絞る | `.claude/rules/`に領域別ルール、`.claude/agents/`にレビュー・テスト作成・ドキュメント作成の役割 |

**Before**: プロジェクト開始時に長大なCLAUDE.mdを書こうとして挫折。

**After**: 短い内容からスタートし、「AIが間違えた箇所」を都度ルールとして追記。

CRMの項目設計で、使われない項目が大量に並ぶと入力する人の集中が削がれるのと同じで、CLAUDE.mdも使われないルールが増えるほど、効かせたいルールが埋もれます。最初は少なく始め、効いていることを確かめながら足していく順番をおすすめします。

### パターン2: ミスドリブンでルールを追加

CLAUDE.mdにルールを追加するタイミングとして効果が出やすいのは、「AIが間違えたとき」です。

```
【ミス発生】
Claude Codeがconsole.logをプロダクションコードに残した

【ルール追加】
.claude/rules/coding-standards.md に以下を追記:
- console.logをプロダクションコードに残さない（console.errorのみ許可）

【再発防止の検証】
同じ種類のタスクを再実行し、ルールが適用されるかを見る
```

この「ミス、ルール追加、検証」のサイクルを回すことで、CLAUDE.mdが実践的なナレッジベースとして成長していきます。ここで役割を分けておくと運用が安定します。どのミスをルールにするか、そのルールがビジネス上妥当かを決めるのは人間の役割です。一方で、ミスの原因の洗い出しや、ルール文面の叩き台づくりはClaude Codeに任せられます。

ただし、ルールを足しても同じミスが繰り返される場合は、書き方ではなく仕組みで止めることを検討します。例えば、どうしても通したくない操作は、CLAUDE.mdの文章に頼るのではなくHooksや権限設定で実行そのものを止めるほうが、担当者が変わっても同じ結果になります。

### パターン3: CLAUDE.mdのコードレビュー

CLAUDE.md自体もプロダクトコードと同様にコードレビューの対象とします。CLAUDE.mdをGit管理下に置き、変更はPR経由で行う流れにしておくと、ルールの変更履歴と理由がチーム全員から見えるようになります。

```
PR: 「CLAUDE.mdにAPI設計ガイドラインを追加」
レビュー観点:
- ルールが具体的か（「適切に」ではなく「try-catch で囲む」のように）
- 矛盾するルールがないか
- pathsのスコープが適切か
- 既存ルールとの重複がないか
```

この運用にしておくと、ルールが特定の人の頭の中ではなくリポジトリに残ります。新しく入ったメンバーも、CLAUDE.mdの履歴を追えば「なぜこのルールがあるのか」を自分で把握でき、担当者が交代しても同じ品質で開発を続けられます。

## Skills・Agent Teams時代のCLAUDE.md設計

Claude Codeには、CLAUDE.md以外にも「指示の置き場所」が増えています。何をCLAUDE.mdに残し、何を外に出すか。この線引きが、そのまま設計の品質になります。

本記事は2026年10月時点の情報です。

### 手順の置き場所は、スキル（SKILL.md）が現行の形

手順書の現行の形は、`SKILL.md`（frontmatterと本文）を置くスキルです。個人用は`~/.claude/skills/`、プロジェクト用は`.claude/skills/`に置きます。旧来の形の`.claude/commands/deploy.md`と、スキルの`.claude/skills/deploy/SKILL.md`は、どちらも`/deploy`を作り、同じように動きます。既存の`.claude/commands/`はそのまま動作し続けるので、急いで移行しなくても問題ありません。ただしスキル側には、補助ファイル用のディレクトリを持てること、frontmatterで呼び出し主体を制御できること、関連する場面でClaudeが自動的に読み込むこと、という3つの違いがあります（出典：[Skills](https://code.claude.com/docs/en/skills)）（出典：[Commands](https://code.claude.com/docs/en/commands)）。

これがCLAUDE.md設計に効いてきます。**特定の作業のときだけ使う長い手順は、CLAUDE.mdに常駐させるのではなくスキルへ出す**のが原則です。スキルの本文は使うときにだけ読み込まれるため、常時読み込まれるコンテキストが軽くなり、その手順を使わないセッションで無駄なトークンを払わずに済みます。`/code-review`や`/batch`、`/debug`のように、あらかじめ同梱されているスキルもあるので、自作する前に確認しておくと二度手間を避けられます。Claudeに勝手に起動されたくない手順は、frontmatterに`disable-model-invocation: true`を書けば、ユーザーの明示呼び出しだけに限定できます。

### 常時ロードと必要時ロードで置き場所を分ける

| 置き場所 | 読み込まれるタイミング | 向く内容 |
| --- | --- | --- |
| ルートCLAUDE.md | 常時 | どの作業でも守る禁止事項、技術スタック、ディレクトリの地図 |
| `.claude/rules/*.md`（paths指定） | 対象パスを触るとき | 領域ごとのコーディング規約・命名規則 |
| `.claude/skills/*/SKILL.md` | 関連する作業のとき、または`/名前`で呼んだとき | 手順書・チェックリスト・レシピ |
| auto memory（`/memory`） | セッションを跨いで参照するとき | 変化する状態・学習した結果 |

ルートCLAUDE.mdは「地図」、`.claude/rules/`は「地域ごとのルール」、スキルは「作業手順書」と考えると迷いません。前述のインポートによる分割は「1ファイルを読みやすく割る」ための道具、スキルへの切り出しは「そもそも読み込ませない」ための道具で、目的が異なります。長い手順がCLAUDE.mdやインポート先にあるなら、まずスキルへの移し替えを検討してください。

### サブエージェントにはモデルを明示的に固定する

サブエージェントには、Explore（読み取り専用）・Plan・general-purposeといった組み込みのものがあり、自作する場合は`.claude/agents/`に定義ファイルを置きます（`/agents`のウィザードは削除されたため、Claudeに依頼するか定義ファイルを直接編集します）。サブエージェントのモデルは、(1)呼び出し時に指定された`model`パラメータ、(2)定義ファイルのfrontmatterの`model`（`inherit`はメインのモデルを指します）、(3)環境変数`CLAUDE_CODE_SUBAGENT_MODEL`、(4)メインセッションのモデル、の順で決まります（出典：[Subagents](https://code.claude.com/docs/en/sub-agents)の「Choose a model」）。つまり、`model`を指定せず、呼び出し時の指定も環境変数も無い場合に限って、**親セッションのモデルをそのまま引き継ぎます**。現行の既定モデルはOpus 5.5なので、メインを上位モデルで動かしていると、実行役のサブエージェントまで同じ単価で回ることになり、コスト設計が静かに崩れます。CLAUDE.mdには「どの役割にどのモデルを充てるか」という方針を書き、エージェント定義側でも固定することをおすすめします。

```
## サブエージェント運用ルール

- 設計・レビュー・オーケストレーションはメインセッションで行う
- コーディング・ファイル操作・データ処理は原則サブエージェントに委任する
- 実行系サブエージェントは model を明示的に指定する（未指定で、呼び出し時の指定や環境変数も無い場合は親モデルを継承する）
```

エージェント定義ファイル側は、frontmatterで固定します。`model`には`sonnet`・`opus`・`haiku`・`fable`のエイリアス、モデルID、`inherit`を指定できます。

```
---
name: bulk-editor
description: 大量のファイル編集を担当する
model: sonnet
isolation: worktree
---
```

`isolation: worktree`を書くと、そのサブエージェントは常に専用のgit worktreeで動きます。変更なしで終了したworktreeは自動的に削除されるため、ファイルを大量に触る役割ほどこの1行の価値が高くなります。なお、auto mode（分類器に許可判断を任せるモード）で動かしている場合、frontmatterの`permissionMode`は無視されます。権限をfrontmatterで緩める前提の設計にはしないでください（出典：[Subagents](https://code.claude.com/docs/en/sub-agents)）（出典：[Worktrees](https://code.claude.com/docs/en/worktrees)）。

条件を満たすまで自律的に作業を続けさせる`/goal`を併用する場合は、CLAUDE.mdに**検証コマンドを明記しておく**と効果が上がります。`/goal`の判定役は会話に出ている内容だけで成否を判断するため、「`npm test`の結果を出力してから完了と宣言する」といった手順がルール化されているほど、条件成立を正しく判定できます。詳しくは[/goalコマンドで条件達成まで自律実行させる方法](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-goal-command)で解説しています。

次の画面は、この節で触れたスラッシュコマンド`/deploy`・`/goal`と、検証に使うコマンド`npm test`をターミナルに並べたものです。先頭の行は`$ claude --version`という実行コマンドで、次の行に`2.1.263 (Claude Code)`というバージョン表示があります。`/deploy`・`/goal`・`npm test`の実行結果は表示していません。

![ターミナル画面。先頭に claude --version コマンドとバージョン出力、下に /deploy・/goal・npm test のコマンドを並べた例](https://start-link.jp/hubfs/blog/screenshots/library/cc_DD-14_1.png)

### Agent Teamsを前提にした書き方

Agent Teamsは、2026年10月時点でexperimentalの機能で、既定では無効です。有効にすると、複数のteammateがそれぞれ独立したコンテキストウィンドウで動きます。teammateも同じCLAUDE.mdを読むため、「誰が読んでも同じ判断になる書き方」の重要度が一段上がります。実務上は次の3点がポイントになってきます。

- 主語を「あなた」ではなく役割で書く（「実装担当は〜」「レビュー担当は〜」）
- ファイル所有権をルールとして明記する（同じファイルを2人が編集すると上書きが起きる）
- 「確認を取ってから進める」ルールは、確認先まで書く（リードなのか、人間なのか）

v2.1.178で`TeamCreate`/`TeamDelete`ツールは削除され、`team_name`の指定も受理はされますが無視されるようになりました。古いCLAUDE.mdに「まずチームを作成して名前を付ける」という手順を書いている場合、その記述はもう不要です。有効化に使う設定は`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`の1つだけです（出典：[Agent teams](https://code.claude.com/docs/en/agent-teams)）。

Agent Teamsそのものの設定と運用は[Claude Codeで複数AIエージェントを並列実行する方法](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-parallel-agents)で扱っています。

## 関連する仕組みとの組み合わせ

CLAUDE.mdは単独で完結する仕組みではなく、カスタムコマンド、Hooks、メモリと組み合わせて力を発揮します。それぞれの役割を分けておくと、「どこに書くか」で迷う時間が減ります。ここでは3つの仕組みとの分担を整理します。

### スキル・カスタムコマンドとの関係

スキル（`.claude/skills/`）はCLAUDE.mdを補完する仕組みです。CLAUDE.mdが「常に適用されるルール」なら、スキルは「特定のタスクを実行するときのレシピ」です。CLAUDE.mdでプロジェクトの大方針を定め、スキルで具体的な作業手順を定義する、という分担が効果的です。旧来の形である[カスタムコマンド](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-custom-commands)（`.claude/commands/`）も引き続き使えますが、前述の通りスキルと同じ`/名前`で呼べるため、新しく作る手順はスキルとして置くのが現行の形です。

### Hooksとの連携

[Claude Code Hooks](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-hooks-automation)は`.claude/settings.json`で定義しますが、CLAUDE.mdにフックの概要と目的を記載しておくと、AIエージェントがフックの存在を認識したうえで作業を進められます。CLAUDE.mdは「こうしてほしい」というお願い、Hooksは「この操作の前後で処理を走らせる」という仕組みです。守られないと困るルールほど、文章ではなくHooks側で担保する設計に寄せることをおすすめします。フックのイベントはセッション開始、ツール実行の前後、停止時など多数あり、種別も`command`・`http`・`prompt`・`agent`（実験的）・`mcp_tool`から選べます。commandフックは、終了コード2を返すと処理をブロックできるイベントがあります。ブロックできるかどうかはイベントごとに決まっており、たとえば`PreToolUse`ではツール呼び出しを止められますが、`PostToolUse`はツールがすでに実行された後のため取り消せず、stderrがClaudeに渡されるだけです（出典：[Hooks reference](https://code.claude.com/docs/en/hooks)の「Exit code 2 behavior per event」）。

### メモリ・コンテキストとの関係

CLAUDE.mdは「プロジェクトのルール」を定義し、[メモリ・コンテキスト](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-memory-context)は「セッションをまたいだ記憶」を保持します。Claude Codeには、学習した内容を自動で保存するauto memoryがあり、`/memory`から確認できます。CLAUDE.mdに書くのは人が決めた「変わらないルール」、auto memoryに記録されるのは「変化する状態や学習結果」です。進行中のタスクの状況や一時的な決定事項をCLAUDE.mdに書き足していくと、ルールと状態が混ざり、古い情報がいつまでも読み込まれ続けます。

## よくある質問

### Q1. CLAUDE.mdが長くなりすぎると、Claude Codeの性能に影響しますか？

CLAUDE.mdの内容はセッション開始時にコンテキストウィンドウに読み込まれるため、長くなるほどトークンを消費し、効かせたいルールも埋もれやすくなります。インポートで取り込んだファイルも読み込まれる点は変わりません。長くなってきたら、特定の領域にだけ効くルールをpaths付きの`.claude/rules/`に、特定の作業のときだけ使う手順をスキルに移し、常時読み込まれる量を減らしてください。

### Q2. CLAUDE.mdとREADME.mdの違いは何ですか？

README.mdは人間の開発者向けのドキュメントで、セットアップ手順や使い方を記載します。CLAUDE.mdはAIエージェント向けの設定ファイルで、コーディング規約や禁止事項を記載します。両者は目的が異なるため、どちらか一方に統合するのではなく、それぞれ独立して管理するのが適切です。

### Q3. .claude/rules/ のファイルに命名規則はありますか？

技術的な制約はありませんが、ファイル名から内容が推測できる命名をおすすめします。`frontend.md`、`backend.md`、`testing.md`、`security.md`のように、ルールの対象領域をファイル名にするのが一般的です。番号プレフィックス（`01-critical.md`、`02-standards.md`）を使って重要度の目安をファイル名で示すパターンもあります（読み込み順や優先順位が変わるわけではありません）。

### Q4. チームでCLAUDE.mdを共同編集する際のベストプラクティスは？

CLAUDE.mdをGit管理下に置き、変更はPR経由で行うことをおすすめします。CLAUDE.mdの変更は「プロジェクトのルール変更」に等しいため、チームメンバー全員がレビューできるフローにしておくと、変更の理由が履歴として残ります。特に禁止事項やセキュリティルールの変更は、テックリードの承認を経る運用にしておくと安全です。

## まとめ

CLAUDE.mdの設計は、プロジェクト規模に応じて段階的に進化させるのが現実的なアプローチです。小規模プロジェクトではルートに1ファイル、中規模では`.claude/rules/`による分割とpathsスコープ制御、大規模モノレポではディレクトリごとのCLAUDE.md階層を組み合わせます。そのうえで、特定の作業のときだけ使う長い手順はスキルへ切り出し、常に読み込まれる量を小さく保ちます。

ユーザー設定（`~/.claude/CLAUDE.md`）とプロジェクト共有のCLAUDE.md、さらに個人用の`CLAUDE.local.md`を使い分け、ミスが発生するたびにルールを追加する「ミスドリブン」の運用を回すと、CLAUDE.mdは特定の人に依存しないチームのナレッジとして育っていきます。

まずは、今あるCLAUDE.mdを「常に効かせたいルール」と「特定の場面でだけ効けばよいルール」に仕分けることから始めてみてください。

1. 現在のCLAUDE.mdの各ルールに、効かせたい範囲（全体・特定ディレクトリ・特定ファイル・特定作業）をメモする
2. 特定の範囲にだけ効くルールを1つ選び、paths付きの`.claude/rules/`またはスキルに移す
3. 次にClaude Codeが間違えたときに、そのミスをルールとして追記し、PRでチームに共有する

Claude Codeの全コマンド一覧は[Claude Codeチートシート](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-cheatsheet)をご覧ください。AI活用の全体像は[AI活用完全ガイド](https://start-link.jp/hubspot-ai/ai)で解説しています。

CRMを活用した業務効率化やAIとの連携に関するご相談は、StartLinkまでお気軽にお問い合わせください。

## あわせて読みたい

- [Claude Code × Stitchでワイヤーフレーム・UIデザインを自動生成する方法](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-stitch-design)
- [Claude Code × Chrome DevTools連携｜WebアプリのライブデバッグをAIで効率化する](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-chrome-devtools)
- [Claude Code MCP連携の始め方｜HubSpot・freee・Slackを接続する設定手順【2026年版】](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-mcp-integration)

記事の内容を、そのまま実務に落とし込みたい方向け

HubSpotゴールドパートナーのStartLinkが、HubSpot導入・AI活用・CRM整備・業務効率化までをまとめて支援しています。記事で気になったテーマを、そのまま相談ベースで整理できます。

[サービス概要を見る](https://start-link.jp/service/hubspot-ai) [無料で相談する](https://start-link.jp/contact)

## 次に読む

### [![](https://start-link.jp/hubfs/blog/screenshots/generated/gen_DD-61_fast_mode_model_support.png) Claude Codeのfast mode（/fast）｜対応モデル・料金・使いどころの判断基準](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-fast-mode)

### [![](https://start-link.jp/hubfs/blog/screenshots/generated/gen_DD-60_agent_view_session_states.png) Claude Code agent viewの使い方｜全セッションを1画面で管理](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-agent-view)

### [![](https://start-link.jp/hubfs/blog/screenshots/generated/gen_DD-58_goal_evaluation_loop.png) Claude Codeの/goalコマンド｜完了条件でAIを自律実行させる方法](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-goal-command)

## あわせて読みたいAI実践ガイド

### [Setup Claude Coworkの使い方と初期設定 導入直後にやるべき設定、CLAUDE.md、スキル設計、運用の型をまとめています。](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-cowork-setup-guide)

### [Team Claude Codeでチーム開発を効率化する方法 レビュー、権限管理、共有ルールまで踏み込んだ実践的なチーム利用ガイドです。](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-team-development)

### [MCP Claude Code × MCP連携ガイド 社内システムとつなぎ、実業務でAIエージェントを動かす方法を整理しています。](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-mcp-integration)

### [Service HubSpot × AIの支援サービス 導入設計から内製化、ワークフロー自動化までの支援内容を確認できます。](https://start-link.jp/service/hubspot-ai)

## 記事の内容を、そのまま実務に落とし込みたい方向け

[無料で相談する](https://start-link.jp/contact) [資料をダウンロード](https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-claudemd-patterns#blog-download)

 株式会社StartLinkは、事業推進に関わる「販売促進」「DXによる業務効率化（ERP/CRM/SFA/MAの導入）」などのご相談を受け付けております。 サービスのプランについてのご相談/お見積もり依頼や、ノウハウのお問い合わせについては、[無料のお問い合わせページ](https://www.start-link.jp/contact)より、お気軽にご連絡くださいませ。

###### 関連キーワード:

[AI](https://start-link.jp/hubspot-ai/tag/ai) [生成AI](https://start-link.jp/hubspot-ai/tag/生成ai)

## サービス資料を無料DL

## 著者情報

![7-1](https://start-link.jp/hubfs/7-1.jpg)

### 今枝 / Imaeda

 株式会社StartLink 代表取締役。累計150社以上のHubSpotプロジェクト支援実績を持ち、Claude CodeやHubSpotを軸にしたAI活用支援・経営基盤AXのコンサルティング事業を展開。  
 HubSpotのトップパートナー企業や大手人材グループにて、エンタープライズCRM戦略策定・AI戦略ディレクションを経験した後、StartLinkを創業。現在はCRM×AIエージェントによる経営管理支援を専門とする。

[StartLink](https://start-link.jp/)

### Service

- [会社情報](https://start-link.jp/about)
- [サービス](https://start-link.jp/service)
- [プロダクト](https://start-link.jp/sync)
- [採用情報](https://start-link.jp/recruit)
- [コンサルタントの方へ](https://start-link.jp/consultant-platform)

### Contact

- [問い合わせ](https://start-link.jp/contact)
- [資料ダウンロード](https://start-link.jp/download/service)
- [Syncナレッジベース](https://start-link.jp/sync/knowledge-base)
- [個人情報保護方針](https://start-link.jp/privacy-policy)
- [個人情報取り扱い規定](https://start-link.jp/personal-information-processing-agreement)

(c) 2026 All Rights Reserved.

```json
{
  "@context" : "https://schema.org",
  "@type" : "BlogPosting",
  "author" : {
    "@type" : "Person",
    "name" : "今枝 拓海",
    "url" : "https://start-link.jp/hubspot-ai/author/imaeda"
  },
  "datePublished" : "2026-03-17T12:51:44.000Z",
  "headline" : "CLAUDE.mdの書き方と設計パターン｜規模別の分割・階層設計とチーム運用",
  "image" : [ "https://start-link.jp/hubfs/blog/screenshots/generated/kv_claude-code-claudemd-patterns.jpg" ],
  "mainEntityOfPage" : {
    "@id" : "https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-claudemd-patterns",
    "@type" : "WebPage"
  },
  "publisher" : {
    "@type" : "Organization",
    "logo" : {
      "@type" : "ImageObject",
      "url" : "https://start-link.jp/hubfs/Start%20Link%20(1500%20x%20600%20px)%20(5)-1.png"
    },
    "name" : "株式会社StartLink"
  }
}
```

```json
{
  "@context" : "https://schema.org",
  "@type" : "FAQPage",
  "mainEntity" : [ {
    "@type" : "Question",
    "acceptedAnswer" : {
      "@type" : "Answer",
      "text" : "CLAUDE.mdの内容はセッション開始時にコンテキストウィンドウに読み込まれるため、長くなるほどトークンを消費し、効かせたいルールも埋もれやすくなります。インポートで取り込んだファイルも読み込まれる点は変わりません。長くなってきたら、特定の領域にだけ効くルールをpaths付きの.claude/rules/に、特定の作業のときだけ使う手順をスキルに移し、常時読み込まれる量を減らしてください。"
    },
    "name" : "CLAUDE.mdが長くなりすぎると、Claude Codeの性能に影響しますか？"
  }, {
    "@type" : "Question",
    "acceptedAnswer" : {
      "@type" : "Answer",
      "text" : "README.mdは人間の開発者向けのドキュメントで、セットアップ手順や使い方を記載します。CLAUDE.mdはAIエージェント向けの設定ファイルで、コーディング規約や禁止事項を記載します。両者は目的が異なるため、どちらか一方に統合するのではなく、それぞれ独立して管理するのが適切です。"
    },
    "name" : "CLAUDE.mdとREADME.mdの違いは何ですか？"
  }, {
    "@type" : "Question",
    "acceptedAnswer" : {
      "@type" : "Answer",
      "text" : "技術的な制約はありませんが、ファイル名から内容が推測できる命名をおすすめします。frontend.md、backend.md、testing.md、security.mdのように、ルールの対象領域をファイル名にするのが一般的です。番号プレフィックス（01-critical.md、02-standards.md）を使って重要度の目安をファイル名で示すパターンもあります（読み込み順や優先順位が変わるわけではありません）。"
    },
    "name" : ".claude/rules/ のファイルに命名規則はありますか？"
  }, {
    "@type" : "Question",
    "acceptedAnswer" : {
      "@type" : "Answer",
      "text" : "CLAUDE.mdをGit管理下に置き、変更はPR経由で行うことをおすすめします。CLAUDE.mdの変更は「プロジェクトのルール変更」に等しいため、チームメンバー全員がレビューできるフローにしておくと、変更の理由が履歴として残ります。特に禁止事項やセキュリティルールの変更は、テックリードの承認を経る運用にしておくと安全です。"
    },
    "name" : "チームでCLAUDE.mdを共同編集する際のベストプラクティスは？"
  } ]
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-claudemd-patterns#article",
  "@type" : "BlogPosting",
  "author" : {
    "@id" : "https://start-link.jp/#founder"
  },
  "dateModified" : "2026-10-24T03:36:45+09:00",
  "datePublished" : "2026-03-17T12:51:44+09:00",
  "headline" : "CLAUDE.mdの書き方と設計パターン｜規模別の分割・階層設計とチーム運用",
  "image" : "https://start-link.jp/hubfs/blog/screenshots/generated/kv_claude-code-claudemd-patterns.jpg",
  "isPartOf" : {
    "@id" : "https://start-link.jp/#website"
  },
  "mainEntityOfPage" : {
    "@id" : "https://start-link.jp/hubspot-ai/ai/claude-code-practice/claude-code-claudemd-patterns",
    "@type" : "WebPage"
  },
  "publisher" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "speakable" : {
    "@type" : "SpeakableSpecification",
    "cssSelector" : [ ".blog-section h2", ".blog-section p:first-of-type", ".blog-section blockquote" ]
  }
}
```

```json
{
  "@context" : "https://schema.org",
  "@type" : "BreadcrumbList",
  "itemListElement" : [ {
    "@type" : "ListItem",
    "item" : "https://start-link.jp",
    "name" : "ホーム",
    "position" : 1
  }, {
    "@type" : "ListItem",
    "item" : "https://start-link.jp/hubspot-ai",
    "name" : "ブログ",
    "position" : 2
  }, {
    "@type" : "ListItem",
    "item" : "https://start-link.jp/hubspot-ai/ai",
    "name" : "AI活用",
    "position" : 3
  }, {
    "@type" : "ListItem",
    "item" : "https://start-link.jp/hubspot-ai/ai/claude-code-practice",
    "name" : "Claude Code実践",
    "position" : 4
  }, {
    "@type" : "ListItem",
    "name" : "CLAUDE.mdの書き方と設計パターン｜規模別の分割・階層設計とチーム運用",
    "position" : 5
  } ]
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#organization",
  "@type" : "Organization",
  "address" : {
    "@type" : "PostalAddress",
    "addressCountry" : "JP",
    "addressLocality" : "中央区",
    "addressRegion" : "東京都",
    "postalCode" : "104-0061",
    "streetAddress" : "銀座1丁目12番4号 N&E BLD.6F"
  },
  "alternateName" : "StartLink Inc.",
  "award" : [ "HubSpot Gold Solutions Partner（HubSpotゴールドパートナー、2026年4月認定）" ],
  "contactPoint" : [ {
    "@type" : "ContactPoint",
    "availableLanguage" : [ "ja" ],
    "contactType" : "customer support",
    "url" : "https://start-link.jp/contact"
  }, {
    "@type" : "ContactPoint",
    "availableLanguage" : [ "ja", "en" ],
    "contactType" : "sales",
    "url" : "https://start-link.jp/contact"
  } ],
  "description" : "「AI × HubSpot」をコンセプトに掲げるHubSpotゴールドパートナー（Gold Solutions Partner、2026年4月認定）。HubSpotマーケットプレイスに自社アプリ（Sync for freee / Notion / Money Forward / Chatwork）を公開するアプリ開発企業であり、HubSpot/Salesforce知見とAI活用を組み合わせたCRM構築・移行・最適化・AIエージェント/PoC支援まで一貫して提供する。",
  "founder" : {
    "@id" : "https://start-link.jp/#founder",
    "@type" : "Person",
    "jobTitle" : "代表取締役",
    "name" : "今枝 拓海",
    "sameAs" : [ "https://x.com/ImaedaTakumii", "https://www.linkedin.com/in/takumi-imaeda/", "https://www.facebook.com/takumiIma" ]
  },
  "foundingDate" : "2024-09-04",
  "hasCredential" : {
    "@type" : "EducationalOccupationalCredential",
    "credentialCategory" : "certification",
    "name" : "HubSpot Gold Solutions Partner",
    "recognizedBy" : {
      "@type" : "Organization",
      "name" : "HubSpot, Inc.",
      "url" : "https://www.hubspot.com/"
    }
  },
  "image" : [ "https://start-link.jp/hubfs/startlink-ai-agent.jpg", "https://start-link.jp/hubfs/startlink-aiorg.jpg" ],
  "knowsAbout" : [ "HubSpot CRM", "HubSpot Implementation", "HubSpot導入支援", "CRM構築", "AI活用", "HubSpot連携アプリ開発", "Salesforce to HubSpot Migration", "Generative AI Integration", "AI Agent Development", "Revenue Operations", "Marketing Automation", "freee Integration", "Notion Integration", "Money Forward Integration" ],
  "legalName" : "株式会社StartLink",
  "logo" : "https://start-link.jp/hubfs/startlink-logo.png",
  "mainEntityOfPage" : "https://start-link.jp/",
  "memberOf" : {
    "@type" : "ProgramMembership",
    "hostingOrganization" : {
      "@type" : "Organization",
      "name" : "HubSpot, Inc.",
      "url" : "https://www.hubspot.com/"
    },
    "membershipNumber" : "Gold Tier",
    "programName" : "HubSpot Solutions Partner Program"
  },
  "name" : "株式会社StartLink",
  "sameAs" : [ "https://www.youtube.com/@startlink-hubspot", "https://x.com/ImaedaTakumii", "https://www.linkedin.com/in/takumi-imaeda/", "https://www.linkedin.com/company/108100307/", "https://www.facebook.com/takumiIma", "https://www.facebook.com/profile.php?id=61566874764985", "https://prtimes.jp/main/html/searchrlp/company_id/149669", "https://app.hubspot.com/ecosystem/46046172/marketplace/solutions/startlink" ],
  "taxID" : "8010001248134",
  "url" : "https://start-link.jp/"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#website",
  "@type" : "WebSite",
  "inLanguage" : "ja",
  "name" : "株式会社StartLink",
  "publisher" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "url" : "https://start-link.jp/"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#service-hubspot",
  "@type" : "Service",
  "areaServed" : "JP",
  "category" : [ "CRM導入", "HubSpot" ],
  "description" : "150社以上の実績を持つHubSpotゴールドパートナーが、業務フローに合わせた設計から構築・本番稼働まで一貫支援。",
  "name" : "HubSpot導入・構築支援",
  "provider" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "serviceType" : "HubSpot導入・構築支援",
  "url" : "https://start-link.jp/service/hubspot"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#service-hubspot-ai",
  "@type" : "Service",
  "areaServed" : "JP",
  "category" : [ "CRM最適化", "AI活用" ],
  "description" : "HubSpotを軸に業務要件に沿った設計改善とAI連携活用を包括支援。",
  "name" : "HubSpot AIコンサルティング",
  "provider" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "serviceType" : "HubSpot AIコンサルティング",
  "url" : "https://start-link.jp/service/hubspot-ai"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#service-hubspot-training",
  "@type" : "Service",
  "areaServed" : "JP",
  "category" : [ "研修", "HubSpot" ],
  "description" : "HubSpotの概念・基本操作からAI活用ノウハウまで、社内浸透のための研修を提供。",
  "name" : "HubSpot研修・レクチャー支援",
  "provider" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "serviceType" : "HubSpot研修・内製化支援",
  "url" : "https://start-link.jp/service/hubspot-ai/training"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#service-sf2hs-replace",
  "@type" : "Service",
  "areaServed" : "JP",
  "category" : [ "CRM移行", "データ移行" ],
  "description" : "Salesforce/HubSpot双方の思想とデータモデルを理解した移行設計とHubSpot側CRM開発を実行。",
  "name" : "SalesforceからHubSpotへのリプレイス支援",
  "provider" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "serviceType" : "SalesforceからHubSpotへのリプレイス支援",
  "url" : "https://start-link.jp/service/salesforce-hubspot-replace"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#service-claude-code-bi",
  "@type" : "Service",
  "areaServed" : "JP",
  "category" : [ "AI活用", "経営管理" ],
  "description" : "複数システムのデータを統合し、毎朝のAIブリーフィングなど経営の意思決定を加速する仕組みを構築。",
  "name" : "Claude Codeによる経営データ活用支援",
  "provider" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "serviceType" : "AI経営管理支援",
  "url" : "https://start-link.jp/service/claude-code/business-intelligence"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#service-claude-code-content",
  "@type" : "Service",
  "areaServed" : "JP",
  "category" : [ "コンテンツマーケティング", "AI活用" ],
  "description" : "キーワード戦略からSEO記事制作、CMS公開まで、AIを活用したコンテンツマーケティングを自動化。",
  "name" : "Claude Codeによるコンテンツマーケティング支援",
  "provider" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "serviceType" : "AIコンテンツ制作支援",
  "url" : "https://start-link.jp/service/claude-code/content-marketing"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#product-sync-freee",
  "@type" : "SoftwareApplication",
  "applicationCategory" : "BusinessApplication",
  "author" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "description" : "HubSpotとfreee会計・freee請求書をシームレスに連携。取引先の同期から請求書作成まで、バックオフィスの業務を自動化するHubSpotマーケットプレイスアプリ。",
  "featureList" : [ "freee取引先をHubSpotに自動同期", "HubSpotからfreee見積書・請求書を作成", "取引データをfreee会計に自動登録", "月次請求・更新処理に対応", "商品項目・品目・部門・タグ情報の連携" ],
  "installUrl" : "https://ecosystem.hubspot.com/marketplace/apps/sync-for-freee-bystartlink",
  "name" : "Sync for freee",
  "offers" : [ {
    "@type" : "Offer",
    "description" : "請求月5件・見積月20件まで",
    "name" : "Free",
    "price" : "0",
    "priceCurrency" : "JPY"
  }, {
    "@type" : "Offer",
    "billingIncrement" : "P1M",
    "description" : "請求月50件・見積月100件まで",
    "name" : "Professional",
    "price" : "4000",
    "priceCurrency" : "JPY"
  }, {
    "@type" : "Offer",
    "billingIncrement" : "P1M",
    "description" : "無制限",
    "name" : "Enterprise",
    "price" : "10000",
    "priceCurrency" : "JPY"
  } ],
  "operatingSystem" : "Web",
  "softwareHelp" : {
    "@type" : "WebPage",
    "url" : "https://start-link.jp/sync/knowledge-base/freee/basic-steps"
  },
  "url" : "https://start-link.jp/sync/freee"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#product-sync-notion",
  "@type" : "SoftwareApplication",
  "applicationCategory" : "BusinessApplication",
  "author" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "description" : "HubSpotのCRMレコードとNotionのページ・データベースを接続。HubSpotの画面から離れずにNotionのすべてにアクセスできるHubSpotマーケットプレイスアプリ。",
  "featureList" : [ "CRMカードからNotionページの作成・閲覧・編集", "NotionデータベースをCRMタブにテーブル表示", "4つのワークフローアクションで自動化", "コンタクト・会社・取引・チケット・サービス・プロジェクト対応" ],
  "installUrl" : "https://ecosystem.hubspot.com/marketplace/listing/sync-for-notion-bystartlink",
  "name" : "Sync for Notion",
  "offers" : [ {
    "@type" : "Offer",
    "description" : "ページ・DB合計50件まで",
    "name" : "Free",
    "price" : "0",
    "priceCurrency" : "JPY"
  }, {
    "@type" : "Offer",
    "billingIncrement" : "P1M",
    "description" : "無制限",
    "name" : "Professional",
    "price" : "10000",
    "priceCurrency" : "JPY"
  } ],
  "operatingSystem" : "Web",
  "url" : "https://start-link.jp/sync/notion"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#product-sync-moneyforward",
  "@type" : "SoftwareApplication",
  "applicationCategory" : "BusinessApplication",
  "author" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "description" : "HubSpotとマネーフォワード クラウドを連携。取引情報から見積書・請求書を自動作成し、取引先・品目の同期や継続請求に対応するHubSpot連携アプリ。",
  "featureList" : [ "取引（Deal）から見積書・請求書を自動作成", "会社情報とマネーフォワード取引先の同期", "商品項目・品目マスタの連携", "月次・固定回数の継続請求に対応（Professionalプラン以上）", "合算請求（Enterpriseプラン限定）", "前受請求（一括請求・月次計上）（Enterpriseプラン限定）", "原価登録（MF会計への仕訳登録）で案件別の原価・粗利を可視化（Enterpriseプラン限定）", "取引レコードにCRMカードで連携ステータスを表示" ],
  "installUrl" : "https://ecosystem.hubspot.com/ja/marketplace/listing/sync-for-moneyforward-bystartlink",
  "name" : "Sync for Money Forward",
  "offers" : [ {
    "@type" : "Offer",
    "description" : "請求月5件・見積月20件まで",
    "name" : "Free",
    "price" : "0",
    "priceCurrency" : "JPY"
  }, {
    "@type" : "Offer",
    "billingIncrement" : "P1M",
    "description" : "請求月50件・見積月100件まで",
    "name" : "Professional",
    "price" : "4000",
    "priceCurrency" : "JPY"
  }, {
    "@type" : "Offer",
    "billingIncrement" : "P1M",
    "description" : "無制限",
    "name" : "Enterprise",
    "price" : "10000",
    "priceCurrency" : "JPY"
  } ],
  "operatingSystem" : "Web",
  "url" : "https://start-link.jp/sync/moneyforward"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://start-link.jp/#product-sync-chatwork",
  "@type" : "SoftwareApplication",
  "applicationCategory" : "BusinessApplication",
  "author" : {
    "@id" : "https://start-link.jp/#organization"
  },
  "description" : "HubSpotとChatworkを連携。ワークフローからChatworkのルームへ通知を送り、CRMカード上で最新のやり取りの確認と返信ができ、紐付けたルームの新着メッセージをHubSpotのノートとして自動で記録するHubSpot連携アプリ。",
  "featureList" : [ "ワークフローアクション「Chatworkに通知」（取引・会社・コンタクト・チケット対応）", "送信先ルームIDとメッセージ本文にHubSpotのプロパティを差し込み", "取引・会社・コンタクトとChatworkルームの紐付け（全プラン無制限）", "CRMカードにルームの最新100件のメッセージを表示（Professionalプラン以上）", "CRMカードからChatworkへメッセージを送信（Professionalプラン以上）", "紐付けたルームの新着メッセージをHubSpotのノートへ自動記録（Enterpriseプラン限定）", "引用や装飾を、HubSpotのノートでも読みやすい見た目のまま記録", "OAuth接続とAPIトークン接続（SAML/SSO環境向け）に対応" ],
  "installUrl" : "https://ecosystem.hubspot.com/marketplace/listing/sync-for-chatwork-bystartlink",
  "name" : "Sync for Chatwork",
  "offers" : [ {
    "@type" : "Offer",
    "description" : "通知 月10件まで・ルーム紐付け無制限",
    "name" : "Free",
    "price" : "0",
    "priceCurrency" : "JPY"
  }, {
    "@type" : "Offer",
    "billingIncrement" : "P1M",
    "description" : "通知無制限・CRMカードで最新100件の表示とメッセージ送信",
    "name" : "Professional",
    "price" : "3000",
    "priceCurrency" : "JPY"
  }, {
    "@type" : "Offer",
    "billingIncrement" : "P1M",
    "description" : "Professionalの全機能＋メッセージ同期（30分ごと）",
    "name" : "Enterprise",
    "price" : "10000",
    "priceCurrency" : "JPY"
  } ],
  "operatingSystem" : "Web",
  "url" : "https://start-link.jp/sync/chatwork"
}
```