Claude Codeを使っていて、こんな経験はありませんか？
「毎回、自分の仕事内容を説明している」
「プロジェクトのルールを何度も伝えている」
「前回お願いしたことを、次の作業でも守ってほしい」
そんなときに役立つのが、**CLAUDE.md（クロード・エムディー）**という設定ファイルです。
CLAUDE.mdを使うと、Claude Codeにあらかじめ知っておいてほしい情報や、作業中に守ってほしいルールをファイルにまとめられます。
この記事では、CLAUDE.mdの基本から、保存場所の違い、実際の作り方、注意点まで、初心者向けに解説します。
CLAUDE.mdとは？Claude Codeに渡す共通ルール
CLAUDE.mdは、Claude Codeが作業するときに参照する指示や情報を、Markdown形式で記述したファイルです。
例えば、Webサイトを制作している場合、次のようなルールを登録できます。
- 作業するWebサイトの概要
- 使用しているプログラミング言語
- ファイルを編集するときの注意事項
- 変更前に確認してほしいこと
- 作業完了時の報告方法
これらをCLAUDE.mdにまとめておけば、毎回すべてを入力する手間を減らせます。
CLAUDE.mdと通常のチャット指示の違い
通常のチャットでは、必要な指示をその都度入力します。
一方、CLAUDE.mdは、継続して使いたいルールをファイルとして保存する仕組みです。
例えば、通常のチャットで次のように伝えたとします。
「ファイルを削除する前に、必ず確認してください」
このルールをCLAUDE.mdに書いておけば、Claude Codeがそのファイルを読み込む作業では、毎回同じ文章を入力する必要がなくなります。
ただし、CLAUDE.mdは絶対的な強制機能ではありません。 指示が常に完全に守られるとは限らないため、重要な操作では人間による確認も必要です。
Markdown（.md）とは？
Markdownは、文章を簡単な記号で整理できる書式です。
例えば、次のように記述します。
# プロジェクトの概要
このフォルダではWebサイトを制作します。
## 作業ルール
- 既存のデザインをできるだけ維持する
- ファイルを削除する前に確認する
- 作業後は変更内容を報告する# は見出し、- は箇条書きを表します。
特別なソフトがなくても、テキストエディターで作成・編集できます。
CLAUDE.mdを使うメリット
1. 同じ説明を繰り返す手間を減らせる
例えば、Claude CodeでブログやWebサイトを管理する場合、サイトの目的や使用技術を毎回説明するのは面倒です。
CLAUDE.mdに基本情報を登録しておくと、Claude Codeが作業を始める際の前提情報として利用できます。
2. 作業ルールを統一しやすくなる
Webサイト制作では、ページごとにデザインやファイル構成が変わると、管理が難しくなります。
「既存のCSSの書き方に合わせる」「新しい機能を追加するときは既存機能への影響を確認する」といったルールを設定することで、作業方針を共有しやすくなります。
3. プロジェクトごとに設定を切り替えられる
ブログ制作、動画編集、プログラミングなど、作業内容によって必要なルールは異なります。
CLAUDE.mdは保存場所によって適用範囲を分けられるため、プロジェクトごとに異なる指示を管理できます。
CLAUDE.mdの保存場所と適用範囲
CLAUDE.mdは、どこに保存するかによって役割が変わります。
初心者が最初に覚えておきたいのは、ユーザー共通の設定とプロジェクト専用の設定の2種類です。
1. ユーザー共通のCLAUDE.md
Claude Codeで使う共通ルールは、ユーザーのホームディレクトリ内にある次の場所へ保存できます。
~/.claude/CLAUDE.md~ は、現在のユーザーのホームディレクトリを表します。
ここには、複数のプロジェクトで共通して使いたいルールを記述します。
例えば、次のような内容です。
# 共通ルール
- 回答は日本語で行う
- 専門用語を使う場合は簡単に説明する
- 重要なファイルを削除する前に確認する
- 不明な情報は推測で断定しない2. プロジェクト専用のCLAUDE.md
特定のプロジェクトだけに適用したいルールは、そのプロジェクトのフォルダ内に保存します。
例えば、次のような構成です。
my-website/
├── CLAUDE.md
├── index.html
├── style.css
└── images/この場合、CLAUDE.md にはWebサイト制作に関するルールを記述できます。
# プロジェクト概要
このフォルダではWebサイトを制作します。
## 使用技術
- HTML
- CSS
- JavaScript
## 作業ルール
- 既存のレイアウトを維持する
- CSSの変更は関連する箇所にまとめる
- 修正後は変更したファイルを報告するこのように、共通ルールはユーザー設定、個別ルールはプロジェクトフォルダと分けると管理しやすくなります。
CLAUDE.mdの作り方【初心者向け3ステップ】
ここからは、実際にCLAUDE.mdを作成してみましょう。
難しいプログラミングの知識は必要ありません。Claude Codeに相談しながら作成できます。
STEP1：Claude Codeで作業フォルダを開く
まず、CLAUDE.mdを作りたいプロジェクトのフォルダをClaude Codeで開きます。
例えば、Webサイトを管理する場合は、そのWebサイトのファイルが入っているフォルダを選択します。
注意： 作業フォルダを間違えると、意図しない場所にファイルが作成される可能性があります。最初にフォルダの場所を確認しましょう。
STEP2：Claude Codeに作成を依頼する
Claude Codeのチャット欄に、次の文章を入力してください。
このプロジェクト用のCLAUDE.mdを作成したいです。
まず、現在のフォルダ構成を確認してください。
その後、CLAUDE.mdに必要な情報を私に質問してください。
質問は一度に多く出さず、初心者にも分かるように進めてください。
回答がまとまったらCLAUDE.mdの内容を提案してください。
ファイルを保存する前に、内容と保存先を確認させてください。
既存のCLAUDE.mdがある場合は、勝手に上書きしないでください。この方法なら、必要な情報をClaude Codeと相談しながら整理できます。
Claude Codeには、プロジェクトを調べてCLAUDE.mdのひな形を作る /init コマンドもあります。すでにファイルがある場合は、内容を確認してから更新しましょう。
STEP3：内容を確認して保存する
Claude Codeが提案した内容を確認します。
特にチェックしたいのは、次の4点です。
- プロジェクトの目的が正しく書かれているか
- 使用している技術やフォルダ構成に間違いがないか
- 必要のないルールが大量に追加されていないか
- ファイルの削除や外部送信に関する危険な指示がないか
問題がなければ保存を依頼します。
保存後は、次のように質問してみてください。
現在読み込まれているCLAUDE.mdの場所と、
主なルールを教えてください。これで、設定した内容を確認できます。
そのまま使えるCLAUDE.mdのサンプル
初めて作成する場合は、複雑な設定よりも、短く分かりやすい内容がおすすめです。
以下は、Webサイト制作を想定したサンプルです。
# プロジェクト概要
このプロジェクトではWebサイトを制作・管理します。
# 基本方針
- 回答は日本語で行う
- 専門用語は初心者にも分かるように説明する
- 不明な情報は推測で断定しない
- 既存のデザインや機能をできるだけ維持する
# ファイル操作
- ファイルを削除する前に確認する
- 大きな変更を行う前に変更内容を説明する
- 既存ファイルを上書きする場合は影響を確認する
- パスワードやAPIキーを回答に表示しない
# 作業完了時の報告
- 変更したファイル
- 変更した内容
- 動作確認の結果
- 残っている問題
以上を簡潔に報告する。このサンプルは、あくまで出発点です。
実際の仕事内容やプロジェクトに合わせて調整してください。
CLAUDE.mdには何を書けばいい？
CLAUDE.mdを便利に使うためには、情報を増やしすぎないことも大切です。
書いておきたい情報
基本的には、作業するたびにClaude Codeに知っておいてほしいことを優先します。
例えば、次のような内容です。
- プロジェクトの目的
- 使用する技術やツール
- コーディングやファイル管理のルール
- 作業時の禁止事項
- テストや確認の方法
「毎回説明していることは何か？」と考えると、必要な項目を見つけやすくなります。
書きすぎない方がよい情報
反対に、たまにしか使わない長い手順書や、大量の参考資料をすべてCLAUDE.mdに入れる必要はありません。
例えば、ブログ記事の執筆手順、画像制作の細かな指示、特定の作業だけで使うチェックリストなどです。
こうした情報は、必要に応じて別のファイルやClaude CodeのSkillsなどで管理する方法があります。
CLAUDE.mdは、毎回参照してほしい基本ルールを中心にまとめると管理しやすくなります。
CLAUDE.mdを使うときの注意点
1. 指示が必ず守られるわけではない
CLAUDE.mdにルールを書いても、Claude Codeがすべての指示を完全に守るとは限りません。
特に、ファイル削除や重要な設定変更などは、実行前に内容を確認することが大切です。
CLAUDE.mdは作業を支援する仕組みであり、バックアップやアクセス権限の管理を置き換えるものではありません。
2. パスワードや秘密情報を記載しない
CLAUDE.mdには、パスワード、APIキー、秘密鍵などの情報を直接書かないようにしましょう。
プロジェクトの共有やバックアップによって、意図せず外部へ公開される可能性があります。
認証情報は、適切な環境変数やシークレット管理の仕組みを使って管理してください。
3. インターネット上の設定ファイルを無条件で使わない
インターネット上には、さまざまなCLAUDE.mdのサンプルが公開されています。
便利なものもありますが、内容を確認せずに導入するのは避けましょう。
特に注意したいのは、次のような指示です。
- ファイルを無条件で削除する
- 外部のサーバーへ情報を送信する
- 確認なしで重要なコマンドを実行する
- セキュリティ設定を無効化する
自分が意味を理解できない命令は、実行する前に確認することが重要です。
4. 定期的に内容を見直す
プロジェクトの構成や作業方法が変わったら、CLAUDE.mdも更新しましょう。
古い情報が残っていると、Claude Codeが現在の作業に合わない提案をする原因になります。
CLAUDE.mdに関するよくある質問
CLAUDE.mdを作らないとClaude Codeは使えない？
いいえ。CLAUDE.mdがなくてもClaude Codeは利用できます。
ただし、継続的に同じプロジェクトを扱う場合は、共通ルールを設定しておくと便利です。
CLAUDE.mdは日本語で書いても大丈夫？
はい。日本語で記述できます。
初心者のうちは、自分が理解しやすい日本語で作成することをおすすめします。
CLAUDE.mdを変更したらすぐに反映される？
CLAUDE.mdはClaude Codeが読み込んで利用するファイルです。
変更した内容が現在の会話に反映されているか不明な場合は、Claude Codeに再読み込みや内容の確認を依頼してください。
新しいセッションを開始して確認する方法もあります。
Claudeのデスクトップアプリでも使える？
Claude Codeのデスクトップ機能では、CLAUDE.mdを利用できます。
ただし、通常のClaudeチャットとClaude Codeでは機能や動作が異なるため、同じように適用されるとは限りません。
まとめ：CLAUDE.mdでClaude Codeをもっと使いやすくしよう
CLAUDE.mdは、Claude Codeにプロジェクトの情報や作業ルールを伝えるための設定ファイルです。
特に、同じフォルダで継続して作業する場合に役立ちます。
最初から完璧なファイルを作る必要はありません。
まずは「回答は日本語で」「ファイル削除前に確認する」「作業後に変更内容を報告する」といった、シンプルなルールから始めてみましょう。
使いながら少しずつ改善していけば、自分の作業に合ったCLAUDE.mdを育てていけます。
Claude Codeに毎回同じ説明をしている方は、ぜひCLAUDE.mdを作成してみてください。
コメント