CLAUDE.mdの書き方・実例テンプレート｜Claude Codeの精度とコストを底上げする

Claude Code を使っていて、「毎回おなじ説明をしている気がする」「プロジェクトの作法を無視した提案が来る」と感じたら、用意すべきなのが CLAUDE.md です。

CLAUDE.md は、Claude Code が毎回自動で読み込む“プロジェクトの指示書”。ここにルールを書いておくと、説明の手間が減り、提案の精度が上がり、結果としてトークン（コスト）の節約にもつながります。

この記事では、CLAUDE.md に何をどう書くかを、コピペで使えるテンプレートつきで解説します。

CLAUDE.md とは：自動で読まれる指示書
なぜ効くのか：精度とコストの両取り
何を書くべきか
実例テンプレート（コピペ可）
運用のコツ
まとめ

CLAUDE.md とは：自動で読まれる指示書

CLAUDE.md は、Claude Code が起動時に自動でコンテキストに読み込むMarkdownファイルです。置き場所は主に3か所。

プロジェクトのルート（./CLAUDE.md）… そのプロジェクト専用のルール
ホーム（~/.claude/CLAUDE.md） … すべてのプロジェクト共通の自分ルール
サブディレクトリ … 特定フォルダだけのローカルルール

ゼロから書かなくても、Claude Code 内で /init を実行すると、リポジトリを読んで叩き台を自動生成してくれます。まずはこれを出発点にするのが楽です。

なぜ効くのか：精度とコストの両取り

CLAUDE.md が効く理由は2つあります。

指示が安定して精度が上がる：プロジェクトの作法（使うライブラリ、命名規則、テスト方法など）を毎回説明しなくても、Claude が前提として踏まえてくれる。
コスト（トークン）の節約：毎回の長い説明や、的外れな提案→やり直しが減る。

ただし注意点もあります。CLAUDE.md は毎ターン読み込まれるので、長すぎると逆にトークンを食います。「簡潔に、効くことだけ」が鉄則です（コストの可視化はccusageの記事も参考に）。

何を書くべきか

盛り込みすぎず、“Claudeが知らないと事故るもの”を優先して書きます。

プロジェクト概要：何を作っているか、技術スタック（言語・フレームワーク）を1〜2行で。
コマンド：ビルド・テスト・lint・起動の具体的なコマンド。これが一番効きます。
コーディング規約：命名規則、フォーマッタ、インデント、使う/使わないライブラリ。
やってほしいこと / やめてほしいこと：「コミット前にtestを通す」「このディレクトリは触らない」など。
ディレクトリ構成の要点：重要なフォルダ・ファイルがどこにあるか。
環境の注意：本番/開発の区別、触ってはいけないリソースなど。

逆に、APIキーやパスワードなどの機密は絶対に書かないでください（CLAUDE.md はリポジトリに入ることが多い＝共有・流出リスク）。

実例テンプレート（コピペ可）

そのまま埋めて使える雛形です。

# プロジェクト概要
- 何を作っているか：（例）社内向けの在庫管理Webアプリ
- 技術スタック：（例）TypeScript / React / Node.js / PostgreSQL

# よく使うコマンド
- 開発サーバ起動：`npm run dev`
- テスト：`npm test`（コミット前に必ず通す）
- Lint/整形：`npm run lint` / `npm run format`
- ビルド：`npm run build`

# コーディング規約
- フォーマッタは Prettier に従う（手動整形しない）
- 命名：変数・関数は camelCase、コンポーネントは PascalCase
- 新しい依存を足す前に、既存で代替できないか確認する

# やってほしいこと / やめてほしいこと
- ✅ 変更後はテストを実行して結果を報告する
- ✅ 既存のコードスタイルに合わせる
- ⛔ `migrations/` 配下は指示なしで触らない
- ⛔ 本番環境向けの操作はしない

# ディレクトリ構成（要点）
- `src/api/` … サーバ側のエンドポイント
- `src/components/` … UIコンポーネント
- `src/lib/` … 共通ユーティリティ

これをベースに、自分のプロジェクトに合わせて削ったり足したりすればOKです。

運用のコツ

まず /init で叩き台を作り、そこから育てる。
使いながら追記する：「また同じ注意をした」と思ったら、それをCLAUDE.mdに1行足す。これが一番効きます。
長くしすぎない：毎ターン読まれるので、効かない記述は消す。簡潔さ＝コスト削減。
グローバルとプロジェクトを使い分け：言語の好み（日本語で答えて等）や個人的な作法は ~/.claude/CLAUDE.md に、プロジェクト固有はリポジトリの CLAUDE.md に。
機密は書かない（再掲）。