Claude Code が AGENTS.md を読まない条件と、両方読ませる2つの方法
Codex と同じリポで Claude Code を使うとき、AGENTS.md に書いた指示が Claude Code には効いていないことがある。CLAUDE.md 系のファイルが1つでもあると、標準設定では AGENTS.md は読まれない。
条件
- Claude Code は v2.1.277 から AGENTS.md を直接読む
- ただし読むのは、作業フォルダかその上の階層に
CLAUDE.md・.claude/CLAUDE.md・CLAUDE.local.mdのどれも無いときだけ - ハマりやすいのは
CLAUDE.local.md。自分用メモのつもりで1つ置くだけで AGENTS.md が読まれなくなる ~/.claude/CLAUDE.md（全プロジェクト共通の個人設定）はこの判定に数えない
両方読ませる方法
/configの Project instructions をclaude-md-and-agents-mdにする- CLAUDE.md に1行
@AGENTS.mdと書いてインポートする
Claude 専用の指示が要らないなら、CLAUDE.md を AGENTS.md へのシンボリックリンクにしてもよい（/memory の表示は CLAUDE.md のままだが中身は AGENTS.md になる、と投稿者が確認）。
確かめ方
/memoryを開き、AGENTS.md のパスが一覧にあるか見る- 指示ファイル同士の矛盾は
/doctor prompt-audit（v2.1.283 以降）で点検できる
関連
- 指示ファイルと既存コードが食い違ったとき: CLAUDE.md／AGENTS.md と既存コードが食い違ったら「コード優先・食い違いは報告」と書いておく
- 指示ファイルが攻撃に使われる例: エージェントを ~/Downloads や拾ったリポで起動しない：起動前の点検と設定ファイルの見張り
出典
- @YamanekoInfo · 2026-10-27
- 公式（投稿内のリンク）: code.claude.com