I’m using Claude Code and OpenAI Codex side‑by‑side on the same projects, and I’m confused about how to treat CLAUDE.md vs AGENTS.md. My current understanding is: CLAUDE.md → Claude‑specific context file that Claude Code auto‑loads for that repo. AGENTS.md → more vendor‑neutral “agents README” that Codex and other tools read. What I’m trying to figure out: Do you keep AGENTS.md as the single source of truth and just mirror it into CLAUDE.md so both tools share the same instructions? Or do you keep Claude‑specific stuff (prompting style, tools, gotchas) in CLAUDE.md and more generic project/workflow info in AGENTS.md? For those using both Claude Code and Codex daily, how do you split the work between them (e.g., reasoning/architecture vs bulk coding), and does that show up in how you write these files? I’ve been recently running this through Superpowers plugin, so any tips or “don’t do this” for shared CLAUDE.md + AGENTS.md setups would be super helpful. submitted by /u/3abwahab
Originally posted by u/3abwahab on r/ClaudeCode