Claude Codeに毎回同じ説明をしない仕組み

Claude Codeを使い始めると、すぐ壁にぶつかる。プロジェクトの背景、使っている技術スタック、禁止したい操作——これを毎回セッションのたびに説明しないと、AIは「何も知らない新人」として動き始める。海外Xでは、この問題を構造で解決するファイル構成が話題になっている。

注目が集まっているのは「きれいなディレクトリ名」ではなく、AIに文脈を事前に読み込ませる仕組みそのものだ。見た目を整えることに時間を使うより、AIが「次のセッションでも同じ前提で動ける」状態をどう作るかが問われている。

海外Xの投稿（@id_2063566425110011904）が整理している構成は、大きく4要素に分けられる。

CLAUDE.mdは、プロジェクト全体の前提を書き込むファイル。「このリポジトリは何をするものか」「使っている言語・フレームワークは何か」「守ってほしいコーディング方針は何か」を一度書いておけば、Claude Codeが起動するたびに自動で読み込む。毎回の説明コストが、ここで大きく削れる。

.claude/rulesは、場所ごとのルール設定。プロジェクト全体に適用する設定とは別に、特定のディレクトリやファイル種別ごとに異なるルールを持たせたい場合に使う。フロントエンドとバックエンドで指示を分けたいケースなどが典型的だ。

hooksは、危険な操作をAIが実行する前に止める仕組み。たとえば「本番DBへの直接書き込みはブロック」「特定のファイルを削除する前に確認を挟む」といった安全装置として機能する。AIに自律的に動かせる範囲が広がるほど、このストッパーの存在が実用上の安心感につながる。

auto memoryは、セッションをまたいで学習内容を保持する機能。「このプロジェクトでは○○という判断をした」という経緯をAIが記録し、次回以降の判断に反映させることができる。一度教えたことを繰り返し教え直す手間が減るのがポイントだ。

この4つは独立したTipsの寄せ集めではなく、「AIに文脈を持たせる」という一つの設計思想から来ている。Claude Codeの共有作業、1コマンドで終わる時代へでも触れたように、Claude Codeをチームや複数プロジェクトで使うなら、こうした「共通の前提をどこに置くか」の設計が作業効率の差になる。