
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*