AGENTS.md を1本にして Claude Code と Codex で共有する(symlink)
個人の共通ルールを1ファイルに書き、~/.claude/CLAUDE.md と ~/.codex/AGENTS.md を同じファイルへの symlink にする。各プロジェクトの AGENTS.md は1行目で共通ファイルを読ませる。
どんな時に使う?
- Claude Code と Codex を併用していて、片方だけルールを直して食い違う
- スキルも両方のツールで同じものを使いたい
手順
bash
mkdir -p ~/Projects/agent-scripts
# 共通ルールを ~/Projects/agent-scripts/AGENTS.md に書く
ln -sf ~/Projects/agent-scripts/AGENTS.md ~/.claude/CLAUDE.md
ln -sf ~/Projects/agent-scripts/AGENTS.md ~/.codex/AGENTS.mdプロジェクトの AGENTS.md 先頭:
READ ~/Projects/agent-scripts/AGENTS.md BEFORE ANYTHINGスキルは共通フォルダで管理し、各ツールのスキルディレクトリへ同期スクリプト(例: scripts/sync-skills)でコピー or symlink。
注意点
- ツール固有の機能(Claude Code の hooks、Codex の設定 toml)は共有ファイルに書かない。
- 共有ファイルは短く保つ。肥大化すると両方のツールの全セッションで毎回トークンを食う(AIコーディング: 肥大化した AGENTS.md を「サブエージェント3案」で整理させるプロンプト)。
- 元ネタは steipete(OpenClaw 作者)の公開リポジトリ agent-scripts。紹介元アカウントは宣伝色が強いので、構成はリポジトリ本体で確認する。