Claudeにコンテキストを与える：CLAUDE.mdとより良いプロンプト

Claude Codeはそのままでもよく機能しますが、プロジェクトの規約を理解し、いくつかのプロンプティング習慣を採用すると、著しく効果的になります。このガイドはその両方をカバーしています。

CLAUDE.mdは、Claudeがそのディレクトリ内のすべてのセッションの開始時に自動的に読む平文のマークダウンファイルです。これは、有能な新しいチームメイトの初日の朝に与えるブリーフィングのようなものです：チームがどのようにやっているか、何を避けるべきか、重要な部分がどこにあるか。

プロンプトで参照したり、手動で添付したりする必要はありません。ファイルが存在すれば、Claudeはすでにそれを読んでいます。

Claudeはいくつかの場所を探して、見つけたものを広いものから具体的なものへとマージします：

ほとんどのチームはプロジェクトルートファイルのみが必要です。gitにコミットしてチーム全体が利益を得られるようにしましょう。

CLAUDE.mdはセッション開始時に1回読み込まれ、Claudeのシステムプロンプトに逐語的に配置されます。要約や切り詰めはなく、各ターンでディスクから再読み込みされません。同じコンテンツは会話全体のコンテキストに留まります。セッション中にファイルを編集した場合、変更は新しいセッションを開始するまで有効になりません。

Claude for Enterpriseの顧客の場合、コスト図は「すべてのリクエストで読み込まれる」が示唆するよりも良いです。Claude CodeはAnthropicのプロンプトキャッシングをシステムプロンプトに適用します。これにはCLAUDE.mdが含まれます。セッション内の最初のリクエストはファイルの完全な入力トークン価格を支払います。その後のリクエストは約5分以内に互いに続き、キャッシュにヒットして、はるかに低いキャッシュ読み取り率で請求されます。キャッシュはコンテンツアドレス指定されるため、CLAUDE.mdへの変更はそれを無効にし、次のリクエストは再び完全な価格を支払います。

実際には、かなりのCLAUDE.mdはセッションごとに1回の完全なトークンと、キャッシュの有効期限が切れるほど長いアイドルギャップの後に1回かかります。メッセージごとに1回ではなく。ファイルをコンテキストウィンドウスペースとシグナルノイズ比のために瘦せたままにしておく価値はありますが、メッセージごとの支出を制御するためだけに行をセーブする必要はありません。Enterpriseの使用ダッシュボードでは、ファイルのフットプリントはほぼ完全にキャッシュ読み取りトークンとして表示され、標準入力トークンではなく表示されます。

任意のプロジェクトで、/initと入力します。Claudeはコードベースを探索し、CLAUDE.mdをドラフトします。ビルドコマンド、テストコマンド、構造概要、および検出された規約をカバーします。ドラフトを確認し、不正確なものを削除し、コミットします。これは約5分かかり、永続的に報酬を得ます。

短くシグナル密度の高いファイルを目指してください。最大で数百行です。すべての行はすべてのリクエストのコンテキストに読み込まれるため、それぞれがそのコストの価値があるべきです。

含める価値があるもの：

含める価値がないもの：

仕様ではなく、生きたオンボーディングドキュメントのように扱ってください。

セッション中に追加することもできます：#の後に指示を入力します（例：# always use async/await, never .then()）。Claudeは正しいCLAUDE.mdに追加することを提案します。

これらは一般的なプロンプトエンジニアリングのヒントではありません。Claudeが実際のコードベースを読み書きしているときに最も重要な習慣です。

Claudeはコードベース自体を探索できます。何が必要でなぜかを伝え、どこかを理解させてください。

❌ 「userService.tsを開き、validate関数を見つけ、42行目にnullチェックを追加します。」

✅ 「メールのないユーザーが検証ステップをクラッシュさせています。それを優雅に処理し、テストを追加してください。」

完全なスタックトレースを貼り付けるのではなく、要約してください。正確なファイル名、行番号、メッセージは、Claudeが正しい場所をすばやく見つけることができます。

複数のファイルに触れるもの場合は、Shift+Tabを押してプランモードに入り、次のように尋ねます：

「公開APIにレート制限を追加する方法を計画してください。まだ何も変更しないでください。」

計画を確認し、会話で調整してから、モードを切り替えて「ステップ1を実行してください」と言います。これは、誤解が12ファイルのdiffに変わる前にそれをキャッチします。

Claudeはコードベースを独自に検索できますが、関連するファイルをすでに知っている場合は、そう言ってください。より速く、より少ないトークンを使用します。@を使用してパスを参照します。例えば@src/auth/login.ts。

例としては、「テストが合格する」、「他のハンドラーのスタイルと一致する」、または「新しい依存関係がない」が含まれます。受け入れ基準を事前に述べることは、複数のラウンドの修正よりも効率的です。

長いセッションはノイズを蓄積します。「ログインバグを修正する」から「請求モジュールをリファクタリングする」に切り替えるときは、/clearを実行して新しく開始します。CLAUDE.mdは耐久性のあるコンテキストを前に進めるため、チャット履歴は必要ありません。

最初の答えがずれている場合、リクエスト全体を言い換える必要はありません。何が間違っているかを単に言ってください。例えば、「それは公開APIを変更します。署名を同じに保ってください。」Claudeは他のすべてを保ち、その点だけを調整します。