AIエージェント講座 →
Claude Code

Claude Codeの設定ファイルを置く場所と読み込み範囲

📌 検索キーワード: claude code 設定ファイル 場所

結論

最初にやること:OSのターミナルでfind .. -name 'CLAUDE.md' -o -name 'CLAUDE.local.md'を実行します。

CLAUDE.mdは必ずルートだけに置くものではなく、Claude Codeは起動ディレクトリから上位階層を探索し、関連サブディレクトリのファイルはその配下を読むときに追加します。

個人共通の指示は~/.claude/CLAUDE.md、チーム共通はリポジトリのCLAUDE.md、個人のプロジェクトメモはCLAUDE.local.mdへ分けられます。

挙動設定は別途settings.jsonの各スコープへ配置します。

実行場所:コメントに従い、ターミナルとClaude Codeの対話画面を使い分けます。

# ターミナルで実行:対象ファイルを検索
find .. -name 'CLAUDE.md' -o -name 'CLAUDE.local.md'
# ターミナルで実行:Claude Codeを起動
claude
# Claude Code起動後の対話画面で実行:コンテキスト使用量を確認
/context

具体的な手順

  1. リポジトリ全体に適用する最小ルールをルートのCLAUDE.mdへ置きます。

  2. パッケージ固有のコマンドや規約はモノレポ内の各ディレクトリへ置きます。

  3. 端末固有または個人用の指示はCLAUDE.local.mdへ分離し、共有対象から外します。

複数のメモリファイルは単純な上書きではなく連結され、起動位置に近い指示ほど後から読み込まれます。

/contextでMemory filesを確認し、不要な階層のファイルはclaudeMdExcludesで除外できます。

実践プロンプト

現在読み込まれているルールの出所を確認させます。

入力場所:Claude Codeの対話画面へ貼り付けます。

現在のコンテキストに読み込まれたメモリファイルを列挙
各ファイルについて:
- 適用範囲
- 競合する指示
- 重複する指示
- ルート、サブディレクトリ、Skillのどこへ置くべきか
まだファイルは変更しない

注意点

  • サブディレクトリのCLAUDE.mdが常に無視されるという説明は現行仕様と異なります。

  • 同じルールを複数階層へ複製すると矛盾しやすいため、最も狭い適切な範囲へ一度だけ記述します。

  • 外部ファイルのimportは初回承認が必要になる場合があるため、共有リポジトリの参照先を確認します。

1日1時間 × 7日間で学ぶ「自作AIエージェント構築講座」

ツールの設定で消耗する側から、自分専用のAI自動化システムを作る側へ。
実践カリキュラムの全貌はこちらから確認できます。

公式カリキュラムを見る →

おすすめの関連記事

Claude Code

Claude Codeの使い方を徹底解説!基本コマンドと安全な実践手順

Claude Code

Claude Codeの料金体系!Pro・Max・API課金の違いと確認方法

Claude Code

Claude Codeとは?CLI・IDE・デスクトップ・Webで使えるAIエージェント

← ポータルTOP(全200件の検索)へ戻る