はじめに

Claude Code を学習に使い始めた方からよく聞く悩みが「毎回同じ説明をAIにしている」「自分の弱点をAIが覚えてくれない」というものです。

このモヤモヤの解決策は、ほとんどの場合 CLAUDE.md に集約されます。CLAUDE.md は Claude Code がリポジトリを読むときに最初に参照するルールファイルで、ここに「自分流」を蓄積していくと、AI出力の精度がじわじわ伸びます。

本記事では、学習者向けに CLAUDE.md を育てるパターンを5つ に絞って紹介します。Next.js + TypeScript の学習リポジトリを想定していますが、他言語でも応用可能です。

パターン1: 「説明を求めるトーン」を固定する

学習中の方が最初に書くべきルールは、AI の口調制御です。

# CLAUDE.md

## 学習中の振る舞い

- コード変更後、必ず「なぜこの設計にしたか」を3行以内で説明する
- 既存コードを読み解くときは、**先に処理の流れを箇条書きで** 出してから手を動かす
- 用語が出てきたら、初出のときだけ「（〇〇とは△△のこと）」と1行注記する

これだけで、AIが「黙ってコードを書く家庭教師」から「説明する家庭教師」に切り替わります。

パターン2: 「禁止事項」を貯めていく

学習が進むほど、AIに「やってほしくないこと」が増えていきます。失敗するたびに CLAUDE.md に1行追記してください。

## やらないでほしいこと

- `any` 型の使用（型を逃げない）
- `try/catch` で例外を握り潰す（必ずどう処理するか書く）
- `data` / `result` / `temp` の変数名（ドメイン語彙を使う）
- README の置き換え（追記のみ、過去の自分の記録を消さない）

ポイントは 「なぜ禁止か」を1行添えない こと。学習用なら理由を書きすぎず、まずルールとして守らせる方が効きます。

パターン3: 「自分の弱点プロファイル」を持つ

学習者ごとに「ここで詰まりやすい」というクセがあります。それを CLAUDE.md に正直に書きます。

## 学習者プロファイル

- 非同期処理（Promise / async）が苦手
  → 出てきたら「なぜここで await が必要か」を必ず説明する
- 型エラーが出ると先にコードを変えがち
  → 必ず先に「型がどうあるべきか」を聞いてから直す
- バックエンドより画面側に強い
  → API 呼び出し時は内部実装より外形契約から説明する

「弱点を AI に開示する」というのは恥ずかしいですが、家庭教師に弱点を伝えないと授業が最適化されない のと同じです。

パターン4: 「セッション完了の儀式」を決める

セッションを終えるときに、AI に対して何をやらせるかをルール化します。

## セッション終了時にAIにやってほしいこと

1. 今日学んだ概念を3つ箇条書きで挙げる
2. 来週の自分が忘れそうな点を1つ、`docs/learner-notes.md` に追記する
3. 質問が3つ未満で終わった場合は「どんな質問が出てもよかったか」を提案する

これを書いておくと、Claude Code が 学習者の代わりに振り返り作業を完結 させます。手作業で振り返るより質も継続性も上がります。

パターン5: 「失敗をルールに昇格」する仕組み

最近、AI コーディングコミュニティで「失敗をチームルールに昇格させる仕組み」というキーワードが流行っています。これは個人学習にもそのまま応用できます。

## 失敗ルール（毎週金曜に追記する）

- 2026-05-02: Tailwind の余白指定を全部 px で書いていた → 必ず `gap-*` / `p-*` / `m-*` で書く
- 2026-05-08: API レスポンスを `as User` でキャストしていた → 必ず zod で検証する

毎週、自分が踏んだ典型的なミスを1〜2個ずつ追記するだけで、3ヶ月後には「自分専用の禁則集」になります。AI がこれを毎回読むため、同じ穴に落ちる頻度がガクッと下がります。

運用の3つのコツ

CLAUDE.md は短く、最初は20行以内 から始める
追記タイミングを固定（週1回・金曜夜など）
不要になったルールは削る（「もう詰まらなくなった」は卒業証）

CLAUDE.md は学習者にとって「自分専用の家庭教師の引き継ぎノート」です。育て方を覚えると、3ヶ月後に同じ AI が違うレベルで応えてくれます。

関連: 教材で手を動かして学ぶ