CLAUDE.md でルールを覚えさせる(/init・/memory)

CLAUDE.md は、Claude Code が会話を始めるたびに読む、指示を書いておくファイルです。この記事では、/init で CLAUDE.md を作り、/memory で確かめる手順を、編集部の検証環境の画面で説明します。

CLAUDE.md とは

Claude Code には、会話をまたいで知識を持ち越すしくみが 2 つあります。

どちらも、会話を始めるたびに読み込まれます。Claude が同じ間違いを 2 回したら CLAUDE.md に書く、というのが公式の使い分けの目安です。

置く場所で、効く範囲が変わる

CLAUDE.md は、置く場所によって効く範囲が変わります。

このほかに、組織の IT 部門が管理する場所もあります。起動したフォルダとその上の階層にある CLAUDE.md は、起動したときに読み込まれます。下の階層のフォルダにあるものは、Claude がそのフォルダのファイルを扱うときに読み込まれます。複数あるときは、上書きではなく、つなげて読まれます。

/init で CLAUDE.md を作る

/init は、プロジェクトのファイルを調べて、CLAUDE.md を作るコマンドです。すでに CLAUDE.md があるときは、上書きせずに、よくするための案を出します。

編集部では、やることリストのアプリ(todo-app)のフォルダで /init を使いました。

できた CLAUDE.md の中身

編集部の環境でできた CLAUDE.md です(1 行目の「# CLAUDE.md」という見出しは省いています)。

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 概要

ブラウザで動くシンプルなやることリスト。素の HTML / CSS / JavaScript だけでできていて、ビルド、パッケージ管理（package.json）、テスト、リンターはない。

## 実行・確認

- `index.html` をブラウザで直接開けば動く（サーバーは不要）。
- 動作確認はブラウザで手作業で行う。自動テストはない。
- JS の文法チェックだけなら `node --check app.js`。

## 構成

- `index.html`：画面の骨組み。`app.js` が使う要素の id（`form`, `input`, `list`, `count`）はここで定義している。id を変えるときは両方のファイルを直す。
- `app.js`：処理はすべてこのファイルにある。
  - 状態は配列 `todos`（`{ text, done }` の並び）だけ。
  - 変更したら必ず `save()`（localStorage のキー `"todos"` に JSON で保存）→ `render()`（リストを全部作り直す）の順に呼ぶ。
  - 各項目のイベント処理は、配列の添字 `i` で `todos` を指す。描画のたびに作り直しているので、添字がずれることはない。
- `style.css`：完了した項目は `li.done` クラスで取り消し線を付ける。`li > label > (checkbox + テキスト)`, `button` という DOM 構造を前提にしている。

## 守ること

- 入力した文字を表示するときは `innerHTML` を使わず、`textContent` やテキストノードで入れる（HTML として解釈させない）。
- 項目は前後の空白を取り除いてから追加し、空なら追加しない。
- localStorage の保存形式を変えるときは、すでに保存されているデータが読み込めなくならないよう注意する。
- 画面の文言とコードのコメントは日本語で書く。

「概要」「実行・確認」「構成」「守ること」の 4 つに分かれています。「守ること」の最初の 2 つが、直した不具合から作られたルールです。

/init で作った CLAUDE.md は、使う前に一度読んで確かめます。公式の書き方の目安は次のとおりです。

• 1 つのファイルは 200 行未満にする
• 具体的に書く(「きちんと整形する」ではなく「字下げは空白 2 つ」のように)
• 見出しと箇条書きで整理する
• 食い違うルールを残さない

/memory で確かめる・直す

/memory と入力すると、Memory の画面が開きます。

• ①Auto-memory: auto memory を使うかどうかです。編集部の環境では true(使う)でした。
• ②Project instructions・User instructions: プロジェクトの CLAUDE.md(./CLAUDE.md)と、自分用の CLAUDE.md(~/.claude/CLAUDE.md)です。選んで Enter を押すと、そのファイルを編集できます。ファイルがなければ作られます。
• ③Open auto-memory folder: auto memory の保存先のフォルダを開きます。

何もせずに閉じるときは Esc を押します。どの CLAUDE.md が読み込まれているかは、/context の「Memory files」でも確かめられます。

ルールを足すときは、頼むか /memory で(「#」は使えません)

以前の Claude Code には、入力の先頭に「#」を付けてメモを足す方法がありました。この方法は、v2.0.70(2025年12月)でなくなりました。いまは、入力の先頭の「#」に特別な働きはありません。

ルールを足すときは、次のどちらかを使います。

• Claude に頼む: 「〜を CLAUDE.md に追加してください」と頼むと、Claude が CLAUDE.md を書き換えます。
• 自分で書く: /memory から CLAUDE.md を開いて、自分で書き足します。

たとえば、次のように頼みます。

コミットのメッセージは日本語で書く、というルールを CLAUDE.md に追加してください

「覚えておいて」のように頼んだときは、CLAUDE.md ではなく auto memory に保存されます。チームで共有したいルールは、CLAUDE.md に入れるよう頼みます。

次の回では、よく使うコマンドとキー操作をまとめて紹介します。