AIToday
AIコーディングZenn AI/ML掲載日時: 2026年11月13日 4:00

CLAUDE.mdの共通ルールと固有ルールを分けて運用

LINEで送る
CLAUDE.mdの共通ルールと固有ルールを分けて運用

3つのポイント

  1. 何が起きたか

    全リポジトリ共通ルールを~/.claude/CLAUDE.mdに移し、目的・構成・ビルド/テストコマンド・ツール固有の制約は各リポジトリのCLAUDE.mdに残した。

  2. なぜ重要か

    共通ルールを1か所直せば全リポジトリに反映され、各ツールが他プロジェクト専用のコマンドを読まなくなる。

わからないところ、AIに聞けます

質問と回答はこのページに公開されます。

こういう要約が、毎朝あなたのメールに届きます。

背景と解説

この設定は、社内ツールが増えるにつれて現れる重複問題に対処するものだ。各リポジトリでCLAUDE.mdを一から書くと、「変更したファイルだけを追加する」「決定理由は別の場所に記録する」といったルールをコピーすることになり、片方だけ更新すると食い違う恐れがあった。逆にすべてをユーザー共通ファイルに押し込むと、全リポジトリが1つのツールにしか関係ないビルドコマンドを読むことになる。

分割は、備品貸出ツールと日報集約ツールという2つの架空リポジトリで検証した。各フォルダにどのファイルにルールがあるか問い合わせると、共通ルールとリポジトリ固有のルールがファイル名付きで返り、別ツールのコマンドは現れなかった。検証で注意点も判明した。ユーザー共通ファイルはクローンしたチームメンバーに共有されず、返答言語の指示が欠けると日本語の質問に英語で答えた。

よくある質問
ユーザー共通のCLAUDE.mdとリポジトリのCLAUDE.mdの振り分けはどう判断したのか?
その1行を別のリポジトリで読んだとき、Claude Codeが混乱したり誤解したりするかどうかで判断した。問題なければユーザー共通ファイルへ、問題があればリポジトリ側へ入れた。
両方のCLAUDE.mdが実際に読み込まれているか確認する方法は?
/contextの「Memory Files」欄を確認する。 /memoryの一覧はまだ存在しないファイルも表示することがあるためだ。ツールのフォルダで/context allを付けてclaude -pを実行すると、UserとProjectの両方の項目が表示された。
チームメンバーがリポジトリをクローンした場合、ユーザー共通のCLAUDE.mdのルールはどうなるのか?
共有されない。ユーザー共通のルールはクローンした人には見えないとClaude Code自身が指摘しており、チーム全体のルールはリポジトリ側にも書くべきだ。
LINEで送る

あなたの仕事に関係するAIニュースを、毎朝お届けします。

業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。

登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →

AIに質問

この記事についてわからないことをAIに質問できます。AIはこの記事・AIToday の過去記事・Wikipedia を読み、出典を付けて答えます。Q&Aはこのページに公開され、他の読者も読めます。

質問と回答はこのページに公開されます。

このようなAIの動きを、御社の業界・競合に合わせて毎日届ける法人プランもあります → 詳しく見る

関連記事

CPC AIの尹氏、3〜5日MVPは決めることを減らして実現と説明

CPC AI Inc.の尹氏は3〜5日でMVPを出す工程を示した

Zenn AI/ML11時間前

AIコードレビュー、小さなPR2本で見えた5つの失敗型

著者はPR #17(CIマトリクスに3行追加・1行削除)とPR #13(Dockerfileのベースイメージ変更とspec追加、2ファイルで39行追加・1行削除)をAnthropicのコードレビュースキルとCodeRab…

Zenn AI/ML11時間前

Claude Codeの4分業、Opus単体より2.7倍のトークン

同じCanonical Zephyrの記事で、Haiku/Sonnet/Opusの4分業は約207秒で198,658トークン、Opus 1体は約168秒で74,381トークンだった

Zenn AI/ML11時間前

Zenn記事をAIエージェントがPRで執筆する環境

筆者は非公開のGitHubリポジトリをZennに連携し、エージェントに環境構築とCLAUDE.mdのルールファイルの下書きを作らせ、筆者自身の記事をエージェント作成PRの第1号として公開した

Zenn AI/ML11時間前

Inflab、CodeRabbitで定型ミスを指摘と報告

InflabのYakpoong氏が約7カ月のCodeRabbit利用を振り返り、誤字や引数の誤り、console.log/System.out.println、BIGINTルールに反するINTEGER外部キーをAIレビュ…

Zenn AI/ML11時間前

長文プロンプト規約は5件中4件しか守られず

AI LaboがVM215上でgemini-3.8-flashに同一タスクを解かせたところ、Mode Aは5大アーキテクチャ規約のうち4件のみ遵守し、Hook方式のMode Bは5件全てを遵守した

Zenn AI/ML11時間前
次の記事へGoogleのAIなし検索廃止に7都市で抗議