はじめに
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を再起動（または新規セッション開始）