Claudeを集中させ続けるCLAUD.mdの裏技

Claude Codeのセッションを切り替えるたびに、プロジェクトの構造やコーディング規約、アーキテクチャ上の決定事項をゼロから説明し直す必要が typically ある。これでは時間が無駄になり、出力にもばらつきが生じる。CLAUD.mdファイルは、Claudeの永続的な記憶として機能することでこの問題を解決する。

CLAUD.mdは、プロジェクトのルート（./CLAUD.md）に置くマークダウンファイルだ。Claude Codeは毎回のセッション開始時にこれを自動的に読み込み、常設の指示としてコンテキストウィンドウに組み込む。技術スタック、命名規則、テストの要件、セキュリティポリシー、そしてチームが従うアーキテクチャ上のルールを記載できる。

始めるには、核となる情報を盛り込んだCLAUD.mdファイルを作成しよう。プロジェクト名、技術スタック（React 18、Node.js、PostgreSQL）、主要なディレクトリ、そして妥協できない規約（「常にTypeScript strictモードを使う」「コードより先にテストを書く」など）だ。分量は300〜800語に抑える。大規模なチームでは、.claude/rules/サブディレクトリにプロジェクト固有のルールを作成し、ルートのファイルはより小さく保つ。Claudeはまた、すべてのプロジェクトにわたる個人的な好みを記したグローバルの~/.claude/CLAUD.mdも読み込む。

ワークフローの例：ある決済処理チームはCLAUD.mdにこう追記した。「バックエンド：Node.js + Express。データベース：行レベルセキュリティを備えたPostgreSQL。セキュリティ：金額フィールドはすべて整数（小数ではなくセント単位）でなければならない。すべてのAPIは認証トークンを必要とする。」これで、Claude Codeとのあらゆるセッションがこれらの制約を自動的に把握する。新しいエンドポイントを書くようClaudeに頼むと、その都度あなたが口にしなくても、これらのルールを守ったコードを生成する。