メインコンテンツへスキップ
見出し画像

自分のアプリに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行から試してみてください!


     
     
    UI/UXデザイナー歴20年🎓AI資格9個 Claude Code月$100課金のオタク🤖 元プログラマー|外資系大手EC10年 現在は国内大手人材サービスでUI/UXデザイナー ワーママの目線でAI活用を発信🍷

    あなたへのおすすめ