メモリが反映されない時

コマンド / 機能

トラブルシューティング

問題解決ガイド

概要

CLAUDE.md やルールファイルが期待通りに動作しない場合のトラブルシューティング方法。

設定例

# よくある問題と解決方法

## 1. CLAUDE.md が読み込まれない
原因: ファイル名やパスの間違い
確認:
- ファイル名は正確に CLAUDE.md（大文字小文字注意）
- プロジェクトルートに配置されているか
- 文字コードは UTF-8 か

## 2. ルールが無視される
原因: 曖昧な記述
❌ 「いい感じにして」
✅ 「変数名は camelCase で、20文字以内にする」

## 3. 競合するルールがある
原因: グローバルとプロジェクトで矛盾
解決: プロジェクトの CLAUDE.md で明示的に上書き
「グローバル設定に関わらず、このプロジェクトでは〇〇」

## 4. @import が動かない
原因: パスの間違い
確認:
- パスは CLAUDE.md からの相対パス
- ファイルが実際に存在するか
- 拡張子 .md が付いているか

## 5. rules/ が読み込まれない
確認:
- ディレクトリ名は .claude/rules/（ドット始まり）
- ファイル拡張子は .md
- ファイル内容はマークダウン形式

---
# デバッグ方法

## 現在の設定を確認
Claude に「現在の CLAUDE.md の内容を教えて」と聞く

## 読み込み状況を確認
Claude に「どのルールファイルを読んでいるか教えて」と聞く

## 特定のルールの適用を確認
Claude に「〇〇についてのルールは何？」と聞く