CLAUDE.mdの書き方|Claude Codeに毎回伝えたいことを1つのファイルにまとめる

本記事にはアフィリエイト広告(PR)が含まれています。
CLAUDE.mdの書き方|Claude Codeに毎回伝えたいことを1つのファイルにまとめる

Claude Codeに2回言ったことは、CLAUDE.mdに書けば次から言わなくて済みます。

  • Claude Codeに、同じ説明を毎回打ちこむのが手間
  • CLAUDE.mdが何を書くファイルなのか分からない

そう思っていても大丈夫です。チャットのプロジェクトの指示と同じことを、Claude Codeでするのが CLAUDE.md です。

「返事は日本語で」「ファイルを消す前に聞いて」のような決まりを一度書いておけば、作業を始めるたびに読んでから動いてくれます。

この記事では、CLAUDE.mdに何を書けばいいのかと作り方を、公式ドキュメントの説明を引きながら紹介します。

Claude Codeをまだ開いたことがない人は、先に始め方の記事を読んでおくと、この記事の操作がそのまま試せます。

あわせて読みたい
Claude Codeの始め方|デスクトップアプリで最初の指示を出すまで Claude Codeは、ターミナルを使わなくてもデスクトップアプリで始められます。用意するもの、練習用フォルダの選び方、プランで計画を見てから最初の指示を出し、変更を確かめて受け入れるまでを紹介します。
同じ説明は一度で済みます
この記事でわかること
  • CLAUDE.mdに書くこと・書かないこと
  • 「/init」での作り方と、自分の決まりの足し方
  • 守ってもらいやすい書き方と、スキルとの分け方
目次

CLAUDE.mdは毎回読むメモ、書くのは2回目の説明をしたこと

CLAUDE.md(クロード・エムディー)は、作業するフォルダの中に置く文字だけのファイルです。最後の「.md」はマークダウンという書き方のファイルという意味で、見出しや箇条書きを記号で書けます。

CLAUDE.md ファイルは、プロジェクト、個人のワークフロー、または組織全体に対して Claude に永続的な指示を与えるマークダウンファイルです。これらのファイルはプレーンテキストで記述し、Claude はすべてのセッションの開始時にそれらを読みます。

出典:Claude Code ドキュメント「Claude があなたのプロジェクトを記憶する方法」(2026年11月時点)

セッションは、Claude Codeで新しく作業を始めてから終わるまでの1回分のことです。CLAUDE.mdがなくてもClaude Codeは使えるので、毎回の説明を減らしたくなったら作る、くらいで大丈夫です。

置き場所は、作業するフォルダのいちばん上です。

書き足すタイミングは、公式でこう説明されています。

CLAUDE.md を、そうでなければ何度も説明し直すことになる内容を記述する場所として扱ってください。以下の場合に追加してください。

  • Claude が同じ間違いを 2 回目に犯した場合
  • コードレビューで Claude がこのコードベースについて知っておくべきだったことが指摘された場合
  • 前回のセッションで入力した同じ修正または説明をチャットに再度入力する場合
  • 新しいチームメンバーが生産性を高めるために同じコンテキストが必要な場合
出典:Claude Code ドキュメント「Claude があなたのプロジェクトを記憶する方法」(2026年11月時点)

コードレビューは作ったものを人がチェックすること、コードベースは作っているもののファイル全体のこと、コンテキストは前もって知っておいてほしい事情のことです。

むずかしく考えず、「これ前にも言ったな」と思ったら書き足す、くらいで十分です。

CLAUDE.mdに書くこと(毎回守ってほしい決まり、使う言葉や色、ファイルの置き場所)と書かないこと(その日だけの頼みごと、長い手順、パスワード)

反対に、その日だけの頼みごと・何段階もある長い手順・パスワードのように人に見られて困るものは、書かないほうがいいです。長い手順の置き場所は、このあと説明します。

最初の1枚は、「/init」と送れば下書きを作ってくれる

白紙から書くのが大変なら、Codeの画面の入力欄に「/init」と送ってみてください。

/init を実行して、開始用の CLAUDE.md を自動的に生成します。Claude はコードベースを分析し、発見したビルドコマンド、テスト指示、プロジェクト規約を含むファイルを作成します。CLAUDE.md が既に存在する場合、/init は上書きするのではなく改善を提案します。

出典:Claude Code ドキュメント「Claude があなたのプロジェクトを記憶する方法」(2026年11月時点)

フォルダの中のファイルを読んで、何を作っているフォルダなのか・どこに何があるのかを下書きしてくれます。すでにCLAUDE.mdがあっても消されず、直したほうがいい所を提案してくれる形です。

「/init 日本語で」のように後ろに一言足すと、日本語で書いてもらいやすくなります。

Claude Codeで「/init 日本語で」と送ると、フォルダが空なのでひな形を作るか聞いてくる画面

まだ何も入っていないフォルダで送ると、読む材料がないので、ひな形だけ作るかどうかを聞いてくれます。ひな形を選ぶと、見出しだけのCLAUDE.mdができます。

/initで作ったCLAUDE.mdのひな形。見出しだけで、このプロジェクト固有の決まりの欄は未記入

ただ、フォルダを読んだだけでは、あなたの好みまでは分かりません。下書きができたら、「このプロジェクト固有の決まり」のような所に、「返事は日本語で」のような自分の決まりを足していきます。足し方は次の2つです。

  1. Claude Codeに頼む:足したい決まりと「CLAUDE.mdに追加して」を送る。書き換えの前に確認が出るので、中身を見てから許可する
  2. 自分で書く:CLAUDE.mdは文字だけのファイルなので、フォルダの中のCLAUDE.mdをメモ帳などで開いて1行足し、保存する

Claude Codeに頼むなら、たとえば次のように送ります。

「ファイルを消す前に、
必ず聞いてから消す」を、
CLAUDE.mdに追加して

「覚えておいて」とだけ頼むと、CLAUDE.mdには書かれないことがあるので、「CLAUDE.mdに追加して」とはっきり書くのがコツです。

守ってもらうには、具体的に短く、見出しと箇条書きで書く

CLAUDE.mdは書いたとおりに必ず動く設定ではなく、Claudeが読んで参考にするメモです。だから書き方しだいで、守ってもらえる度合いが変わります。

公式では、確かめられるくらい具体的に書くようすすめています。

検証可能なほど具体的な指示を書いてください。

出典:Claude Code ドキュメント「Claude があなたのプロジェクトを記憶する方法」(2026年11月時点)

「検証可能」は、できたかどうかをあとで確かめられる、という意味です。たとえば次のように書きかえます。

  • 「見やすくして」ではなく「文字の大きさは16px以上にする」
  • 「いい感じの色で」ではなく「使う色はベージュとミントの2色だけ」
  • 「ちゃんと整理して」ではなく「画像はimagesフォルダに入れる」

長さは、200行くらいまでにおさめます。

CLAUDE.md ファイルあたり 200 行以下を目標にしてください。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。

出典:Claude Code ドキュメント「Claude があなたのプロジェクトを記憶する方法」(2026年11月時点)

長く書くほど、1つ1つの決まりが守られにくくなるということです。前の記事で作った売上グラフのページなら、たとえば次のくらいで十分です。

「#」で始まる行が見出し、「-」で始まる行が箇条書きです。

# このフォルダについて
- 毎月の売上を入れると
  グラフが出るページを作っている

# 決まり
- 返事は日本語で、
  専門用語には一言説明をつける
- ファイルを消す前に必ず聞く
- 文字の大きさは16px以上
- 使う色はベージュとミントの2色

# ファイルの場所
- ページは index.html
- 画像は images フォルダ

決まりどうしが食い違っていると、Claudeがどちらか一方を選んでしまうことがあるので、ときどき読み返して古い決まりを消しておきます。

手順が長いものはスキルに分ける

「記事を書いたら画像を作って下書きに保存して…」のような何段階もある手順は、CLAUDE.mdではなくスキルに分けるようにと公式でも書かれています。

すべてのセッションで Claude が保持すべき事実に限定してください。ビルドコマンド、規約、プロジェクトレイアウト、「常に X を実行する」ルールなどです。エントリが複数ステップの手順である場合、またはコードベースの 1 つの部分にのみ関連する場合は、代わりにスキルまたはパススコープ付きルールに移動してください。

出典:Claude Code ドキュメント「Claude があなたのプロジェクトを記憶する方法」(2026年11月時点)

CLAUDE.mdは毎回まるごと読まれるので、たまにしか使わない手順は分けておきます。分け方の目安は次のとおりです。

  • CLAUDE.md:いつでも守ってほしい短い決まりや、フォルダの中の場所
  • スキル:決まった作業をするときにだけ使う、何段階もある手順

2つを組み合わせると、ふだんの決まりはCLAUDE.mdで守ってもらいつつ、決まった作業はスキルの手順どおりに進めてもらえます。スキルの作り方は、こちらの記事で紹介しています。

あわせて読みたい
Claudeのスキルとは?毎回のコピペ指示をなくす「作業手順書」の仕組み Claudeのスキルは、毎回コピペしていた指示をしまっておける手順書です。プロジェクトやカスタム指示との違い、使い始める3ステップ、小さく作って育てるコツを、公式ヘルプの説明とあわせて紹介します。

チャットでいつも使っている「プロジェクト」の指示とも、置き場所が違います。プロジェクトの指示はチャットのプロジェクトの中で、CLAUDE.mdはClaude Codeで開いたフォルダの中で使われます。

両方を使うなら、それぞれに書いておきます。

まとめ

  • CLAUDE.mdは、Claude Codeが作業を始めるたびに最初に読む、フォルダの中のメモ
  • 「これ前にも言ったな」と思ったことを書き足していく
  • 最初の1枚は「/init」で下書きを作り、足したい決まりは「CLAUDE.mdに追加して」と頼む
  • 確かめられるくらい具体的に、200行くらいまでで、見出しと箇条書きで書く
  • 何段階もある手順はスキルに分ける

まずは、今日Claude Codeに2回言ったことを1つ、CLAUDE.mdに書いてみてください。

次の記事では、Claudeを使って収入につなげるときの全体像を紹介します。

あわせて読みたい
Claudeで稼ぐ方法まとめ|現実的な6つの使い方と「楽して稼げる」の落とし穴 Claudeはお金を生んでくれませんが、稼ぐための作業は早くしてくれます。現実的な6つの稼ぎ方と、任せる所・自分で決める所・気をつけること、「楽して稼げる」話の落とし穴と最初の1つの選び方を紹介します。
よかったらシェアしてね!
  • URLをコピーしました!

コメント

コメントする

目次