Codex を社内に配るとき、情報システム部門がまず決めたいのは「Codex が実行するコマンドは、どのフォルダを読めて、どこに書けるのか」です。作業中のリポジトリには書き込めないと仕事になりません。一方で、鍵を置いたフォルダや別の案件のリポジトリまで触れる状態は避けたいはずです。
この線引きを名前付きの設定としてまとめたものが「権限プロファイル(permission profile)」です。2026年11月18日に公開された Codex CLI 0.170.0 の変更履歴でも、サンドボックスの説明に権限プロファイルとファイルの規則の解説が加わったことが挙げられています。この記事では、権限プロファイルの決め方を、法人で配る順番に沿って整理します。製品の動きに関わる内容は、2026年11月19日に OpenAI の公式ドキュメント(Permissions・Sandbox・Managed configuration・Changelog)で確かめた範囲に絞りました。
本記事の結論: 権限プロファイルは現在ベータで、内容が変わる可能性があります。そのうえで法人では、組み込みの :workspace を土台にした社内用のプロファイルを1〜3個作り、鍵や設定ファイルは deny で外します。使ってよいプロファイルは管理設定の allowed_permission_profiles で絞り、古い sandbox_mode の設定は先に消します。設定を配ったら、止まるはずの読み書きが本当に止まるかを OS ごとに試してください。
権限プロファイルとは何か
公式の Permissions では、権限プロファイルを「Codex が代わりに実行するローカルのコマンドが、何を読めて、何に書けて、ネットワークのどこに届くか」を決める名前付きの方針として説明しています。ファイルの規則で読み書きの範囲を、ネットワークの規則で行き先を決めます。
ここで押さえておきたいのは、サンドボックスと承認の役割の違いです。Sandbox のページでは「サンドボックスは技術的な境界を決め、承認ポリシーはその境界を越える前に止まって聞くべきときを決める」と説明されています。また、サンドボックスは組み込みのファイル操作だけでなく、Codex が起動するコマンドにもかかります。権限プロファイルは、この「境界」の側を細かく書くための仕組みです。
なお、ページの冒頭には権限プロファイルがベータで、活発に開発中のため変わる可能性があると明記されています。社内に配る前に、使っている版の記載を確かめる手順を必ず入れてください。
組み込みの3つのプロファイル
最初から用意されているプロファイルは次の3つです。
| プロファイル | できること | 法人での考え方 |
|---|---|---|
:read-only |
ローカルのコマンドを読み取りだけにする | 調査・レビュー・初めて触るリポジトリの確認に使う |
:workspace |
作業中のワークスペースのルートとシステムの一時フォルダに書ける | 社内用プロファイルの土台にする |
:danger-full-access |
ローカルのサンドボックスの制限を外す | 既定にしない。使える人と場面を限る |
公式ドキュメントでは、:danger-full-access は「その広いアクセスが意図したものであるときだけ」使うよう書かれています。法人の既定にはせず、後で説明する管理設定で使えないようにしておくのが基本です。
:workspace には法人にとって都合のよい性質があります。:workspace を土台に広げたプロファイルでは、.git・.agents・.codex・.aws が読み取りだけに保たれます(自分で上書きしない限り)。リポジトリの履歴や Codex 自身の設定、クラウドの認証情報を置くフォルダを書き換えさせない状態から始められるので、社内用のプロファイルはここから作るのが分かりやすいです。
社内用のプロファイルを書く
社内用のプロファイルは config.toml の [permissions.<名前>] に書き、最上位の default_permissions にその名前を指定します。公式ドキュメントの例をもとに、後で説明する extends で :workspace を土台にした形にすると次のようになります。
default_permissions = "project-edit"
[permissions.project-edit]
extends = ":workspace"
[permissions.project-edit.workspace_roots]
"~/code/app" = true
"~/code/shared-lib" = true
[permissions.project-edit.filesystem.":workspace_roots"]
"." = "write"
".devcontainer" = "read"
"**/*.env" = "deny"
それぞれの意味は次のとおりです。
extends: 土台にするプロファイル。:read-only・:workspace・ほかの名前付きプロファイルを指定できます。:danger-full-accessは土台にできませんworkspace_roots: そのプロファイルでワークスペースのルートとして扱うフォルダを足しますfilesystem.":workspace_roots": 有効なすべてのワークスペースのルートの中にかける規則です
公式ドキュメントでは、同じ名前のプロファイルを複数の設定の層で足したり置き換えたりできることも説明されています(例として /etc/codex/config.toml と ~/.codex/config.toml の両方で同じプロファイルのワークスペースのルートを足す形が示されています)。ただし description は extends では引き継がれません。
読み書きの3つの値
ファイルの規則に書ける値は3つです。
read: その下のファイルを一覧にして読めるが変更はできないwrite: 読み書きできる。OS が許す範囲で作成・名前の変更・削除も含むdeny: 読み書きの両方を止める。広く許した中から一部を外すときに使う
パスの書き方
パスには、特別な名前と通常のパスの両方を使えます。
| 書き方 | 意味 |
|---|---|
:root |
ファイルシステムのルート |
:minimal |
一般的なツールが動くのに要る OS と実行環境のパス |
:workspace_roots |
セッションのワークスペースのルートと、プロファイルで足したルート |
:tmpdir |
$TMPDIR の場所(ある場合) |
:slash_tmp |
/tmp(ある場合) |
/absolute/path |
絶対パス(Windows では C:\path の形) |
~/path |
ホームフォルダの下のパス |
:workspace_roots の下では、"docs" = "read" や "generated" = "deny" のようにルートからの相対パスで書けます。../other-repo のように上のフォルダへさかのぼる書き方は受け付けられません。別のフォルダを足したいときは、workspace_roots か絶対パスで明示的に書くことになります。
優先順位: 細かい指定と deny が勝つ
規則がぶつかったときの決まりは2つです。
- より細かい(深い)パスの指定が、広い指定より優先される
- 同じパスに2つの指定があるときは
denyがwriteに、writeがreadに勝つ
この決まりがあるので、「ワークスペース全体は write、その中の .env と鍵のフォルダだけ deny」という書き方が素直に効きます。鍵の扱い全体は鍵と環境変数の記事にまとめています。
** の書き方は OS で差が出る
"**/*.env" = "deny" のようなパターンは、各ワークスペースのルートからの相対で照合されます。Linux・WSL・Windows では、終わりのない ** の展開の深さを glob_scan_max_depth(1以上)で絞れます。公式ドキュメントでは、これらの OS では read や write のパターン指定は持ち運びにくいため、正確なパスやフォルダ単位の規則のほうが好ましいとしています。
法人で配るなら、許す側(read・write)はフォルダ単位で書き、パターンは外す側(deny)にだけ使うと決めておくと、OS による違いに悩む場面が減ります。
部署ごとにプロファイルを分ける
プロファイルは名前を付けて複数持てるので、仕事の種類ごとに分けておくと説明しやすくなります。例えば次の3つです。
| 社内での名前の例 | 土台 | 読み書きの考え方 | 向いている人 |
|---|---|---|---|
review |
:read-only |
読み取りだけ。書き込みはさせない | コードを読む・説明させるだけの部署・初めての試験導入 |
project-edit |
:workspace |
担当リポジトリに書ける。.env と鍵のフォルダは deny |
日常の開発をする部署 |
project-edit-shared |
project-edit |
上に加えて共通ライブラリのリポジトリもルートに足す | 複数リポジトリをまたいで直す担当者 |
ポイントは、「誰に何を許すか」をプロファイルの名前で説明できるようにすることです。設定の中身を読まなくても、「この部署は review から始める」と社内で言えれば、申請や承認の記録もそろえやすくなります。試験導入する部署の選び方は試験導入の部署選びの記事を参考にしてください。
承認ポリシーとの組み合わせにも気をつけます。公式ドキュメントでは、プロファイルは承認ポリシーと一緒に使い、承認ポリシーをアクセスの広さに合わせるよう書かれています。書き込める範囲が広いプロファイルほど、境界を越える前に人へ聞く設定を外さないでください。承認ポリシーの考え方はサンドボックスと承認ポリシーの記事で説明しています。
管理設定で使えるプロファイルを絞る
開発者それぞれの config.toml に任せると、:danger-full-access に切り替えた人だけ制限が外れた状態が生まれます。全員にかけたい制限は、管理者が配る requirements.toml にまとめます。
公式の Managed configuration では、requirements は利用者が上書きできない管理者の制限で、承認ポリシー・サンドボックスのモード・権限プロファイルなど安全に関わる設定を縛ると説明されています。手元の値が制限とぶつかると、Codex は制限に合う値へ戻して利用者に知らせます。
権限プロファイルを絞るのが allowed_permission_profiles です。決まりは次のとおりです。
- この表を置くと、それが使ってよいプロファイルの完全な一覧になる
trueにしたものだけが許され、書いていないものとfalseにしたものは使えない- 組み込みのプロファイルや、今後のバージョンで足されるプロファイルも、書いていなければ使えない
- Codex 0.138.0 以降が必要で、それより前のバージョンはこの表を無視する
「書いていないものは全部止まる」という決まりは、法人にとって扱いやすい形です。新しい版で広いプロファイルが足されても、一覧に足すまでは使われません。
切り替えるときの順番
公式ドキュメントには、切り替えの注意も書かれています。
- 管理するプロファイルの許可リストを配る前に、
sandbox_modeと[sandbox_workspace_write]を設定から消す - 古い版と新しい版が混ざる期間は、
allowed_sandbox_modesの制限を一時的に残してよい(全員が 0.138.0 以降になるまで) - 読み込まれる設定のどれかに
sandbox_modeが残っているか、--sandboxを付けて起動すると、古い設定のほうが使われる
3つ目は見落としやすい点です。社内の手順書やスクリプトに --sandbox が残っていると、配ったプロファイルが効かないまま動きます。切り替えの前に、社内の手順書と自動化のスクリプトを一度検索しておいてください。
配り方は、ChatGPT でサインインする利用者なら管理画面の Agent security から始める方法が案内されており、ローカルのファイルを配らなくても使えると書かれています。ChatGPT でサインインしない利用者向けには、自社で用意した HTTPS の配布先から Codex CLI とデスクトップアプリへ配る方法や、macOS の MDM で配る方法も説明されています。設定を固定する全体の考え方はセキュリティとガバナンスの記事にまとめています。
OS ごとの違いと注意点
権限プロファイルを実際に守らせる仕組みは OS によって異なります。
| OS | 仕組み | 公式ドキュメントにある注意 |
|---|---|---|
| macOS | Seatbelt | 方針を守らせられないときは、サンドボックスなしで動かさずにコマンドの実行を断る |
| Linux・WSL | bubblewrap と seccomp | 古い Landlock の方式はファイルを絞る方針では使えないため、更新時に features.use_legacy_landlock を切る |
| Windows | プロセスの分離 | 権限の低い方式はネットワークの分離が弱い。Linux のサンドボックスの形に合わせたいなら WSL を勧めている |
ほかにも、運用で効いてくる注意が4つ書かれています。
- ファイルの規則が空のとき:
filesystemの表が空か無い場合、ファイルへのアクセスは絞られたままになり、起動時に警告が出ます。広く開いてしまう方向には倒れません - パターンの照合は起動時の時点: Linux・WSL・Windows では、読み取りを止めるパターンに当たるファイルは各コマンドの起動時に確定します。その後に作られたファイルは、動いているコマンドの中では止まりません
- 書いたものは後に残る: スクリプト・シェルの起動ファイル・共有フォルダへの書き込みは、後でサンドボックスの外で動くツールにも影響します。書き込みを許すフォルダにシェルの設定ファイルを含めないでください
- クラウドは別扱い: Work Cloud がこのプロファイルに対応していると考えないよう書かれています
ネットワークの規則も同じプロファイルの中に書けますが、ネットワークの許可とドメインでの絞り込みは別の設定です。プロキシを有効にしないとドメインの決まりは守られません。また、Web 検索・コネクタ・MCP サーバー・ブラウザやコンピューター操作・Codex 自身の通信は、コマンドのネットワークの許可リストでは管理されません。ネットワーク側の決め方はネットワークアクセスの記事で説明しています。
導入して確かめる手順
社内では次の順で進めると、設定と記録がそろいます。
- 使っている Codex の版と、Permissions のページの最新の記載を確かめる(ベータのため変わることがある)
- 試験導入する部署の作業を書き出し、読むだけで足りるか・どのリポジトリに書く必要があるかを表にする
:read-onlyと:workspaceを土台に、社内用のプロファイルを1〜3個作る。.env・鍵・認証情報のフォルダはdenyにする- 社内の設定・手順書・スクリプトから
sandbox_modeと--sandboxを探して消す requirements.tomlのallowed_permission_profilesに社内用のプロファイルだけをtrueで書いて配る。古い版が残る間はallowed_sandbox_modesも残す- 各 OS で、止まるはずの操作を Codex に頼む。ワークスペースの外のフォルダへの書き込み・
.envの読み取り・:danger-full-accessへの切り替えが止まることを確かめる - 許したリポジトリでは作業が進むことを確かめ、結果と設定の中身を記録する。プロファイルや Codex の版を変えるたびに手順6と7をやり直す
手順6は、設定を書いただけで終わらせないための確認です。パターンの照合は起動時の時点で決まることや、OS によって守らせる仕組みが違うことを考えると、「止まるはずの読み書きが本当に止まるか」を実際の端末で試すことがいちばん確かです。社内ルールに落とすときは社内利用ガイドラインの記事の項目に「使ってよいプロファイル」と「申請の手続き」を足してください。危ないコマンドそのものを止める仕組みはコマンドルールの記事で扱っています。
まとめ
権限プロファイルは、Codex が実行するコマンドに読ませる範囲・書かせる範囲・触らせない範囲を名前付きでまとめる仕組みです。現在はベータなので最新の記載を確かめながら使います。法人では :workspace を土台に社内用のプロファイルを少数作り、鍵や設定は deny で外し、使ってよいプロファイルを allowed_permission_profiles で絞ります。古い sandbox_mode の設定を残さないこと・OS ごとに止まることを試すことの2点が、配ったあとに効かない状態を防ぐ鍵です。
この記事の内容は、2026年11月19日時点の OpenAI 公式ドキュメントの記載に基づいています。設定項目の名前や画面の操作は変わることがあるため、使う前に最新の記載をご確認ください。デジライズでは、情報システム部門と一緒に部署ごとの権限プロファイルを設計し、管理設定の配り方・古い設定からの切り替え・端末ごとの確認までを含めて Codex の法人導入を支援しています。進め方に迷ったら、お気軽にご相談ください。
- https://learn.chatgpt.com/docs/permissions
- https://learn.chatgpt.com/docs/sandboxing
- https://learn.chatgpt.com/docs/enterprise/managed-configuration
- https://learn.chatgpt.com/docs/changelog
確認日:2026年11月19日。提供条件・機能・料金は変更されるため、最新情報は各公式ページをご確認ください。
デジライズの実績はデジライズ全体の社内集計値です。Codex の機能・対応環境・料金・提供条件は記事の公開・更新時点の OpenAI 公式情報に基づき、変更される場合があります。導入効果は企業や業務によって異なります。



