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

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

こんにちは、飯塚です!

「CLAUDE.mdって、何をどう書けばいいの?」と悩んでいませんか?

そんな方に向けて、私が実際に使っている「書き方」をまとめました。

飯塚

この記事は、こんな人におすすめです!

  • 毎回AIを替えるたびに、自分のことを一から説明している
  • ルールに、何を書けば効果的かで迷っている
  • 気づけば、CLAUDE.mdの中身が、ぐちゃぐちゃになっている..

大事なのは、Claude Codeが「あなたが誰か」を分かったうえで動けているか。

 

本記事では、実際のリアルな私のCLAUDE.mdをお見せながら解説しますね!

AIを使うときに、毎回、自分のことを説明しなくて済むようにしたい方は、

ぜひ最後までご覧ください😊

目次

この内容は動画でも解説しています。

CLAUDE.mdとは?毎回読まれるルールファイル

CLAUDE.mdは、Claude Codeが会話を始めるときに読むルールファイルです。

「こう動いてね」という決まりを書いておくと、毎回の説明がいらなくなります。

下は、私のObsidian Vaultに置いているCLAUDE.md。

CLAUDE.mdを開いた画面。一番上にObsidian Vaultの説明の1行、その下にStack(使っている道具)と行動ルールの見出しが並び、左の一覧の下にAGENTS.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/ に保存する」。
保存先を見れば、守れたかどうかをすぐ確かめられます。

CLAUDE.mdの行動ルールの欄。英語で考え日本語で答える、不明な点は質問する、選択肢には推奨度と理由、成果物は.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のタスク(手順・チェックリスト)・知識(マニュアル・資料)・USER.mdのメモから、スキル・記憶・プロンプトとユーザー情報ができる

置き場所は、ツールの中ではなく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と同じ並びで書いていきましょう!

STEP
ObsidianにUSER.mdを作る

Obsidian Vaultの直下にUSER.mdを作り、名前・職業・経歴・好きなこと・苦手なものを書きます。

STEP
一番上にObsidian Vaultの説明と行動ルールを書く

まずは1行で、Obsidian Vaultの説明を。
その下に「行動ルール」の見出しを立て、毎回守ってほしい決まりを箇条書きにしましょう。

STEP
セッション開始に、最初に読むものを並べる

「以下を聞かずに順番に読む」と書き、読ませたいファイルの場所を並べます。
CLAUDE.mdのセッション開始の欄。以下を聞かずに順番に読む、として過去の教訓・MEMORY.md・今日と昨日の記録・USER.mdの4つが並んでいる画面

私は、過去の教訓・長期記憶・直近2日の記録・USER.mdの4つ。
毎回、私のことと直近の状況を分かったうえで答えてくれます。

STEP
スキルは名前と場所だけ書く

スキルの中身は書かず、名前と一言、SKILL.mdの場所を並べます。
CLAUDE.mdのAvailable Skillsの欄。zoom-manager・obsidian-cli・wiki-updateなどのスキルが、一言の説明と.agents/skillsの下の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、Claude CodeはCLAUDE.md、CodexはAGENTS.mdを読み、CLAUDE.mdから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が「あなたが誰か」を知らないからです。

オブ君
Claude CodeからCodexに替えたら、いつもと違う答えが返ってきました…
飯塚
自分のことはUSER.mdに書いて、どのAIからも読ませよう!ルールもAGENTS.mdにまとめれば、替えても困らないよ。

私もCursor・Claude Code・Codexと替えてきて、最初は出力ががらっと変わって大変でした。
今はどれを使っても、同じような出力が出ています。

2. シンボリックリンクが難しい

難しければ、CLAUDE.mdの1行目に書くやり方で十分です。

オブ君
AGENTS.mdとCLAUDE.mdを、どうやってつなげばいいのか分かりません…
飯塚
シンボリックリンクが難しければ、1行目に書くだけで大丈夫!作り方は、Claude CodeやCodexに聞けば教えてくれるよ。

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

AGENTS.mdを開くとCLAUDE.mdと同じ中身が出ている画面。左の.claudeの中のskillsなどに矢印が付き、シンボリックリンクと表示されている

シンボリックリンクなら、片方を直すと、もう片方にも同じ中身が出ます。

よくある質問

CLAUDE.mdは、自分で一から書くのですか?

/initと打てば、Claude Codeがフォルダを調べて下書きを作ってくれるんです。

すでにCLAUDE.mdがあるときは、上書きはせず、直す案を出してくれる仕組み。

~/.claude/CLAUDE.mdとObsidian Vaultの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との使い方まで、通して知りたい方に向けて無料の動画を用意しました。

無料プレゼント:10Xロードマップ

元医師の私が、20分の動画で次の5つを話しています。

  • 情報に溺れないための、情報処理のやり方
  • 自分の頭を鍛えながら、AIを使いこなす方法
  • 情報を思考に、思考を知的資産に変えるシステムの全体像
  • 自分らしさを入れて、量産型のAIコンテンツから抜け出す方法
  • 自分の右腕になるAIエージェントを育てる仕組み

10Xロードマップ(無料動画)

メールアドレスを登録すると、すぐに見られます。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次