--- title: "Claude Code と Codex で AGENTS.md を使う" description: "Codex は既定で AGENTS.md を読み込みます。Claude Code 2.1.277 以降は、プロジェクトに CLAUDE.md がなければ読み込みます。両方を残すなら、CLAUDE.md に @AGENTS.md と書きます。" canonical: "https://logbrew.co/ja/guides/agents-md" last_updated: "2026-11-10" --- # Claude Code と Codex で AGENTS.md を使う Codex は既定で `AGENTS.md` を読み込みます。Claude Code 2.1.277 以降は、プロジェクトに `CLAUDE.md` がなければ読み込みます。両方を残すなら、`CLAUDE.md` に `@AGENTS.md` と書きます。 2026年11月10日 に Claude Code 2.1.319、Codex CLI 0.167.0 で検証 執筆 [Furkan Erday](https://github.com/furkanerday). Furkan Erday は LogBrew の創業者です。毎日 Claude Code と Codex を使って LogBrew を開発しています。 Canonical: https://logbrew.co/ja/guides/agents-md ## 各エージェントが `AGENTS.md` を読み込む条件 | プロジェクトにあるファイル | Claude Code | Codex | | --- | --- | --- | | `AGENTS.md` だけ | 読み込む | 読み込む | | `AGENTS.md` と `CLAUDE.md` | 読み込まない | 読み込む | | `@AGENTS.md` をインポートする `CLAUDE.md` | 読み込む | 読み込む | | `AGENTS.md` へのシンボリックリンクにした `CLAUDE.md` | 読み込む | 読み込む | | `AGENTS.md` と `CLAUDE.local.md` | 読み込まない | 読み込む | 各エージェントが最初のリクエストで送った指示を読みました。 ## 2 つのエージェントで 1 つのファイルを使う ### プロジェクトのルートに AGENTS.md を書く ビルドコマンド、テストコマンド、コードのルールを 1 つのファイルにまとめます。どちらのエージェントも、Git リポジトリのルートから現在のフォルダーまで順に読み込みます。 ### Claude Code を更新する Claude Code はバージョン 2.1.277 から `AGENTS.md` を自分で読み込みます。古いバージョンでは、次の手順のインポートが必要です。 ```bash claude update ``` ### CLAUDE.md から AGENTS.md をインポートする 現在のフォルダーかその上に `CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md` のどれかがあると、Claude Code は `AGENTS.md` を読み込みません。両方を読み込むには、`CLAUDE.md` にこの行を追加します。 ```bash @AGENTS.md ``` ### または CLAUDE.md を AGENTS.md へのリンクにする `CLAUDE.md` にインポートの行しか書かないなら、代わりにシンボリックリンクにします。 ```bash ln -s AGENTS.md CLAUDE.md ``` ### または設定で両方を読み込む `CLAUDE.local.md` を残したまま `AGENTS.md` も読み込むには、`~/.claude/settings.json` にこれを追加します。セッション内では、`/config` の Project instructions オプションで同じ値を設定できます。 ```bash { "pluginConfigs": { "cc-plugin-agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` ### Codex が読み込んだ内容を確認する 作業するフォルダーで実行します。Codex のドキュメントは、読み込んだ指示を Codex に繰り返させるコマンドとして、これを挙げています。 ```bash codex --ask-for-approval never "Summarize the current instructions." ``` ## 実際に試して確認したこと 両方のエージェントをローカルのテストサーバーに向け、それぞれが最初のリクエストで送った指示を読みました。これで、各エージェントがどのファイルを読み込むかが正確にわかります。 プロジェクトに `CLAUDE.md` がないとき、Claude Code は `AGENTS.md` を読み込み、デバッグログに `no CLAUDE.md found; AGENTS.md loaded` と出しました。横に `CLAUDE.md` があると、Claude Code は `AGENTS.md` を読み込みませんでした。`@AGENTS.md` のインポートかシンボリックリンクを使うと、`AGENTS.md` の本文はちょうど 1 回だけ現れました。 上の `pluginConfigs` の設定では、プロジェクトに `CLAUDE.local.md` があっても、両方のファイルが読み込まれました。 Codex は最初に `~/.codex/AGENTS.md`、次にルートの `AGENTS.md`、最後に現在のフォルダーのファイルを読み込みました。`AGENTS.override.md` は同じフォルダーの `AGENTS.md` を置き換えました。`CLAUDE.md` は、`project_doc_fallback_filenames` に追加するまで読み込まれませんでした。両方のファイルがあるときは、フォールバックを設定していても、Codex は `AGENTS.md` だけを読み込みました。 ## AGENTS.md と CLAUDE.md の違い Codex は各フォルダーの `AGENTS.override.md` か `AGENTS.md` と、グローバルの `~/.codex/AGENTS.md` を読み込みます。既定の上限は合計 32 KiB です。`CLAUDE.md` は `project_doc_fallback_filenames` に追加したときだけ読み込みます。 Claude Code は `CLAUDE.md` を優先します。`AGENTS.md` と `.claude/AGENTS.md` は、対象となるプロジェクトの `CLAUDE.md` がないときだけ読み込みます。個人用の `~/.claude/CLAUDE.md` はこの判定に含まれないので、`AGENTS.md` と一緒に読み込まれます。 ## GitHub の報告でわかること 409 件のコメントが付いた #6235 では、Claude Code に AGENTS.md への対応が求められました。2026年8月17日、Anthropic のエンジニアが上のインポートとシンボリックリンクを案内して閉じました。今では Claude Code がファイルを自分で読み込みます。#31005 は `.agents/skills/` への対応も求めていて、まだ開いています。 ## よくある質問 ### Claude Code は AGENTS.md を読み込みますか？ はい。バージョン 2.1.277 から、現在のフォルダーかその上に `CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md` がなければ読み込みます。2.1.319 で確認しました。 ### AGENTS.md と CLAUDE.md のどちらを使うべきですか？ チームの誰かが Codex や別のエージェントを使うなら `AGENTS.md` を使います。`CLAUDE.md` は Claude Code だけに当てはまるルール用に残し、そこから `@AGENTS.md` をインポートします。 ### CLAUDE.md を AGENTS.md へのシンボリックリンクにできますか？ はい。検証では、Claude Code はリンク先のファイルを 1 回だけ読み込みました。インポートと同じ結果です。 ### Codex は CLAUDE.md を読み込みますか？ 既定では読み込みません。`~/.codex/config.toml` に `project_doc_fallback_filenames = ["CLAUDE.md"]` を追加します。 ## 本番環境のエラーをエージェントに渡す LogBrew の MCP サーバーを接続すると、Claude Code や Codex は承認したプロジェクトのエラー、ログ、トレースを読めます。十分な無料プランで始められ、カードは不要です。 [エージェントを接続](https://logbrew.co/ja/agents) ## 出典 - [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md) - [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235) - [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005) ## AI コーディングエージェントのその他のガイド - [Claude Code と Codex に MCP サーバーを追加する](https://logbrew.co/ja/guides/mcp-server-claude-code-codex) - [Claude の overloaded エラー 529 とレート制限エラー 429 を解決する](https://logbrew.co/ja/guides/claude-overloaded-rate-limit-error) - [Claude Code、Codex、ブラウザー JavaScript のエラーを解決する](https://logbrew.co/ja/guides)