CLAUDE.mdの書き方完全ガイド｜Claude Codeを自分専用AIに変える設定術

「Claude Codeを使ってみたけど、なんか普通のAIと変わらない気がする…」

そう感じているなら、CLAUDE.mdを書いていないことが原因かもしれません。

Claude Codeはフォルダを開いて起動しただけでは、素のAIと大差ありません。
でもCLAUDE.mdというファイルを1つ書くだけで、状況は一変します。

AIが：

本記事では、CLAUDE.mdの基本構成・書き方・実例を完全解説します。
Claude Codeを使い始めた初心者から、マルチエージェント構成を組みたい上級者まで、すべて網羅した保存版ガイドです。

CLAUDE.mdは、Claude Codeが起動時に自動的に読み込むマークダウン形式の設定ファイルです。

Claude Codeはプロジェクトのルートディレクトリに CLAUDE.md が存在する場合、最初に読み込みます。
つまり、このファイルに書いた内容がAIへの「最初の指示」かつ「常時有効な設定」になるわけです。

一言で言えば、CLAUDE.mdはAIを「汎用ツール」から「自分専用アシスタント」に変えるファイルです。

Gitで管理するプロジェクトにCLAUDE.mdをコミットしておけば、チーム全員が同じ設定でClaude Codeを使えるという利点もあります。

①　役割固定の力（ペルソナ設定）

CLAUDE.mdでAIの役割・ペルソナ・行動指針を定義することで、Claude Codeは会話の最初から適切なモードで動き始めます。

「あなたは経験10年のシニアエンジニアです」と書けば、技術的な質問に専門家として答えてくれます。
「あなたはマーケティング部長です」と書けば、施策の提案を部長視点で考えてくれます。

さらに重要なのが禁止事項の定義です。
「絶対にしてはいけないこと」をCLAUDE.mdに明記することで、AIが勝手にファイルを削除したり、意図しない処理をするリスクを大幅に下げられます。

②　記憶の力（コンテキスト共有）

Claude Codeは会話ごとにリセットされますが、CLAUDE.mdに書いた内容は常に読み込まれます。

プロジェクトの背景・過去の決定事項・禁止事項などを書いておけば、毎回説明しなくても伝わります。
例えば「このプロジェクトはWordPressとNotionを連携させているが、Notion経由のWP投稿は品質が落ちるため禁止」と書けば、AIは自動的にその制約を守って動きます。

③　スキル展開の力（/コマンド定義）

CLAUDE.mdには「利用可能なスキル」として/コマンド形式のショートカットを定義できます。

よく使う作業を/コマンドで定義しておく例：

これにより、長い指示を毎回書く必要がなくなり、ワンコマンドで複雑な作業を開始できます。

CLAUDE.mdの構成に決まったフォーマットはありませんが、以下の7セクションを入れると効果的です。

# [エージェント名 / プロジェクト名]

## 役割定義
あなたは〇〇です。[具体的な役割・専門領域・スタンスを3〜5行で]

## プロジェクト概要
[プロジェクトの目的・背景・重要なコンテキスト]

## 主な業務
- タスク1
- タスク2
- タスク3

## 行動指針
- 原則1（どう判断するか）
- 原則2（何を優先するか）
- 原則3（どのトーンで話すか）

## 制約・禁止事項
- してはいけないこと1
- してはいけないこと2
- ユーザー承認なしに実行しないこと

## 利用可能なスキル
- `/スキル名` — スキルの説明（参照: skills/filename.md）

## 出力形式
[返答の言語・スタイル・フォーマットの指定]

このテンプレートをベースに、自分のプロジェクトや用途に合わせてカスタマイズしてください。
「役割定義だけ」の10行CLAUDE.mdでも、ないよりはるかに効果があります。

① 役割定義：最も重要なセクション

役割定義はCLAUDE.mdの核心です。ここを雑に書くと、AIの振る舞いが一貫しません。

② 行動指針：具体的な状況→対応を書く

行動指針はAIがどう判断するかのルールを定義します。
曖昧な表現ではなく、「〜な場合は〜する」という具体的な条件付きルールを書くのがコツです。

③ スキル（/コマンド）：詳細はファイルに分ける

スキルは繰り返し使うタスクをテンプレート化するものです。
CLAUDE.mdには「どんなコマンドがあるか」だけ書き、詳細な手順は skills/ フォルダの専用ファイルに書くのがベストプラクティスです。

## 利用可能なスキル
- `/write-article` — ブログ記事執筆（参照: skills/blog-article.md）
- `/morning`       — 朝のルーティン実行（参照: skills/morning-routine.md）
- `/sns-post`      — SNS投稿文生成（参照: skills/sns-amplify.md）

スキルファイルを分けることで、CLAUDE.md本体が肥大化せず、スキルの更新も容易になります。

CLAUDE.mdの真価が発揮されるのが、マルチエージェント構成です。

複数のフォルダを作り、それぞれに異なる役割のCLAUDE.mdを配置することで、AIを会社組織のように運用できます。

company/
├── CLAUDE.md          ← 会社全体の方針・価値観
├── ceo/
│   └── CLAUDE.md     ← CEOエージェント（全部門統括・戦略立案）
├── marketing/
│   ├── CLAUDE.md     ← マーケティング部長（集客・コンテンツ戦略）
│   ├── blog/
│   │   └── CLAUDE.md ← ブログチーム（記事制作・SEO・WordPress公開）
│   └── sns/
│       └── CLAUDE.md ← SNSチーム（X・Instagram・note）
├── development/
│   └── CLAUDE.md     ← 開発エージェント（実装・コードレビュー）
└── hr/
    └── CLAUDE.md     ← 人事エージェント（採用・評価）

この構成のポイント：

• 上位の CLAUDE.md ほど「方針・価値観・全体像」を書く
• 下位の CLAUDE.md ほど「専門スキル・具体的な手順・ツール」を書く
• 各部門フォルダで Claude Code を起動するだけで、その部門として動く
• CEOフォルダで起動すれば、全部門を統括するCEOとして動く

マルチエージェント構成を始める3ステップ

最初は「CEO」と「1部門」の2フォルダだけでOKです。使いながら部門を増やしていきましょう。

まとめ：CLAUDE.mdはAIを「チーム」に変えるファイル

CLAUDE.mdは、Claude Codeを「使えるツール」から「頼れる専属チーム」に変える最重要ファイルです。

今すぐ実践できる3ステップ：

まずは小さく始めてみましょう。役割定義だけを書いた10行のCLAUDE.mdでも、Claude Codeの使い勝手は劇的に変わります。

• ✅ CLAUDE.mdは役割定義・行動指針・スキル定義を書くファイル
• ✅ 具体的・条件付きの指示が効く（「丁寧に」ではなく「〜の場合は〜する」）
• ✅ 詳細はスキルファイルに分けて、CLAUDE.mdはシンプルに保つ
• ✅ マルチエージェント構成でAI組織を作れる
• ✅ 使いながら改善するのがベストプラクティス

Ryo

XFacebookInstagram

「頑張っているのに成果が出ない」
「良い習慣を続けられない」

そんな悩みの多くは、努力不足ではなく「脳の仕組みを無視した働き方」が原因です。

科学的ワーク研究所は、
行動心理学・脳科学・睡眠科学の知見と、
最新AIツールの活用を組み合わせた
「科学的な仕事術」を実践・研究し、
その知見を発信するメディアです。

▼ このブログで学べること
・集中力・記憶力・意思決定力を高める脳科学的アプローチ
・習慣化に失敗しないための行動心理学メソッド ・Claude CodeなどのAIを使った業務自動化・生産性向上の実践事例

エビデンスのある方法論と、すぐに試せるAIツール活用を組み合わせて、あなたの仕事を根本から変えます。 まずは「習慣化・生産性」カテゴリから読んでみてください。