Claude CodeのCLAUDE.mdの書き方と活用法

結論

最初にやること：OSのターミナルでclaudeを実行します。

CLAUDE.mdは一般的な設定JSONではなく、Claude Codeが会話開始時に読むプロジェクトメモリです。

ビルド、Lint、テストの実コマンド、独自規約、失敗しやすい注意点だけを記述します。

長い仕様や一時的な作業手順はSkillsや関連ディレクトリのCLAUDE.mdへ分離します。

実行場所：コメントに従い、ターミナルとClaude Codeの対話画面を使い分けます。

# ターミナルで実行：Claude Codeを起動
claude
# Claude Code起動後の対話画面で実行：プロジェクト用CLAUDE.mdを初期生成
/init
# Claude Code起動後の対話画面で実行：コンテキスト使用量を確認
/context

具体的な手順

1. リポジトリルートで/initを実行し、コードベースから雛形を生成します。

2. 自動生成内容からディレクトリ一覧や一般常識を削り、Claudeが推測できない情報だけを残します。

3. /contextで読み込みとサイズを確認し、必要に応じて.claude/rules/やSkillsへ分割します。

CLAUDE.mdに必須フォーマットはなく、人間が読める短いMarkdownが推奨されます。

他エージェント用のAGENTS.mdを使う場合は、CLAUDE.mdから@AGENTS.mdとしてimportできます。

実践プロンプト

実務向けの最小テンプレートです。

入力場所：Claude Codeの対話画面へ貼り付けます。

- Install: pnpm install --frozen-lockfile
- Lint: pnpm lint
- Test: pnpm test
- 公開API型を変更する前に確認
- 変更後は対象テストを実行
- 生成物と秘密ファイルを編集しない

注意点

• CLAUDE.mdを「必ず守るシステムプロンプト」と断定せず、具体的で検証可能な指示を書く必要があります。

• 同じ内容を上位と下位へ重複させると矛盾しやすいため、適用範囲を分けます。

• ファイル名は大文字のCLAUDE.mdを使用し、読み込みは/contextで確認します。