はじめに
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 が違うレベルで応えてくれます。
関連: 教材で手を動かして学ぶ
- まず無料で試したい方: 教材の体験版を GitHub で配布中(
git cloneしてすぐ動かせます。CLAUDE.md のサンプルも同梱) → https://github.com/ayies128/next-ai-camp-trial - 全20セッション完全版+メンタリング → https://menta.work/plan/20251
- YouTubeチャンネル → https://www.youtube.com/channel/UC1rXVD9WYsQPQEWZyd-A1KA/