#382 Claude CodeとCodexに同じ設定を書き続けてた。1行で解決しました

2026年5月12日 07:36

「またこっちにも同じことを書くのか」と思いながら、もう一方のファイルを開いていました。

こんにちは、ちーみつです。

Claude CodeとCodexという2つのAIを使っています。
それぞれに「このプロジェクトではこう動いてほしい」と指示するファイルがあるのですが、同じ内容を両方に書き続けていました。
たまたま1行で解決する方法を見つけました。

2つの設定ファイル、それぞれ別々に

Claude Codeというのは、ターミナルやコードエディタ、アプリで使えるAIコーディングツールです。

プロジェクトフォルダを開くと、`CLAUDE.md`というファイルを自動で読み込みます。
「このプロジェクトではこういうルールでお願い」という指示を書いておく場所ですね。

Codexにも同じ仕組みがあって、`AGENTS.md`がそれにあたります。

私はClaude Codeをメインに使っていて、ときどきCodexに切り替えています。
だから両方に同じ内容を書いていたんですよ。

片方を更新したら、もう片方も同じように更新する。

それを繰り返しながら、ずっと「二度手間じゃないか」と感じていました。
CLAUDE.mdもAGENTS.mdも、書いてある内容は一緒なのに、別々に管理していたわけです。

AI 時代の開発の教科書を試していたとき、気づいたらCLAUDE.mdにこの1行が書かれていました。

@AGENTS.md

教材に書いてあったわけではないんです。
AIが自動で書いたのを、後から見て気づきました。

この1行があると、Claude CodeはCLAUDE.mdを読んだあとAGENTS.mdも続けて読んでくれます。
実際の指示はAGENTS.mdにまとめておいて、CLAUDE.mdは参照するだけの構成になります。

逆でもOK。
AGENTS.mdに`@CLAUDE.md`と書いて、指示の本体をCLAUDE.mdに置く形でも動きます。

片方が入り口で、もう片方が本体という構成です。

修正が必要なときも、どちらか1つを直すだけでよくなりました。
「あれ、こっちは更新したっけ」という確認が要らなくなっています。

AGENTS.mdとCLAUDE.mdに同じ内容を書いている方はお試しください。

最後まで読んでいただきありがとうございます。

noteより数時間早く、メルマガで先にお届けしています。
不定期ですが、メルマガだけで加筆して配信することあります。
登録していただくと以下のプレゼントを受け取れます。