Codex CLI の AGENTS.md とは？

​

短い答え

​

記載する内容

• 依存関係のインストール、プロジェクトの起動、テストの実行方法
• よく使う検証コマンド
• コーディングスタイルと命名規則
• 安易に変更すべきでないディレクトリ
• 完了前に必要なチェック
• コミュニケーションと出力に関するチームの方針

​

記載しない内容

• API Key、トークン、パスワード、非公開の認証情報
• 一時的なタスク指示
• 長い製品の背景説明
• リポジトリと関係のない汎用プロンプト
• 古くなったコマンドとパス

​

適用範囲と優先順位

1. 最初に CODEX_HOME のグローバルルールを読みます。既定の場所は ~/.codex で、空でない AGENTS.override.md を優先し、なければ AGENTS.md を使います。
2. 次にプロジェクトルート（通常は Git ルート）から現在の作業ディレクトリまで順に調べます。プロジェクトルートが見つからない場合、プロジェクトのルールは現在のディレクトリだけを確認します。
3. プロジェクト内の各階層では空でないファイルを最大 1 つ使います。優先順は AGENTS.override.md、AGENTS.md、project_doc_fallback_filenames に設定した名前です。

​

ディレクトリの例

~/.codex/AGENTS.md
repo/AGENTS.md
repo/services/payments/AGENTS.override.md
repo/services/payments/AGENTS.md
repo/services/search/AGENTS.md

​

推奨構成

# Project instructions

## Build and test
- Run `npm test` before finishing behavior changes.
- Run `npm run lint` after editing TypeScript files.

## Style
- Keep diffs small and focused.
- Match existing component patterns.

## Safety
- Do not edit files outside this repository.
- Do not commit secrets.

​

未適用や競合を確認する

codex -C /path/to/repo/services/payments "List the instruction files you loaded and the test command that applies here. Do not edit files."

• 作業ディレクトリと CODEX_HOME を確認します。リポジトリルートから起動しても、すべての子ディレクトリの指示を事前に読むわけではありません。
• 正確なファイル名、空でない内容、同じ階層の AGENTS.override.md を確認します。代替名は project_doc_fallback_filenames への登録が必要です。
• 長い指示が切り詰められる場合は project_doc_max_bytes を確認します。重複を減らし、重要なルールを先頭に置いてください。
• 競合時は両方の出典ファイルと適用ディレクトリを特定します。矛盾するルールを各所にコピーするのではなく、該当ディレクトリに限定した例外を書きます。指示ファイルでサンドボックス権限は変更できません。

​

よくある間違い

• AGENTS.md を非常に長い汎用プロンプトにすること。
• ファイルにシークレットを書き込むこと。
• プロジェクトコマンドが変わっても更新しないこと。
• AGENTS.md とユーザーレベルの config.toml を混同すること。
• ルールがあるため差分とテストのレビューは不要だと考えること。

​

BetterToken について

​

関連ドキュメント

• Codex CLI とは？
• Codex CLI の config.toml を設定する方法
• Codex CLI のサンドボックスと承認モードとは？
• Claude Code の CLAUDE.md とは？

​

参照

• Codex AGENTS.md ガイド
• Codex ベストプラクティス
• OpenAI Codex ディスカッション
• Codex の詳細設定