Codexサンドボックスの権限プロファイル:フルアクセスなしでnpmを許可
Codexのワークスペース保護を維持しながら、パッケージレジストリへのアクセスを許可します。権限プロファイルとネットワークプロキシを設定し、許可と拒否の両方を検証します。広い読み取り権限、OSによる制限、企業の管理要件で選択できるプロファイルが変わる条件も説明します。
目次

Codexでリポジトリのファイルは編集できるのにnpmパッケージをダウンロードできない場合は、API設定より先にサンドボックスの権限プロファイルを確認してください。組み込みの:workspaceプロファイルはコマンドのネットワーク通信を無効にするため、ローカルのCodexセッションで依存パッケージをインストールする開発者に影響します。フルアクセスに切り替えるのではなく、:workspaceを継承したプロファイルでネットワークプロキシを有効にし、レジストリのホスト名を許可してください。
2026-11-19時点で、OpenAIは権限プロファイルをベータ機能として説明しています。この記事では、ローカルで実行するコマンドの権限を設定します。以降のコード例で使うシェルはBashです。macOS、Linux、またはWSL2で設定と動作を確認するための手順を示します。
標準のワークスペースプロファイルでは何ができますか?
Gitリポジトリをワークスペースのルートとして使う場合、:workspaceはサンドボックス内のコマンドにソースファイルの編集を許可します。ただし、ワークスペース内のすべての場所が書き込み可能になるわけではなく、一部のディレクトリには保護が残ります。各ワークスペースルートの下にある.git、.codex、.agents、.awsは読み取り専用のままです。そのため、.codex/config.tomlなどのリポジトリ設定や、.git/hooks内のフックを直接書き換えることはできません。この保護はワークスペースルート配下のパスに適用されます。コンピューター上の同じ名前のディレクトリすべてを保護するものではありません。
読み取りは、より広い範囲で許可されます。OS上でユーザーに権限があれば、コマンドはリポジトリの外にあるファイルも読めます。OpenAIの標準サンドボックスの制限に関する説明では、外部に置かれたコンパイラー、SDK、ライブラリ、設定を使うための仕組みとされています。これらのファイルをCodexのコマンドから隠す機能ではありません。
ネットワークが無効なのは、データを読めるコマンドに、そのデータを外部へ送信する権限まで自動的に与えないためです。同じ理由で、依存パッケージのダウンロードにも追加のアクセス許可が必要です。また、OpenAIは子プロセスが親プロセスのサンドボックス制限を継承すると説明しています。元のコマンドが終了した後も動き続ける子孫プロセスにも、制限は引き続き適用されます。
たまにダウンロードするだけなら、既定のプロファイルを変更せず、ネットワークアクセスの要求を確認してください。ネットワークプロキシの説明によると、Codexは要求をユーザーに提示するか、自動審査に回します。依存パッケージを繰り返しダウンロードする場合は、レジストリへのアクセスを許可した専用プロファイルを使います。ネットワークを必要としない作業では、無効のままにしてください。
npmレジストリ用のdevプロファイルを設定する
インストール済みのCodex CLIが、文書化されているcodex sandbox --permission-profileに対応している必要があります。以下の確認にはnpm、curl、Bashも必要です。ポリシーを検証するときは、普段の開発用リポジトリではなく、確認後に破棄できるGitリポジトリの作業コピーを使ってください。検証コマンドは、その作業コピーのルートから実行します。
ユーザー設定ファイル~/.codex/config.tomlを編集します。すでに設定が書かれている場合は、対応する既存のテーブルに以下の項目を組み込みます。単に末尾へ追加して、同じテーブルを重複して定義しないでください。この設定で、devが既定の権限プロファイルになります。
従来のsandbox_modeや[sandbox_workspace_write]と、この設定を併用しないでください。権限プロファイルのドキュメントでは、両方を混在させず、どちらか一方の設定方式を選ぶ必要があります。
default_permissions = "dev"
[features]
network_proxy = true
[permissions.dev]
description = "Workspace editing with npm registry access."
extends = ":workspace"
[permissions.dev.filesystem.":workspace_roots"]
".devcontainer" = "read"
".vscode" = "read"
".env" = "deny"
".env.local" = "deny"
"secrets" = "deny"
[permissions.dev.network]
enabled = true
[permissions.dev.network.domains]
"registry.npmjs.org" = "allow"
"example.com" = "deny"
extends = ":workspace"は、.gitと.codexの読み取り専用保護を含め、組み込みの保護を継承します。追加したファイルシステムの設定では、エディターと開発用コンテナーの設定を引き続き読めるようにしながら、それらへの書き込みを禁止します。各ワークスペースルート配下では、指定した環境変数ファイルとsecretsディレクトリ以下へのアクセスも拒否します。OpenAIのファイルシステム権限の定義では、readは読み取り専用、writeは読み書き、denyはアクセスの拒否を意味します。
ネットワークには、通信自体の許可と、ドメイン単位の制限を担う別々の設定項目があります。permissions.dev.network.enabled = trueはネットワークの利用を許可し、**network_proxy = true**はドメインルールの適用を有効にします。ネットワーク権限のドキュメントにあるとおり、プロキシが有効でない状態でネットワークを許可すると、直接ネットワークにアクセスできます。その場合、ドメインルールは適用されません。プロキシの設定を省略しないでください。
OpenAIの企業向けセキュリティガイドでは、依存パッケージへのアクセス例にregistry.npmjs.orgを使っています。ここでのexample.comは、拒否動作を確認するために明示的に禁止した接続先です。ドメインルールの仕様では、明示的な拒否が、一致する許可ルールより優先されます。許可ルールに該当しない別の接続先へ要求を送る場合は、その要求の承認が必要になるか、要求自体がブロックされます。
この設定で、パッケージのインストール処理が接続する可能性のあるホストすべてにアクセスできるわけではありません。追加の接続先が必要になった場合も、先にそのホストへアクセスする理由を調べます。プロジェクトでの必要性を確認できてから、ホスト名を追加してください。
許可と拒否の両方を確認する
codex sandboxを使い、対象のプロファイルを直接適用してコマンドを試します。--include-managed-configも指定すると、プロファイルを解決する際に管理者の要件が含まれます。企業ポリシーによって選択できるプロファイルが制限されている場合は、その管理要件も含めた状態で確認することが重要です。
まず、Bashからレジストリへの接続を確認します。
codex sandbox --permission-profile dev --include-managed-config -- \
npm ping --registry=https://registry.npmjs.org \
--cache="$PWD/.npm-cache"
npm pingが成功すると、PONGが表示されます。この例ではcacheオプションでnpmのキャッシュをワークスペース内に置きます。そのため、ワークスペースの外にキャッシュを置く場合と違い、キャッシュ保存先への書き込み権限を別途追加する必要がありません。この確認で分かるのはレジストリに接続できることだけです。すべての依存パッケージやインストールスクリプトが正常に処理される保証ではありません。
次に、ワークスペースへの書き込み、Gitメタデータの保護、禁止ドメインへのアクセスを確認します。それぞれ個別に実行してください。Gitメタデータへの書き込み制限をこの方法で確認するには、.gitというディレクトリが実際に存在している必要があります。実際のリポジトリディレクトリを指すファイルの場合は、この確認の対象外です。
# Expect success: create and remove a temporary workspace file.
codex sandbox --permission-profile dev --include-managed-config -- \
bash -c 'p=$(mktemp ./codex-write-check.XXXXXX) && rm "$p"'
# Expect a filesystem permission denial.
codex sandbox --permission-profile dev --include-managed-config -- \
bash -c 'p=$(mktemp .git/codex-write-check.XXXXXX) && rm "$p"'
# Expect a proxy policy rejection.
codex sandbox --permission-profile dev --include-managed-config -- \
curl --fail --head --max-time 15 https://example.com
設定が意図どおりに機能していれば、ワークスペース内でのファイル作成と削除は成功します。一方、.git内への書き込みと、禁止した接続先へのネットワーク要求は拒否されることが期待されます。設定ミス、ディレクトリが存在しないこと、無関係な接続障害による失敗は、意図した制限が機能した証拠にはなりません。禁止した書き込みやネットワーク要求のどちらか一方でも成功した場合は、そこで作業を止めます。通常の開発作業でそのプロファイルを使う前に、実際にどの設定が適用されているのかを調べてください。上の例は、読者の環境で実行して結果を確かめるための手順です。実施済みのテスト結果として示しているものではありません。
期待どおりの結果になったら、リポジトリのルートから新しいCodexセッションを開始します。/permissionsを実行し、OpenAIのプロファイル設定例で説明されているdevの項目と説明文を確認してください。そのプロファイルが有効な状態で、元の依存パッケージのインストールを再試行します。キャッシュはワークスペース内に置くか、必要な外部キャッシュディレクトリだけにwrite権限を与えてください。
ダウンロードがまだ失敗する場合の確認点
プロファイルが適用されない場合は、読み込まれた設定に従来のサンドボックス設定が残っていないか、最初に確認します。続いて設定の優先順位を確認してください。コマンドラインの指定や信頼済みプロジェクトの設定が、ユーザーの既定値を上書きすることがあります。設定を書き換えたプロファイルと、現在のセッションが実際に使っているプロファイルを混同しないでください。使われていないプロファイルの権限を増やし続けても解決しません。
npm pingは成功するのにインストールが失敗する場合は、失敗した要求の接続先とファイルシステムのパスを別々に調べます。別のホスト名への接続には、その接続先を許可するかどうかの判断が必要です。ワークスペース外のキャッシュに書き込むには、対応するファイルシステムのルールが必要です。ファイルシステムとネットワークの権限は別なので、ネットワークを許可してもファイルの書き込み権限は増えません。
許可した接続先でも失敗する場合は、クライアントがプロキシ設定を使っているか確認してください。OpenAIのネットワークプロキシの実装解説には、プロキシ用の環境変数を使わないプログラムもあると記されています。サンドボックスの制限を取り除くのではなく、クライアントやその設定を調べてください。
Codex自体がモデルプロバイダーに接続できない問題と、サンドボックス内のパッケージマネージャーがブロックされる問題は別です。プロバイダーの認証、Base URL、プロトコルの設定については、別記事のCodex API接続ガイドを参照してください。
読み取り範囲が広いとAPIキーも見えてしまいますか?
はい。読み取り専用の保護は変更を防ぐもので、読み取りを防ぐものではありません。OpenAIはCodexサンドボックスの解説記事で、このトレードオフを明記しています。以下はその和訳です。
その代わりに、コンピューター上の別の場所にある機密ファイルも、引き続き読み取り可能な場合があります。たとえば、APIキーを含む設定ファイルです。
したがって、標準のプロファイルを選んでいるというだけでは、リポジトリ外に置いた秘密情報がコマンドから見えなくなるとは保証されません。
この例が拒否するのは、ルートからの相対パスで指定した.envと.env.local、およびsecretsディレクトリ以下だけです。認証情報を保存するあらゆるファイル名や保存場所を網羅するものではありません。環境に応じて機密性の高いパスにdenyルールを追加してください。必要なら、ワークスペースの外にあるパスも対象にします。確認には無害なテスト用ファイルを使い、実際の認証情報を表示しないでください。
書き込み可能なファイルにもリスクがあります。OpenAIは、node_modules/prettierなどのインストール済みパッケージを書き換えると、エディターが後でサンドボックスの外で実行するフォーマッターに影響し得ると説明しています。node_modulesはGitの追跡対象から除外されることが多いため、変更がgit statusに表示されない可能性があります。追跡中のソースコードだけでなく、書き込み可能なツールや生成された依存ファイルも確認してください。
複数のコーディングエージェントを使うチームは、秘密情報とGitを保護するClaude Codeの権限設定も見直してください。Codexの権限設定キーを別のクライアントにコピーせず、それぞれのツールの設定方式を使います。
DockerではなくOSのサンドボックス機能を使う理由
OSのサンドボックス機能を使えば、Codexは既存の開発ツールを使いながら、起動するコマンドにOSレベルの制限を適用できます。OpenAIはネイティブサンドボックスの設計を、開発環境全体をコンテナー内に再構築する必要をなくすための選択と説明しています。
この設計が必要になる具体的な場面として、OpenAIはMac上でiOSアプリを開発する例を挙げています。OpenAIが説明する構成では、DockerコンテナーからMac用のネイティブビルドツールやiPhoneシミュレーターを起動できません。ビルドやシミュレーターの操作をMacホストに委ねれば、その処理はコンテナー内ではなくホスト上で実行されます。つまり、コンテナーのサンドボックスの外での操作になります。そのため、ホスト上の操作には別の制限が必要です。
macOSでは、CodexはSeatbeltを使います。LinuxとWSL2については、OpenAIのサンドボックス設定手順が、ディストリビューションのパッケージマネージャーでbubblewrapをインストールするよう勧めています。サンドボックスの起動失敗と、レジストリへの要求が拒否される問題は、分けて調べてください。
Windows上で直接実行する場合は、別途検証が必要です。Windowsサンドボックスのドキュメントでは、対応するデバイスでMXCを推奨しています。また、従来のunelevated実装は、指定したパスの読み取り拒否に対応しないと注意されています。WSL2のBashで期待どおりの結果を得られても、それをWindows上で直接実行した場合の検証の代わりにはできません。Windows側でも制限が適用されるかを確認する必要があります。
作業全体をコンテナー内で完結できるなら、コンテナーも選択肢です。ホストのツールに依存する場合は、ホスト上で実行する操作を特定して制限してください。ホストに委ねた処理までコンテナーが保護すると考えないでください。
企業はdevの選択を禁止できますか?
はい。管理者は管理用のrequirements.tomlを使い、ユーザーが選択できるプロファイルを制限できます。ローカルでプロファイルを定義しても、その制限は上書きできません。OpenAIの管理要件の設定例には、次のポリシーがあります。
default_permissions = ":read-only"
[allowed_permission_profiles]
":read-only" = true
":danger-full-access" = false
allowed_permission_profilesがある場合、最終的に統合されたテーブルが、許可されたプロファイルの完全な一覧になります。そのテーブルにないプロファイルと、明示的にfalseに設定されたプロファイルは拒否されます。上の例が統合後の最終的な許可リストなら、独自のdevプロファイルは許可されていないため使えません。ポリシーの回避を試みるのではなく、ビルドに適したプロファイルを管理者に承認してもらってください。
管理設定のドキュメントには、重要なバージョン条件もあります。権限プロファイルの許可リストにはCodex 0.138.0以降が必要です。Codex 0.137.0以前は、allowed_permission_profilesと管理対象のdefault_permissionsを無視します。この機能で制限を強制できることを前提にする前に、管理下にある各クライアントのバージョンを確認してください。一部のクライアントだけを確認して済ませないことが重要です。
展開時には、対応する各OSで、許可されたビルドと意図的に禁止した操作を検証します。レジストリの権限は必要な範囲に絞り、想定したプロファイルが選ばれていることを確認してください。クライアントを更新する際にも、禁止操作の確認を継続します。