AIToday
用語解説

CLAUDE.md とは?Claude Code に毎回守らせたいルールの書き方

著者:(AITODAY プロダクトオーナー)

公開日:最終更新日:

CLAUDE.md とは?Claude Code に毎回守らせたいルールの書き方

この記事でわかること

  • CLAUDE.md は Claude Code が起動するたびに最初に読む「このプロジェクトのルール」
  • 置き場所によって、どこまで効くかが変わる(プロジェクト全員/自分のすべてのプロジェクト/自分だけ)
  • 200行以内が目安。同じ注意を2回したら1行足すくらいでちょうどいい

Claude Code が起動のたびに読む CLAUDE.md の役割、4つの置き場所、書き方のコツと、そのまま使えるテンプレート。

一言でいうと、CLAUDE.md は Claude Code が起動するたびに最初に読む「このプロジェクトのルール」です。毎回チャットで説明していることを書いておけば、次から言わなくて済みます。

CLAUDE.md とは

Claude Code は、新しく会話を始めるたびに前の会話の内容を覚えていない状態からスタートします。そこで、毎回伝えたいことをファイルに書いておき、起動時に読ませるのが CLAUDE.md の役割です。

中身はただの .md(Markdown)ファイルで、日本語の箇条書きで書けます。.md 自体の説明は「なぜAIツールは .md ファイルばかりなのか」にまとめています。

置き場所は4つ

置く場所によって、どこまで効くかが変わります。

置き場所効く範囲書くもの
プロジェクト直下の CLAUDE.md(または .claude/CLAUDE.md)そのプロジェクト。チームで共有起動・テストのコマンド、コードの書き方のルール
~/.claude/CLAUDE.md自分のすべてのプロジェクト「回答は日本語で」など自分の好み
プロジェクト直下の CLAUDE.local.mdそのプロジェクトの自分だけ(Git に入れない)自分の検証用URLやテスト用のデータ
会社が配る管理用の場所会社の全員情報システム部門が決める全社ルール

複数あるときは、上書きではなく全部まとめて読まれます。起動時に実際に読み込まれたファイルは、Claude Code で /context と打つと「Memory files」の欄で確認できます。/memory は置き場所の一覧を出して、そこからファイルを開いて編集するためのコマンドです。

何を書けばいいか

公式ドキュメントでは、次のようなときに足すのがよいとされています。

  • Claude が同じミスを2回したとき
  • 前回と同じ補足をチャットに打ち込んでいるとき
  • 新しく入った人にも同じ説明が必要なとき

逆に、何ステップもある作業手順や、一部の作業でしか使わない内容は CLAUDE.md に書かず、SKILL.md に分けた方が軽く済みます。

書き方のコツ

  1. 具体的に書く。「コードをきれいに」ではなく「インデントはスペース2つ」のように、守れたか確認できる書き方にします
  2. 短くする。1ファイル200行以内が目安です。長いほど守られにくくなります
  3. 矛盾させない。2つの指示がぶつかると、どちらに従うかは Claude 次第になります
ポイント

Claude Code で /init と打つと、プロジェクトを読んで最初の CLAUDE.md を自動で作ってくれます。ゼロから書く必要はありません。

そのまま使えるテンプレート

# このプロジェクトについて
(1〜2行で、何をするためのプロジェクトか)

# ルール
- 回答は日本語で
- 本番のデータベースには書き込まない
- 変更したらテストを実行してから報告する

# よく使うコマンド
- 開発サーバー起動: npm run dev
- テスト: npm test

# フォルダ構成
- src/ に本体のコード
- docs/ に手順書

よくある勘違い

  • 「書けば必ず守ってくれる」:絶対ではありません。CLAUDE.md はあくまで参考として読まれます。どうしても止めたい操作は、フック(hooks)という別の仕組みで止めます。
  • 「書けば書くほど賢くなる」:逆です。長いと大事なルールが埋もれます。

まとめ

CLAUDE.md は、Claude Code に毎回伝えたいことを書いておくファイルです。まずは /init で作ってもらい、同じ注意を2回したら1行足す、という育て方がいちばん続きます。

次に読む

よくある質問

Q. CLAUDE.md はゼロから書かないといけませんか?
A. いいえ。Claude Code で /init と打つと、プロジェクトの中身を読んで最初の CLAUDE.md を作ってくれます。そこから自分のルールを足していけば十分です。
Q. CLAUDE.md と自動メモリ(auto memory)は何が違いますか?
A. CLAUDE.md は自分が書くルールで、自動メモリは Claude が作業中に自分で残すメモです。どちらも毎回読み込まれますが、確実に守らせたいことは CLAUDE.md に書きます。
Q. CLAUDE.md は Git に入れていいですか?
A. プロジェクト直下の CLAUDE.md は、チームで共有する前提のファイルなので入れて大丈夫です。自分だけのメモは CLAUDE.local.md に書いて、Git には入れないようにします。
Q. ほかのファイルの中身を読ませることはできますか?
A. できます。CLAUDE.md の中に「@ファイルのパス」と書くと、そのファイルも一緒に読み込まれます。README や手順書をまとめて読ませたいときに使えます。

出典:Anthropic(Claude Code 公式ドキュメント)

あなたの仕事に関係するAIニュースを、毎朝お届けします。

業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。

登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →

関連記事