読み込み中

CLAUDE.mdファイル

レッスン 810 分
読み込み中

CLAUDE.mdファイル

要約文字起こし

Claude Codeの最も便利な機能の1つがCLAUDE.mdファイルです。これにより、Claude Codeはプロジェクトについての永続的なメモリを持つことができます。

それが解決する問題

CLAUDE.mdファイルがない状態でClaude Codeを開くと、毎回まっさらな状態からスタートします。コードベースを再探索し、どの依存関係が必要かを把握し、すでに実装されている機能を理解しなければなりません。時には仮定に基づいて判断することもあり、そうなるとClaudeを正しい方向に導くのが難しくなります。

CLAUDE.mdはこれを解決します。これはプロジェクトのルートに追加するMarkdownファイルで、Claude Codeはセッションを開始するたびに自動的にこれを読み込みます。コードベースのオンボーディング スクリプトだと考えてください。CLAUDE.mdファイルの内容は、あなたのプロンプトに追記されます。

例

典型的なCLAUDE.mdファイルは次のようなものです。

markdown
# Project

This is a Next.js 15 app using the App Router, Tailwind, and Drizzle ORM.

# Commands
- Dev server: `pnpm dev`
- Run tests: `pnpm test`
- Lint: `pnpm lint`

# Code Style
- Use 2-space indentation
- Prefer named exports
- All API routes go in app/api/
- Use server actions instead of API routes where possible

いたってシンプルです。これで、Claude CodeにReactコンポーネントの作成を依頼すると、すでにTailwindを使ってスタイリングすることや、あなたのコード規約に従うことを理解しています。

VS Codeで開かれたCLAUDE.mdファイル。プロジェクト情報、コマンド、コードスタイルのルールが表示されている

CLAUDE.mdはチームのためのもの

CLAUDE.mdはバージョン管理にコミットすることができますし、そうすべきです。そうすればチーム全体がその恩恵を受けられます。実は、誰のためのものかによってメモリファイルには階層があります。

  • プロジェクトレベルのCLAUDE.md は、プロジェクトのルートディレクトリに置かれます。チームと共有されます。

  • ユーザーレベルのCLAUDE.md は、あなたの設定フォルダに置かれます。これはあなた専用のもので、すべてのプロジェクトに適用されます。個人的な好みはここに記述してください。

ヒント

修正内容をメモリに保存する。 たとえば「APIルートではなく常にサーバーアクションを使うように」といったことを繰り返しClaudeに修正させられている場合は、そのルールをメモリに保存するよう明示的にClaudeに依頼しましょう。次にプロジェクトを開いたときには、それを覚えています。

CLAUDE.mdファイルにルールを保存するようClaudeに依頼している様子 — APIルートではなく常にサーバーアクションを使う

プロジェクトのドキュメントを参照する。 プロジェクト内にClaudeに参照してほしいドキュメントがある場合は、@記号をファイルパスと一緒に使用してください。

markdown
## README.md

Please read if you need more info: @README.md

最初は作らずに始める。 プロジェクトを始める際は、最初はCLAUDE.mdファイルを作らずに、どこで常にモデルの軌道修正が必要になるかを見極めることをお勧めします。こうすることで、CLAUDE.mdを必要最低限の情報だけに絞った、コンパクトなものに保てます。準備ができたら、/initを実行してClaudeに生成してもらいましょう。

今すぐ試してみましょう

CLAUDE.mdがないプロジェクトを選び、/initを実行してください。Claudeが書いた内容を読み、新しいチームメンバーにわざわざ伝えないような行があれば削除しましょう。自分が繰り返し行っている修正を1つ追加し、新しいセッションを開始して、その修正が関係する内容を依頼してみてください。Claudeはそれに従いましたか?

まとめ

もどかしいClaude Codeのセッションと生産的なセッションの違いは、多くの場合コンテキストにあります。そして、そのコンテキストを提供する手段がCLAUDE.mdファイルなのです。あなたの技術スタック、好み、そしてコマンドから始め、そこから積み上げていきましょう。