CLAUDE.md の使い方
CLAUDE.md とは
CLAUDE.md は、Claude Code に対する常駐の指示書です。Claude Code を起動すると、このファイルの内容が自動的に読み込まれ、毎回の会話で指示として適用されます。
たとえるなら、新しく来たアシスタントに「うちではこういうルールで仕事をしてね」と渡すマニュアルのようなものです。
なぜ必要なの?
Claude Code はとても賢く便利ですが、指示がなければ独自の判断で作業を進めることがあります。
- 大切なファイルを確認なしに上書きしてしまう
- よくわからないコマンドをいきなり実行する
- 不要なパッケージを勝手にインストールする
CLAUDE.md で事前にルールを伝えておくことで、こうしたトラブルを防げます。
CLAUDE.md の種類と配置場所
CLAUDE.md は配置する場所によって効果の範囲が変わります。
| 種類 | 配置場所 | 効果の範囲 |
|---|---|---|
| プロジェクト用 | プロジェクトフォルダの直下（~/Projects/my-workspace/CLAUDE.md） |
そのプロジェクトでのみ有効 |
| グローバル用 | ~/.claude/CLAUDE.md |
すべてのプロジェクトで共通して有効 |
まずはプロジェクト用から始めましょう
初めての方はプロジェクトフォルダに CLAUDE.md を作成するだけで十分です。慣れてきたら、どのプロジェクトでも共通のルールをグローバル用に書くと便利です。
初心者におすすめの安全ルール
Claude Code を安心して使うために、以下のルールを CLAUDE.md に書いておくことをおすすめします。
基本テンプレート
# ワークスペースのルール
## 基本ルール
- 日本語で応答してください
- 技術的なコマンドを実行する前に、何をするか平易な日本語で説明してください
- 判断に迷ったら、勝手に進めずに確認してください
## ファイル操作の保護
- 既存ファイルを上書きする前に、必ず確認してください
- 重要なファイルを変更する場合は、バックアップを作成してください
## 削除コマンドの制限
- rm、del、rmdir 等の削除コマンドは原則として実行しないでください
- rm -rf（強制削除）は絶対に実行しないでください
## パッケージのインストール
- npm、pip、brew 等のインストールコマンドは、事前に何をインストールするか説明し、承認を得てから実行してください
各ルールの解説
ファイル操作の保護
Claude Code はファイルの作成や編集が得意ですが、確認なしに既存ファイルを書き換えてしまうことがあります。このルールを書いておくと、上書き前に「このファイルを変更してよいですか?」と確認してくれるようになります。
削除コマンドの制限
rm -rf は、指定したフォルダとその中身をすべて削除する強力なコマンドです。間違った場所で実行すると、大切なファイルが取り返しのつかない状態になります。初心者の方は、削除コマンドを禁止しておくのが安全です。
パッケージのインストール制限
パッケージとは、ソフトウェアの追加機能のようなものです。Claude Code が作業の過程で「これが必要です」とパッケージをインストールすることがありますが、中には不要なものや、パソコンの環境に影響を与えるものもあります。事前に説明を求めることで、不要なインストールを防げます。
技術的なコマンドの説明
Claude Code が実行するコマンドは、慣れていないと何をしているのかわかりません。このルールを書いておくと、「今からこのコマンドを実行します。これは〇〇するためのコマンドです」と説明してくれるようになります。
CLAUDE.md の作り方
方法 1: Claude Code に作ってもらう
一番簡単な方法です。Claude Code を起動して、以下のように指示してください:
CLAUDE.md ファイルを作成してください。
内容は以下のルールを含めてください:
- 日本語で応答する
- ファイル上書き前に確認する
- 削除コマンドは実行しない
- パッケージインストール前に説明する
- コマンド実行前に平易な日本語で説明する
方法 2: テンプレートをコピーする
上の「基本テンプレート」をそのままコピーして、プロジェクトフォルダに CLAUDE.md というファイル名で保存してください。
慣れてきたらカスタマイズしよう
CLAUDE.md は自由に書き換えられます。使っていくうちに「こういうルールも欲しいな」と思ったら、どんどん追記してください。
カスタマイズの例
プロジェクトの説明を追加する:
よく使うファイルの場所を教える:
作業スタイルの指定: