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

CLAUDE.mdを書くだけでClaudeが別人になる話




    Claudeに同じことを毎回説明してる、って人いない?


    「このプロジェクトはTypeScriptで、テストはvitestを使ってて、コメントは日本語で...」って毎回打ってる。正直つらい。


    それがCLAUDE.mdという1ファイルを置くだけで完全に解消された。




    CLAUDE.mdとは


    プロジェクトのルートに置く、Claudeへの「事前説明書」みたいなファイル。


    Claudeはプロジェクトを開くたびにこのファイルを自動で読む。だから「このプロジェクトのルール」を一度書いておけば、毎回説明しなくて済む。


    `

    プロジェクト/

    ├── CLAUDE.md ← ここに置く

    ├── src/

    └── package.json

    `




    何を書けばいいか


    私が実際に使ってる内容:


    ①使っている技術スタック

    `

    • TypeScript + Node.js
    • テスト: vitest
    • パッケージ管理: pnpm

    `


    ②禁止事項

    `

    • コメントは日本語で書く
    • any型を使わない
    • console.logを本番コードに残さない

    `


    ③よく使うツールの説明

    `

    • 外部APIはlib/api/に格納
    • 環境変数は.envから読む(dotenv済み)

    `


    これだけ書いておくと、Claudeが勝手に「このプロジェクトのルール」を守って動いてくれる。




    実際の効果


    正直ここまで変わるとは思ってなかった。


    Before: 毎回「このプロジェクトでは〜」と文脈説明→5回に1回は忘れて、Claudeが違うやり方でコードを書く


    After: 何も言わなくてもプロジェクトのルールを守ったコードが出てくる。もはや別人。


    特に効いたのが「禁止事項」の記述。「any型を使わない」と書いておいたら、本当に一度も使わなくなった。




    Cursorでも使える


    Claude Code専用かと思ってたけど、Cursorにも.cursorrulesという同じ概念があって、書き方もほぼ同じ。


    どちらを使ってる人にも今すぐ適用できる。




    まとめ


    • CLAUDE.md = Claudeへの事前説明書
    • ルート直下に置くだけ、特別な設定不要
    • 技術スタック・禁止事項・ツール説明の3つを書くだけで劇的に改善
    • Cursorでも同じ考え方が使える(.cursorrules)

    一度書けばずっと使えるし、チームで共有すれば全員のClaudeの挙動が揃う。


    やってない人は今すぐ試してみて。本当に別人になるから。




    *X: @AiLabJP*


     
     
    「人生は短いから、単純作業は全部AIに任せる」がモットーの25歳💡Antigravity×n8n×Remotionで寝てる間にコンテンツ生成|YouTubeで実装フロー解説|noteで即使えるJSON販売|失敗も全部シェア|合理的な怠け者です🛋️

    あなたへのおすすめ