非エンジニアのためのClaude Code・AI活用メディア運営:株式会社GORO
基本とほかのAIとの違い業務での使い方会社での導入Web制作とAI運営者情報

> 業務での使い方

CLAUDE.mdの書き方とは?非エンジニアが最初に書くべき内容と注意点を解説

公開2026.10.06更新2026.10.11読了目安13分個人向け

執筆:株式会社GORO編集部/運営:旭 俊成(株式会社GORO 代表)

CLAUDE.mdの書き方とは?非エンジニアが最初に書くべき内容と注意点を解説

この記事でわかること

  • CLAUDE.mdの正しい置き場所と読み込まれ方
  • 書くべき内容と書かないほうがいい内容の区別
  • 長すぎるCLAUDE.mdが引き起こす問題と目安
目次閉じる開く
  1. 01CLAUDE.mdはどこに作る?正しい配置と読み込まれるタイミング
  2. 02CLAUDE.mdに何を書けばいい?書くべき内容と書かないほうがいい内容
  3. 03CLAUDE.mdは短く保つ:長すぎると起きること
  4. 04機密情報や顧客データはどう守る?CLAUDE.mdだけに頼らない制御
  5. 05書いたあとの運用はどうする?チャットの外に記録を残す考え方
  6. 06最初は何から書く?研修で絞った2つのポイント

Claude Codeを使い始めてすぐに「CLAUDE.md」という単語を目にしたものの、どこに置き、何を書けばいいのか分からず手が止まっていませんか。じつはCLAUDE.mdには、公式ドキュメントが示す明確な配置場所と書き方の基本があります。ただし、書けば書くほど良いわけではありません。公式のベストプラクティスも、肥大化したCLAUDE.mdは書いた指示を無視される原因になると警告しています。社内の業務ルールを安全にAIへ覚えさせたいなら、まず「どこに」「何を」書くかを押さえましょう。ここでは公式の推奨ルールと、非エンジニアの研修で実際に参加者がつまずいた点、機密情報の扱い方までをあわせて解説します。

CLAUDE.mdはどこに作る?正しい配置と読み込まれるタイミング

CLAUDE.mdの正式な置き場所は2つです。プロジェクトのフォルダ直下(./CLAUDE.md)か、.claudeフォルダの中(./.claude/CLAUDE.md)のどちらかです。どちらに置いても、Claude Codeは会話を始めるたびに自動で読み込みます。

正式な置き場所は./CLAUDE.mdまたは./.claude/CLAUDE.md

How Claude remembers your projectは、この2つの場所を正式な配置として明記しています。

置き場所特徴
./CLAUDE.mdプロジェクトのフォルダ直下に置く、最も基本的な形
./.claude/CLAUDE.md.claudeフォルダの中にまとめて置く形

どちらを選んでも、読み込まれる仕組みに違いはありません。見た目の整理のしやすさで選べば十分です。

会話のたびに自動で読み込まれる仕組み

CLAUDE.mdは、Claude Codeが会話を始めるたびに読み込む特別なファイルです。Using CLAUDE.MD filesは、CLAUDE.mdの内容がClaudeのシステムプロンプトの一部になり、毎回の会話にあらかじめ読み込まれると説明しています。会話を始めた時点で、業務のルールや背景がすでに前提として組み込まれる仕組みです。毎回ゼロから説明し直す手間がなくなります。

プロジェクトルートを汚したくないときの代替案

フォルダの直下に置きたくない場合は、.claude/CLAUDE.mdを使う方法があります。Explore the .claude directoryは、プロジェクトルートを汚したくない場合の代替手段として、この置き場所を案内しています。

ある企業向け研修では、参加者から実際にこうした声が上がりました。「ルールを書くファイル(CLAUDE.md)を作りたいが、どこにあるのか分からない」「自分たちに合ったフォルダ構成の正解が分からない」。インストールの次の段階で、多くの人が同じところで止まります。

この研修の様子はClaude Code未経験だった全部門5名が、4時間の研修から1ヶ月後も毎日使い続けている事例で紹介しています。フォルダの切り方そのものはClaude Codeのフォルダ構成とは?非エンジニアが業務記録を活かす置き方を解説で扱います。

CLAUDE.mdに何を書けばいい?書くべき内容と書かないほうがいい内容

正しい場所に置けたら、次に迷うのが中身です。Best practices for Claude Codeは、書くべき内容と書かないほうがいい内容を表で示しています。ここでは、この基準を非エンジニアの業務に当てはめて整理します。

毎回説明し直したくなることを書く

How Claude remembers your projectは、CLAUDE.mdを「説明し直す手間を省く場所」として扱うよう案内しています。業務であれば、次のような内容が該当します。

書くべき内容の例具体例
資料のフォーマット提案書は見出し→結論→根拠の順で書く、など
社内特有の用語の定義「稟議」は部長決裁まで、「本申請」は役員決裁まで、など
進め方のルール会議の議事録は当日中に共有フォルダへ置く、など
禁止事項顧客名は仮名で記録する、など

これらは一度ファイルに書いてしまえば、毎回チャットの冒頭で説明する必要がなくなります。Using CLAUDE.MD filesも、会話のたびに基本情報が読み込まれ、繰り返しの説明が不要になると説明しています。

コードを読めば分かること・頻繁に変わる情報は書かない

Best practices for Claude Codeは、「コードを読めば分かること」と「頻繁に変わる情報」の2つを書かない対象として明示しています。業務文脈に置き換えると、次のようになります。

  • 資料やフォルダを開けば分かる内容(ファイル名の一覧、最新の数値など)
  • 日々変わる情報(今月の担当者名、直近の締切日、進行中の案件名など)

これらをCLAUDE.mdに書き込むと、情報が古くなった時に実態とずれます。ずれたルールが残ったまま読み込まれ続けると、かえって誤った前提で動く原因になります。資料やフォルダの中身で確認できることは、そちらに任せたほうが安全です。

同じ間違いを繰り返した時に追記するという考え方

CLAUDE.mdを最初から完璧に仕上げる必要はありません。How Claude remembers your projectは、同じ間違いが繰り返された時や、同じ説明を2度した時に追記すべきだと具体的に案内しています。

つまり、使いながら育てるファイルという位置づけです。最初の数行から始めて、実際に困った場面が出てきたらその都度書き足していく進め方が、公式の案内に沿った方法です。許可の出し方やアクセス制御の決め方はClaude Codeの設定、最初に何を決める?非エンジニアが知るべき許可の出し方と置き場所で扱います。

CLAUDE.mdは短く保つ:長すぎると起きること

使いながら育てていくファイルだとしても、際限なく膨らませていいわけではありません。公式のドキュメントは、CLAUDE.mdの分量そのものについても具体的な目安を示しています。

公式が推奨する目安は200行未満

Explore the .claude directoryは、CLAUDE.mdの目安を200行未満と明記しています。200行を超えても、ファイル自体は全文読み込まれます。ただし、指示への追従度が下がる可能性があるとしています。

200行という数字は、コードの行数に慣れた感覚だと多く感じるかもしれません。資料のフォーマットや用語の定義、進め方のルールを箇条書きで並べていくと、意外と早い段階でこの行数に近づきます。

長すぎるファイルで指示が埋もれて無視され始める

なぜ行数の目安が重要なのか。Best practices for Claude Codeは、肥大化したCLAUDE.mdが実際の指示を無視させると警告しています。

書いたルールが多くなるほど、どの指示を優先すべきか判断する手がかりが薄まります。結果として、せっかく書いた禁止事項や進め方のルールが読み飛ばされる状況が起こり得ます。情報を足せば足すほど安全になるわけではなく、むしろ逆の結果を招く場合があるという点に注意が必要です。

憲法のように最小限にとどめるという考え方

この公式の警告を踏まえて、研修ではどういう方針を取ったのか。全部門の受講者を対象にしたある研修では、ルールを書くファイルは短く保つという方針を決めました。

実録支援先の声(GOROの事例より)

ルールを書くファイルは短く保つ

ルールを書くファイルは短く保つ:CLAUDE.mdは長くするほど毎回の読み込み量が増えます。憲法のように最小限にとどめます。

出典:Claude Code未経験だった全部門5名が、4時間の研修から1ヶ月後も毎日使い続けている事例(GOROの事例記事)

公式が示す200行未満という目安と、この研修で決めた最小限にとどめる方針は、同じ方向を向いています。思いついたルールを次々と書き足すのではなく、本当に毎回必要な項目だけを残す進め方です。

項目を増やしたくなったときは、前述の「同じ間違いを繰り返した時に追記する」という基準に立ち返り、実際に困った場面があったかどうかで判断します。困っていない項目まで先回りして書き込むと、行数だけが増えて指示の優先度は下がっていきます。

機密情報や顧客データはどう守る?CLAUDE.mdだけに頼らない制御

文量を絞ったCLAUDE.mdでも、書き方次第で機密情報を守れると考えたくなります。ただし公式ドキュメントは、CLAUDE.mdの指示だけでは不十分だと明確に区別しています。

CLAUDE.mdの指示はあくまで『試みる内容』を形作るだけ

Configure permissionsは、プロンプトやCLAUDE.mdの指示がClaudeの「試みる内容」を形作るだけだと説明しています。実際に許可するかどうかは、別の仕組みが判断します。

つまり、CLAUDE.mdに「このフォルダは見ない」と書いても、それは依頼にすぎません。Claudeが指示に従おうとする前提は保てますが、強制力を持つ仕組みではないという点を押さえておく必要があります。

実際のアクセス制御はsettings.jsonの拒否ルールで行う

強制力を持たせたい場合、Configure permissionsはsettings.jsonの拒否ルールを使うよう案内しています。たとえば特定フォルダの読み取りを拒否する設定は、Read(//Users/alice/secrets/**) のように書きます。

この記述はsettings.jsonの中にdenyルールとして追加します。CLAUDE.mdの依頼文と違い、Claude Code自体が読み取りを止める仕組みです。

ただし万能ではありません。同じドキュメントは、Read・Editの拒否ルールが自前でファイルを読み込むスクリプトなどには及ばないと注意しています。OSの階層で完全に止めたい場合は、サンドボックスという別の仕組みが必要になります。法人導入にあたって設定の全体像を把握したい場合はClaude Codeのセキュリティは大丈夫?法人導入前に知るべき安全性と対策で整理しています。

参照させないフォルダを明記して制御した例

顧客の個人情報や売上データまで渡していいのか、という不安を持つ読者は多いはずです。この懸念に対して実際に行った対処が記録されています。

実録代表・旭の一次体験

顧客情報・個人情報のフォルダを参照させない

無防備には渡しません。CLAUDE.md(AIへの指示書)に「顧客情報・個人情報を持つフォルダからはデータを参照しない」と明記して制御。

出典:スライド作りをClaude Designに任せたら、主役はスライドではなくなった(代表・旭俊成のnote)

前述のとおり、CLAUDE.mdの指示自体は依頼にとどまります。この例の制御を確実にしたい場合、同じ内容をsettings.jsonの拒否ルールにも反映させる組み合わせが、公式の案内に沿った形になります。CLAUDE.mdで方針を示し、settings.jsonで実際の読み取りを止める。この二段構えが、機密情報を扱う際の基本的な考え方です。

書いたあとの運用はどうする?チャットの外に記録を残す考え方

二段構えの制御を整えても、CLAUDE.mdの中身は使いながら更新していく必要があります。公式ドキュメントは、更新のタイミングについても目安を示しています。

同じ説明を2度した時はCLAUDE.mdに追記する

前述のとおり、同じ間違いや同じ説明を繰り返した時が追記のタイミングです。How Claude remembers your projectは、CLAUDE.mdを「本来なら説明し直す内容を書き留める場所」として位置づけています。

この基準は、回数を数える運用にそのまま使えます。1回目の説明は口頭やチャットで済ませ、2回目の依頼で同じ内容を伝えたらCLAUDE.mdに書き足す。こうした簡単な判断基準を決めておくと、追記のタイミングで迷わずに済みます。

チャットの履歴に頼らず記録ファイルで引き継ぐ発想

CLAUDE.mdを育てる一方で、チャットのやり取りそのものをどう扱うかという問題も残ります。チャットの履歴は検索しづらく、別のチャットを立ち上げると前提が引き継がれません。

この問題に対して、チャットの外に記録を残す方法を試した記録があります。

実録代表・旭の一次体験

チャットの外に記録を残す

チャットの外にコンテキストを貯める場所も作りました。CLAUDE.md、議事録.md、意思決定ログ.mdです。チャットの履歴には頼りません。これらのファイルを読み返せば、会話を再開できます。

分断というより、記録を介した引き継ぎだと考えています。

出典:Claude Code 重いときの原因と対策。文字も消える不具合と、再発させない運用ルール(代表・旭俊成のnote)

CLAUDE.mdが業務のルールを扱う場所だとすれば、議事録.mdは会話の記録、意思決定ログ.mdは判断の経緯を残す場所です。役割を分けておくと、どのファイルに何を書くか迷いにくくなります。

チャットを閉じても、前提や決定事項はファイルの中に残ります。次に作業を再開する時は、記録ファイルを読み返すところから始められます。

最初は何から書く?研修で絞った2つのポイント

記録ファイルの役割分担まで整理できたら、残る疑問は着手の順番です。CLAUDE.mdに書く内容は多岐にわたるため、最初から全部を揃えようとすると手が止まります。

Claude Code活用で押さえる4つの基本

GOROのClaude Code研修では、使い始めるときに押さえることを4つに整理しています。

順番押さえること
1フォルダを決める
2ルールをファイルに書く
3外部のアプリとつなぐ
4手順をスキルにする

4つを並べると、どれも必要に見えます。しかし、ある企業向け研修ではこのうち最初の2つだけに時間を使いました。

最初の2つ(フォルダとルール)に絞った理由

絞った理由は、参加者が実際に詰まっていた箇所と一致させたためです。研修ではフォルダの切り方とルールの書き方に絞って時間を使い、外部連携や手順のスキル化までは扱いませんでした。

これからCLAUDE.mdを書き始める場合も、同じ順番が目安になります。まずフォルダの置き場所を決め、次にそのフォルダを前提にしたルールを数行書く。外部連携や手順のスキル化は、ルールを使いながら困った場面が出てきてから検討する進め方でも間に合います。最初の2つに絞ることで、書く量を抑えながら実際に使えるCLAUDE.mdに近づけられます。

Claude Codeを自分の業務で試したい方へ

Claude Code マンツーマン講座は、オンラインで1対1で進める回数制の講座です。毎回、受講者の実際の業務を題材にして、作ったものを受講者のPCに残していきます。何回受けるかは、無料相談で業務の内容を伺ってから決めます。チームで導入する場合は、Claude Code法人研修をご覧ください。

運営

旭 俊成 株式会社GORO 代表取締役

株式会社GORO代表。Web支援・UI/UX支援・AI支援の事業を経営しながら、社内の業務と企業研修でClaude Codeを使っています。使ってみて分かったことをnoteで書いています。

記事は株式会社GORO編集部が、AIを使って制作しています。事例は自社の実践と研修の実績にもとづいています。

SERVICE

Claude Codeを、自分の業務で
使えるようになるために

個人向け

Claude Code マンツーマン講座

あなたの実際の業務を題材に、1対1で自動化を作っていくオンライン講座です(回数制)。

講座の内容を見る

法人・チーム向け

Claude Code研修

非エンジニアの部署・チーム向けに、業務に合わせて内容を設計する研修です。menu社・Steve Inc.で実施しました。

研修の内容を見る