
自分のアプリにCLAUDE.mdを設定してみた【漢字練習アプリ編】
はじめに
以前の記事で紹介した漢字練習アプリ「かんじれんしゅう」に、CLAUDE.mdを設定してみました。
▼ 漢字アプリの記事はこちら
https://note.com/aiwakaruman/n/n883ce2bc53fd
CLAUDE.mdとは、Claude Codeへの「ルールブック」のようなファイルです。プロジェクトに置いておくだけで、毎回説明しなくてもClaude Codeがルールに従って動いてくれるようになります。(詳しくは前回の記事をご覧ください)
今回は、実際のプロジェクトにCLAUDE.mdを設定する流れを、そのまま記録します。
やったこと(全体の流れ)
🔵 ステップ1:グローバル設定を作る(全プロジェクト共通・5分)
🔵 ステップ2:プロジェクト用の設定を作る(kanji-app専用・10分)
🔵 ステップ3:.gitignoreに追加する(個人開発の場合)
たったこれだけです。順番に見ていきましょう。
ステップ1:グローバル設定を作る
まず、すべてのプロジェクトに共通する「自分の好み」を設定します。
ターミナルでこのコマンドを実行:
mkdir -p ~/.claude次に、~/.claude/CLAUDE.md を作成して、以下を書きます:
## Preferences
- Ask before committing to git
- Prefer editing existing files over creating new ones
- Run tests after making changes
- Keep code simple -- no over-engineering
- No unnecessary comments or docstrings
## Workflow
- When something goes sideways, stop and re-plan -- don't keep pushing
- After finishing a task: run typecheck, tests, and lint before calling it done
## Style
- Prefer small, focused functions
- Use early returns over nested conditionalsこれはGitHubで人気のテンプレート(abhishekray07/claude-md-templates)をそのまま使いました。たった15行ですが、効果は大きいです。
特に「Ask before committing to git(コミット前に聞いて)」は、勝手にコミットされるのを防いでくれるので安心感があります。
ステップ2:プロジェクト用の設定を作る
ここが本題です。Claude Codeにプロジェクトの中身を見てもらい、CLAUDE.mdを作ってもらいました。
実際にできたファイルがこちらです:
## Project
kanji-app -- 小学生向けの漢字練習Webアプリ(「かんじれんしゅう」)
## Stack
- React 19, JavaScript (JSX)
- Vite 7, React Router 7 (HashRouter)
- Zustand (状態管理)
- kanjivg-js (漢字の筆順SVG)
- GitHub Pages にデプロイ (base: /kanji-app/)
## Structure
- src/components/kanji/ -- 漢字一覧・詳細表示
- src/components/practice/ -- 書き取り練習
- src/components/quiz/ -- クイズ機能
- src/components/progress/ -- ダッシュボード
- src/components/layout/ -- ナビゲーション等
- src/data/ -- 学年別の漢字データ
- src/stores/ -- Zustand ストア(進捗管理)
- src/utils/ -- 筆順マッチング等のユーティリティ
## Commands
- Dev: `npm run dev`
- Build: `npm run build`
- Lint: `npm run lint`
- Preview: `npm run preview`
## Verification
変更後、以下の順で確認すること:
1. `npm run lint` -- lint エラーを修正
2. `npm run build` -- ビルドが通ることを確認
## Conventions
- CSSは App.css / index.css に集約(CSS Modules不使用)
- ルーティングは HashRouter を使用(GitHub Pages対応)
- 漢字データは src/data/ に学年別で管理
## Don't
- TypeScriptに変換しないで -- このプロジェクトはJSXで統一
- CSS-in-JSやTailwindを導入しないで -- 既存のCSSファイルを使う
- BrowserRouterに変更しないで -- GitHub Pagesでは動かない全部で30行。Claude Codeがプロジェクトの構成を読み取って、自動で作ってくれました。
個人的に「これは効く」と思ったポイント
Don't セクション
一番大事だと思ったのは、最後の「Don't」セクションです。
このプロジェクトはJavaScript(JSX)で書いているのですが、Claude Codeは親切心で「TypeScriptに変換しましょうか?」と提案してくることがあります。
「TypeScriptに変換しないで」と書いておくだけで、余計な提案がなくなります。
同じように「BrowserRouterに変更しないで」も重要です。GitHub Pagesでは HashRouter を使う必要があるのですが、一般的にはBrowserRouterの方が推奨されるため、Claude Codeが切り替えようとすることがあります。
Commands セクション
開発コマンドを書いておくと、Claude Codeが自分でビルドやリントを実行してくれるようになります。
「この変更でビルド通る?」と聞かなくても、変更後に自動で `npm run lint` → `npm run build` を実行して確認してくれます。
ステップ3:.gitignoreに追加する
個人開発の場合、CLAUDE.mdは自分だけのファイルなので、Gitにコミットする必要はありません。
.gitignore に以下を追加します:
# Claude Code
.claude/これで、CLAUDE.mdがGitHubにアップされることはありません。
チーム開発の場合は、逆にコミットしてチームで共有するのがおすすめです。
よくある疑問
Q. CLAUDE.mdはデプロイが必要?
いいえ。CLAUDE.mdはあなたのPC上でClaude Codeが読むだけのファイルです。アプリの一部ではないので、GitHub Pagesなどにデプロイする必要はありません。.vscode/settings.json のような「開発ツールの設定ファイル」と同じ位置づけです。
Q. 全部自分で書かないとダメ?
いいえ。Claude Codeに「このプロジェクトを見て、CLAUDE.mdを作ってください」と頼めば、プロジェクトの構成を読み取って自動で作ってくれます。そこから自分好みに修正するのが一番ラクです。
Q. あとから変更できる?
もちろん。むしろ最初から完璧にする必要はありません。使っていて「あ、これも書いておけばよかった」と思ったら、その都度追記していくのがベストです。
まとめ
📌 グローバル設定(15行)+ プロジェクト設定(30行)= 合計45行
📌 設定にかかった時間は15分くらい
📌 「Don't」セクションが一番効果を実感しやすい
📌 デプロイ不要。置くだけでOK
📌 個人開発なら .gitignore に追加しておく
CLAUDE.mdは「こうしてね」よりも「これはやめてね」を書いた方が効果的だと感じました。Claude Codeは基本的に優秀なので、余計なことをさせない設定が一番響くようです。
まだ設定していない方は、まずグローバル設定の15行から試してみてください!