rulesの早見

Codexのrulesとは?prefix_ruleの書き方と確認のしかた

Codexのrules(ルール)は、サンドボックスの外でどのコマンドを動かしてよいかを細かく決めるファイルです。置き場所、prefix_rule の書き方、判定の優先順、試し方、注意点を、OpenAI公式の文書(2026年11月16日確認)に沿って整理します。公式は、rulesを実験的な機能として案内しています。

このサイトはCodexの公式サイトではありません。公式の文書を元に日本語で整理した解説です。画面の表示や手順は更新されるため、出典と照らして確認してください。

最初に答え

rulesは、「このコマンドはサンドボックスの外で動かしてよいか」を決めるファイルです。公式の説明では、~/.codex/rules/default.rules のように、設定の隣の rules フォルダに .rules ファイルを置きます。判定は3つです。

decision動き
allow(既定)確認なしでサンドボックスの外で実行する
prompt一致するコマンドを実行するたびに確認する
forbidden確認もせず、依頼そのものを止める

複数のルールに一致した時は、いちばん厳しい判定が採用されます。順番は forbidden > prompt > allow です。

どこに置くか

TUIで「このコマンドを許可リストに入れる」を選ぶと、Codexは ~/.codex/rules/default.rules に書き込みます。管理者は、requirements.toml で制限の強い prefix_rule を全員に適用できます。置き場所の全体像は.codexフォルダの場所を見てください。

prefix_ruleの書き方

ルールは prefix_rule() で書きます。公式の例は次のとおりで、gh pr view から始まるコマンドを、サンドボックスの外で実行する前に確認する指定です。

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",
    ],
    not_match = [
        "gh pr --repo openai/codex view 7888",
    ],
)
項目内容
pattern(必須)コマンドの先頭部分のリスト。各要素は文字列(例 "pr")か、候補のリスト(例 ["view", "list"])
decisionallow・prompt・forbidden。省略すると allow
justification理由の文。確認の画面や拒否のメッセージに出ることがある。forbidden の時は代わりの方法も書くとよい
match / not_match一致する例と一致しない例。読み込み時に検査され、書き間違いを早く見つけられる

ルールのファイルは、Pythonに似た書き方のStarlarkという言語です。副作用なしで動くように作られていて、ファイルを触らずに安全に評価できます。

一致のしかた:先頭が合うかどうか

Codexは、コマンドの引数のリスト(execvp(3) が受け取る形)を pattern と比べます。一致するのは先頭から完全に同じ時です。上の not_match の例のように、サブコマンドの前に別の引数が入ると一致しません。引数の順番が変わるだけで効かなくなるため、match に実際に使う形を書いておくと安心です。

bash -lc などの複合コマンド

bash -lc・bash -c と、zsh・sh の同じ形は、特別に扱われます。

書いたルールを試す

公式には、ルールの判定を試すコマンドがあります。

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

出力はJSONで、いちばん厳しい判定と、一致したルール(justification を含む)が表示されます。--rules を複数回付けると、複数のファイルを合わせて試せます。このコマンドは公式の一覧で「experimental(実験的)」とされています。

使う時の注意

権限そのものの設計は権限プロファイルとconfig.tomlで整理しています。

書き方の例(公式の書式に沿った当サイトの例)

公式の書式に当てはめると、たとえば次のようなルールが書けます。上は確認を求める例、下は止める例です。実際に使う前に、必ず codex execpolicy check で一致のしかたを試してください。

prefix_rule(
    pattern = ["git", ["push", "reset"]],
    decision = "prompt",
    justification = "Pushing or resetting needs a human look",
)

prefix_rule(
    pattern = ["rm", "-rf"],
    decision = "forbidden",
    justification = "Use a trash-safe alternative instead",
)

1つめは、pattern の2つめの要素に候補のリストを使い、git push と git reset の両方を1つのルールで扱っています。2つめは、rm -rf から始まるコマンドを止める例です。justification に代わりの方法を書いておくと、止められた時にCodexが次の手を考えやすくなります。

承認・権限プロファイル・rulesの使い分け

Codexの安全まわりの設定は、役割が違います。サンドボックスと承認は「何が自動で動くか」の大枠、権限プロファイルは「どのフォルダやネットワークに触れるか」のまとまり、rulesは「サンドボックスの外で動かすコマンドごとの許可」です。大枠は広げずに、よく使う安全なコマンドだけをrulesで許可すると、確認の回数を減らしながら範囲を保てます。

よくある質問

rulesを書いたのに効きません。

Codexを再起動したか、ファイルの置き場所が rules フォルダの中か、プロジェクトの .codex を信頼しているかを確認します。公式は、追加後に再起動するよう案内しています。

rm を丸ごと禁止にできますか。

pattern に ["rm"] を書き、decision を forbidden にします。ただし、リダイレクトや変数を含む複雑なシェルの文は1つの塊として判定されるため、試しのコマンドで必ず確かめてください。

--yolo とrulesの関係は。

公式の文書では、rulesはサンドボックスの外で動かす許可の判断に使うものとして説明されています。承認とサンドボックスを両方外す設定は別の話なので、大事なフォルダでは使わない方が安全です。

関連ページ

出典と確認日

出典は公式の文書です。実験的な機能のため、書き方や動きは更新されることがあります。迷ったら出典を優先してください。

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認
(公式の情報と照らした日)
更新履歴
(公開)

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。