プロジェクトのルールをClaude.mdファイルに埋め込む

毎回のセッションでコーディング標準を繰り返すのはやめよう。プロジェクトのルートにCLAUDE.mdファイルを作成すれば、Claude Codeが起動時にプロジェクトのアーキテクチャ、ビルドコマンド、コーディングスタイルを自動的に読み込む。この永続的なメモリはトークン枠を消費することなく、すべての開発者セッションにわたって保持される。

Claude CodeのCLAUDE.mdシステムを使えば、プロジェクト固有の指示をリポジトリに直接組み込める。新しいセッションを始めるたびにClaudeへ技術スタックや命名規則、ビルド手順を説明する代わりに、Claudeが自動的に読み込むシンプルなマークダウンファイルを作成するのだ。

始めるには、Claude Codeで/initコマンドを実行する。これにより既存のコードベースが分析され、関連するコンテキストを含むスターターのCLAUDE.mdが生成される。その後、このファイルを編集して、ビルドおよびテストコマンド、コーディング標準、アーキテクチャ上の決定、フォルダ構成、命名規則を含められる。ルートに./CLAUDE.mdとして保存し、バージョン管理にコミットすれば、チーム全体が同じコンテキストの恩恵を受けられる。

このファイルはリポジトリ内に置かれ、gitを通じて同期されるため、プロジェクトで作業するすべての開発者(そしてClaude Code自体)が同じ指示を受け取る。Claudeは作業ディレクトリとすべての親ディレクトリからCLAUDE.mdファイルを読み込み、順番に連結するため、プロジェクト全体のルール、チーム全体のルール、個人の好みを階層化できる。

例えば、TypeScript/Reactプロジェクトで作業しているなら、CLAUDE.mdには次のように指定できる。「常にTypeScriptのstrictモードを使用し、実装前にVitestでユニットテストを書き、./docs/architecture.mdのフォルダ構成に従い、conventionalなコミットメッセージを使用すること」。保存されれば、Claude Codeは指示を繰り返すことなく毎セッションでこれを読み込む。

ファイルは300行未満に保とう。Claudeは毎セッションの開始時にこれを読み込み、トークンが重要だからだ。冗長な説明よりも、影響の大きい標準に焦点を当てよう。