CLAUDE.mdでプロジェクトの前提を伝える

CLAUDE.md は、Claude Code が 会話の開始のたびに読む、プロジェクトの説明書 です。コードを読むだけでは分からないルールや、使うコマンドを書いておくと、毎回説明しなくて済みます。

作り方

プロジェクトのフォルダで claude を起動し、次を実行します。

/init

プロジェクトの構成を調べて、CLAUDE.md のひな形を作ってくれます。作られたあと、自分で読んで、手直し します。

書くこと・書かないこと

短く、読みやすく書くのがコツです。長すぎると、Claude Code が大事なルールを見落とします。

書く	書かない
コードを読んでも分からないコマンド(ビルド、テストなど)	コードを読めば分かること
標準とは違う書き方のルール	その言語の一般的なルール
ブランチ名やコミットメッセージの決まり	変わりやすい情報
開発環境で気をつけること(必要な環境変数など)	長い説明やチュートリアル
ハマりやすい点	「きれいなコードを書く」のような当たり前のこと

1行ごとに、「これを消したら、Claude Code が間違えるか?」と考えます。間違えないなら、消します。

例

このガイドのような、WSL上でWebサイトを作るプロジェクトの例です。

# プロジェクトの概要
学習記録を載せる静的サイト(Astro)。

# コマンド
- 開発サーバー: `npm run dev`
- 公開用ビルド: `npm run build`(`dist/` に出力される)

# ルール
- 記事は `src/content/` の下にMarkdownで書く
- 返答と、記事の文章は日本語で書く
- ファイルやフォルダは、確認なしで削除しない
- `dist/` と `node_modules/` は編集しない

# 作業の進め方
- 変更したら、`npm run build` が通ることを確認する
- コミットメッセージは日本語で、何をしたかを1行で書く

置き場所

場所	用途
プロジェクトのフォルダの CLAUDE.md	そのプロジェクトだけのルール。Gitに入れて、チームで共有できる
~/.claude/CLAUDE.md	すべてのプロジェクトに共通する、自分の好み

育て方

• Claude Code が同じ間違いを繰り返したら、そのルールを CLAUDE.md に1行足す
• 聞いたことを、Claude Code が無視するようなら、CLAUDE.md が長すぎないか見直す
• 大事な1行だけに「IMPORTANT」などの強調を付ける(多用すると目立たなくなります)

確認する

• /init で、CLAUDE.md が作られた
• 自分で読み直し、不要な行を消した
• claude を起動し直して、ルールが守られているか確認した

参考

• ベストプラクティス:CLAUDE.mdを書く(公式)