Codex を開発チームで使い始めると、承認の画面が何度も出てきます。「gh pr view のような読むだけのコマンドは毎回聞かないでほしい」「逆に git push は必ず人が確かめたい」「rm -rf はそもそも実行させたくない」。こうした線引きを、社員一人ひとりのその場の判断に任せていると、チームによって安全の水準がばらばらになります。

この線引きを ファイルに書いて決めておく のが Codex の rules(コマンドルール) です。rules では、サンドボックスの外で実行しようとするコマンドを「許可」「確認」「禁止」の3つに分けられます。さらに管理者は、組織の管理設定 requirements.toml で「確認」と「禁止」のルールを全員にかけられます。

この記事では、rules の置き場所と書き方、つないだコマンドの扱い、書いたルールの確かめ方、管理者が全員にかける方法、社内での進め方を整理します。製品の内容は、2026年11月13日に OpenAI の公式ドキュメント「Rules」と「Managed configuration」で確かめた範囲に絞りました。

結論: 現場は .rules・全員に守らせることは requirements.toml

先に要点をまとめます。

  1. rules はサンドボックスの外で実行するコマンドを allow(許可)・prompt(確認)・forbidden(禁止)に分ける仕組み。公式には 実験的な機能 と書かれている
  2. 個人は ~/.codex/rules/、リポジトリは <repo>/.codex/rules/ に .rules ファイルを置く。リポジトリの rules はプロジェクトの .codex/ が信頼済みのときだけ読み込まれる
  3. 複数のルールが当てはまったら もっとも厳しい判断 が勝つ。&& などでつないだコマンドは1つずつ判定される
  4. 書いたルールは codex execpolicy check で事前に確かめられる
  5. 管理者は requirements.toml の [rules] で prompt か forbidden のルールを全員にかけられる。allow はここには書けない

rules・承認・hooks の違い

Codex には操作を制御する仕組みがいくつかあります。rules の位置づけを先に押さえておくと、どこに何を書くか迷いません。

仕組み 決めること 向いている使い方
サンドボックス ファイルの読み書きやネットワークの範囲 作業の土台になる境界を決める
承認の設定 どんなときに人の確認を求めるか 自動で進めてよい範囲の全体を決める
rules 特定のコマンドを許可・確認・禁止のどれにするか 「このコマンドだけは」という個別の線引き
hooks 決まった場面で社内のスクリプトを動かす 内容を見て判断する検査や記録
AGENTS.md 作業の進め方を文章で伝える 機械的に止める必要のない作業の約束

rules はコマンドの 先頭の並び で判定する、単純で読みやすい仕組みです。引数の中身まで細かく見たいときは hooks のほうが向いています。hooks の使い方はhooks の記事を、土台の設定はサンドボックスと承認ポリシーの記事をご覧ください。

rules ファイルの置き場所

公式ドキュメントでは、有効になっている設定の層の隣にある rules/ フォルダに .rules ファイルを作ると説明されています。Codex は起動時に、すべての有効な層の rules/ を読み込みます。

置き場所 効く範囲 読み込まれる条件
~/.codex/rules/default.rules など その人のすべての作業 常に読み込まれる
<repo>/.codex/rules/ そのリポジトリでの作業 プロジェクトの .codex/ の層が信頼済みのとき
Team Config の置き場所 チームの設定を配っている範囲 配られた層が有効なとき

押さえておきたい点は3つです。

  1. 書いたら Codex を再起動する: ルールは起動時に読み込まれるため、足したあとは再起動が必要です
  2. 承認の画面で許可すると個人のファイルに残る: CLI の画面でコマンドを許可の一覧に加えると、Codex は ~/.codex/rules/default.rules に書き込みます
  3. Work Cloud のローカル接続は別扱い: Work Cloud からローカルのコンピューターを使う場合は、手元の .rules は効かず、管理者が Agent security の rules の項目で設定すると公式ドキュメントに書かれています

rules の書き方

.rules ファイルは、Python に似た Starlark という言語で書きます。副作用なしで動くように作られた言語で、1つのルールは prefix_rule() で表します。公式ドキュメントの例は次の形です(説明のコメントは省いています)。

prefix_rule(
    pattern = ["gh", "pr", "view"],
    decision = "prompt",
    justification = "Viewing PRs is allowed with approval",
    match = [
        "gh pr view 7888",
        "gh pr view --repo openai/codex",
        "gh pr view 7888 --json title,body,comments",
    ],
    not_match = [
        "gh pr --repo openai/codex view 7888",
    ],
)

それぞれの項目の意味は次のとおりです。

項目 必須 意味
pattern 必須 コマンドの先頭の並び。要素は文字列か、["view", "list"] のような候補の一覧
decision 任意(既定は allow) allow は確認なしでサンドボックスの外で実行、prompt は毎回確認、forbidden は確認なしで止める
justification 任意 理由。確認や拒否の画面に表示されることがある
match・not_match 任意 当てはまるべき例と当てはまってはいけない例。読み込み時に検証される

pattern はコマンドの引数の並びと先頭から完全に一致する必要があります。上の例で gh pr --repo openai/codex view 7888 が not_match に入っているのはこのためです。途中に別の引数が入ると当てはまりません。

justification は社員が読む文面です。とくに forbidden では、公式ドキュメントも「代わりの方法を書く」ことを勧めています。「本番の DB には接続できません。検証環境の接続先を使ってください」のように、止めた理由と次にやることを1文で書いておくと、問い合わせが減ります。

match と not_match はテストの役割を持ちます。書き間違いで意図しないコマンドまで許可してしまうことを読み込みの段階で見つけられるので、社内で共有するルールには必ず付けておくのがおすすめです。

判定のしくみ: もっとも厳しいものが勝つ

複数のルールが同じコマンドに当てはまったときは、もっとも厳しい判断が使われます。強さの順は forbidden > prompt > allow です。

この性質のおかげで、ルールを足すときは「広く許可して、危ないものだけ上から禁止する」書き方ができます。たとえば git の読み取り系を許可していても、git push を prompt にするルールが別にあれば、push のときは確認が出ます。

つないだコマンドの扱い

bash -lc や bash -c(zsh・sh も同様)で渡された命令は、中身の台本(スクリプト)が判定の対象になります。公式ドキュメントでは次のように説明されています。

  1. 単純なコマンドを &&・||・;・| でつないだだけの場合: 1つずつに分けて判定し、もっとも厳しい結果を使う。git add を許可していても git add . && rm -rf / が許可されることはない
  2. リダイレクト・置き換え・環境変数・ワイルドカード・制御構文を含む場合: 分けずに、命令全体を ["bash", "-lc", "<スクリプト全体>"] という1つのコマンドとして判定する

2つめの形は個別のルールに当てはまりにくいため、結果として確認に回ることが多くなります。「許可したはずなのに確認が出る」という問い合わせがあったら、まずこの形になっていないかを確かめてください。

書いたルールを確かめる

ルールを配る前には、codex execpolicy check で判定を確かめます。公式ドキュメントの例は次の形です。

codex execpolicy check --pretty \
  --rules ~/.codex/rules/default.rules \
  -- gh pr view 7888 --json title,body,comments

結果は JSON で返り、もっとも厳しい判断と、当てはまったルール(justification を含む)が表示されます。--rules を繰り返すと複数のファイルを合わせて確かめられ、--pretty を付けると読みやすく整形されます。

社内で使うときは、次の3種類のコマンドを一覧にして確かめると漏れが少なくなります。

  1. 許可したいコマンド(例: テストの実行・読むだけの gh の操作)
  2. 確認にしたいコマンド(例: git push・パッケージの追加)
  3. 禁止したいコマンド(例: rm -rf・本番環境への接続)

Codex が提案するルールに注意する

公式ドキュメントでは、smart approvals が既定で有効になっていると説明されています。Codex がサンドボックスの外での実行を求める場面で、prefix_rule を提案することがあります。

便利な反面、提案された接頭辞が広すぎると、意図していないコマンドまで確認なしで通るようになります。たとえば ["npm", "run", "test"] で十分なところを ["npm"] で受け入れると、npm のすべての操作が対象になります。公式ドキュメントも、受け入れる前に提案された接頭辞を確かめるよう書いています。社員向けの研修では「提案されたルールは、範囲を読んでから受け入れる」と伝えておきましょう。

管理者が全員にかけるルール

全員に必ず守らせたいルールは、組織の管理設定 requirements.toml の [rules] に書きます。公式ドキュメントの例は次の形です。

[rules]
prefix_rules = [
  { pattern = [{ token = "rm" }], decision = "forbidden", justification = "Use git clean -fd instead." },
  { pattern = [{ token = "git" }, { any_of = ["push", "commit"] }], decision = "prompt", justification = "Require review before mutating history." },
]

.rules と書き方が少し違い、pattern の要素は token(決まった語)か any_of(候補のどれか)で表します。ほかにも次の違いがあります。

比べる点 .rules ファイル requirements.toml の [rules]
書く人 利用者・リポジトリの管理者 組織の管理者
decision 省略できる(既定は allow) 必須。prompt か forbidden だけ
利用者による上書き できる できない(もっとも厳しい判断が勝つため)
書く言語 Starlark TOML

管理者のルールは利用者の .rules と合わさり、もっとも厳しい判断が勝ちます。そのため、社員が手元で allow を書いても、管理者の forbidden や prompt は外れません。

クラウドで管理する場合は、Admin Console の Agent security で対象の方針を選び、Edit as TOML から Global の requirements.toml に書きます。公式ドキュメントでは、Agent security が有効な場合、ワークスペースのオーナー・管理者・Codex の管理権限を持つメンバーが方針を管理できると説明されています。なお、承認ポリシーの画面の操作ではコマンドルールは作られないため、TOML として書く必要があります。requirements.toml で設定を固定する全体の考え方はセキュリティとガバナンスの記事にまとめています。

社内での進め方

rules を社内に入れるときは、次の順番で進めると手戻りが少なくなります。

  1. 止めたいコマンドを洗い出す: 情シスと開発の責任者で「禁止」「確認」にしたいコマンドを一覧にする。削除・履歴の書き換え・本番環境への接続・外部への公開が候補になりやすい
  2. 試験チームの許可の記録を集める: 1〜2週間使ってもらい、各自の ~/.codex/rules/default.rules に増えた許可を見せてもらう。よく許可しているコマンドが、チームで共有する許可の候補になる
  3. リポジトリ用の .rules を書く: 共有する許可と確認を <repo>/.codex/rules/ に置き、match と not_match を付けて codex execpolicy check で確かめる
  4. 全員にかける禁止と確認だけを管理者に移す: 例外を認めないものは requirements.toml の [rules] に書く。許可はここには書けないので、許可はリポジトリ側に残す
  5. 理由の文面を見直す: justification が社員の読める言葉になっているか、禁止したときの代わりの方法が書いてあるかを確かめる
  6. 変更の窓口を決める: rules は実験的な機能なので、仕様が変わったときに誰が直すかを決めておく

使うチームの選び方は試験導入する部署と人の選び方、社内の約束ごとの文章は社内利用ガイドラインの作り方が参考になります。

まとめ

Codex の rules を使うと、サンドボックスの外で実行するコマンドを許可・確認・禁止に分けて、チームの線引きをファイルで共有できます。複数のルールが当てはまったときはもっとも厳しい判断が勝ち、&& などでつないだコマンドも1つずつ判定されます。書いたルールは codex execpolicy check で確かめ、全員に守らせたい確認と禁止は requirements.toml の [rules] で管理者がかけます。ただし rules は実験的な機能で、hooks と同じくサンドボックスと承認の設定の代わりにはなりません。土台の設定の上に重ねて使ってください。

この記事の内容は、2026年11月13日時点の OpenAI 公式ドキュメントの記載に基づいています。実験的な機能のため、書き方や置き場所は変わることがあります。使う前に最新の記載をご確認ください。デジライズでは、止めたいコマンドの洗い出しから、rules・hooks・サンドボックスを組み合わせた設定の設計、管理者の方針づくりまでを情報システム部門と一緒に進める Codex の法人導入支援のご相談を承っています。「まず1つのチームで試したい」という段階からでもお問い合わせください。