CLAUDE.mdとは？書き方・置き場所・/initでの作り方と効果的な運用のコツを解説

「Claude Codeに毎回同じ説明をしている」「プロジェクトの決まりを守ってくれないことがある」。Claude Codeを使い始めた開発者から、こうした声をよく伺います。こうした悩みを解決するのが、CLAUDE.mdです。

CLAUDE.mdは、Claude Codeに常に守ってほしい指示や、プロジェクトの情報を書いておくファイルです。公式の資料によると、Claude Codeは毎回のセッションの最初にCLAUDE.mdを読み込み、その内容を踏まえて作業を進めます。

本記事では、Claude Codeの公式の資料の情報をもとに、CLAUDE.mdの仕組み、置き場所、/initでの作り方、効果的な書き方、ルールのファイルでの整理、自動のメモリーとの違い、うまく効かないときの対処法、チームで運用するコツまでを整理します。

確認したいポイント	結論	詳細
CLAUDE.mdとは？	Claude Codeへの常設の指示書	プロジェクトの決まりや作業の手順などを書いておくと、Claude Codeが毎回のセッションの最初に読み込まれます。
どこに置く？	プロジェクトの直下などに置く	プロジェクト用は「./CLAUDE.md」、自分用は「~/.claude/CLAUDE.md」など、用途によって置き場所が異なります。
どうやって作る？	「/init」で下書きを自動で作る	公式の資料では、「/init」を実行すると、Claudeがコードを調べてCLAUDE.mdの下書きを作ると案内されています。
書き方のコツは？	短く、具体的に、整理して書く	公式の資料では、1つのファイルは200行未満を目安に、確かめられる具体的な指示を書くよう案内されています。

この記事でわかること

• CLAUDE.mdの仕組みと、自動のメモリーとの違い
• CLAUDE.mdの4つの置き場所と、読み込まれる順番
• /initで作る方法と、効果的な書き方のコツ
• ほかのファイルの読み込みや、ルールのファイルでの整理の方法
• うまく効かないときの対処法と、チームで運用するコツ

AIを活用したシステム開発を検討している企業の方へ ネクストスケールでは、AI活用の戦略設計から、AIを活用したシステム開発、業務の自動化の仕組みづくり、利用ルールの整備、社員研修までを一気通貫で支援しています。支援内容や料金、導入事例をまとめた資料を無料でお送りします。 資料請求はこちら

CLAUDE.mdとは

最初に、CLAUDE.mdがどのような仕組みなのかを確認しておきましょう。

Claude Codeへの常設の指示書

公式の資料によると、Claude Codeの各セッションは、新しい状態から始まります。前のセッションでの説明や修正の内容は、そのままでは次のセッションに引き継がれません。

そのため、毎回のセッションで同じ説明を繰り返す手間や、説明を忘れたときにClaudeが決まりと違う作業をしてしまうといった問題が起きやすくなります。

CLAUDE.mdは、利用者が書く、Claudeへの継続的な指示のファイルです。Markdownの形式で書き、Claudeが毎回のセッションの最初に読み込まれます。プロジェクトの決まり、個人の作業の進め方、組織全体の方針などを書いておけます。

たとえば、新しく加わったメンバーに最初に渡す、プロジェクトの説明の資料のようなものです。CLAUDE.mdがあることで、Claudeは毎回同じ前提で作業を始められます。

自動のメモリーとの違い

公式の資料によると、Claude Codeには、CLAUDE.mdのほかに、Claudeが自分でメモを書く「自動のメモリー（auto memory）」という仕組みもあります。違いを表で整理します。

項目	CLAUDE.md	自動のメモリー（auto memory）
書く人	利用者	Claude
内容	指示や決まり	学んだことや傾向
範囲	プロジェクト、利用者、組織	リポジトリごと
読み込み	毎回のセッション	毎回のセッション（最初の200行または25KBまで）

Claudeの動きを導きたい場合はCLAUDE.md、利用者の修正からClaudeに自動で学んでほしい場合は自動のメモリー、と使い分けます。

指示は「参考の情報」であり、強制ではない

公式の資料では、CLAUDE.mdも自動のメモリーも、Claudeは強制の設定ではなく、参考の情報として扱うと明記されています。どのような場合でも必ず止めたい操作がある場合は、フック（PreToolUse hook）という別の仕組みを使うよう案内されています。

また、公式の資料では、指示が具体的で簡潔なほど、Claudeは一貫して従いやすくなるとされています。

CLAUDE.mdに書くべきこと

公式の資料では、CLAUDE.mdを「本来なら何度も説明し直すことを書き留めておく場所」として扱うよう案内されています。

CLAUDE.mdに追加するタイミング

公式の資料によると、次のような場合に、CLAUDE.mdに追加するとよいとされています。

Claudeが同じ間違いを2回したとき、コードのレビューで、Claudeが知っておくべきだったことが見つかったとき、前のセッションと同じ修正や説明をチャットで入力したとき、新しいメンバーが同じ情報を必要とするときです。

毎回必要な事実に絞る

公式の資料では、CLAUDE.mdには、ビルドのコマンド、コードの決まり、プロジェクトの構成、「常にXをする」といったルールなど、毎回のセッションで必要な事実を書くよう案内されています。

逆に、一度しか使わない情報や、特定の作業のときだけ必要な情報は、CLAUDE.mdに書くと処理の量を無駄に使うことになります。

一方、複数の手順からなる作業や、コードの一部にだけ関係する内容は、スキルや、特定のファイルにだけ適用されるルールに移すよう勧められています。

CLAUDE.mdの置き場所

公式の資料によると、CLAUDE.mdは、いくつかの場所に置くことができ、場所ごとに適用される範囲が異なります。

範囲	置き場所（公式の資料より）	主な用途
組織全体（管理者）	macOS・Linux・Windowsごとの決まった場所	会社のコーディングの基準、セキュリティの方針
利用者（自分）	~/.claude/CLAUDE.md	すべてのプロジェクトに共通する自分の好み
プロジェクト	./CLAUDE.md または ./.claude/CLAUDE.md	チームで共有するプロジェクトの決まり
ローカル（自分のみ）	./CLAUDE.local.md	自分だけのプロジェクト用の設定（.gitignoreに追加）

プロジェクトのCLAUDE.md

最もよく使うのが、プロジェクトのCLAUDE.mdです。公式の資料によると、「./CLAUDE.md」または「./.claude/CLAUDE.md」に置きます。ビルドとテストのコマンド、コードの決まり、設計の判断、名前の付け方、よく使う作業の流れなど、プロジェクトに関わる全員に当てはまる指示を書きます。

プロジェクトのCLAUDE.mdは、バージョン管理の仕組みでチームと共有されるため、個人の好みではなく、プロジェクトの基準を書くことが大切です。

自分用のCLAUDE.md

すべてのプロジェクトに共通する自分の好みは、「~/.claude/CLAUDE.md」に書きます。たとえば、回答の言語や、自分がよく使うツールなどです。

自分用のCLAUDE.mdには、「回答は日本語で」「変更の前に計画を見せて」といった、どのプロジェクトでも共通する作業の進め方を書いておくと便利です。

特定のプロジェクトでの自分だけの設定は、「./CLAUDE.local.md」に書き、.gitignoreに追加して共有しないようにします。

読み込まれる順番

公式の資料によると、Claude Codeは、作業しているフォルダと、その上にあるすべてのフォルダのCLAUDE.mdとCLAUDE.local.mdを読み込みます。読み込んだファイルは、上書きではなく、つなげて読み込まれ、作業しているフォルダに近いものほど後に読みます。

下の階層のフォルダにあるCLAUDE.mdは、起動の時点では読み込まれず、Claudeがそのフォルダのファイルを読んだときに読み込まれます。

この仕組みを使うと、フロントエンドとバックエンドなど、フォルダごとに異なる決まりを、それぞれのフォルダのCLAUDE.mdに書き分けられます。

/initでCLAUDE.mdを作る

CLAUDE.mdは自分で一から書くこともできますが、「/init」のコマンドを使うと、下書きを自動で作れます。

/initの使い方

公式の資料によると、Claude Codeのセッションで「/init」を実行すると、Claudeがコードを調べ、ビルドのコマンド、テストの方法、見つけたプロジェクトの決まりなどを書いたCLAUDE.mdを作ります。

すでにCLAUDE.mdがある場合は、上書きせずに改善の案を示すとされています。作られた下書きをもとに、Claudeが自分では見つけられない指示を書き加えて仕上げましょう。

たとえば、チームで決めた命名の決まり、使ってはいけないライブラリ、過去にトラブルになった点などは、コードを調べるだけではわからないため、人が書き加える必要があります。

対話で作る方法

公式の資料によると、「CLAUDE_CODE_NEW_INIT=1」を設定すると、対話で段階的に作る方法が使えます。CLAUDE.md、スキル、フックのうち何を用意するかを尋ね、コードを調べ、追加の質問で不足を補い、ファイルを書く前に確認できる案を示すとされています。

初めてCLAUDE.mdを作る場合や、どのような内容を書けばよいかわからない場合に、この方法を試してみるとよいでしょう。

ほかのツールの指示を取り込む

公式の資料によると、「/init」は、Cursorのルールのファイルや、GitHub Copilotの指示のファイルなどを読み込み、関係する部分をCLAUDE.mdに取り込みます。ほかのAI開発のツールから移行する場合に便利です。

Claude Codeを開発の現場に取り入れたい方へ 社内の開発の体制やプロジェクトの状況を伺い、Claude CodeなどのAIの開発のツールの導入と設定、CLAUDE.mdなどのルールの整備、安全な運用の進め方を無料でご提案します。オンラインで30分からご相談いただけます。 相談予約はこちら

効果的な書き方のコツ

公式の資料では、CLAUDE.mdの効果的な書き方として、次の点が案内されています。

1つのファイルは200行未満を目安に

公式の資料によると、CLAUDE.mdは毎回のセッションの最初に読み込まれ、会話と同じように処理の量を使います。1つのファイルは200行未満を目安にし、長くなる場合は、特定のファイルにだけ適用されるルールに分けるよう案内されています。

長いファイルほど処理の量を多く使い、指示が守られにくくなるとされています。

見出しと箇条書きで整理する

公式の資料では、Markdownの見出しや箇条書きで、関係する指示をまとめるよう勧められています。Claudeも人と同じように構成を読み取るため、整理された項目のほうが、詰まった文章よりも従いやすいとされています。

人が読んでもわかりやすいCLAUDE.mdは、新しいメンバーへのプロジェクトの説明の資料としても役立ちます。

確かめられるほど具体的に書く

公式の資料では、確かめられるほど具体的に書くよう案内されています。例として、次のような書き方が紹介されています。

「コードをきちんと整える」ではなく「インデントは2つの空白にする」、「変更をテストする」ではなく「コミットの前にnpm testを実行する」、「ファイルを整理しておく」ではなく「APIの処理はsrc/api/handlers/に置く」のように書きます。

矛盾する指示をなくす

公式の資料によると、2つのルールが矛盾していると、Claudeがどちらかを任意に選ぶことがあります。CLAUDE.mdや下の階層のCLAUDE.md、ルールのファイルを定期的に見直し、古い指示や矛盾する指示を削除しましょう。

書き方の例

# プロジェクトの概要

– 社内の勤怠管理のWebアプリ（TypeScript、React）

# よく使うコマンド

– 開発のサーバーの起動：npm run dev

– テスト：npm test（コミットの前に必ず実行）

# コードの決まり

– インデントは2つの空白

– APIの処理は src/api/handlers/ に置く

– 新しいライブラリを追加する前に、必ず確認を求める

ほかのファイルの読み込みとルールでの整理

大きなプロジェクトでは、指示を複数のファイルに分けて整理すると、管理しやすくなります。

@でほかのファイルを読み込む

公式の資料によると、CLAUDE.mdでは、「@ファイルの場所」の書き方で、ほかのファイルを読み込めます。読み込んだファイルは、起動の時点で展開されて読み込まれます。

概要は @README を、使えるコマンドは @package.json を参照してください。

# 追加の指示

– Gitの作業の流れ @docs/git-instructions.md

公式の資料によると、読み込んだファイルの中でさらにほかのファイルを読み込むこともでき、最大で4段階までとされています。ただし、読み込んだファイルも起動の時点で読み込まれるため、処理の量を減らす効果はありません。

作業しているフォルダの外にあるファイルを読み込む場合は、初めてのときに承認を求める画面が表示されます。

.claude/rules/でルールを分ける

公式の資料によると、「.claude/rules/」のフォルダに、テーマごとにMarkdownのファイルを置くと、指示を分けて管理できます。たとえば、コードの書き方、テスト、セキュリティなどのテーマごとにファイルを作ります。

ファイルを分けておくと、担当者ごとに管理しやすく、変更の履歴も追いやすくなります。公式の資料では、自分のすべてのプロジェクトに適用するルールを「~/.claude/rules/」に置くこともできると案内されています。

特定のファイルにだけ適用するルール

公式の資料によると、ルールのファイルの先頭に「paths」の設定を書くと、指定した種類のファイルを扱うときだけ、そのルールが読み込まれます。

—

paths:

  – “src/api/**/*.ts”

—

# APIの開発のルール

– すべてのAPIで入力の内容を確認する

– 決まった形式のエラーの応答を使う

必要なときだけ読み込まれるため、処理の量を節約しながら、細かなルールを設定できます。

公式の資料では、常に必要ではない作業ごとの指示は、ルールではなく、呼び出したときや関係する依頼のときだけ読み込まれるスキルを使うよう案内されています。

AIを活用した開発の体制づくりを検討している方へ ネクストスケールの支援内容やAIを活用したシステム開発の進め方、料金プラン、導入事例をまとめた資料をご用意しています。社内での検討資料としてもご活用ください。 資料請求はこちら

AGENTS.mdとの関係

ほかのAI開発のツールでは、AGENTS.mdという名前の指示のファイルが使われることがあります。

AGENTS.mdを読む場合

公式の資料によると、Claude Codeのバージョン2.1.277以降では、CLAUDE.mdがない場合にAGENTS.mdを読み込むことができます。初期の設定では、CLAUDE.mdやCLAUDE.local.mdがある場合は、CLAUDE.mdだけを読むとされています。

両方を読み込みたい場合は、「/config」の設定で読み込むファイルを変更できると案内されています。

1つのファイルをほかのツールと共有する

公式の資料では、AGENTS.mdをほかのツールと共有したい場合は、CLAUDE.mdの中で「@AGENTS.md」と書いて読み込む方法が紹介されています。その下に、Claude Code向けの指示を書き加えられます。

自動のメモリーの使い方

CLAUDE.mdとあわせて、自動のメモリーの仕組みも理解しておきましょう。

Claudeが自分でメモを残す

公式の資料によると、自動のメモリーでは、Claudeが作業しながら、利用者の役割や好み、利用者からの修正、コードからはわからない進行中の作業や決定、外部の情報の場所などを、自分のためにメモとして残します。

一方、コードから読み取れることや、CLAUDE.mdにすでに書かれていることは、保存しないとされています。

保存の場所と読み込み

公式の資料によると、自動のメモリーは、「~/.claude/projects/プロジェクト/memory/」に保存され、同じリポジトリの作業のフォルダで共有されます。目次の役割の「MEMORY.md」の最初の200行または25KBまでが、毎回のセッションの最初に読み込まれます。

自動のメモリーは、そのパソコンの中だけに保存され、ほかのパソコンとは共有されないとされています。

オン・オフの切り替え

公式の資料によると、自動のメモリーは初期の状態でオンになっています。「/memory」の画面で切り替えられ、プロジェクトごとに無効にすることもできます。保存された内容は、普通のMarkdownのファイルなので、いつでも確認・編集・削除できます。

CLAUDE.mdを育てる運用のサイクル

CLAUDE.mdは、一度作って終わりではなく、使いながら育てていくものです。

Claudeの間違いを記録する

Claudeが同じ間違いを繰り返したときや、同じ説明を何度もしていると気づいたときは、CLAUDE.mdに追加するタイミングです。気づいたときにすぐ追加すると、次のセッションから改善されます。

追加するときは、なぜその指示が必要なのかも一言添えておくと、後から見直すときに判断しやすくなります。

定期的に見直して減らす

追加を続けると、CLAUDE.mdは長くなり、指示が守られにくくなります。月に一度など、定期的に見直し、古い指示や不要な指示を削除しましょう。公式の資料によると、「/doctor」の点検の機能では、コードから読み取れる内容を削り、落とし穴や理由、ツールの初期の設定と異なる決まりを残すよう、CLAUDE.mdを短くする案を示すとされています。

効果を確かめる

指示を追加した後は、Claudeの動きが改善されたかを確かめましょう。改善されない場合は、指示の書き方を具体的にする、フックを使うといった別の方法を検討します。

チームで使う場合は、改善の効果があった指示の例を共有すると、ほかのプロジェクトのCLAUDE.mdづくりにも役立ちます。

確認と編集の方法

CLAUDE.mdが正しく読み込まれているかを、確認する方法を紹介します。

/memoryで確認・編集する

公式の資料によると、「/memory」のコマンドで、CLAUDE.md、CLAUDE.local.md、そのほかのメモリーのファイルの一覧を表示し、選んだファイルを編集できます。自動のメモリーのオン・オフの切り替えもできます。

まだ存在しないファイルを選ぶと、新しく作ってから開くとされています。

/contextで読み込まれたファイルを確認する

公式の資料によると、「/context」のコマンドで、現在のセッションに読み込まれたCLAUDE.mdやルールのファイルを確認できます。CLAUDE.mdが一覧にない場合は、Claudeはその内容を見ていません。

Claudeに追加を依頼する

公式の資料によると、「〜を覚えておいて」と依頼すると、Claudeは自動のメモリーに保存します。CLAUDE.mdに追加したい場合は、「これをCLAUDE.mdに追加して」と直接依頼するか、「/memory」で自分で編集します。

CLAUDE.mdが効かないときの対処法

公式の資料で案内されている、CLAUDE.mdが守られないときの確認点を紹介します。

読み込まれているかを確認する

まず、「/context」で、CLAUDE.mdが読み込まれているかを確認します。読み込まれていない場合は、置き場所が正しいかを確認しましょう。

Claude Codeを起動したフォルダによって、読み込まれるCLAUDE.mdが変わる点にも注意が必要です。

指示を具体的にする・矛盾を探す

公式の資料によると、CLAUDE.mdの内容は、システムの指示の後に、利用者のメッセージとして渡されるため、厳密に守られる保証はないとされています。特に、あいまいな指示や、矛盾する指示は守られにくくなります。指示を具体的にし、複数のファイルの間で矛盾がないかを確認しましょう。

必ず実行したいことはフックで

公式の資料では、コミットの前や、ファイルの編集の後など、決まった時点で必ず実行したいことは、フックとして書くよう案内されています。フックは、Claudeの判断に関係なく実行されます。

CLAUDE.mdは行動の指針、フックは必ず実行する処理、と役割を分けて考えるとわかりやすくなります。

会話を要約した後に指示が消えた場合

公式の資料によると、プロジェクトの直下のCLAUDE.mdは、会話の要約（/compact）の後に読み直されます。指示が消えた場合は、会話の中でだけ伝えた指示だった可能性があります。続けて守ってほしい指示は、CLAUDE.mdに書いておきましょう。

下の階層のCLAUDE.mdや、特定のファイルにだけ適用されるルールは、Claudeが関係するファイルを読んだときに、改めて読み込まれるとされています。

チームでCLAUDE.mdを運用するコツ

チームでClaude Codeを使う場合は、CLAUDE.mdをチームの資産として運用すると効果的です。

プロジェクトのCLAUDE.mdをレビューする

プロジェクトのCLAUDE.mdは、コードと同じようにバージョン管理し、変更をレビューしましょう。誰かが追加した指示が、ほかのメンバーの作業に影響することがあるためです。

チームでCLAUDE.mdに書く内容の基準を決めておくと、指示が増えすぎたり、矛盾したりするのを防げます。

組織全体の指示を配る

公式の資料によると、組織では、管理者が決まった場所に組織全体のCLAUDE.mdを置き、構成の管理のツールで配布できます。このファイルは、個人の設定で除外できないとされています。

会社として、セキュリティの方針やデータの扱いの注意など、すべての開発者に守ってほしい指示がある場合に役立ちます。

公式の資料では、特定のツールやコマンドを禁止するといった技術的な強制は設定のファイルで、行動の指針はCLAUDE.mdで行うよう、使い分けが案内されています。

秘密の情報を書かない

プロジェクトのCLAUDE.mdは、チームで共有され、リポジトリにも残ります。パスワードや接続の情報などの秘密の情報は、書かないようにしましょう。

秘密の情報は、環境の変数や、専用の秘密の情報の管理の仕組みで管理し、CLAUDE.mdにはその仕組みの使い方だけを書くようにします。

AIのエージェントを使った開発や業務の自動化の考え方は、AIエージェント 自動化｜RPAとの違い・自動化の5段階・失敗しない設計手順でも詳しく解説しています。

関連記事：AIエージェント 自動化 RPAとの違い・自動化の5段階・失敗しない設計手順【2026年版】

CLAUDE.mdに関するよくある質問

最後に、CLAUDE.mdについてよく寄せられる質問と、その回答を紹介します。

CLAUDE.mdは日本語で書いてもよい？

日本語で書いても読み込まれます。チームのメンバーが読みやすい言語で書くとよいでしょう。回答の言語を指定したい場合も、CLAUDE.mdに書いておけます。

コマンドや、ファイルの名前などは、実際の表記のまま書くようにしましょう。

CLAUDE.mdの大きさに上限はある？

公式の資料によると、Claude Codeは4MiBまでのCLAUDE.mdを読み込み、それより大きいファイルは読み込まないとされています。ただし、短いファイルのほうが指示が守られやすいため、200行未満を目安にしましょう。

人向けのメモを書きたい場合は？

公式の資料によると、HTMLのコメント（<!– –>）で書いた内容は、Claudeに渡される前に取り除かれます。人向けのメモを、処理の量を使わずに残せます。

たとえば、指示を追加した理由や、見直しの予定などを、コメントとして残しておくと便利です。

社員がAIの開発のツールを安全に使いこなせるよう、生成AI活用研修などで基礎をそろえておくのも効果的です。

AIを活用した開発を業務に定着させたい方へ Claude CodeなどのAIの開発のツールの導入と設定から、CLAUDE.mdなどのルールの整備、セキュリティと運用のルールづくり、社員向けの研修まで、伴走して支援します。お気軽にご相談ください。 相談予約はこちら

まとめ｜CLAUDE.mdを育てて、Claude Codeとの開発を効率化しよう

CLAUDE.mdは、Claude Codeが毎回のセッションの最初に読み込む、常設の指示書です。プロジェクト用は「./CLAUDE.md」、自分用は「~/.claude/CLAUDE.md」などに置き、「/init」で下書きを作って、Claudeが自分では見つけられない指示を書き加えて仕上げます。

200行未満を目安に、具体的で、整理された、矛盾のない指示を書き、長くなる場合はルールのファイルに分けましょう。CLAUDE.mdは強制の設定ではないため、必ず実行したいことはフックを使います。詳しくは、Claude Codeの公式の資料「How Claude remembers your project」で確認できます。

ネクストスケールでは、AI活用の戦略設計から、AIを活用したシステム開発、業務の自動化の仕組みづくり、利用ルールの整備、社員研修までを一気通貫で支援しています。支援の詳細はAIシステム開発やAIコンサル・AX伴走支援のページで紹介していますので、AIを活用した開発をどこから進めるか迷っている場合も、お気軽にご相談ください。

AIを活用したシステム開発を一緒に進めませんか 開発の体制の整理から、AIの開発のツールの導入と設定、ルールの整備、安全な開発の環境づくり、AIを活用したシステム開発、社員への定着までをご支援します。しつこい営業はいたしませんので、まずは無料相談をご利用ください。 相談予約はこちら