拾光 AI 工作室

Claude Code 非エンジニア実践・第3回・約9分

それに習慣を覚えさせる：非エンジニアのための CLAUDE.md の書き方

本記事の目次

    執筆時のバージョン：Claude Code 2.1.x／2026年11月（内容は公式ドキュメント 2026-11 の確認に基づいて整理）。 Claude Code は更新がとても速く、画面の文言、コマンド名、既定値は変わることがあります。見ている画面が本文と違うときは、必ず公式ドキュメントを優先してください。

    この記事でできるようになること

    ここまでの2篇で、お気づきになったと思います。新しい会話を開くたびに、Claude はあなたが誰なのかを忘れてしまいます。

    昨日「ファイル名に『最終版』は使わない」と教えたのに、今日新しいウィンドウを開くと、また同じことを聞かれてしまいます。命名ルールやレポートの形式、触ってはいけないフォルダーなどを、毎回説明し直すことになります……

    この記事では、その問題の解決方法をご説明します。あなたの習慣を CLAUDE.md という名前のテキストファイルに書き、フォルダーに置きます。以後、そのフォルダーで Claude Code を起動するたびに、最初から内容を読み込みます。 一度設定すれば、長く効果が続きます。

    読み終えると、次のことができるようになります

    • CLAUDE.md が何か、どこに置けばよいかがわかる
    • 「六段構成」の形式を使い、20分以内に最初の一つを書き上げられる
    • /memory と /context all で、本当に読み込まれているかを確認できる
    • 書き込むべきでない内容と、指示どおりに動かないときの確認方法がわかる

    必要なもの：

    • 第1篇の手順で Claude Code をインストールし、ログイン済みであること
    • 普段ファイルを扱うフォルダー1つ（練習用で構いません。第1・2篇の Claude練習 をそのまま使えます）
    • 約30分

    まず理解：CLAUDE.md とは何か、何ではないか

    何か： メモ帳だけで書ける、テキストファイル（Markdown 形式。実際は純粋なテキストに # の見出し記号を数個加えたものです）。Claude Code は作業を始めるたびに、その内容を背景情報として読み込みます。公式の説明では、「何度も説明し直す必要のある内容」を保管しておく場所です。

    何ではないか： 強制力のある設定ではありません。 公式ドキュメントにも明記されているとおり、Claude は CLAUDE.md を「背景情報」として扱い、できる限り従おうとしますが、厳密に守る保証はありません。指示があいまいだったり、互いに矛盾していたりすると、無視されやすくなります。

    非エンジニアにとって、この点は特に重要です：

    「ファイルを削除しないこと」と CLAUDE.md に書くのは、注意を促すことであって、動きを止めることではありません。本当のブレーキは、第1篇で説明した権限モード（作業前に確認を求めてくる）です。両方を組み合わせて使ってください。

    置き場所（覚えておくべきは2つだけ）

    公式ドキュメントには何種類もの場所が載っていますが、非エンジニアは次の2つだけ覚えれば十分です。

    得たい効果 ファイルの場所 説明
    特定のフォルダーで作業するときだけ適用 そのフォルダー内の CLAUDE.md 例：Claude練習 フォルダー。このフォルダー（またはその下）で起動すると読み込まれます
    どのフォルダーでも適用 ~/.claude/CLAUDE.md Windows では ~ は C:\Users\あなたの名前 を指します。「私は誰か」「回答は常に繁体字中国語で」といった個人的な好みを書くのに向いています

    その他の2つの細かい点：

    • 「起動したフォルダー」とその上位のフォルダーにある CLAUDE.md を読み込みます。内容は互いに上書きされず、重ねて適用されます。
    • サブフォルダーの CLAUDE.md は、最初からは読み込まれず、そのサブフォルダーのファイルを扱い始めたときに読み込まれます。

    おすすめの進め方：まずは1つだけ作り、いちばんよく作業するフォルダーに置いてください。 書き慣れてから追加していけば十分です。

    手順1：まず下書きを作ってもらう（/init）

    白紙から始めたくない場合は、作業フォルダーで Claude Code を起動してから、次のように入力します：

    /init

    公式ドキュメントによると、/init は初期の CLAUDE.md を自動生成します。すでにファイルがある場合は、上書きせず改善案を提示します。

    ただし注意してください：/init はプログラムのプロジェクト向けに設計されており、コードベースを分析してビルドコマンドやテストコマンドを探します。フォルダーの中身が Word、Excel、画像ばかりの場合、生成される内容は漠然としていたり、的外れになったりする可能性があります。（本記事の著者は、ドキュメントだけのフォルダーで /init の出力を実際に検証していないため、「検証待ち」と表記しています。）そのため、非エンジニアの方には、次の手順として、自分で書くか、Claude にインタビューしてもらうことをおすすめします。

    手順2：「六段構成」で最初の1つを書く

    メモ帳を開き、名前を付けて保存します。ファイル名は必ず CLAUDE.md にしてください（保存の種類は「すべてのファイル」を選んでください。そうしないと CLAUDE.md.txt になり、読み込まれません）。作業フォルダーに保存します。

    下の構成をコピーして、自分の内容に置き換えてください：

    # 關於我
- 我是【某某公司】的【行政專員】，名字叫【小安】。
- 我不是工程師，請用白話說明你做了什麼，不要丟一大段技術術語。
- 回答一律用繁體中文（台灣用語）。

# 這個資料夾放什麼
- 00 待整理：還沒分類的檔案
- 10 會議：會議紀錄，依年份分資料夾
- 90 封存：已結案，只讀不改

# 檔名規則
- 格式：YYYYMMDD_類型_主題_版本.副檔名，例如 20261105_會議_採購檢討_v1.docx
- 版本從 v1 開始，改版加 1。不要用「最終版」「最終版(2)」。

# 常見工作怎麼做
## 整理檔案
1. 先列出「舊檔名 → 新檔名」給我看，我說「好」才動手。
2. 動手前先把原檔名清單存成 CSV，方便我救回來。

# 不能做的事
- 不刪除任何檔案；要移除的，移到 90 封存。
- 不覆蓋原檔；修改一律另存新版本。
- 不確定的事先問我，一次問一個問題。

# 不要寫進任何檔案的東西
- 密碼、銀行帳號、身分證字號、客戶私人聯絡方式。

    この六段（私は誰か／フォルダー／ファイル名／よくある作業／やってはいけないこと／機密データ）で、多くのオフィスの場面をカバーできます。

    書くときは次の4つの原則を意識してください

    公式ドキュメントの「効果的な書き方」を、わかりやすく言い換えると：

    1. 確認できるくらい具体的に。 「ファイル名はきちんと」では不十分です。「形式は YYYYMMDD_種類_テーマ_版、例：……」のように書いてください。公式の例では、「2スペースでインデントする」は「コードを正しく整形する」よりも効果的です。
    2. 短く。 公式では1つあたり200行以内に収めることを勧めています。長すぎると作業記憶を圧迫し、遵守率が下がります。
    3. 見出しと箇条書きを使う。 段落ごとに分かれている内容は、長い文章の塊より読みやすくなります。
    4. 矛盾させない。 上位フォルダーに「英語のファイル名を使う」とあり、この文書に「中国語のファイル名を使う」とあると、どちらを選ぶかがランダムになる可能性があります。

    書くべき内容と書くべきでない内容

    書くのに適している 書くのに適していない
    毎回必要なルール（命名、形式、口調） 今回だけ使う指示（会話の中で直接伝える）
    フォルダー構成、触ってはいけない場所 パスワード、アカウント、身分証番号、顧客の個人情報（毎回の会話に読み込まれてしまいます）
    「同じ間違いを2回目にした」ときの訂正 非常に長い作業マニュアル（長すぎると内容が薄まってしまいます）

    もう一つの実用的な判断基準：公式では、「複数の手順からなる固定の流れ」は「スキルカード」にしたほうがよいとされています（次回の記事で説明します）。CLAUDE.md には「毎回知っておくべき事実とルール」を入れます。

    手順3：本当に読み込まれたか確認する

    書いただけでは、読み込まれたとは限りません。必ず確認してください。 保存後、そのフォルダーで Claude Code を起動します：

    cd "$env:USERPROFILE\Claude練習"
claude

    起動したら、次の2つのコマンドを入力してください（公式ドキュメントに基づく）：

    ① 一覧を見る：

    /context all

    一覧の Memory files（メモリファイル）のブロックに、いま書いた CLAUDE.md のパスが表示されるはずです。ここに載っていなければ、読み込まれていません。

    ② 開いて編集する：

    /memory

    このコマンドは CLAUDE.md の場所（ユーザーレベル、プロジェクトレベルを含む）を一覧表示します。ファイルを1つ選ぶと、パソコンのエディターで開いて修正できます。一覧にあるファイルがまだ存在しない場合は、選ぶと先に作成してくれます。

    ③ 一文でテストする：

    我剛下載了一份採購檢討會議的 Word 檔，請告訴我依照我的規則，它應該叫什麼檔名。先不要改。

    「YYYYMMDD_会議_購買振り返り_v1.docx」のような形式で答えてくれたら、読み込めています。

    注意：画面の見た目やブロック名はバージョンによって変わることがあります。上記の /context all、/memory コマンドは公式ドキュメントの記載に基づくもので、筆者は各バージョンの画面を一つずつ照合してはいません。

    手順4：指示どおりに動かないときの確認方法

    公式のトラブルシューティングの順序を、わかりやすく言い換えると：

    1. まず /context all：ファイルは Memory files に載っていますか？載っていなければ → ファイル名が間違っている（よくあるのは CLAUDE.md.txt になっているケース）か、そのフォルダーで起動していません。
    2. 指示があいまい？ 例を入れ、確認できる書き方に直してください。
    3. 互いに矛盾するルールはない？ /memory に表示される各ファイルを開き、同じことについて違うことを書いていないか確認してください。
    4. サブフォルダーの CLAUDE.md は一覧に表示されません。 使われるときに読み込まれる仕組みです。故障ではありません。
    5. 「必ず実行させたいこと」を CLAUDE.md だけに頼らない。 公式では、特定のタイミングで必ず実行しなければならないことには hook（やや上級向け）を使うよう述べられています。非エンジニアの代替策は、第1篇の権限モードを使い、作業前に必ず確認を求めさせることです。

    もう一つのよくある疑問：Claude 自身もメモを取る

    あなたが書く CLAUDE.md とは別に、公式ドキュメントには Claude Code の「自動メモリ」についての説明もあります。これは、あなたの訂正や好みをもとに、Claude が自分でメモを書く機能です。メモは、パソコンの ~/.claude/projects/ の下に保存されます。/memory で開く・編集する・削除することができ、/memory から機能をオフにすることもできます。

    違いは簡単です：CLAUDE.md はあなたが書くルール、自動メモリは Claude が書くメモです。 安定して予測可能にしたいなら、重要なルールは自分で CLAUDE.md に書いてください。

    手順5：その後のメンテナンス

    公式が勧めるタイミングは実用的なので、そのまま使ってください：

    • 同じ間違いを2回したら、その訂正を書き加えてください。
    • 別の会話で同じ訂正を何度も打っていることに気づいたら、それを書き加えてください。
    • 代筆をお願いしたい場合は、「このルールを CLAUDE.md に追加してください。」と言えば大丈夫です。
    • 毎月一度は見直して、古くなったルールを削除してください。公式にも /doctor prompt-audit があり、古くなった内容や互いに矛盾する内容がないかチェックしてもらえます（新しいバージョンが必要です。「要検証」と表記しています）。

    4つの「やってはいけないこと」

    1. パスワード、アカウント、顧客情報は書き込まないでください。 この内容は毎回読み込まれますし、フォルダを他の人と共有する場合もあります。
    2. 1冊のマニュアルのように書かないでください。 200行を超えると、かえって効果が下がります。
    3. 書いたからといって、動作が固定されるわけではありません。 これは注意を促すものであり、保証ではありません。重要な操作は、Claude の計画を確認してから同意してください。
    4. 書いたら放置しないでください。 必ず /context all で一度確認してください。

    既製のものをすぐに使いたい方へ

    ゼロから最初の1つを書くのは、意外と時間がかかります。そこで、事務アシスタント、SNS運営担当、フリーランスの3職種向けのテンプレートを用意しました。いずれも構成が整えられ、「記入が必要な箇所」が明示されています。使い方の説明と書き換えガイドも付いています。【 】の部分をご自身の内容に置き換えるだけで使えます。

    👉 デジタル商品を見る

    （購入されなくても問題ありません。上記の「六段構成」で、使える最初の1つは十分に書けます。）

    次回予告

    第4回：《毎週行う作業を1枚のスキルカードにする：Agent Skills入門》 CLAUDE.md には「毎回知っておくべきルール」を置き、毎週決まって行う「複数ステップの作業手順」は、次回スキルカードにする方法をご紹介します。その後は一言で呼び出せるようになります。

    参考資料（いずれも公式ドキュメント、2026年11月時点で確認）

    操作説明：CLAUDE.md の場所、サイズの目安（200行）、/context all、/memory、/init、自動メモリの説明は、上記の公式ドキュメントに基づいて整理しています。本記事では、画面を作者のパソコンで1項目ずつ実際に確認してはいません。 文書フォルダでの /init の出力と、/doctor prompt-audit は「要検証」です。Mac のパスの書き方（~/.claude/CLAUDE.md）は同じですが、PowerShell のコマンドは、Terminal で cd ~/Claude練習 のように書き換えてください。例に出てくる人名と会社名はすべて架空のものです。

    同シリーズの関連記事

    ← 記事一覧に戻る

    このページは繁体字中国語から機械翻訳しています。内容に違いがある場合は繁体字中国語の原文が優先されます。購入・サポートは繁体字中国語での対応となります。