Claude Codeを使い始めたころ、毎回同じことを頼んでいました。「私は非エンジニアなので、専門用語を使わないでください」「ファイルを消す前に確認してください」「URLは推測で書かないでください」。

あるとき、作業フォルダに「CLAUDE.md」というファイルを置いておくと、Claude Codeが起動時にそれを読んで、書いてあるルールに従うと知りました。毎回頼んでいたことを、そこに全部書きました。それ以来、頼み忘れて失敗することが減っています。

この記事は、非エンジニアの私がCLAUDE.mdに実際に書いていることと、書き方、育て方です。安全のためのルールそのもの（削除前に確認する、など）は別の記事にまとめる予定なので、ここでは「ファイルとしてどう持つか」を中心に書きます。

CLAUDE.mdとは【自分ルールを書いておくファイル】

CLAUDE.mdは、ただのテキストファイルです。中身は日本語で書いた「お願い」の箇条書きで、プログラムではありません。Claude Codeは、作業を始めるときにこのファイルを読んで、書いてあることを前提に動きます。

たとえば「専門用語を使わないで」と書いておくと、毎回頼まなくても、平易な言葉で説明してくれます。「ファイルを消す前に必ず確認して」と書いておくと、消す前に聞いてきます。

プロンプト（毎回の頼み方）との違いは、プロンプトはその場限り、CLAUDE.mdはずっと有効なことです。頼み方の基本はプロンプトとは?AIへの頼み方のコツ7つ【NG例・OK例つき】に書きましたが、そのうち「毎回言っていること」をCLAUDE.mdに移す、と考えると分かりやすいです。

どこに置くか【フォルダごと・全体】

置き場所は2種類あります。

最初は「作業フォルダの中」だけで十分です。私も最初はブログ用のフォルダに1つ置いただけでした。全体用は、複数のフォルダで同じことを書いていると気づいてから作りました。全体用の正確な置き場所は変わることがあるので、公式のドキュメントで確認してください。

ファイルの作り方は、メモ帳やテキストエディタで新規作成して「CLAUDE.md」という名前で保存するだけです。拡張子が「.md」になっていれば動きます。

私のCLAUDE.mdの中身【5つの章】

私の全体用CLAUDE.mdは、5つの章でできています。長さは全部で40行くらいです。

①私は誰か

「非エンジニアの会社員。プログラムは読めない。専門用語は避けて、平易な日本語で説明して」。これが一番効きます。説明の仕方が変わります。

②絶対にやってはいけないこと

「パスワードやAPIキーをファイルに直接書かない」「家族の名前や住所を含むファイルを作らない」「ファイルの削除・移動は実行前に必ず確認する」。失敗すると取り返しがつかないことを、ここに置きます。

③この作業の決まり（作業フォルダ用）

ブログのフォルダなら、「記事のURLは公開済み一覧のファイルからコピーする。推測で書かない」「本文は書かない。構成案と校正の指摘まで」「公開ボタンは押さない。下書きまで」。その作業で過去に失敗したことが、そのままルールになっています。

④困ったときにどうするか

「この構成でできないと判断したら、無理に別の方法を探さず『できない』と言って止まって」「判断に迷うことは、勝手に決めずに聞いて」。止まってほしい場面を先に書いておくと、暴走が減ります。

⑤私への接し方

「私が気づいていないリスクは、先に指摘して」「ルール違反になりそうなときは、作業を止めて言って」。私が見落とすことを、道具のほうに見ていてもらうためのお願いです。

実際の書き方の例

ブログ作業フォルダに置いているCLAUDE.mdの一部を、そのまま載せます。

見てのとおり、プログラムの知識はどこにも要りません。「#」で始まる行は見出しで、「-」で始まる行は箇条書きです。それだけです。

失敗するたびに1行足す

私のCLAUDE.mdは、最初は5行でした。いまは40行です。増えた行は、全部失敗のあとに足したものです。

• 推測で書いたURLが開かなかった → 「URLは一覧からコピー」
• 本文まで書かれて、それを使ってしまった → 「本文は書かない」
• 「効果を実感した」と見出しに書かれた → 「確かめていない数字や実績を書かない」
• 専門用語だらけの説明が返ってきた → 「非エンジニア。平易な日本語で」

失敗したら、その場で1行足す。次の作業から効きます。「また同じ失敗をした」がなくなるのが、このファイルの一番の価値でした。Claude Codeで実際に起きた失敗はClaude Codeの失敗例5つ|AIに任せてはいけないことに書きましたが、あの記事の失敗の多くは、いまはCLAUDE.mdの1行になっています。

書かないこと

逆に、CLAUDE.mdに書かないと決めていることもあります。

• パスワード・APIキー——「設定ファイルから読む」とは書いても、中身は書きません。CLAUDE.mdはただのテキストなので、誰でも読めます
• その日だけの頼みごと——「今日は記事Xを校正して」は、毎回のプロンプトで言います。CLAUDE.mdは「いつも」のことだけ
• 長い説明——1行で書けないルールは、まだルールになっていません。短く書けるまで待ちます
• 家族の情報——「家族の名前を書かない」というルールは書きますが、名前そのものは当然書きません

渡してはいけない情報と、自分で確かめること

渡してはいけない情報

CLAUDE.mdはClaude Codeが毎回読むファイルなので、ここに書いたものは毎回渡されます。上の「書かないこと」がそのまま当てはまります。特にパスワード類は、「便利だから」と書きたくなる場所ですが、絶対に書きません。

自分で確かめること

CLAUDE.mdに書いたからといって、100%守られるとは限りません。長い作業の途中で、ルールから外れることがあります。だから、大事なルール（削除前の確認、公開しない、URLを推測しない）は、ファイルに書いたうえで、結果も自分で確かめます。ファイルは保険であって、確認の代わりではありません。

よくある質問

Q. 書き方に決まりはありますか?

日本語の箇条書きで動きます。「#」の見出しと「-」の箇条書きだけ覚えれば十分です。きれいに書くより、1行ずつはっきり書くほうが効きます。

Q. 長く書いたほうが効きますか?

逆でした。長いと、大事なルールが埋もれます。私は40行を超えたら、要らなくなった行を消すようにしています。「絶対にやってはいけないこと」は、上のほうに短く置きます。

Q. 効いているか、どうやって分かりますか?

簡単な確認は、Claude Codeに「CLAUDE.mdに何が書いてありますか」と聞くことです。読めていれば内容を答えます。本当に効いているかは、ルールに反することを頼んでみて、止まるかを見るのが確実です。私は「公開して」と頼んで、「公開はしないルールです」と返ってくるのを確かめました。

Q. 会社のパソコンでも使えますか?

ファイルの仕組みは同じですが、会社のパソコンでClaude Codeを使っていいかは、会社のルールが先です。私は会社のパソコンでは使っていません。

Q. 最初の1行は何を書けばいいですか?

「私は非エンジニアです。専門用語を使わず、平易な日本語で説明してください」です。これだけで、返ってくる説明が変わります。あとは失敗するたびに足せば、勝手に育ちます。Claude Codeを入れたばかりの人はClaude CodeをMacに入れるまでに詰まった話【素人の実録】のあとに、この1行から始めてみてください。

CLAUDE.mdを作ってから、Claude Codeへの頼み方が短くなりました。毎回の「非エンジニアなので」「消す前に聞いて」が要らなくなったからです。プログラムが書けなくても、ルールは書けます。それを1つのファイルに置いておくだけで、道具の使い心地は変わりました。