毎回同じ指示、打っていませんか？

Claude Codeを使い始めると、気づかないうちに同じ作業を繰り返しています。

毎回同じ指示を入力する。

文体や出力がセッションごとにブレる。

SKILL.mdとの違いがわからない。

CLAUDE.mdは、こうした問題をまとめて解決するためのファイルです。

「Claudeに毎回伝えなくていい共通ルール」を定義できます。

ただし、書き方を間違えると逆効果になります。

Claudeが指示を守らない。

トークンだけ消費する。

設定したのに動作が変わらない。

こうした状態に陥るケースも少なくありません。

この記事では、Anthropicの公式ドキュメントをもとに、以下のポイントを整理します。

  • CLAUDE.mdに何を書くべきか

  • SKILL.mdとの役割の違い

  • 自動メモリとの使い分け

  • トークンを無駄にしない設計（200行の目安）

  • 置き場所とスコープの考え方

読みながら、そのまま設定できる構成にしています。

CLAUDE.mdとは？役割と使い方を1分で理解する

CLAUDE.mdの設定方法とは？

多くの人が、ここで最初の誤解をします。

「CLAUDE.mdを書けば、Claudeは必ずその通りに動く。」

そう思って設定した結果、守られずに終わる。

現場でよく見る、最初のつまずきです。

CLAUDE.mdは継続指示ファイルです。

Claude Codeの各セッションは、毎回まっさらなコンテキストから始まります。前回の指示は一切引き継がれません。

そこで、CLAUDE.mdを用意することで、毎回の指示入力を省略できます。

ターミナルを開いて新しいセッションを始める瞬間、Claudeはまず最初にCLAUDE.mdファイルを読み込みます。

設定ではなく、文脈です。

Anthropic公式ドキュメントでは、CLAUDE.mdは「文脈として読み込まれる情報」と説明されています。

短く・具体的に書くほど、Claudeが守りやすくなりますよ。

項目 内容
ファイル形式 Markdownファイル（.md）
読み込みタイミング セッション開始時に毎回自動読み込み
書く内容 ルール・文体・方針・NG事項
強制力 強制設定ではなく「文脈情報」として扱われる
推奨サイズ 200行未満（公式推奨）

CLAUDE.mdの書き方｜実務で使えるテンプレート付き

AI導入の現場で、最初の設定でつまずく人の大半がこう言います。

「何を書けばいいかわからない。」

ファイルを開いて、カーソルが止まる。その状態を抜け出すには、書くべき内容を5つに分けるだけです。

Anthropicの公式ドキュメントでは、コーディング標準・ワークフロー・プロジェクト構成・方針やルールの記載が推奨されています。

「毎回伝えるのは手間だが、毎回守ってほしいこと」をまとめる場所です。

書くべき内容の5つのカテゴリ

カテゴリ 記載内容の例
①プロジェクトの目的 このサービス・サイトは何のためのものか
②共通ルール 文体・トーン・言葉の選び方
③出力の方針 形式・長さ・構成の指定
④やってほしくないこと NG表現・禁止行動の列挙
⑤参照先・補足 参照すべきドキュメントや用語集

以下は、記事作成・コンテンツ制作向けのCLAUDE.mdテンプレートです。
そのままコピーして、自分のプロジェクトに合わせて書き換えてください。

# CLAUDE.md

## このプロジェクトの目的
WordPress向けに、初心者にもわかりやすいSEO記事を作る。

## 共通ルール
- です・ます調で書く
- 導入文を必ず入れる
- 見出しは検索意図に沿って整理する
- 難しい言葉は噛み砕いて説明する
- 例えはWordPress運営に寄せる

## NG
- 専門用語だけで話を進めない
- 導入なしでいきなり本題に入らない
- 根拠のない情報を書かない

200行ルール｜長く書きすぎると逆効果になる理由

「詳しく書くほど、Claudeは正確に動く。」

そう信じて書き続けると、ある時点から動作が不安定になります。
延々とターミナルと向き合いながら、なぜか指示が守られない状況です。

実は、逆です。

Anthropic公式ドキュメントでは、CLAUDE.mdはセッション開始時にコンテキストへ読み込まれるため、長いほどトークンを消費し、Claudeの従いやすさが下がると説明されています。

CLAUDE.md ファイルは各セッションの開始時にコンテキストウィンドウに読み込まれ、会話と一緒にトークンを消費します。これらはコンテキストであり強制的な設定ではないため、指示の書き方は Claude がそれに従う信頼性に影響します。具体的で簡潔でよく構造化された指示が最適に機能します。サイズ: CLAUDE.md ファイルあたり 200 行以下を目標にします。

Anthropic公式ドキュメント引用

推奨は1ファイル200行未満です。

私も最初は、「詳しく書きすぎてClaudeが混乱して全く反映されていない（汗）」という体験をしました。

改善方法は、不要な項目を削り、重要なルールだけを残すことで正常に動作するようになりました。

それでも長くなる場合は、.claude/rules/ディレクトリで分割すると便利です。

行数の目安 影響 対処法
〜100行 最も守られやすい状態 そのまま運用
100〜200行 問題なし（公式推奨範囲内） 定期的に内容を見直す
200行超 トークン消費増・従いやすさ低下 .claude/rules/で分割

CLAUDE.mdの置き場所と優先順位の仕組み

CLAUDE.mdの置き場所

「とりあえずプロジェクト直下に置けばいい。」

この考えは間違いではありません。

ただ、スコープの仕組みを知らないまま使うと、複数プロジェクトで設定が衝突したとき原因がわかりません。

Claudeのスコープとは、「Claudeが見ていい範囲・使っていい情報の範囲」のことです。

CLAUDE.mdは複数の場所に置くことができます。
置き場所によってスコープが変わり、より具体的な場所のものが優先されます。

場所が答えを決めます。

置き場所 スコープ 用途 優先順位
組織設定ディレクトリ 全組織共通 管理ポリシー・全体共通ルール 低
ユーザーホームディレクトリ 個人 個人の作業スタイル・好み 中
プロジェクト直下 プロジェクト単位 プロジェクト固有のルール 高

初心者はまずプロジェクト直下に置くことが推奨されます。

設定後は、/memoryコマンドでどのスコープのCLAUDE.mdが読み込まれているかを確認します。
現場では、この確認を最初のステップとして指導しています。

SKILL.mdとの違い｜「全体方針」と「個別機能」を使い分ける

CLAUDE.mdとSKILL.mdとの違いや役割分担

ここが分岐点です。

CLAUDE.mdとSKILL.mdを混同したまま設定を進めると、どこに何を書いたのか把握しづらくなります。結果として管理が煩雑になり、意図した通りにClaudeが動作しない原因になることがあります。

実際の運用では、SKILL.mdにルールや方針を書いてしまい、設定が分散してしまうケースも見られます。

SKILL.mdはタスク実行のための補助的な仕組みであり、CLAUDE.mdは全体のルールや方針を定義するファイルです。

この役割の違いを最初に理解しておくことが、安定した運用につながります。

ファイル 役割 使うタイミング 読み込み方
CLAUDE.md 全体方針・共通ルールの共有 毎回守ってほしいことがある時 セッション開始時に自動
SKILL.md 特定作業のための機能追加 特定タスクを繰り返し使う時 自動または/skill-nameで手動
自動メモリ 会話からClaudeが自動記録 特別な操作は不要 セッション開始時に先頭部分を自動読込

なお、旧来の.claude/commands/はSkillsに統合されています。

既存のcommandsファイルは引き続き動作しますが、新規作成はSKILL.mdで行うことが推奨されています。

自動メモリとの違い｜2つの記憶システムを正しく使い分ける

「自動メモリがあるなら、CLAUDE.mdはいらないのでは？」

この疑問は、設定を進めるとほぼ確実に出てきます。

結論から言うと、両方必要です。

理由はシンプルで、役割がまったく違うからです。

CLAUDE.mdは人が意図的に設計するルールです。

自動メモリはClaudeが会話の中から拾い上げる補助情報です。

ユーザーの好みや過去の文脈を記録するものであり、設計されたルールではありません。

この2つは役割が異なるため、混同すると管理が崩れるので、ご注意ください。

項目 CLAUDE.md 自動メモリ
誰が書くか 人が手動で記述 Claudeが自動で記録
内容 方針・ルール・NG事項 会話から学んだ好みや注意点
読み込みタイミング セッション開始時に全文 セッション開始時に先頭部分
管理方法 自分でファイルを編集 /memoryコマンドで確認・編集
向いている用途 プロジェクト全体の共通設定 個人の作業スタイルの補完

/memoryコマンドを使うと、CLAUDE.mdの編集・自動メモリのオンオフ・自動メモリの記録内容の確認ができます。

設定後は必ずこのコマンドで状態を確認することを、オススメいたします。

よくある誤解と失敗パターン3選

失敗

設定した。動かない(汗）なぜか。

CLAUDE.mdの設定で失敗する原因は、ほぼ3つに集約されます。

ClaudeCodeの設定代行の現場で繰り返し見てきた誤解と、その改善方法を整理します。

失敗①：書いたのにClaudeが守ってくれない

多くの人が、ここで間違えます。

CLAUDE.mdは強制設定ではありません。

Anthropic公式ドキュメントでは「文脈として読み込まれる情報」と位置づけられています。

指示が長すぎる・抽象的すぎる場合、Claudeが優先順位をつけられず、守られにくくなります。

改善方法は「1ルール1行」で具体的に書くことです。

「丁寧に書く」ではなく「です・ます調で書く」。
「わかりやすくする」ではなく「専門用語には必ず括弧で説明を添える」。

この粒度で書き換えるだけで、動作が変わります。

守られにくい書き方 守られやすい書き方
丁寧な文体で書く です・ます調で書く
わかりやすく説明する 専門用語には括弧で説明を添える
読者に寄り添う文章にする 導入文は読者の悩みから書き始める
良い記事を書く 見出しごとに結論→理由→具体例の順で書く

失敗②：SKILL.mdと同じものだと思っていた

CLAUDE.mdとSKILL.mdは役割が異なります。

CLAUDE.mdは、プロジェクト全体に適用されるルールや方針を定義するファイルです。

一方で、SKILL.mdは特定タスクの手順を定義するファイルです。

この違いを理解せずに設定すると、管理が煩雑になります。

例えば、SEO記事のルールをSKILL.mdに入れると、実行のたびに手動で呼び出す必要があり、効率が下がります。

そのため、常に守らせたいルールはCLAUDE.md、タスクごとの処理はSKILL.mdに分けることが重要です。

失敗③：詳しく書けば書くほど良いと思っていた

長さは、精度ではありません。

CLAUDE.mdは長くなるほど逆効果です。

セッション開始時にコンテキストへ読み込まれるため、行数が増えるほどトークンを消費し、Claudeが指示を処理しにくくなります。

設定後に「指示の通りに動かない」と感じたら、まずCLAUDE.mdの行数を確認します。

200行を超えている場合は、重複ルールの削除と.claude/rules/への分割で改善できます。

初期設定を50行以内に抑えることを推奨しています。

ジワリジワリと堅実に進めることがおすすめです。

Claude Codeの料金と使い方の全体像も確認しておこう

設定の前に、確認すべきことがあります。

CLAUDE.mdを設定してClaudeを効率よく使うためには、Claude Code自体のプラン・料金の理解も必要です。

無料枠の範囲・Proプランの違いによって、使えるコンテキスト量や実行回数が変わります。

Claude Codeの料金まとめ｜無料枠・Proの違いと安く使う方法

まとめ｜まずはCLAUDE.mdを1つ作る

難しく考えなくて大丈夫です。

まずはプロジェクト直下にCLAUDE.mdを1つ作りましょう。

  • 全体ルール → CLAUDE.md
  • 個別タスク → SKILL.md
  • 補助情報 → 自動メモリ

最初は50行以内でOK。動かしながら改善していくのが正解です。