くまだどうも、くまだです。
最近コーディングにClaude Codeを使っています。
Claude Codeはブログネタになりそうだとおもったので、自分の環境や経験をベースに書いていこうと思います。
このブログではClaude Codeに関する記事のこれが初記事となります。
Claude Code導入方法は他の記事でもさんざん語りつくされているので割愛します。
（なお、もっと効率的な書き方があるというのもあると思いますが、現状の自分はこういう感じで書いているという一つの例でだと思ってみてもらえればと）
CLAUDE.mdとは
ひとことで言うと、Claude Codeが毎回勝手に読んでくれる説明書です。普通のプロンプトはその場かぎりです。チャットを閉じたら消えてしまう。
CLAUDE.mdに書いたことは、そのプロジェクトで作業するたびに毎回読まれます。
なので、こういうものを置いておくと効きます。
- フォルダ構成
- 使ってるテンプレートやコーディング規約
- やってほしくないこと
- 判断に迷ったときの優先順位
ファイル名のとおりただのMarkdownなので、特別な書式はいりません。見出しと箇条書きで書けます。
置き場所は3つある
置く場所で効く範囲が変わります。
1. グローバル（全プロジェクト共通）
~/.claude/CLAUDE.mdWindowsなら C:\Users\ユーザー名\.claude\CLAUDE.md です。
すべてのプロジェクトで読まれます。自分はここに「案件が変わっても変わらないこと」を置いてます。
例えば、
- 日本語で会話する
- gitコマンドは実行しない
- .envは読まない
- 完了報告のフォーマット
など。ボクの場合はgitコマンドを触らせないようにしていますが、人によってはgitコマンドを触らせている場合もあるので、その場合は書かなくてもだいじょうぶです。
2. プロジェクトルート
その案件でだけ読まれます。gitで管理すればチームで共有できるので、案件固有の情報はこっち。
プロジェクト/CLAUDE.md3. プロジェクトの .claude 配下
プロジェクト/.claude/CLAUDE.mdこれも読まれます。ルート直下を汚したくないときに。
自分は用途で分けてます。ルート直下は別のツールや人も見るので、Claude Code専用の細かい話は .claude/ のほうへ、みたいな。
3つは併用できます。グローバルに共通ルール、プロジェクトに案件固有、という重ね方が基本になると思います。
まずこれだけ書いてみる
いきなり全部やろうとすると手が止まるので、最初はこれくらいで十分です。自分はコーダーなので、例えば以下のような感じになります。
```markdown
# プロジェクト名
## 概要
（何を作っているか2〜3行）
## 技術構成
- テンプレート：
- CSS設計：
- 画像の置き場所：
- ブレイクポイント：
## 禁止事項
-
-
## 完了の定義
-
```あとは作業しながら「これ毎回言ってるな」と思ったことを足していく。
先に完璧なものを作ろうとしないほうがいいです。
まとめ
- CLAUDE.mdは、Claude Codeが毎回自動で読む指示書
- 置き場所は3つ。グローバル（全案件）／プロジェクトルート（案件別）／.claude/配下
- 併用できる。共通ルールはグローバル、案件固有はプロジェクトへ
- 最初から作り込まない。毎回言っていることを足していく
置いただけだと実はあんまり効かなくて、書き方でだいぶ変わります。
ここまで読んでくださりありがとうございました。