CLAUDE.mdの書き方|中身・置き場所・USER.mdの読ませ方

こんにちは、飯塚です!
「CLAUDE.mdって、何をどう書けばいいの?」と悩んでいませんか?
そんな方に向けて、私が実際に使っている「書き方」をまとめました。
飯塚この記事は、こんな人におすすめです!
- 毎回AIを替えるたびに、自分のことを一から説明している
- ルールに、何を書けば効果的かで迷っている
- 気づけば、CLAUDE.mdの中身が、ぐちゃぐちゃになっている..
大事なのは、Claude Codeが「あなたが誰か」を分かったうえで動けているか。
本記事では、実際のリアルな私のCLAUDE.mdをお見せながら解説しますね!
AIを使うときに、毎回、自分のことを説明しなくて済むようにしたい方は、
ぜひ最後までご覧ください😊
この内容は動画でも解説しています。
CLAUDE.mdとは?毎回読まれるルールファイル
CLAUDE.mdは、Claude Codeが会話を始めるときに読むルールファイルです。
「こう動いてね」という決まりを書いておくと、毎回の説明がいらなくなります。
下は、私のObsidian Vaultに置いているCLAUDE.md。


一番上にObsidian Vaultの説明、その下に使っている道具と行動ルール。
左の一覧の下にあるAGENTS.mdは、Codexなどが読むルールファイルで、あとで説明します。
自分で一から書かなくても、/initと打てば下書きを作ってもらえます。
/initの使い方は、ObsidianとClaude Codeの連携の記事で紹介しました。
CLAUDE.mdの書き方の基本
置き場所を決めて、毎回言い直していることを、短く具体的に書きます。
1. 置き場所はObsidian Vaultの直下
自分で使うなら、Obsidian Vaultの直下にCLAUDE.mdを1枚置けば始められます。
私も、Obsidian Vaultの直下に置いているんです。
置ける場所は4つあり、場所によって読まれる範囲が変わります。
| 置き場所 | 読まれる範囲 | 向いている中身 |
|---|---|---|
~/.claude/CLAUDE.md |
自分のすべてのプロジェクト | どこでも守ってほしい自分の好み |
./CLAUDE.mdか./.claude/CLAUDE.md |
そのフォルダ(Obsidian Vault) | そのObsidian Vaultの説明とルール |
./CLAUDE.local.md |
そのフォルダで自分だけ | 人と共有しない設定 |
| 管理ポリシーの場所 | 組織の全員 | 会社が決めるルール |
いくつもあるときは、全部をつなげて読む仕組み。
場所の一覧は、公式のClaude があなたのプロジェクトを記憶する方法にあります。
2. 書くのは毎回言い直していること
書くのは、チャットで何度も言い直していることだけです。
同じ説明を、もう一度チャットに打ち込んだら、それがCLAUDE.mdに書く合図。
私の行動ルールには、次のような決まりが並んでいます。
- 考えるのは英語、答えるのは日本語
- 分からない点は、積極的に質問する
- 成果物は、決まったフォルダに保存する
- Obsidianのノートの移動は、Obsidian CLIを使う
何段もある作業の手順は、ルールではなくスキルに分けます。
CLAUDE.mdには、スキルの名前と場所だけを書いておけば十分なんです。
3. 短く、具体的に書く
1行で、守れたかどうかを確かめられるくらい具体的に書きます。
悪い例は「成果物は整理しておく」。
どこに置けばいいのか、AIには分からないですよね?
直し方は「成果物は .agents/artifacts/ に保存する」。
保存先を見れば、守れたかどうかをすぐ確かめられます。


長さの目安は、1ファイル200行以下(公式の目安)。
私も、スキルの一覧は重要なものだけに絞っています。
Claude CodeのUSER.mdとは?
USER.mdは、Claude Codeの公式のファイル名ではなく、自分で作る取り扱い説明書です。
Claude Codeのメモリの公式の案内に、USER.mdという名前は出てきません。
Claude Codeが会話の始めに読むのは、CLAUDE.mdなどのルールファイル。
だからUSER.mdは、CLAUDE.mdから「読んでね」と指して使います。
中身は、名前・職業・経歴・好きなこと・苦手なもの。
会社に出す履歴書のようなもので、1枚あれば、どのAIにもあなたのことが伝わります。


置き場所は、ツールの中ではなくObsidian。
Obsidianに置くので、CursorやCodexからも同じ1枚を読めます。
どのフォルダで起動しても読ませたいなら、ユーザー用の~/.claude/CLAUDE.mdに@で書く方法もあります。
@~/Obsidian/USER.md
@のあとに、USER.mdの場所を書く(パスは自分のObsidian Vaultに合わせる)- 書いたファイルは、
CLAUDE.mdと一緒に読み込まれる
USER.mdに書く中身の例は、AIエージェントの作り方の記事で紹介しました。
CLAUDE.mdを書く4ステップ
それでは、私のCLAUDE.mdと同じ並びで書いていきましょう!
Obsidian Vaultの直下にUSER.mdを作り、名前・職業・経歴・好きなこと・苦手なものを書きます。
まずは1行で、Obsidian Vaultの説明を。
その下に「行動ルール」の見出しを立て、毎回守ってほしい決まりを箇条書きにしましょう。
「以下を聞かずに順番に読む」と書き、読ませたいファイルの場所を並べます。


私は、過去の教訓・長期記憶・直近2日の記録・USER.mdの4つ。
毎回、私のことと直近の状況を分かったうえで答えてくれます。
スキルの中身は書かず、名前と一言、SKILL.mdの場所を並べます。


書く中身は、次のような形です。
(Obsidian Vaultの説明を1行)
## 行動ルール
- 考えるのは英語、答えるのは日本語
- 不明な点は質問する
- 成果物は .agents/artifacts/ に保存する
## セッション開始
以下を聞かずに順番に読む:
1. USER.md — ユーザーの情報
## Available Skills
- (スキルの名前):(一言の説明)(SKILL.mdの場所)
- 見出しは、私の
CLAUDE.mdの並びのまま - 読むものは、作ったファイルの分だけ足していく
スキルの中身まで書くと、CLAUDE.mdがすぐ長くなります。
中身はSKILL.mdに分けて、ここには場所だけを書きましょう。
1行目でAGENTS.mdも読ませる
CursorやCodexも使うなら、CLAUDE.mdの1行目でAGENTS.mdを読ませます。
ルールファイルの名前が、ツールごとに違うからです。


| ツール | 読むルールファイル |
|---|---|
| Cursor | .mdcのファイル、AGENTS.md |
| Codex | AGENTS.md |
| Claude Code | CLAUDE.md |
AGENTS.mdは、業界の標準と言われているファイル。
私の環境では、ルールの本体はCLAUDE.mdにあります。
AGENTS.mdは、そのCLAUDE.mdを指すシンボリックリンクにしているんです。
ただ、シンボリックリンクの設定は少し難しいですよね。
もっと手軽なのは、ルールの本体をAGENTS.mdに書き、CLAUDE.mdの1行目に「AGENTS.mdを読んでください」と書くやり方。
1行足すだけで、ルールも1つにそろいます。
(公式の書き方は、文で頼むより、@AGENTS.mdと1行書いて読み込む形です)
@AGENTS.md
CLAUDE.mdの1行目(ひな形の#の見出しより上)に書く- 2行目から下には、Claude Codeだけに守ってほしいことを書ける
今のClaude Codeは、CLAUDE.mdが無いフォルダならAGENTS.mdを自分で読みます。
両方あるとCLAUDE.mdだけを読むので、この1行が要るんですね。
つまずきやすいところ
つまずきやすいのは、AIの乗り換えと、2つのファイルのつなぎ方です。
1. AIを替えたら、答えががらっと変わった
答えが変わるのは、新しいAIが「あなたが誰か」を知らないからです。






USER.mdに書いて、どのAIからも読ませよう!ルールもAGENTS.mdにまとめれば、替えても困らないよ。私もCursor・Claude Code・Codexと替えてきて、最初は出力ががらっと変わって大変でした。
今はどれを使っても、同じような出力が出ています。
2. シンボリックリンクが難しい
難しければ、CLAUDE.mdの1行目に書くやり方で十分です。



AGENTS.mdとCLAUDE.mdを、どうやってつなげばいいのか分かりません…


私の画面では、.claudeの中のskillsなども、矢印の付いたシンボリックリンク。
開いているAGENTS.mdにも、CLAUDE.mdと同じ中身が出ています。


シンボリックリンクなら、片方を直すと、もう片方にも同じ中身が出ます。
よくある質問
/initと打てば、Claude Codeがフォルダを調べて下書きを作ってくれるんです。
すでにCLAUDE.mdがあるときは、上書きはせず、直す案を出してくれる仕組み。
どちらも読まれ、上書きはされません。
Obsidian VaultでClaude Codeを起動しているなら、ユーザー用のあとにObsidian Vaultのほうが読まれる順番です。
まとめ
以上、CLAUDE.mdの書き方を紹介しました!それでは、今回の内容をおさらいします。
CLAUDE.mdは、Claude Codeが会話の始めに読むルールファイル- 置き場所はObsidian Vaultの直下。毎回言い直していることを、短く具体的に書く
USER.mdは、自分で作る取り扱い説明書。CLAUDE.mdから読ませる- 書く並びは、行動ルール・セッション開始・スキルの一覧
- CursorやCodexも使うなら、1行目で
AGENTS.mdを読ませる
CLAUDE.mdは、Claude Codeが「あなたが誰か」を分かったうえで動くための入り口です。
まずはObsidianにUSER.mdを1枚作り、CLAUDE.mdのセッション開始に書き足してみてください。
AIが自分を分かる仕組みを作りたい方へ
CLAUDE.mdとUSER.mdが整ったら、次はObsidianにメモをためて、AIが読む中身を育てる段階です。
集め方からAIとの使い方まで、通して知りたい方に向けて無料の動画を用意しました。
