AIコーディング実験室

CLAUDE.md の書き方：Claude Code に毎回同じ指示を覚えさせる設定ファイルの実例

公開: 2026-09-19CLAUDE.md設定Claude Code使い方メモリ

Claude Code に「このプロジェクトでは pnpm を使って」「テストは npm test で」「日本語でコメントを書いて」と毎回伝えるのは無駄です。CLAUDE.md に書いておけば、セッションを開くたびに自動で読み込まれます。

CLAUDE.md とは

Claude Code がセッション開始時に読み込む Markdown ファイルです。内容はそのまま「前提」として毎回の指示に含まれます。

置く場所は 3 段階あります。

場所 効く範囲 用途
./CLAUDE.md（プロジェクト直下） そのプロジェクト ビルド・テストのコマンド、規約、構成
./CLAUDE.local.md そのプロジェクト、git に入れない 個人の好み、ローカルのパス
~/.claude/CLAUDE.md 全プロジェクト 言語、応答スタイル、常に守る約束

サブディレクトリに置いた CLAUDE.md は、そのディレクトリのファイルを扱うときに読まれます。

/init で生成する

プロジェクトで claude を起動して /init と打つと、コードベースを見て CLAUDE.md のたたき台を作ってくれます。まずこれで作り、足りない部分を追記するのが早いです。

書くべきこと

1. コマンド

Claude が毎回探さなくて済むように、確実に動くコマンドを書きます。

## コマンド
- 開発サーバー: `npm run dev`
- テスト: `npm test`（単体）、`npm run test:e2e`（E2E）
- Lint: `npm run lint`
- ビルド: `npm run build`

2. 構成と役割

## 構成
- `src/pages/` Astro のページ。ファイル名がそのまま URL
- `src/content/articles/` 記事。frontmatter は content.config.ts のスキーマに従う
- `src/data/*.json` ツールの定数。料金改定時はここだけ直す

3. 守ってほしい規約

## 規約
- コメントとコミットメッセージは日本語
- 外部リンクには rel="noopener" を付ける
- アフィリエイトリンクは AffiliateLink コンポーネント経由（rel="sponsored nofollow" が付く）
- 記事の数値には確認日を添える

4. やってほしくないこと

## 禁止
- `git push` は人が行う。Claude は commit まで
- `node_modules/` と `dist/` は編集しない
- 料金の数値を推測で書かない。不明なら「要確認」と書く

書かない方がよいこと

  • コードで分かること: ファイル一覧、関数の説明。古くなるだけ
  • 一般論: 「きれいなコードを書いて」。効かない
  • 機密: API キー、パスワード。CLAUDE.md は会話に含まれる
  • 長い説明: 100 行を超えたら削る。重要な指示ほど短く上に

テンプレート

# プロジェクト名

一言で何のリポジトリか。

## コマンド
- dev: 
- test: 
- build: 

## 構成
- 

## 規約
- 

## 禁止
-

効果を確かめる

書いた指示が効いているかは、セッションを新しく開いて、CLAUDE.md に書いた内容に反する指示をわざと出してみると分かります。「テストは pytest で」と書いてあるのに「テスト実行して」で pytest が呼ばれれば効いています。

私の CLAUDE.md

（執筆中）

まとめ

  • CLAUDE.md は「毎回言わなくて済む前提」を置く場所
  • プロジェクト直下・ローカル・ユーザーの 3 段階
  • /init でたたき台を作り、コマンド・構成・規約・禁止を追記
  • 短く、判断に必要なことだけ。機密は書かない

よくある質問

Q. CLAUDE.md はどこに置きますか？

プロジェクトのルート（git のトップ）に置くのが基本です。ユーザー全体に効かせたい内容は ~/.claude/CLAUDE.md に置きます。

Q. CLAUDE.md が長いと問題がありますか？

毎回の会話に含まれるため、長いほどトークンを消費し、重要な指示が埋もれます。100 行以内を目安に、判断に必要なことだけ書きます。

Q. /init で自動生成したものをそのまま使ってよいですか？

たたき台としては十分ですが、ビルドやテストのコマンド、守ってほしい規約は自分で追記した方が精度が上がります。

検証環境: Windows 11 Pro / Claude Code CLI / 2026-09-19 時点。料金や仕様は変更されることがあるため、最新情報は公式サイトで確認してください。

関連記事