CLAUDE.md、結局なにを書けばいいの？ — ちゃんと書いたら全然違った話

Zenn / 4/23/2026

💬 OpinionTools & Practical Usage

共有:

Key Points

「CLAUDE.md（Claudeへの指示・事前設定をまとめたファイル）」に何を書けばよいかがテーマで、正しく書くことで運用体験が大きく変わるという主張です
良いCLAUDE.mdは“AIに望む振る舞い”を具体化し、曖昧さを減らすことで回答の質と一貫性を上げることに焦点が当たっています
実際の書き方として、目的・前提・制約・出力形式などを整理して渡す考え方が示唆されています
ちゃんと書かなかった場合のズレ（期待と違う回答）を踏まえ、テンプレ的に整えることで改善するという内容です

はじめに Claude Code の体験記、最近ほんとに増えましたよね。「アプリが1日でできた」「寝てる間にリファクタが終わってた」。どれもワクワクするんですが、いざ自分で触り始めると、同じ指示をしたのに、昨日と違う結果が返ってくる。頼んでないファイルまで勝手に直す。何度注意しても、同じミスを繰り返す。こうなって「あれ？思ってたんと違う」となりがちです。結論から言うと、原因のほとんどは CLAUDE.md の書き方でした。ちゃんと書き直したら、体感が全く変わったので、その知見を共有します。 ! 対象：Claude Code を使い始めたが、挙動が安定しなくて困っている...

Continue reading this article on the original site.

Read original →