[Claude Code] CLAUDE.mdの使い方

Claude Codeはコーディングにも利用できるAIエージェントです。
CLAUDE.mdを用意することで、AIエージェントに”このプロジェクトのルール”を覚えさせることができます。
この記事では、CLAUDE.mdの役割と書き方を紹介します。

やすひら

CLAUDE.mdの役割と書き方を紹介します

CLAUDE.mdとは何か

Claude Codeは起動時に、プロジェクトのルートディレクトリにあるCLAUDE.mdを自動的に読み込みます。
CLAUDE.mdを書いておくことで、常時有効な指示としてAIエージェントに指示することができます。

毎回「日本語で回答してください」「このルールを守ってください」と伝える必要がなくなります。
プロジェクトの文脈をあらかじめ渡しておくことで、AIがより的確な提案をしてくれるようになります。

CLAUDE.mdの書き方

CLAUDE.mdには、常時指示したいプロンプトを書いておくことが効果的です。

ポイントは「AIが迷いそうな判断」を事前に指示しておくことです。「どのコマンドを使うか」「どのファイルを先に読むか」など、作業の前提となる情報を書いておくと効果的です。

言語/コミュニケーション設定

言語やコミュニケーション方法を設定します。

設定ファイル

## 言語設定
- 常に日本語で会話する

言語を設定しておくことで、Claude Codeとの会話がスムーズになります。

あわせて読みたい

[Claude Code]日本語の設定方法

プロジェクトの概要

プロジェクトの概要を設定します。

設定ファイル

## このリポジトリの概要
AIエージェントを活用したライフワーク管理リポジトリです。
タスクはGitHub Issues、アイデアはMarkdownファイルで管理します。

プロジェクトの概要を設定しておくことで、Claude Codeにプロジェクトの概要を毎回伝えなくても、会話ができるようになります。

AIに守ってほしいルール

AIに守ってほしいルールを設定します。

設定ファイル

## 必ず守ること
- タスクの評価を行う前に、必ず context.md を読む
- Issueの操作には gh コマンドを使う
- Issueには種別ラベル（task または idea）を必ず付ける

AIが必ず守ってほしいルールを設定します。
各タスクのルールは、rulesに設定することもできます。

CLAUDE.mdの定義例

筆者が運用しているライフワーク管理リポジトリのCLAUDE.mdは以下の構成です。

設定ファイル

# CLAUDE.md

Claude Code がこのリポジトリで作業する際の指針です。

## 言語設定
- 常に日本語で会話する

## このリポジトリの概要
AIエージェントを活用したライフワーク管理リポジトリです。
タスクはGitHub Issues、アイデアはMarkdownファイルで管理します。

## 必ず守ること
- タスク・アイデアの評価・提案を行う前に、必ず context.md を読む
- Issueの操作には gh コマンドを使う
- Issueには種別ラベル（task または idea）を必ず付ける
- 繰り返し実行されそうなタスクが発生した場合、スキル化を提案する

シンプルですが、これだけで「日本語で返答する」「作業前に context.md を読む」「gh コマンドを使う」という3つの行動がAIに徹底されます。

CLAUDE.mdを置く場所

CLAUDE.mdはプロジェクトのルートに置くのが基本です。
サブディレクトリに置くことも可能で、サブディレクトリ内で作業するときだけ、指示が有効になります。
大規模なプロジェクトでは、ディレクトリごとにルールを分けることもできます。

トラブルシューティング

CLAUDE.mdのトラブルシューティングを紹介します。

CLAUDE.mdが長くなった場合

CLAUDE.mdは、AIエージェントが毎回読み込むため、長くなるとトークン量が多くなってしまいます。
トークン量が多すぎると、AIエージェントの精度が低下する可能性もあるため、CLAUDE.mdは短く保つ必要があります。

CLAUDE.mdが中くなった場合は、rulesという仕組みを利用します。
rulesでは、あるパターンのみ適応するルールをパターン毎に定義できる仕組みです。
パターンに応じて実行する指示文は、rulesに定義しておくことで、CLAUDE.mdが長文化することを防止できます。

まとめ

CLAUDE.mdの使い方について紹介しました。

CLAUDE.mdは、Claude Codeを利用する上で重要な指示文です。
常時有効化したい指示分を、CLAUDE.mdに定義しておくことで、高精度な作業が可能になります。