第3章 ルールファイルAGENTS.md — CLAUDE.mdをCodexに移す
必須 この段階を進めるなら、必ず読んでください。一言まとめ: Codexは作業を始める前に**
AGENTS.mdを読みます。Claude CodeのCLAUDE.mdは、そのままではCodexは読みません。 整理ツールフォルダのルールをAGENTS.mdに移し、新しい会話でルールを言わなくても**守るかどうかを試します。
この章は、2026年11月1日に確認したCodex公式ドキュメントと、このガイドが整理ツールフォルダで実際に試した結果をもとに書きました。ルールファイルがなぜ必要かは、Claude Code 第6章で説明しました。ここでは、Codexで違う点だけを扱います。
CodexはCLAUDE.mdを読まない
Codexのルールファイルの名前はAGENTS.mdです。[1] 別の名前のファイルをルールとして使うには、設定に別途登録する必要があり、登録していない名前は無視されます。[2] そのため、CLAUDE.mdはそのままではルールとして読まれません。
第2章の実行記録でも確認できました。CodexはフォルダでAGENTS.mdを探し、なかったので様式(templates/)だけを読みました。CLAUDE.mdは開いていません。
それでも第2章の議事録は、(メモになし)のルールを守っていました。同じルールが様式の案内文(templates/README.md)にも書かれていたからです。逆に言えば、CLAUDE.mdだけに書かれたルールは、Codexは知りません。
理解度チェック
AGENTS.md がないのに、Codex は「(メモにない)」というルールを守りました。このガイドの実習では、その理由は何だったでしょうか?
CLAUDE.mdをAGENTS.mdに移す
移す作業もCodexに任せます。この章の実行も、第2章と同じCodexをターミナルで動かしたものです。今回は、ルールを1つ新しく加えました。あとでこのルールが守られているかを見れば、AGENTS.mdを読んだかどうかをかなり信頼できる形で推測できます。
CLAUDE.mdはClaude Codeが読むルールファイルだよ。同じルールをCodexも読めるように、AGENTS.mdに移して。ルールの内容は変えずに、ルールを1つだけ追加して:「整理したファイルの一番下に『原本と照らし合わせること』の節を置き、数字・名前・日付のうち再確認が必要なものを3つ以内で書く。」CLAUDE.mdはそのままにして。CodexはCLAUDE.mdの5つのルールをそのまま移し、新しいルールを6番目として加えました。そして「追加したルールを除けば、原本と内容が完全に一致することを検証した」と知らせました。
結果: AGENTS.md
CLAUDE.mdを消さなかった理由があります。同じフォルダをClaude Codeでも使い続けられるようにするためです。その代わり、2つのファイルを一緒に直す必要があります。片方だけ直すと、2つのツールが別のルールで作業することになります。
理解度チェック
同じフォルダを Claude Code と Codex の両方で使うために、AGENTS.md を作り、CLAUDE.md も残しておきました。今後の注意点はどれでしょうか?
ルールを言わずに試す
新しい会話を開き、ルールの話はせずに、勉強メモの整理だけをお願いします。
inbox/study-2026-10-28-prompt-lecture.txt を勉強ノートに整理して、notes/ に保存して。結果の一番下に、新しいルールの節ができました。
## 原本と照らし合わせること
- 講義の日付: 10/28(水)。原本には10/28と書かれており、年はファイル名の2026年を基準にした。
- 講義の分量: 1時間。
- 講師が紹介したプロンプトの書き方: 5種類。結果: ルールだけで作った勉強ノート
| いつ作ったファイル | 「原本と照らし合わせること」の節 |
|---|---|
| AGENTS.md前(第2章の議事録) | なし |
| AGENTS.md後(この勉強ノート) | あり |
出典: このガイドの実習結果(2026-11-01、各1回)
新しいルールはAGENTS.mdにしかなかったので、Codexがそのファイルを読んで従ったと見ることができます。毎回守られる保証はないので、結果を見るたびに確認しましょう。
この実験の限界(クリックして開く)
- 1回ずつ試した結果です。
- 前と後のメモの種類(議事録・勉強ノート)が違います。
- 様式のチェックリストにも、「原本のメモと一度照らし合わせた」という似た項目があります。
もっと確かめたければ、同じメモをAGENTS.mdなしで1回、ありで1回動かして比べてみてください。
理解度チェック
AGENTS.md が本当に読まれているか確認したいと思います。このガイドが使った方法はどれでしょうか?
AGENTS.mdを読む順番
AGENTS.mdは2か所に置けます。[3]
| 場所 | 適用範囲 | 例 |
|---|---|---|
~/.codex/AGENTS.md | 自分のすべてのフォルダ | 「答えは韓国語で」 |
プロジェクトフォルダのAGENTS.md | そのフォルダだけ | 整理ツールのルール |
出典: Codex公式ドキュメント(一部のみ抜粋)[3:1]
両方あるときはつなげて、1つのように読みます。このとき、今いるフォルダに近いファイルが後ろにつき、後ろに来た指示が前の指示より優先されます。[4]
たとえば、~/.codex/AGENTS.mdに「答えは韓国語で」、整理ツールフォルダのAGENTS.mdに「答えは英語で」と書いてあるとします。整理ツールフォルダのファイルが後ろにつくので、このフォルダでは「英語で」が勝ちます。
つなげられる量には上限があります。合わせたサイズが標準で32KiB(キビバイト、ファイルの大きさの単位)に達すると、その後ろは足されません。[5] 韓国語でおよそ1万字強です。ルールは短く保ってください。
ルールを直したのに反映されていないようなら、新しい会話を始めるか、Codexを再起動してください。Codexは実行を始めるたびに、ルールを新しく読み込みます。[6]
AGENTS.mdがまだないフォルダなら、アプリの入力欄に/initと打って、ひな形を作ることもできます。[7]
理解度チェック
~/.codex/AGENTS.md と整理ツールのフォルダの AGENTS.md が、違うことを言っています。どちらが優先されるでしょうか?
インポート(Import)とメモリ
この章で手でやったことを、一度にやってくれる機能もあります。インポートは、ほかのエージェントの設定を一度に移してくれる機能です。アプリでは、Claude Code・Claude Cowork・Cursorから取り込めます。[8] アプリの設定のImportメニューから始めます。[9]

このガイドの画面(2026-11-01)では、設定の左の一覧にImportがあり、このコンピューターで見つかったClaude Code・Claude Cowork・Cursorが、それぞれImportボタンと一緒に表示されていました。このガイドはボタンを押していません。
このガイドはインポートを実行しませんでした。 インポートは、1つのフォルダだけでなく、自分のコンピューターの個人設定まで一緒に調べます。[10] そして、ルールファイル、スキル、スラッシュコマンド、設定ファイルを、Codex側の対応するものに変えて一度に移します。たとえばCLAUDE.mdはAGENTS.mdになります。[11] 一度にたくさん移されるので、何が移されるのかを1つずつ自分の目で見たいなら、この章のように手で移すほうがよいでしょう。
インポートが移すものと確認すること(クリックして開く)
| Claude Code側 | Codexに来ると |
|---|---|
ルールファイル(CLAUDE.mdなど) | AGENTS.md |
| スキル | スキル |
スラッシュコマンド(/名前) | スキル($名前) |
settings.json | config.toml |
出典: Codex公式ドキュメント(一部のみ抜粋)[11:1]
settings.jsonとconfig.tomlは、それぞれのツールの設定を書いておくファイルです。名前が違うだけで、役割は同じです。
取り込んでも、元の設定は変わったり消えたりしません。[12] ただし、取り込んだあとには次のものを必ず確認するよう言われています。[13]
- スキルが使えるツールや権限を制限してある部分
- フック(決まったときに自動で動くスクリプト)
- 空欄に値を入れて使うコマンド(引数を使うコマンド)
設定にImportメニューがなければ、GeneralでImport other agent setupを探します。[9:1]
メモリ(Memories)は、以前の作業の文脈を次の作業に持っていく機能です。[14] 自分のコンピューターのCodexのメモリは、標準ではオフになっています。[15] 公式ドキュメントはメモリを「思い出しの補助」としてのみ見ていて、必ず守るルールはメモリに任せないように言っています。[16] 必ず守るルールはAGENTS.mdに書くよう言っています。[17]
理解度チェック
必ず守ってほしい整理ルールは、どこに置くよう公式ドキュメントはすすめているでしょうか?
自分でやってみよう
- 上の依頼で、
CLAUDE.mdをAGENTS.mdに移させる。新しいルールを1つ一緒に加える。 AGENTS.mdを開いて、元のルールがそのままか、新しいルールが加わったかを見る。- 新しい会話を開いて、ルールの話はせずに勉強メモを整理させる。
- 結果に新しいルールが守られているかを確認する。
続きの課題: 第4章では、Codexが何を自分でやり、何を聞いてくるかを決める権限メニューと、変更内容を元に戻す方法を学びます。
まとめ
- Codexは
AGENTS.mdを読む。CLAUDE.mdは、そのままでは読まない。 - 2つのツールを一緒に使うなら、2つのファイルを一緒に直す。
- 新しいルールを入れて、言わないまま試せば、ルールファイルが読まれているかがわかる(今回の実習: 前0 → 後1)。
- 個人のルールは
~/.codex/AGENTS.md、フォルダのルールはフォルダのAGENTS.md。近いほうが優先される。 - インポートは設定を一度に移すが、個人設定まで調べられる。必ず守るルールは、メモリではなく
AGENTS.mdに。
用語まとめ
| 用語 | 読み方 | 一言でいうと |
|---|---|---|
| Import | インポート | ほかのエージェントの設定をCodexに移す機能 |
| Memories | メモリーズ | 以前の作業の文脈を次に思い出す機能 |
/init | イニット | AGENTS.mdのひな形を作るコマンド |
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: 第4章 権限と元に戻す方法
参考資料(17件)
Codex公式ドキュメント、「Custom instructions with AGENTS.md」。"Codex reads
AGENTS.mdfiles before doing any work." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Custom instructions with AGENTS.md」。"Filenames not on this list are ignored for instruction discovery." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Custom instructions with AGENTS.md」。"In your Codex home directory (defaults to
~/.codex, unless you setCODEX_HOME), Codex readsAGENTS.override.mdif it exists." / "Starting at the project root (typically the Git root), Codex walks down to your current working directory." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Custom instructions with AGENTS.md」。"Files closer to your current directory override earlier guidance because they appear later in the combined prompt." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Custom instructions with AGENTS.md」。"Codex skips empty files and stops adding files once the combined size reaches the limit defined by
project_doc_max_bytes(32 KiB by default)." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Custom instructions with AGENTS.md」。"If instructions look stale, restart Codex in the target directory." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Slash commands」。"Generate an
AGENTS.mdscaffold for the current project." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Import from another agent」。"The desktop app can import from Claude Code, Claude Cowork, or Cursor." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Import from another agent」。"If Import isn't available as a settings section yet, open General and find Import other agent setup." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Import from another agent」。"The import flow checks both your user-level setup and your existing projects." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Import from another agent」。表「What ChatGPT can import」のInstruction files・
settings.json・Skills・Slash commandsの行。 learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Import from another agent」。"Importing doesn't change or delete your existing agent setup." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Import from another agent」。"Tool restrictions or permissions in imported skills and agents." / "Hooks whose behavior may differ after import." / "Prompt templates or command-style prompts that depend on arguments, shell interpolation, or file-path placeholders." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Memories」。"Memories let ChatGPT and Codex carry useful context from earlier work into future work." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Memories」。"Local Codex memories are off by default." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Memories」。"Treat memories as a helpful recall layer, not as the only source for rules that must always apply." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Memories」。"Keep required team guidance in
AGENTS.mdor checked-in documentation." learn.chatgpt.com (確認日 2026-11-01) ↩︎