Claude Code の CLAUDE.md の書き方｜非エンジニアが「止めてほしいこと」を書いている実例

結論から書くと、私の CLAUDE.md の中心は「やってほしいこと」より「止めてほしいこと」です。エンジニアではないので、危ない操作に自分で気づけないからです。

この記事では、非エンジニアの私が CLAUDE.md に実際に書いている内容と、書くときのコツを紹介します。

結論：非エンジニアの CLAUDE.md は「止めてもらうルール」から書く

CLAUDE.md は、Claude Code が作業を始めるときに読む指示書です。ここに書いたことは、毎回の作業で守ってもらえます。

私が書いている内容は、大きく4つに分かれます。

種類	書いていること
自分のこと	エンジニアではないので、ルール違反になりそうなら止めて指摘してほしい
使う道具	使う仕組みを決めておき、それ以外は勧めないでほしい
やらないと決めていること	パスワードをコードに書かない、など
話し方	専門用語を避けて、やさしい言葉で説明してほしい

置き場所は2つ覚えておけば足りる

公式の説明では、CLAUDE.md を置ける場所がいくつか用意されています。非エンジニアなら、まず次の2つを覚えておけば十分です。

• 自分用（すべての作業に効く）：ホームフォルダの .claude の中にある CLAUDE.md
• 作業フォルダ用（そのフォルダだけに効く）：作業フォルダの中の CLAUDE.md

私は、どの作業でも守ってほしいルールを「自分用」に書いています。サイトごとの決まりは、それぞれの作業フォルダに分けています。

私が実際に書いているルール

1. 自分のことを最初に書く

いちばん最初に「私はエンジニアではありません」と書いています。続けて「私が気づかなくても、ルール違反になりそうな時は必ず止めて指摘してください」と頼んでいます。

この一文があると、作業の途中で止まって確認してくれる場面が増えました。

2. 使う道具を決めておく

AIは、頼んでいないのに新しい仕組みを勧めてくることがあります。そこで、使う仕組みをあらかじめ決めて書いています。

「それ以外の方法を使いたいときは、勝手に進めず、専門家に相談するよう伝えて」とも書きました。自分で判断できない選択を、AIに任せきりにしないためです。

3. やらないと決めていることを箇条書きにする

次のような項目を、短い箇条書きで並べています。

• パスワードや合鍵（APIキー）を、プログラムの中に直接書かない
• お客さまの情報や、まだ公開していない情報を保存しない
• 作ったものを、誰でも見られる場所に置かない

「なぜダメか」まで書くと長くなるので、ここは言い切りにしています。

4. 話し方を頼む

「専門用語はなるべく避けて、平易な日本語で説明してください」と書いています。さらに「私が気づいていない危険は、先に教えてください」とも頼みました。

これで、作業の報告が読みやすくなりました。

書くときのコツ

短く、言い切りで書く

長い説明より、短い決まりの方が守られやすいと感じています。1つの項目は1〜2行にしています。

決めたことは日付つきで書き足す

作業の中で新しい決まりができたら、日付をつけて書き足します。あとから「いつ決めたっけ？」と迷わずに済みます。

パスワードそのものは書かない

CLAUDE.md には「パスワードはどこに保管しているか」までしか書きません。パスワードの中身は、決まった保管場所に置いています。

CLAUDE.md を書いてから変わったこと

いちばん変わったのは、危ない操作の前に止まってくれるようになったことです。たとえば、お金に関わる操作や、外に公開する操作の前に確認が入ります。

書いたルールは、私のような非エンジニアにとっての「安全柵」です。この柵があるから、日々の作業を安心して任せられています。

実際にどんな作業を任せているかは、Claude Code の自動化の例にまとめました。WordPress のサイトで任せている例は、SWELL × Claude Code の記事で紹介しています。

まとめ

• 非エンジニアの CLAUDE.md は「止めてほしいこと」から書く
• 置き場所は「自分用」と「作業フォルダ用」の2つを覚えれば足りる
• 自分のこと・使う道具・やらないと決めていること・話し方の4つを書く
• 短く言い切りで書き、決めたことは日付つきで書き足す