本文へ移動
問い合わせ設計室相談する

AGENTS.md・CLAUDE.md ジェネレーター

用途と守らせたいルールを選ぶと、AGENTS.md と CLAUDE.md の雛形ができます。登録は不要で、選んだ内容は外部に送りません。

  • 登録不要
  • 入力した内容は外部に送りません
  • ブラウザの中だけで計算

条件を選ぶ

用途

用途を変えると、下の選択はその用途のおすすめに戻ります。

使うツール
守らせたいルール
禁止事項

選んだ内容はこの画面の中だけで処理し、外部には送りません。

作成した雛形

AGENTS.md34 行

# 作業ルール(すべての AI ツール共通)

## このフォルダについて

(ここを書き換える)このリポジトリが何のためのものかを 1〜2 行で書く。
例: 社内の見積もり作成ツール。TypeScript と React で作っている。

## 作業のルール

- 報告は日本語で書き、結論を最初に書く。
- 大きな変更や方針の変更は、作業の前に内容を説明し、了承を得てから進める。
- 変更は小さく分け、1 つずつ確認してから次に進む。
- 変更したら下の「確認の方法」を実行し、結果をそのまま報告する。確認していないことは、確認していないと書く。
- 分からないことは推測で埋めず、分からないと書いて質問する。
- 既存のファイルの書き方、命名、文体に合わせる。

## やってはいけないこと

- パスワード、API キー、個人情報を、ファイルにも報告にも書かない。
- 確認なしにファイルを削除したり、元に戻せない上書きをしたりしない。
- 確認なしに外部へ送信・公開しない(メールの送信、投稿、公開の操作など)。
- 指示なしに git の commit と push をしない。
- 確認なしに新しいパッケージやツールを追加しない。

## 確認の方法

(ここを書き換える)実際に使っているコマンドを書く。
- テスト: `npm test`
- 型チェック: `npm run check`
- 1 つのテストだけ実行する方法: (例: `npm test -- path/to/file.test.ts`)

## 気をつける点

(ここを書き換える)同じ注意を 2 回したことがあれば、ここに 1 行で足す。

CLAUDE.md8 行

@AGENTS.md

# Claude Code だけに当てはまること

共通のルールは AGENTS.md にある。ここには Claude Code だけに関係することを書く。

(ここを書き換える)なければ、この見出しから下は消してよい。
- 例: 手順の長い作業は、スキルにまとめてから使う。
  • AGENTS.md と CLAUDE.md を、どちらも作業するフォルダのいちばん上に置きます。
  • CLAUDE.md の 1 行目の「@AGENTS.md」は消さないでください。この行がないと、Claude Code は AGENTS.md を読みません。
  • 共通のルールは AGENTS.md だけに書きます。両方に同じことを書くと、片方だけ直したときに食い違います。
  • 「(ここを書き換える)」の行を、自分の内容に直してから使ってください。

ルールづくりを相談する

結果の読み方

  • できあがるのは雛形です。「(ここを書き換える)」と書かれた行を、自分のフォルダの内容に直してから使ってください。
  • ファイルは、AI に作業させるフォルダのいちばん上に置きます。
  • 「併用」を選んだ場合、CLAUDE.md の 1 行目の @AGENTS.md は消さないでください。この行が AGENTS.md を読み込む指定です。
  • ここに書いたルールは AI への指示であり、必ず守られる保証はありません。絶対に防ぎたい操作は、ツールの権限設定でも止めてください。

AGENTS.md と CLAUDE.md の書き方

以下は 2026-11-21 に各ツールの公式ドキュメントで確認した内容です。ツールの更新で動作が変わることがあるため、うまく読み込まれないときは公式ドキュメントを確認してください。

2 つのファイルの役割

どちらも、AI のコーディングツールが作業の最初に読む「作業ルールのメモ」です。中身は普通の Markdown で、決まった項目はありません。

  • CLAUDE.md: Claude Code が読むファイルです。作業するフォルダと、その上の階層にあるものが起動時に読み込まれます。
  • AGENTS.md: 特定のツールに限らない共通の形式です。OpenAI の Codex をはじめ、複数のツールが読みます。

併用するときの書き分け

Claude Code は、作業フォルダか、その上の階層に CLAUDE.md があると、AGENTS.md を自動では読みません。AGENTS.md だけがある場合は読みますが、この動作には Claude Code の 2.1.277 以降が必要です。

そのため、Claude Code と Codex などを併用するときは、公式ドキュメントが勧める次の形にします。

  1. 共通のルールは AGENTS.md に書く。
  2. CLAUDE.md に @AGENTS.md と書いて読み込む(公式の例では 1 行目)。
  3. Claude Code だけに関係することを、その下に書く。

同じルールを両方のファイルに書くと、片方だけ直したときに内容が食い違います。共通のルールは AGENTS.md の 1 か所にまとめてください。

長くしすぎない目安

Claude Code の公式ドキュメントは、CLAUDE.md を 1 ファイル 200 行未満にすることを目安にしています。長いファイルは読み込みの負担が増え、指示が守られにくくなるためです。Codex は、読み込む AGENTS.md の合計が初期設定で 32 KiB までです。

書く内容は「AI がフォルダを読んでも分からないこと」に絞ります。確認に使うコマンド、間違えやすい決まり、理由が書かれていない判断などです。フォルダの構成の説明は、AI が自分で読めるので書かなくてかまいません。

書いた後に育てる方法

  • 同じ注意を 2 回したら、その内容を 1 行で足します。
  • あいまいな書き方は具体的に直します。「きれいに書く」ではなく「インデントは空白 2 つ」のように書きます。
  • 矛盾する指示が残っていると、AI はどちらかを選んでしまいます。古くなった行は消します。
  • Claude Code では、/memory で読み込まれているファイルを確認して編集できます。/init は、フォルダの内容をもとに CLAUDE.md の下書きや改善案を作ります。
  • 手順の長い作業は、ルールのファイルに書き足すのではなく、スキルに分けます。

確認した公式ページ

確認日: 2026-11-21

関連記事

関連ツール

無料ツールの一覧を見る

結果をもとに進め方を相談する

状況をうかがったうえで、合う進め方を提案します。まだ依頼するか決めていない段階でもかまいません。

  • 初回 30 分は無料
  • オンライン
  • 返信は 2、3 営業日以内

書いていただけると助かること

  1. 会社または事業の概要と、関わる人数
  2. 相談したい内容(マーケティング、SEO、AI 導入、研修など)
  3. いま困っていること、いつまでに進めたいか