Claude Code・Gemini CLI・Codex CLI の設定ファイルを CLAUDE.md に一本化する方法"
はじめに
お疲れ様です。あきとです。
いくつかのAIエージェントを併用していると、指示ファイルが複数存在することになります。私自身元々は @CLAUDE.md のような参照でCLAUDE.mdにまとめていたのですが、流石に同じ役割のファイルがいくつも並ぶ状態そのものが気になっていました。
どうにか指示ファイルが1つにまとめられないかと調べてみると、Gemini CLI と Codex CLI は設定によって参照を変更できることがわかりました。今回は、AI エージェント向けの指示ファイルを CLAUDE.md に寄せて管理する方法をまとめます。
CLI エージェントの設定ファイルが分散する問題
まずは、各 CLI エージェントがデフォルトでどのファイルを見るのかを整理します。
- Claude Code →
CLAUDE.md - Gemini CLI →
GEMINI.md - Codex CLI →
AGENTS.md
3つのツールに同じルールを適用したい場合、各ファイルへ同じ内容を書く必要があります。
たとえばコーディング規約や応答方針を変えたとき、1つだけ直して残りを忘れる恐れがあります。CLAUDE.md に寄せておけば、更新先を絞れるので管理がかなり楽です。
ここからは、Gemini CLI と Codex CLI で CLAUDE.md を使う設定を順番に見ていきます。
Gemini CLI の設定方法
Gemini CLI は、設定でコンテキスト用ファイル名を変更できます。
プロジェクトルートの .gemini/settings.json に、以下の記述を追加してください。
{
"context": {
"fileName": ["CLAUDE.md"]
}
}
context.fileName にファイル名を指定すると、デフォルトの GEMINI.md ではなく CLAUDE.md を読むようになります。
context.fileName は文字列でも配列でも指定できます。たとえば ["CLAUDE.md", "GEMINI.md"] のように書けば、複数の候補を持たせられます。
Codex CLI の設定方法
一方で Codex CLI は、config.toml でフォールバック用のファイル名を指定します。
~/.codex/config.toml または リポジトリ内の .codex/config.toml に、以下の記述を追加してください。
project_doc_fallback_filenames = ["CLAUDE.md","README.md"]
この設定を入れると、Codex CLI は各ディレクトリで次の順番に指示ファイルを探します。
AGENTS.override.mdAGENTS.mdCLAUDE.mdREADME.md
ただ、project_doc_fallback_filenames はあくまで代替候補です。同じ階層に AGENTS.override.md または AGENTS.md がある場合は、そちらが優先されます。
まとめ
今回は、Claude Code・Gemini CLI・Codex CLI の指示ファイルを CLAUDE.md に寄せて管理する方法を紹介しました。
Gemini CLI はファイル名を直接切り替えられます。これに対し Codex CLI はフォールバック設定なので、AGENTS.md がある階層ではそちらが優先される仕組みです。ここだけ理解しておけば、運用で迷いにくくなります。
指示ファイルを 1つに寄せると、更新漏れを防ぎやすくなります。何より、設定ファイルが散らからないだけでもとても快適です。CLI エージェントを複数使い分けている方は、ぜひ試してみてください。
本ブログが誰かの参考になれば幸いです。
参考資料
- GEMINI.md ファイルでコンテキストを提供する | Gemini CLI
- AGENTS.md によるカスタム指示 | Codex CLI
- Codex CLI Configuration Reference
クラスメソッドオペレーションズ株式会社について
クラスメソッドグループのオペレーション企業です。
運用・保守開発・サポート・情シス・バックオフィスの専門チームが、IT・AIをフル活用した「しくみ」を通じて、お客様の業務代行から課題解決や高付加価値サービスまでを提供するエキスパート集団です。
当社は様々な職種でメンバーを募集しています。
「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、クラスメソッドオペレーションズ株式会社 コーポレートサイト をぜひご覧ください。※2026年1月 アノテーション㈱から社名変更しました
