rulesの早見
Codexのrulesとは?prefix_ruleの書き方と確認のしかた
Codexのrules(ルール)は、サンドボックスの外でどのコマンドを動かしてよいかを細かく決めるファイルです。置き場所、prefix_rule の書き方、判定の優先順、試し方、注意点を、OpenAI公式の文書(2026年11月16日確認)に沿って整理します。公式は、rulesを実験的な機能として案内しています。
最初に答え
rulesは、「このコマンドはサンドボックスの外で動かしてよいか」を決めるファイルです。公式の説明では、~/.codex/rules/default.rules のように、設定の隣の rules フォルダに .rules ファイルを置きます。判定は3つです。
| decision | 動き |
|---|---|
allow(既定) | 確認なしでサンドボックスの外で実行する |
prompt | 一致するコマンドを実行するたびに確認する |
forbidden | 確認もせず、依頼そのものを止める |
複数のルールに一致した時は、いちばん厳しい判定が採用されます。順番は forbidden > prompt > allow です。
どこに置くか
- 自分用:
~/.codex/rules/(例:default.rules) - プロジェクト用:
<リポジトリ>/.codex/rules/。公式によると、プロジェクトの.codexを信頼している時だけ読み込まれます - 起動時に、有効な設定の層ごとに
rulesフォルダを調べます。チームの設定の置き場所も対象です - 追加したあとは、Codexを再起動します
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"]) |
decision | allow・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 の同じ形は、特別に扱われます。
- 分けて判定される場合:文が、普通の単語を
&&・||・;・|でつないだ一直線の形のとき。たとえばgit add . && rm -rf /は、git add .とrm -rf /に分けて判定され、いちばん厳しい結果が使われます。git addを許可しても、チェーン全体が許可されるわけではありません - 分けられない場合:リダイレクト(
>・>>・<)、置換($(...)・バッククォート)、環境変数の指定、ワイルドカード(*・?)、制御構文を含むとき。この場合は、文全体が1つの["bash", "-lc", "..."]として判定されます
書いたルールを試す
公式には、ルールの判定を試すコマンドがあります。
codex execpolicy check --pretty \
--rules ~/.codex/rules/default.rules \
-- gh pr view 7888 --json title,body,comments出力はJSONで、いちばん厳しい判定と、一致したルール(justification を含む)が表示されます。--rules を複数回付けると、複数のファイルを合わせて試せます。このコマンドは公式の一覧で「experimental(実験的)」とされています。
使う時の注意
- rulesは実験的で、公式は変わる可能性があると案内しています
- 先頭の一致なので、引数の順番や、サブコマンドの前に付けた引数で効かなくなる
- 複合コマンドが分けて判定されるのは、単純な場合だけ
- プロジェクトのrulesは、信頼した
.codexの層だけで読み込まれる - Smart approvals(既定で有効)では、権限の引き上げを求める時にCodexが
prefix_ruleを提案することがあります。提案された先頭部分は、受け入れる前によく読んでください - WorkのクラウドでLocal computer accessを使う場合、管理されたコマンドの規則はAgent Securityの
rulesで設定し、ローカルの.rulesは適用されません
権限そのものの設計は権限プロファイルと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はサンドボックスの外で動かす許可の判断に使うものとして説明されています。承認とサンドボックスを両方外す設定は別の話なので、大事なフォルダでは使わない方が安全です。
関連ページ
出典と確認日
- OpenAI Learn: Rules(置き場所・prefix_rule・優先順・execpolicy check)
- OpenAI Learn: コマンドラインのオプション(codex execpolicy)
- 確認日: 2026年11月16日
出典は公式の文書です。実験的な機能のため、書き方や動きは更新されることがあります。迷ったら出典を優先してください。
