はじめに

AGENTS.md がない場合に別ファイル名をフォールバックできる設定を初めて知りました。

結論、~/.codex/config.toml にこれを書くだけです。

# ~/.codex/config.toml
project_doc_fallback_filenames = ["CLAUDE.md"]

これで、既存プロジェクトが CLAUDE.md 運用でも、Codexが指示を読んでくれます。
AGENTS.md を CLAUDE.md へのシンボリックリンクにしなくても、project_doc_fallback_filenames の設定だけで CLAUDE.md を読み込ませられることを知りました。

どんなときに便利？

すでに CLAUDE.md を各ディレクトリで運用している
Claude CodeとCodexを併用している

読み込み順（ここが大事）

Codexは各ディレクトリで次の順に探します。

AGENTS.md
project_doc_fallback_filenames に並べた名前（例: CLAUDE.md）

つまり、AGENTS.md があればそちらが優先され、ないときだけ CLAUDE.md が使われます。

設定例

# ~/.codex/config.toml
project_doc_fallback_filenames = ["CLAUDE.md"]

注意点

設定変更後はCodexを再起動（または新規セッション開始）

参考

https://developers.openai.com/codex/guides/agents-md