構成リファレンス

このページは、Codex の設定ファイルを調べるための検索可能なリファレンスです。概念の解説や例については、まず設定の基本と高度な設定を参照してください。

`config.toml`

ユーザーレベルの設定は ~/.codex/config.toml にあります。プロジェクト単位の上書き設定を .codex/config.toml ファイルに追加することもできます。Codex は、プロジェクトを信頼している場合にのみ、プロジェクト単位の設定ファイルを読み込みます。

プロジェクト単位の設定では、マシンローカルのプロバイダー、認証、ホスト側で管理するアプリリクエストのメタデータ、通知、設定プロファイルの選択、テレメトリのルーティングキーを上書きできません。Codex は、openai_base_url、 chatgpt_base_url、apps_mcp_product_sku、model_provider、 model_providers、notify、profile、profiles、 experimental_realtime_ws_base_url、otel がプロジェクト内の .codex/config.toml に含まれていても無視します。プロバイダー、通知、テレメトリのキーは、代わりにユーザーレベルの設定に記述してください。設定のプロファイルファイルは、 config.toml と同じディレクトリに $CODEX_HOME/profile-name.config.toml として配置します。 --profile profile-name で使用するプロファイルを選択します。

サンドボックスと承認に関するキー（approval_policy、sandbox_mode、sandbox_workspace_write.*）については、このリファレンスと併せてサンドボックスと承認、書き込み可能なルート内の保護されたパス、ネットワークアクセスを参照してください。ベータ版の権限プロファイルについては、権限を参照してください。

Key	Type / Values	Details
`agents`	`table`	マルチエージェントの設定とカスタムロール宣言です。スカラー設定の名前は予約されており、カスタムロール名には使用できません。
`agents.<name>.config_file`	`string (path)`	そのロール用の TOML 構成レイヤーへのパスです。相対パスは、ロールを宣言している設定ファイルを基準に解決されます。
`agents.<name>.description`	`string`	そのエージェント種別を選択して生成するときに Codex に提示される、ロールに関するガイダンスです。
`agents.default_subagent_model`	`string`	生成するエージェントのデフォルトモデルです。生成時にモデルが明示的に指定されている場合は、その指定が優先されます。
`agents.default_subagent_reasoning_effort`	`string`	生成するエージェントのデフォルトの推論強度です。生成時に推論強度が明示的に指定されている場合は、その指定が優先されます。
`agents.enabled`	`boolean`	マルチエージェントツールを有効または無効にします。デフォルトは true です。
`agents.interrupt_message`	`boolean`	エージェントのターンが中断されたときに、モデルから参照できるメッセージを記録します。デフォルトは true です。
`agents.max_concurrent_threads_per_session`	`number`	プライマリスレッドを除き、生成されたエージェントのスレッドを同時に開いておける最大数です。未設定の場合は Codex がデフォルト値を選択します。
`agents.max_threads`	`number`	`agents.max_concurrent_threads_per_session` の従来の別名です。
`allow_login_shell`	`boolean`	シェルベースのツールがログインシェルとして動作できるようにします。デフォルトは `true` です。`false` の場合、`login = true` のリクエストは拒否され、`login` を省略するとデフォルトで非ログインシェルになります。
`analytics.enabled`	`boolean`	このマシン／プロファイルのアナリティクスを有効または無効にします。未設定の場合は、クライアントのデフォルトが適用されます。
`approval_policy`	`untrusted \| on-request \| never \| { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }`	コマンド実行前に Codex が一時停止して承認を求めるタイミングを指定します。`approval_policy = { granular = { ... } }` を使用すると、ほかのプロンプトでは対話形式を維持しながら、特定のカテゴリのプロンプトについて表示を許可するか自動拒否するかを指定することもできます。`on-failure` は非推奨です。対話型の実行では `on-request`、非対話型の実行では `never` を使用してください。
`approval_policy.granular.mcp_elicitations`	`boolean`	`true` の場合、MCP の誘発プロンプトは自動拒否されず、表示が許可されます。
`approval_policy.granular.request_permissions`	`boolean`	`true` の場合、`request_permissions` ツールからのプロンプトの表示が許可されます。
`approval_policy.granular.rules`	`boolean`	`true` の場合、execpolicy の `prompt` ルールによって発生する承認プロンプトの表示が許可されます。
`approval_policy.granular.sandbox_approval`	`boolean`	`true` の場合、サンドボックスの権限昇格に関する承認プロンプトの表示が許可されます。
`approval_policy.granular.skill_approval`	`boolean`	`true` の場合、スキルスクリプトの承認プロンプトの表示が許可されます。
`approvals_reviewer`	`user \| auto_review`	`on-request` またはきめ細かな承認ポリシーで、対象となる承認プロンプトを誰がレビューするかを指定します。デフォルトは `user` です。`auto_review` ではレビュー担当のサブエージェントを使用します。この設定はサンドボックスの動作を変更しません。また、サンドボックス内ですでに許可されている操作をレビューの対象にすることもありません。
`apps._default.approvals_reviewer`	`user \| auto_review`	アプリごとの上書き設定がない場合に、アプリツールの承認プロンプトをレビューするデフォルトの担当者です。省略すると、アプリは最上位の `approvals_reviewer` の値を継承します。
`apps._default.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	アプリ単位またはツール単位の上書き設定がないアプリツールに適用する、承認に関するデフォルトの動作です。
`apps._default.destructive_enabled`	`boolean`	`destructive_hint = true` が設定されたアプリツールを、デフォルトで許可するか拒否するかを指定します。
`apps._default.enabled`	`boolean`	アプリごとの上書き設定がない場合に、すべてのアプリに適用する有効／無効のデフォルト設定です。
`apps._default.open_world_enabled`	`boolean`	`open_world_hint = true` が設定されたアプリツールを、デフォルトで許可するか拒否するかを指定します。
`apps.<id>.approvals_reviewer`	`user \| auto_review`	このアプリのツールの承認リクエストをレビューする担当です。`apps._default.approvals_reviewer` を上書きします。
`apps.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	ツールごとの上書き設定がない場合に、このアプリのツールに適用するデフォルトの承認動作です。
`apps.<id>.default_tools_enabled`	`boolean`	ツールごとの上書き設定がない場合に、このアプリのツールに適用するデフォルトの有効・無効の設定です。
`apps.<id>.destructive_enabled`	`boolean`	このアプリのツールのうち、`destructive_hint = true` を示すものを許可またはブロックします。
`apps.<id>.enabled`	`boolean`	ID で指定したアプリ／コネクタを有効または無効にします（デフォルト：true）。
`apps.<id>.open_world_enabled`	`boolean`	このアプリのツールのうち、`open_world_hint = true` を示すものを許可またはブロックします。
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	アプリの特定のツールに適用する承認動作の上書き設定です。
`apps.<id>.tools.<tool>.enabled`	`boolean`	アプリの個々のツール（例：`repos/list`）の有効・無効を上書きする設定です。
`auto_review.policy`	`string`	自動レビュー用のローカルなポリシー指示を Markdown 形式で指定します。管理設定の `guardian_policy_config` が優先されます。空の値は無視されます。
`background_terminal_max_timeout`	`number`	空の `write_stdin` ポーリング（バックグラウンドターミナルのポーリング）の最大待機時間（ミリ秒）です。デフォルトは `300000`（5 分）です。従来の `background_terminal_timeout` キーに代わる設定です。
`browser_use.allow_history_access`	`boolean`	ブラウザの履歴へのアクセスを制限するには、`false` に設定します。管理要件によって、この制限を強制することもできます。
`browser_use.default_origin_policy`	`table`	フォールバックとして適用する、ブラウザのオリジンに対する制限です。`access`、`uploads`、`downloads`、`full_cdp_access` に対応しており、それぞれ `allow` または `deny` に設定します。
`browser_use.origins.<origin>`	`table`	`browser_use.default_origin_policy` と同じフィールドを使用する、オリジンごとのブラウザ制限です。HTTP または HTTPS スキームを含め、必要に応じてポートを指定します。パス、クエリ、フラグメントは含めません。ローカルの設定値で、管理設定による拒否を緩和することはできません。
`chatgpt_base_url`	`string`	ChatGPT のログインフローで使用するベース URL を上書きします。
`check_for_update_on_startup`	`boolean`	Codex の起動時に更新を確認します（更新を一元管理している場合にのみ false に設定してください）。
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	CLI が認証情報をキャッシュする保存先を指定します。
`compact_prompt`	`string`	履歴のコンパクション用プロンプトをインラインで上書きします。
`computer_use.default_app_access`	`allow \| deny`	「コンピューターの使用」で、フォールバックとして適用するネイティブアプリへのアクセスポリシーです。アプリ固有のエントリでポリシーを指定できます。ローカル設定で管理設定による制限を緩和することはできません。
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	バンドル識別子をキーとして指定する、macOS ネイティブアプリへのアクセス設定です。
`computer_use.windows.always_allowed_app_ids`	`array<string>`	「コンピューターの使用」で、承認を求めずに開ける Windows アプリの識別子です。一覧にないアプリには承認が必要です。保存済みの項目は、ChatGPT デスクトップアプリの「コンピューターの使用」設定から削除してください。
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Application User Model ID（AUMID）をキーとして指定する、パッケージ化された Windows アプリへのアクセス設定です。
`computer_use.windows.exes`	`array<table>`	Windows 実行ファイルへのアクセスルールです。各ルールには `publisher_name`、`product_name`、`access`（`allow` または `deny`）が必要です。`binary_name` は任意です。
`default_permissions`	`string`	サンドボックス内のツール呼び出しに適用するデフォルトの権限プロファイル名です。組み込みのプロファイルは `:read-only`、`:workspace`、`:danger-full-access` です。カスタムプロファイル名には、対応する `[permissions.<name>]` テーブルが必要です。`sandbox_mode` または `[sandbox_workspace_write]` と併用しないでください。
`desktop.custom_file_handlers.<id>`	`table`	ユーザーレベルでのみ使用できます。ChatGPT デスクトップアプリのアプリで開くメニューに追加する項目を定義します。例とハンドラー ID の制約については、カスタムファイルハンドラーの追加を参照してください。
`desktop.custom_file_handlers.<id>.args`	`array<string>`	コマンドとファイル入力の間に挿入する引数です（デフォルト：`[]`）。
`desktop.custom_file_handlers.<id>.command`	`string`	検出して起動する実行可能ファイルのパスまたはコマンド名です。必須です。
`desktop.custom_file_handlers.<id>.icon`	`string`	ハンドラーのアイコンには、バンドル済みアセットのパス、Base64 エンコードされた `data:image/...` URL、ファイル URI、またはローカルの絶対パスを指定します。必須です。サポートされていないソースの場合は、デフォルトの VS Code アイコンを使用します。
`desktop.custom_file_handlers.<id>.input`	`path \| json_argument \| json_stdin`	アプリがハンドラーにファイル入力を渡す方法です（デフォルト：`path`）。
`desktop.custom_file_handlers.<id>.label`	`string`	アプリで開くメニューに表示される名前です。必須です。
`desktop.custom_file_handlers.<id>.supports_ssh`	`boolean`	SSH ワークスペース内のファイルで、このハンドラーを選択可能にします（デフォルト：`false`）。
`developer_instructions`	`string`	セッションに挿入する追加の開発者指示です（任意）。
`disable_paste_burst`	`boolean`	TUI のバーストペースト検出を無効にします。
`experimental_compact_prompt_file`	`string (path)`	コンパクション用プロンプトの上書き設定をファイルから読み込みます（試験的機能）。
`experimental_use_unified_exec_tool`	`boolean`	統合実行を有効にするための旧名称です。`[features].unified_exec` または `codex --enable unified_exec` を使用してください。
`features.apps`	`boolean`	アプリ（コネクタ）連携を有効にします。安定版の機能で、デフォルトで有効です。アプリとコネクタの通信は、サンドボックス内のコマンド用ネットワークプロキシや、そのドメイン許可リストによる制御の対象外です。
`features.code_mode.direct_only_tool_namespaces`	`array<string>`	コードモードで、直接のツール呼び出しを通じてのみ使用できるツールの名前空間です。
`features.code_mode.enabled`	`boolean`	コードモード機能の構成を有効にします。この機能は開発中で、デフォルトでは無効です。
`features.code_mode.excluded_tool_namespaces`	`array<string>`	コードモードで、ネストされたツールのガイダンスとエグゼキューターへの公開対象から除外するツールの名前空間です。
`features.context_management.experimental_mode`	`boolean`	試験的なコンテキスト管理を有効にします。デフォルトでは無効です。コンテキストを繰り返し単一の要約に圧縮する代わりに、メモと検索可能な履歴を使って、蓄積された詳細情報を保持します。Plus、Pro、または Pro Lite の ChatGPT アカウントでのサインインが必要です。
`features.enable_request_compression`	`boolean`	サポートされている場合、ストリーミングリクエストのボディを zstd で圧縮します（安定版、デフォルトで有効）。
`features.fast_mode`	`boolean`	TUI でモデルカタログのサービスティアを選択できるようにします（安定版、デフォルトで有効）。使用中のモデルが対応を示している場合は、Fast ティアのコマンドも有効にします。
`features.goals`	`boolean`	目標の永続化と自動継続を有効にします（安定版、デフォルトで有効）。
`features.hooks`	`boolean`	`hooks.json` またはインラインの `[hooks]` 構成から読み込むライフサイクルフックを有効にします。`features.codex_hooks` は非推奨の別名です。
`features.memories`	`boolean`	メモリを有効にします。デフォルトでは無効です。
`features.multi_agent`	`boolean`	マルチエージェントの連携ツール（`spawn_agent`、`send_input`、`resume_agent`、`wait_agent`、`close_agent`）を有効にします（安定版、デフォルトで有効）。
`features.network_proxy`	`boolean \| table`	サンドボックス内で実行するコマンド用のネットワークプロキシを起動します（実験的機能、デフォルトでは無効）。管理者が管理する `experimental_network` 要件が有効で、その要件によってプロキシが起動される場合を除き、権限プロファイルのドメインルールを適用するにはこの設定が必要です。`domains` などの機能レベルのポリシーオプションを設定する場合は、テーブル形式を使用してください。ウェブ検索、アプリ、MCP、その他のホスト型ツールはフィルタリングされません。
`features.network_proxy.allow_local_binding`	`boolean`	より広範なローカル／プライベートネットワークへのアクセスを許可します。デフォルトは `false` です。ただし、ローカル IP アドレスのリテラルまたは `localhost` に完全一致する許可ルールを使用すれば、特定のローカル宛先へのアクセスを許可できます。
`features.network_proxy.allow_upstream_proxy`	`boolean`	環境で設定されたアップストリームプロキシを経由する多段接続を許可します。デフォルトは `true` です。
`features.network_proxy.dangerously_allow_all_unix_sockets`	`boolean`	許可リストに含まれる宛先だけに限定せず、任意の Unix ソケット宛先を許可します。デフォルトは `false` です。厳密に管理された環境でのみ使用してください。
`features.network_proxy.dangerously_allow_non_loopback_proxy`	`boolean`	ループバック以外のリスナーアドレスを許可します。デフォルトは `false` です。有効にすると、localhost 以外からもプロキシリスナーにアクセスできるようになる可能性があります。
`features.network_proxy.domains`	`map<string, allow \| deny>`	サンドボックス内のネットワーク接続に適用されるドメインポリシーです。デフォルトでは未設定で、`allow` ルールを追加するまで外部の宛先は許可されません。ホストへの完全一致、サブドメインのみに一致する `.example.com`、ドメイン自体とサブドメインに一致する `.example.com`、すべてのホストに一致する `` の許可ルールをサポートします。`*` を使用すると、パブリックネットワークへのアウトバウンドアクセスが広範に開放されるため、範囲を限定したルールを推奨します。ブロックする宛先には `deny` ルールを追加します。競合した場合は `deny` が優先されます。
`features.network_proxy.enable_socks5`	`boolean`	SOCKS5 サポートを有効にします。デフォルトは `true` です。
`features.network_proxy.enable_socks5_udp`	`boolean`	SOCKS5 経由の UDP 通信を許可します。デフォルトは `true` です。
`features.network_proxy.enabled`	`boolean`	コマンドのネットワークアクセスが有効な場合に、サンドボックス内で実行するコマンド用のネットワークプロキシを起動します。デフォルトは `false` です。プロキシが無効な間は、権限プロファイルのドメインルールは適用されません。
`features.network_proxy.proxy_url`	`string`	サンドボックス内のネットワーク接続に使用する HTTP リスナー URL です。デフォルトは `"http://127.0.0.1:3128"` です。
`features.network_proxy.socks_url`	`string`	SOCKS5 リスナー URL です。デフォルトは `"http://127.0.0.1:8081"` です。
`features.network_proxy.unix_sockets`	`map<string, allow \| deny>`	サンドボックス内のネットワーク接続に適用される Unix ソケットポリシーです。デフォルトでは未設定です。許可するソケットには `allow` エントリを追加してください。
`features.personality`	`boolean`	パーソナリティの選択 UI を有効にします（安定版、デフォルトで有効）。
`features.prevent_idle_sleep`	`boolean`	ターンの実行中にマシンがスリープしないようにします（実験的機能、デフォルトでは無効）。
`features.remote_plugin`	`boolean`	リモートプラグインカタログを有効にします（安定版、デフォルトで有効）。
`features.rollout_budget.enabled`	`boolean`	ロールアウト予算の追跡を有効にします。この機能は開発中で、デフォルトでは無効です。有効にする場合は `features.rollout_budget.limit_tokens` が必須です。
`features.rollout_budget.limit_tokens`	`integer`	ロールアウト予算の追跡に使用するトークン数の上限です。正の値で指定します。ロールアウト予算を有効にする場合は必須です。
`features.rollout_budget.prefill_token_weight`	`number`	ロールアウト予算の計算で、プリフィルトークンに適用する有限かつ非負の倍率です。デフォルトは `1.0` です。
`features.rollout_budget.reminder_interval_tokens`	`integer`	ロールアウト予算のリマインダーの間隔です。正のトークン数で指定します。デフォルトは `limit_tokens` の 10% で、最小値は 1 トークンです。
`features.rollout_budget.sampling_token_weight`	`number`	ロールアウト予算の計算で、サンプリングされたトークンに適用する有限かつ非負の倍率です。デフォルトは `1.0` です。
`features.shell_snapshot`	`boolean`	シェル環境のスナップショットを作成し、コマンドの繰り返し実行を高速化します（安定版、デフォルトで有効）。
`features.shell_tool`	`boolean`	コマンド実行用のデフォルトの `shell` ツールを有効にします（安定版、デフォルトで有効）。
`features.skill_mcp_dependency_install`	`boolean`	スキルに必要な MCP 依存関係が不足している場合に、確認プロンプトの表示とインストールを許可します（安定版、デフォルトで有効）。
`features.unified_exec`	`boolean`	PTY ベースの統合 exec ツールを使用します（安定版、Windows を除きデフォルトで有効）。
`features.web_search`	`boolean`	従来の切り替え設定です（非推奨）。代わりにトップレベルの `web_search` 設定を使用してください。
`features.web_search_cached`	`boolean`	従来の切り替え設定です（非推奨）。`web_search` が未設定の場合、true は `web_search = "cached"` に対応します。
`features.web_search_request`	`boolean`	従来の切り替え設定です（非推奨）。`web_search` が未設定の場合、true は `web_search = "live"` に対応します。
`feedback.enabled`	`boolean`	すべてのローカルクライアントで `/feedback` によるフィードバック送信を有効にします（デフォルト：true）。
`file_opener`	`vscode \| vscode-insiders \| windsurf \| cursor \| none`	Codex の出力に含まれる引用を開くための URI スキームです（デフォルト：`vscode`）。
`forced_chatgpt_workspace_id`	`string (uuid)`	ChatGPT へのログインを特定のワークスペース識別子に限定します。
`forced_login_method`	`chatgpt \| api`	Codex で使用できる認証方法を特定の方式に限定します。
`hide_agent_reasoning`	`boolean`	TUI と `codex exec` の両方の出力で推論イベントを抑制します。
`history.max_bytes`	`number`	設定すると、古いエントリから順に削除し、履歴ファイルのサイズを指定したバイト数以内に制限します。
`history.persistence`	`save-all \| none`	Codex がセッションの記録を history.jsonl に保存するかどうかを制御します。
`hooks`	`table`	`config.toml` 内でインライン定義するライフサイクルフックです。`hooks.json` と同じイベントスキーマを使用します。例とサポート対象のイベントについては、フックガイドを参照してください。
`hooks.<Event>`	`array<table>`	`PreToolUse`、`PermissionRequest`、`PostToolUse`、`PreCompact`、`PostCompact`、`SessionStart`、`SessionEnd`、`SubagentStart`、`SubagentStop`、`UserPromptSubmit`、`Stop`、`Interrupt` などのフックイベント用のマッチャーグループです。
`hooks.<Event>[].hooks`	`array<table>`	マッチャーグループ用のフックハンドラーです。コマンドフックと MCP ツールフックをサポートしています。プロンプトフックとエージェントフックのハンドラーは解析されますが、実行はスキップされます。
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	大きすぎる `additionalContext` をディスクに保存し、モデルには短いプレビューを提示するための、ハンドラーごとのおおよそのトークンしきい値です。デフォルトは `2500` です。`0` の場合はコンテキスト全体をモデルに直接渡します。サイズの大きいフック出力を参照してください。
`hooks.<Event>[].hooks[].async`	`boolean`	トリガー元の処理を遅らせることなく、コマンドフックをバックグラウンドで実行します。デフォルトは `false` です。`SessionEnd` は常に同期実行されます。フックのバックグラウンド実行を参照してください。
`hooks.<Event>[].hooks[].commandWindows`	`string`	コマンドフックのコマンドを Windows でのみ上書きする設定です。TOML の別名 `command_windows` も使用できます。
`instructions`	`string`	将来の利用のために予約されています。`model_instructions_file` または `AGENTS.md` の使用を推奨します。
`log_dir`	`string (path)`	Codex がログファイルを書き込むディレクトリです。デフォルトは `$CODEX_HOME/log` です。この設定を明示すると、オプトイン方式のプレーンテキスト TUI ログ `codex-tui.log` も有効になり、同じディレクトリに出力されます。
`mcp_oauth_callback_port`	`integer`	MCP OAuth ログインで使用するローカル HTTP コールバックサーバーの固定ポートをグローバルに指定します（任意）。サーバー固有の `oauth.callback_port` が優先されます。どちらも設定されていない場合、Codex は OS が選択した一時ポートにバインドします。
`mcp_oauth_callback_url`	`string`	MCP OAuth ログイン用のベースコールバック URL です（任意）。devbox のイングレス URL などを指定します。認可サーバーが発行者の識別に対応している場合、新しく追加した事前登録済みクライアントはこの URL をそのまま使用します。コールバックが保存されていない既存のクライアントは、サーバー固有のコールバック ID を追加します。発行者の識別に対応していない場合、設定済みのコールバックに必要な ID がない事前登録済み MCP サーバーは、この URL に ID を追加したものにフォールバックします。コールバック URL のポート番号では、リスナーのポートは指定されません。
`mcp_oauth_credentials_store`	`auto \| file \| keyring`	MCP OAuth 認証情報の優先保存先です。
`mcp_optional_startup_grace_ms`	`integer (milliseconds)`	初期ツールカタログの構築時に、必須ではない MCP サーバーに共通で適用する待機時間です。デフォルトは `1000` です。`0` に設定すると、代わりに各サーバーの `startup_timeout_sec` に従って待機します。
`mcp_servers.<id>.args`	`array<string>`	MCP stdio サーバーのコマンドに渡す引数です。
`mcp_servers.<id>.auth`	`oauth \| chatgpt`	MCP HTTP サーバーで、設定済みの Bearer トークンと認可ヘッダーに次いで使用する認証フォールバックです。`oauth`（デフォルト）では、保存済みの MCP OAuth 認証情報があれば使用します。`chatgpt` では、信頼されたファーストパーティの ChatGPT オリジンに対して現在の ChatGPT セッションを使用し、その後、保存済みの OAuth 認証情報にフォールバックします。いずれの取得元からも認証情報が得られない場合、どちらのモードでも認証なしで接続できます。
`mcp_servers.<id>.bearer_token_env_var`	`string`	MCP HTTP サーバーの Bearer トークンの取得元となる環境変数です。
`mcp_servers.<id>.command`	`string`	MCP stdio サーバーの起動コマンドです。
`mcp_servers.<id>.cwd`	`string`	MCP stdio サーバープロセスの作業ディレクトリです。
`mcp_servers.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	ツールごとの上書き設定がない場合に、このサーバーの MCP ツールに適用するデフォルトの承認動作です。
`mcp_servers.<id>.disabled_tools`	`array<string>`	MCP サーバーの `enabled_tools` の適用後に適用する拒否リストです。
`mcp_servers.<id>.enabled`	`boolean`	構成を削除せずに MCP サーバーを無効にします。
`mcp_servers.<id>.enabled_tools`	`array<string>`	MCP サーバーが公開するツール名の許可リストです。
`mcp_servers.<id>.env`	`map<string,string>`	MCP stdio サーバーに転送する環境変数です。
`mcp_servers.<id>.env_http_headers`	`map<string,string>`	環境変数から値を設定する、MCP HTTP サーバー用の HTTP ヘッダーです。
`mcp_servers.<id>.env_vars`	`array<string \| { name = string, source = "local" \| "remote" }>`	MCP stdio サーバー向けに許可リストへ追加する環境変数です。文字列で指定したエントリは、デフォルトで `source = "local"` として扱われます。`source = "remote"` は、エグゼキューターを介したリモート stdio でのみ使用してください。
`mcp_servers.<id>.experimental_environment`	`local \| remote`	MCP サーバーの配置先を指定する試験的な設定です。`remote` は、リモートエグゼキューター環境を介して stdio サーバーを起動します。streamable HTTP のリモート配置は実装されていません。
`mcp_servers.<id>.http_headers`	`map<string,string>`	各 MCP HTTP リクエストに含める静的な HTTP ヘッダーです。
`mcp_servers.<id>.http_headers_helper`	`string (command)`	HTTP ヘッダーの名前と値を JSON オブジェクトとして出力するローカルコマンドです。ローカル接続の HTTP MCP サーバーでのみサポートされます。明示的に指定した Bearer トークンと OAuth 認証情報は、ヘルパーが提供する Authorization ヘッダーよりも優先されます。
`mcp_servers.<id>.oauth_resource`	`string`	MCP へのログイン時に含める、任意指定の RFC 8707 OAuth リソースパラメーターです。
`mcp_servers.<id>.oauth.callback_port`	`integer`	この MCP サーバーの OAuth コールバックリスナーで使用する固定ポートです。`mcp_oauth_callback_port` を上書きします。URL にポートを明示した直接のループバックコールバックを使用する場合は、リスナーポートにも同じポートを設定してください。
`mcp_servers.<id>.oauth.callback_url`	`string`	サーバー固有の OAuth コールバックです。発行者の識別がサポートされている場合、または URL の末尾がすでにサーバー固有のコールバック ID である場合、事前登録済みのクライアントはこのコールバックを再利用します。それ以外の場合、Codex はグローバルまたはデフォルトのコールバックにその ID を付加して使用します。事前登録済みの ID がないクライアントは、クライアント登録時にこのコールバックを使用します。
`mcp_servers.<id>.oauth.client_id`	`string`	この MCP サーバーでの認可とトークン交換に使用する、事前登録済みの OAuth クライアント ID です。
`mcp_servers.<id>.required`	`boolean`	true の場合、有効化されているこの MCP サーバーを初期化できないと、起動または再開に失敗します。
`mcp_servers.<id>.scopes`	`array<string>`	その MCP サーバーへの認証時に要求する OAuth スコープです。
`mcp_servers.<id>.startup_timeout_ms`	`number`	`startup_timeout_sec` をミリ秒単位で指定するための別名です。
`mcp_servers.<id>.startup_timeout_sec`	`number`	MCP サーバーの起動タイムアウトを上書きします。デフォルトは 10 秒です。
`mcp_servers.<id>.tool_timeout_sec`	`number`	MCP サーバーのツールごとのタイムアウトを上書きします。デフォルトは 60 秒です。
`mcp_servers.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	このサーバーの特定の MCP ツールに適用する承認動作の上書き設定です。
`mcp_servers.<id>.tools.<tool>.output_token_limit`	`integer (positive)`	特定の MCP ツールの出力に割り当てるトークン予算です。シリアライズ用の標準の余裕分 20% を加える前の値です。そのツールについて、モデルがデフォルトで使用する出力切り詰めのトークン予算を上書きします。
`mcp_servers.<id>.url`	`string`	MCP streamable HTTP サーバーのエンドポイントです。
`memories.consolidation_model`	`string`	全体のメモリ統合に使用するモデルの上書き設定です（任意）。
`memories.disable_on_external_context`	`boolean`	`true` の場合、MCP ツール呼び出し、ウェブ検索、ツール検索などの外部コンテキストを使用するスレッドをメモリ生成の対象から除外します。デフォルトは `false` です。従来のエイリアスは `memories.no_memories_if_mcp_or_web_search` です。
`memories.extract_model`	`string`	スレッドごとのメモリ抽出に使用するモデルの上書き設定です（任意）。
`memories.generate_memories`	`boolean`	`false` の場合、新しく作成されたスレッドはメモリ生成の入力として保存されません。デフォルトは `true` です。
`memories.max_raw_memories_for_consolidation`	`number`	全体の統合に向けて保持する、最近の未加工メモリの最大数です。デフォルトは `256`、上限は `4096` です。
`memories.max_rollout_age_days`	`number`	メモリ生成の対象となるスレッドの最大経過期間です。デフォルトは `30` で、`0`～`90` の範囲に制限されます。
`memories.max_rollouts_per_startup`	`number`	起動時の 1 回の処理で扱うロールアウト候補の最大数です。デフォルトは `16`、上限は `128` です。
`memories.max_unused_days`	`number`	メモリを統合対象に含めるための、最終使用日からの最大経過日数です。デフォルトは `30` で、`0`～`365` の範囲に制限されます。
`memories.min_rate_limit_remaining_percent`	`number`	メモリ生成を開始するために必要な、Codex のレート制限ウィンドウにおける残量の最小割合です。デフォルトは `25` で、`0`～`100` の範囲に制限されます。
`memories.min_rollout_idle_hours`	`number`	スレッドがメモリ生成の対象となるまでに必要な最小アイドル時間です。デフォルトは `6` で、`1`～`48` の範囲に制限されます。
`memories.use_memories`	`boolean`	`false` の場合、Codex は既存のメモリを今後のセッションに組み込みません。デフォルトは `true` です。
`model`	`string`	使用するモデルです（例：`gpt-5.5`）。
`model_auto_compact_token_limit`	`number`	履歴の自動コンパクションを開始するトークン数のしきい値です。未設定の場合は、モデルのデフォルト値を使用します。
`model_auto_compact_token_limit_scope`	`total \| body_after_prefix`	自動コンパクションのしきい値の計算で、アクティブなコンテキスト全体（デフォルトの `total`）を数えるか、引き継がれたコンパクションウィンドウのプレフィックスより後の増加分（`body_after_prefix`）のみを数えるかを指定します。
`model_catalog_json`	`string (path)`	起動時に読み込む JSON モデルカタログのパスです（任意）。選択した `$CODEX_HOME/profile-name.config.toml` プロファイルファイルで、プロファイルごとにこの設定を上書きできます。
`model_context_window`	`number`	アクティブなモデルで使用できるコンテキストウィンドウのトークン数です。
`model_instructions_file`	`string (path)`	組み込みの指示を置き換える設定です。`AGENTS.md` の代わりに使用します。
`model_provider`	`string`	`model_providers` のプロバイダー ID です（デフォルト：`openai`）。
`model_providers.<id>`	`table`	カスタムプロバイダーの定義です。組み込みプロバイダーの ID（`openai`、`ollama`、`lmstudio`）は予約済みであり、上書きできません。
`model_providers.<id>.auth`	`table`	カスタムプロバイダーで、コマンドを使って Bearer トークンを取得するための設定です。`env_key`、`experimental_bearer_token`、`requires_openai_auth` と併用しないでください。
`model_providers.<id>.auth.args`	`array<string>`	トークン取得コマンドに渡す引数です。
`model_providers.<id>.auth.command`	`string`	Codex が Bearer トークンを必要とするときに実行するコマンドです。このコマンドはトークンを stdout に出力する必要があります。
`model_providers.<id>.auth.cwd`	`string (path)`	トークン取得コマンドの作業ディレクトリです。
`model_providers.<id>.auth.refresh_interval_ms`	`number`	Codex がトークンを事前に更新する間隔です（ミリ秒、デフォルト：300000）。認証の再試行後にのみ更新するには `0` に設定します。
`model_providers.<id>.auth.timeout_ms`	`number`	トークン取得コマンドの最大実行時間です（ミリ秒、デフォルト：5000）。
`model_providers.<id>.base_url`	`string`	モデルプロバイダーの API ベース URL です。
`model_providers.<id>.env_http_headers`	`map<string,string>`	環境変数が存在する場合に、その値から設定される HTTP ヘッダーです。
`model_providers.<id>.env_key`	`string`	プロバイダーの API キーを指定する環境変数です。
`model_providers.<id>.env_key_instructions`	`string`	プロバイダーの API キーに関するセットアップ案内です（任意）。
`model_providers.<id>.experimental_bearer_token`	`string`	プロバイダーに直接指定する Bearer トークンです（非推奨。代わりに `env_key` を使用してください）。
`model_providers.<id>.http_headers`	`map<string,string>`	プロバイダーへのリクエストに追加する静的 HTTP ヘッダーです。
`model_providers.<id>.name`	`string`	カスタムモデルプロバイダーの表示名です。
`model_providers.<id>.query_params`	`map<string,string>`	プロバイダーへのリクエストに追加するクエリパラメーターです。
`model_providers.<id>.request_max_retries`	`number`	プロバイダーへの HTTP リクエストの再試行回数です（デフォルト：4 回）。
`model_providers.<id>.requires_openai_auth`	`boolean`	プロバイダーで OpenAI 認証を使用します（デフォルト：false）。
`model_providers.<id>.stream_idle_timeout_ms`	`number`	SSE ストリームのアイドルタイムアウトです（ミリ秒、デフォルト：300000）。
`model_providers.<id>.stream_max_retries`	`number`	SSE ストリーミングが中断した場合の再試行回数です（デフォルト：5 回）。
`model_providers.<id>.supports_standalone_web_search`	`boolean`	互換性のあるスタンドアロンのウェブ検索エンドポイントへの対応を宣言します（デフォルト：false）。スタンドアロン検索は開発中であり、デフォルトでは無効です。プロバイダーが対応しているだけでは有効になりません。
`model_providers.<id>.supports_websockets`	`boolean`	プロバイダーが Responses API の WebSocket トランスポートに対応しているかどうかを指定します。
`model_providers.<id>.wire_api`	`responses`	プロバイダーが使用するプロトコルです。サポートされている値は `responses` のみで、省略した場合もデフォルトでこの値が使用されます。
`model_providers.amazon-bedrock.aws.profile`	`string`	組み込みの `amazon-bedrock` プロバイダーで使用する AWS プロファイル名です。
`model_providers.amazon-bedrock.aws.region`	`string`	組み込みの `amazon-bedrock` プロバイダーで使用する AWS リージョンです。
`model_reasoning_effort`	`minimal \| low \| medium \| high \| xhigh`	対応モデルの推論強度を調整します（Responses API のみ。`xhigh` が利用できるかはモデルによって異なります）。
`model_reasoning_summary`	`auto \| concise \| detailed \| none`	推論要約の詳細度を選択するか、要約を完全に無効にします。
`model_supports_reasoning_summaries`	`boolean`	Codex が推論メタデータを送信するかどうかを強制的に指定します。
`model_verbosity`	`low \| medium \| high`	GPT-5 Responses API の出力の詳細度を任意で上書きする設定です。未設定の場合、選択したモデルまたはプリセットのデフォルト値が使用されます。
`notice.hide_full_access_warning`	`boolean`	フルアクセスの警告プロンプトを確認済みかどうかを記録します。
`notice.hide_gpt-5.1-codex-max_migration_prompt`	`boolean`	gpt-5.1-codex-max 移行プロンプトを確認済みかどうかを記録します。
`notice.hide_gpt5_1_migration_prompt`	`boolean`	GPT-5.1 移行プロンプトを確認済みかどうかを記録します。
`notice.hide_rate_limit_model_nudge`	`boolean`	レート制限に伴うモデル切り替えリマインダーのオプトアウト状態を記録します。
`notice.hide_world_writable_warning`	`boolean`	Windows で全ユーザーが書き込み可能なディレクトリに関する警告を確認済みかどうかを記録します。
`notice.model_migrations`	`map<string,string>`	確認済みのモデル移行を old->new 形式のマッピングとして記録します。
`notify`	`array<string>`	通知時に呼び出されるコマンドです。Codex から JSON ペイロードを受け取ります。
`openai_base_url`	`string`	組み込みの `openai` モデルプロバイダーのベース URL を上書きします。
`oss_provider`	`lmstudio \| ollama`	`--oss` で実行する際に使用するデフォルトのローカルプロバイダーです。未設定の場合は、プロバイダーの指定を求めます。
`otel.environment`	`string`	送出される OpenTelemetry イベントに適用する環境タグです（デフォルト：`dev`）。
`otel.exporter`	`none \| otlp-http \| otlp-grpc`	OpenTelemetry エクスポーターを選択し、必要に応じてエンドポイントのメタデータを指定します。
`otel.exporter.<id>.endpoint`	`string`	OTEL ログ用エクスポーターのエンドポイントです。
`otel.exporter.<id>.headers`	`map<string,string>`	OTEL エクスポーターのリクエストに含める静的ヘッダーです。
`otel.exporter.<id>.protocol`	`binary \| json`	OTLP/HTTP エクスポーターが使用するプロトコルです。
`otel.exporter.<id>.tls.ca-certificate`	`string`	OTEL エクスポーターの TLS 接続で使用する CA 証明書のパスです。
`otel.exporter.<id>.tls.client-certificate`	`string`	OTEL エクスポーターの TLS 接続で使用するクライアント証明書のパスです。
`otel.exporter.<id>.tls.client-private-key`	`string`	OTEL エクスポーターの TLS 接続で使用するクライアント秘密鍵のパスです。
`otel.log_user_prompt`	`boolean`	未加工のユーザープロンプトを OpenTelemetry ログとともにエクスポートする機能を有効にします。
`otel.metrics_exporter`	`none \| statsig \| otlp-http \| otlp-grpc`	OpenTelemetry メトリクスエクスポーターを選択します（デフォルト：`statsig`）。
`otel.trace_exporter`	`none \| otlp-http \| otlp-grpc`	OpenTelemetry トレースエクスポーターを選択し、必要に応じてエンドポイントのメタデータを指定します。
`otel.trace_exporter.<id>.endpoint`	`string`	OTEL ログ用トレースエクスポーターのエンドポイントです。
`otel.trace_exporter.<id>.headers`	`map<string,string>`	OTEL トレースエクスポーターのリクエストに含める静的ヘッダーです。
`otel.trace_exporter.<id>.protocol`	`binary \| json`	OTLP/HTTP トレースエクスポーターが使用するプロトコルです。
`otel.trace_exporter.<id>.tls.ca-certificate`	`string`	OTEL トレースエクスポーターの TLS 接続で使用する CA 証明書のパスです。
`otel.trace_exporter.<id>.tls.client-certificate`	`string`	OTEL トレースエクスポーターの TLS 接続で使用するクライアント証明書のパスです。
`otel.trace_exporter.<id>.tls.client-private-key`	`string`	OTEL トレースエクスポーターの TLS 接続で使用するクライアント秘密鍵のパスです。
`permissions.<name>.description`	`string`	この名前付きプロファイルの説明文です。`extends` を使用しても、親プロファイルの説明は継承されません。
`permissions.<name>.extends`	`string`	この名前付きプロファイルより先に適用する親プロファイルです（任意）。別の名前付きプロファイル、`:read-only`、または `:workspace` を指定します。`:danger-full-access`、未定義の親プロファイル、循環参照は拒否されます。
`permissions.<name>.filesystem`	`table`	名前付きのファイルシステム権限プロファイルです。各キーには、絶対パス、または `:minimal` や `:workspace_roots` などの特殊トークンを指定します。
`permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>`	`"read" \| "write" \| "deny"`	実際に適用される各ワークスペースルートを基準に、ファイルシステムアクセスの範囲を設定します。ルート自体には `"."` を使用します。`"*/.env"` などの glob 形式のサブパスでは、`"deny"` によって読み取りを拒否できます。
`permissions.<name>.filesystem.<path-or-glob>`	`"read" \| "write" \| "deny" \| table`	パス、glob パターン、特殊トークンへの直接アクセスを許可するか、そのルート配下のネストされたエントリの適用範囲を設定します。一致するパスの読み取りを拒否するには `"deny"` を使用します。
`permissions.<name>.filesystem.glob_scan_max_depth`	`number`	サンドボックスの起動前に一致するパスのスナップショットを作成するプラットフォームで、読み取り拒否用の glob パターンを展開する際の最大深度です。設定する場合は `1` 以上にする必要があります。
`permissions.<name>.network.allow_local_binding`	`boolean`	サンドボックス内のネットワーク通信を通じて、ローカルネットワークやプライベートネットワークへの広範なアクセスを許可します。この設定が `false` のままでも、ローカル IP アドレスのリテラルまたは `localhost` に完全一致する許可ルールによって、特定のローカル接続先へのアクセスを許可できます。
`permissions.<name>.network.allow_upstream_proxy`	`boolean`	サンドボックス内のネットワーク通信が別のアップストリームプロキシを経由することを許可します。
`permissions.<name>.network.dangerously_allow_all_unix_sockets`	`boolean`	Unix ソケットの宛先をデフォルトの限定された範囲に制限せず、任意の宛先を許可します。厳格に管理された環境でのみ使用してください。
`permissions.<name>.network.dangerously_allow_non_loopback_proxy`	`boolean`	サンドボックス内のネットワーク通信のリスナーが、ループバック以外のアドレスにバインドすることを許可します。有効にすると、リスナーが localhost 以外からアクセス可能になる場合があります。
`permissions.<name>.network.domains`	`table`	サンドボックス内で実行するコマンドのドメインルールです。`features.network_proxy`、または有効化された管理者管理のネットワーク要件によってプロキシが起動した場合にのみ適用されます。ホストの完全一致、`.example.com`、`.example.com`、すべてを対象とする `` の許可ルールに対応し、`deny` が優先されます。ウェブ検索、アプリ、MCP サーバーは制限されません。
`permissions.<name>.network.domains.<pattern>`	`allow \| deny`	完全一致するホスト、または `.example.com` や `*.example.com` などの範囲を限定したワイルドカードパターンを許可または拒否します。
`permissions.<name>.network.enable_socks5`	`boolean`	この権限プロファイルでサンドボックス内のネットワーク通信を有効にした場合に、SOCKS5 を利用可能にします。
`permissions.<name>.network.enable_socks5_udp`	`boolean`	有効にすると、SOCKS5 リスナー経由の UDP 通信を許可します。
`permissions.<name>.network.enabled`	`boolean`	この権限プロファイルでコマンドのネットワークアクセスを有効にします。この設定ではネットワークプロキシは起動しません。`features.network_proxy` が有効でなく、管理者が管理するネットワーク要件も有効になっていない場合、コマンドはネットワークに直接アクセスし、プロファイルのドメインルールは適用されません。
`permissions.<name>.network.mode`	`limited \| full`	サブプロセスの通信に使用するネットワークプロキシモードです。
`permissions.<name>.network.proxy_url`	`string`	この権限プロファイルでサンドボックス内のネットワーク通信を有効にした場合に使用する HTTP リスナーの URL です。
`permissions.<name>.network.socks_url`	`string`	この権限プロファイルで使用する SOCKS5 プロキシのエンドポイントです。
`permissions.<name>.network.unix_sockets`	`table`	サンドボックス内のネットワーク通信に適用する Unix ソケット許可リストのオーバーライド設定です。ソケットパスをキーとして使用し、`allow` でパスを追加し、`deny` で拒否します。
`permissions.<name>.network.unix_sockets.<path>`	`allow \| deny`	`allow` を使用して Unix ソケットの絶対パスを実際に適用される許可リストに追加するか、`deny` を使用して拒否します。拒否されたエントリは、実際に適用される許可リストから除外されます。
`permissions.<name>.workspace_roots`	`table`	プロファイルで定義するワークスペースルートです。セッション実行時のワークスペースルートとともに、`:workspace_roots` のファイルシステムルールが適用されます。
`permissions.<name>.workspace_roots.<path>`	`boolean`	`true` の場合、そのパスをプロファイルのワークスペースルートに追加します。無効化されたエントリは適用されません。
`personality`	`none \| friendly \| pragmatic`	`supportsPersonality` への対応を示すモデルのデフォルトのコミュニケーションスタイルです。スレッド単位、ターン単位、または `/personality` で上書きできます。
`plan_mode_reasoning_effort`	`none \| minimal \| low \| medium \| high \| xhigh`	プランモード専用の推論強度の上書き設定です。未設定の場合、プランモードでは組み込みプリセットのデフォルト値が使用されます。
`plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	プラグインが提供する MCP サーバー上のツールに対するデフォルトの承認動作です。
`plugins.<plugin>.mcp_servers.<server>.disabled_tools`	`array<string>`	プラグインが提供する MCP サーバーで、`enabled_tools` の後に適用する拒否リストです。
`plugins.<plugin>.mcp_servers.<server>.enabled`	`boolean`	プラグインのマニフェストを変更せずに、インストール済みプラグインに同梱された MCP サーバーを有効または無効にします。
`plugins.<plugin>.mcp_servers.<server>.enabled_tools`	`array<string>`	プラグインが提供する MCP サーバーから公開されるツールの許可リストです。
`plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	プラグインが提供する MCP ツールの承認動作をツールごとに上書きします。
`project_doc_fallback_filenames`	`array<string>`	`AGENTS.md` がない場合に追加で探すファイル名です。
`project_doc_max_bytes`	`number`	プロジェクトの指示を組み立てる際に `AGENTS.md` から読み込む最大バイト数です。
`project_root_markers`	`array<string>`	プロジェクトルートの判定に使うマーカーファイル名のリストです。親ディレクトリをたどってプロジェクトルートを探すときに使用します。
`projects.<path>.trust_level`	`string`	プロジェクトまたは Worktree を信頼済みまたは未信頼としてマークします（`"trusted"` \| `"untrusted"`）。未信頼のプロジェクトでは、プロジェクトローカルの構成、フック、ルールなど、プロジェクト単位の `.codex/` レイヤーがスキップされます。
`review_model`	`string`	`/review` で使用するモデルの上書き設定です（任意）。デフォルトでは、現在のセッションのモデルを使用します。
`sandbox_mode`	`read-only \| workspace-write \| danger-full-access`	コマンド実行時のファイルシステムおよびネットワークアクセスに適用するサンドボックスポリシーです。
`sandbox_workspace_write.exclude_slash_tmp`	`boolean`	workspace-write モードで、書き込み可能なルートから `/tmp` を除外します。
`sandbox_workspace_write.exclude_tmpdir_env_var`	`boolean`	workspace-write モードで、書き込み可能なルートから `$TMPDIR` を除外します。
`sandbox_workspace_write.network_access`	`boolean`	workspace-write サンドボックス内で外部へのネットワークアクセスを許可します。
`sandbox_workspace_write.writable_roots`	`array<string>`	`sandbox_mode = "workspace-write"` の場合に追加する、書き込み可能なルートです。
`service_tier`	`string`	新しいターンで優先するサービスティアです。`fast`、またはアクティブなモデルが提示するほかのティアを使用してください。`fast` はリクエスト値 `priority` に対応します。
`shell_environment_policy.exclude`	`array<string>`	従来の環境変数の除外パターンです。新しい構成では `shell_environment_policy.filters` を使用してください。同じレイヤーで両方の形式を併用しないでください。
`shell_environment_policy.experimental_use_profile`	`boolean`	サブプロセスの起動時に、ユーザーのシェルプロファイルを使用します。
`shell_environment_policy.filters`	`map<string, include \| exclude>`	大文字と小文字を区別しない、標準形式の環境変数パターンフィルターです。含める対象のエントリは許可リストを作成しますが、除外された値を復元することはできません。明示的な `set` の値は、除外処理の後に適用されます。同じレイヤーで、フィルターと従来の `exclude` または `include_only` 配列を併用しないでください。
`shell_environment_policy.ignore_default_excludes`	`boolean`	他のフィルターを適用する前に、名前に KEY、SECRET、TOKEN を含む変数を保持します（デフォルト：true）。シークレットを示す変数名を自動的に除外するには、false に設定します。
`shell_environment_policy.include_only`	`array<string>`	従来の環境変数パターンの許可リストです。新しい構成では `shell_environment_policy.filters` を使用してください。同じレイヤーで両方の形式を併用しないでください。
`shell_environment_policy.inherit`	`all \| core \| none`	サブプロセスの起動時に環境変数を継承するための基本方針です。
`shell_environment_policy.set`	`map<string,string>`	除外処理の後に明示的に追加する環境変数の値です。これらの値も、含める対象を指定するフィルターによって削除される場合があります。
`show_raw_agent_reasoning`	`boolean`	アクティブなモデルが未加工の推論内容を出力した場合に、それを表示します。
`skills.config`	`array<object>`	config.toml に保存される、スキルごとの有効／無効の上書き設定です。
`skills.config.<index>.enabled`	`boolean`	参照先のスキルを有効または無効にします。
`skills.config.<index>.path`	`string (path)`	`SKILL.md` を含むスキルフォルダーへのパスです。
`skills.max_context_tokens`	`integer (positive)`	利用可能なスキルのカタログに割り当てるトークン数です。デフォルトはモデルのコンテキストウィンドウの 2% です。明示的に指定する値の上限は `10000` トークンです。
`sqlite_home`	`string (path)`	Codex が SQLite ベースの状態 DB を保存するディレクトリです。この DB は、エージェントのジョブや、その他の再開可能なランタイム状態に使用されます。
`suppress_unstable_features_warning`	`boolean`	開発中の機能フラグを有効にしたときに表示される警告を抑制します。
`tool_output_token_limit`	`number`	個々のツールや関数の出力を履歴に保存する際のトークン数の上限です。
`tool_suggest.disabled_tools`	`array<table>`	検出可能な特定のコネクタやプラグインの提案を無効にします。各エントリには `type = "connector"` または `"plugin"` と、`id` を指定します。
`tool_suggest.discoverables`	`array<table>`	追加で検出できるコネクタやプラグインについて、ツールの提案を許可します。各エントリには `type = "connector"` または `"plugin"` と、`id` を指定します。
`tools.view_image`	`boolean`	ローカル画像を添付するツール `view_image` を有効にします。
`tools.web_search`	`boolean \| { context_size = "low\|medium\|high", allowed_domains = [string], location = { country, region, city, timezone } }`	ウェブ検索ツールの構成です（任意）。オブジェクト形式では、検索コンテキストのサイズ、検索を許可するドメイン、ユーザーのおおよその位置を設定できます。これらの検索ドメインフィルターは、サンドボックス内で実行するコマンドのネットワークドメインルールとは別であり、コネクタや MCP サーバーを制限しません。
`tui`	`table`	インラインのデスクトップ通知の有効化など、TUI 固有のオプションです。
`tui.alternate_screen`	`auto \| always \| never`	TUI で代替画面を使用するかどうかを制御します。デフォルトは auto です。auto の場合、Zellij ではスクロールバックを保持するため代替画面を使用しません。
`tui.animations`	`boolean`	ターミナルのアニメーション（ウェルカム画面、シマー、スピナー）を有効にします（デフォルト：true）。
`tui.keymap.<context>.<action>`	`string \| array<string>`	TUI アクションに割り当てるキーボードショートカットです。サポートされるコンテキストには、`global`、`chat`、`composer`、`editor`、`vim_normal`、`vim_operator`、`vim_text_object`、`pager`、`list`、`approval` があります。一部のコンポーザーアクションでは、対応する `tui.keymap.global` の割り当てがフォールバックとして使用されます。サポートされている場合は、コンテキスト固有の割り当てが優先されます。
`tui.keymap.<context>.<action> = []`	`empty array`	そのキーマップのコンテキストで、アクションの割り当てを解除します。キー名には、`ctrl-a`、`shift-enter`、`page-down`、`minus` などの正規化された文字列を使用します。
`tui.model_availability_nux.<model>`	`integer`	モデルのスラッグをキーとする起動時ツールチップの内部状態です。
`tui.notification_condition`	`unfocused \| always`	TUI 通知を、ターミナルにフォーカスがない場合のみ送信するか、フォーカスの有無にかかわらず送信するかを制御します。デフォルトは `unfocused` です。
`tui.notification_method`	`auto \| osc9 \| bel`	ターミナル通知の送信方式です（デフォルト：auto）。
`tui.notifications`	`boolean \| array<string>`	TUI 通知を有効にします。必要に応じて、特定のイベントタイプに限定できます。
`tui.raw_output_mode`	`boolean`	ターミナル上で範囲を選択してコピーしやすくするため、TUI を raw スクロールバックモードで起動します（デフォルト：false）。`/raw` またはデフォルトの `alt-r` キーバインドで切り替えられます。
`tui.resume_cwd`	`current \| session`	セッションを再開またはフォークするときに使用する作業ディレクトリです。未設定の場合、現在のディレクトリがセッションに保存されたディレクトリと異なると、Codex が使用するディレクトリの選択を求めます。
`tui.show_tooltips`	`boolean`	TUI のウェルカム画面に初期操作を案内するツールチップを表示します（デフォルト：true）。
`tui.status_line`	`array<string> \| null`	TUI フッターのステータス行に表示する項目識別子を順番に並べたリストです。`null` を指定すると、ステータス行が無効になります。
`tui.terminal_title`	`array<string> \| null`	ターミナルのウィンドウ／タブのタイトルに表示する項目識別子を順番に並べたリストです。デフォルトは `["spinner", "project"]` です。`null` を指定すると、タイトルの更新が無効になります。
`tui.theme`	`string`	構文ハイライトのテーマを上書きします（ケバブケースのテーマ名）。
`tui.vim_mode_default`	`boolean`	コンポーザーを、挿入モードではなく Vim のノーマルモードで起動します（デフォルト：false）。セッションごとに `/vim` で切り替えることもできます。
`web_search`	`disabled \| cached \| indexed \| live`	ウェブ検索モードです（デフォルト：`"cached"`。cached は外部ウェブにアクセスせず、OpenAI が管理するインデックスを使用します。indexed は検索インデックスで許可された場合に限り外部アクセスを認めます。`--yolo` または他のフルアクセスのサンドボックス設定を使用する場合、デフォルトは `"live"` になります）。制限のないリアルタイム取得には `"live"` を、ツールを削除するには `"disabled"` を使用します。
`windows_wsl_setup_acknowledged`	`boolean`	Windows の初期設定ガイドを確認済みかどうかを記録します（Windows のみ）。
`windows.sandbox`	`unelevated \| elevated`	Windows 上で Codex をネイティブ実行する場合の、Windows 専用のネイティブサンドボックスモードです。
`windows.sandbox_private_desktop`	`boolean`	Windows のネイティブ環境では、サンドボックス化された最終的な子プロセスをデフォルトでプライベートデスクトップ上で実行します。従来の `Winsta0\\Default` の動作との互換性が必要な場合にのみ `false` に設定してください。

Key

agents

Type / Values

table

Details

マルチエージェントの設定とカスタムロール宣言です。スカラー設定の名前は予約されており、カスタムロール名には使用できません。

Key

agents.<name>.config_file

Type / Values

string (path)

Details

そのロール用の TOML 構成レイヤーへのパスです。相対パスは、ロールを宣言している設定ファイルを基準に解決されます。

Key

agents.<name>.description

Type / Values

string

Details

そのエージェント種別を選択して生成するときに Codex に提示される、ロールに関するガイダンスです。

Key

agents.default_subagent_model

Type / Values

string

Details

生成するエージェントのデフォルトモデルです。生成時にモデルが明示的に指定されている場合は、その指定が優先されます。

Key

agents.default_subagent_reasoning_effort

Type / Values

string

Details

生成するエージェントのデフォルトの推論強度です。生成時に推論強度が明示的に指定されている場合は、その指定が優先されます。

Key

agents.enabled

Type / Values

boolean

Details

マルチエージェントツールを有効または無効にします。デフォルトは true です。

Key

agents.interrupt_message

Type / Values

boolean

Details

エージェントのターンが中断されたときに、モデルから参照できるメッセージを記録します。デフォルトは true です。

Key

agents.max_concurrent_threads_per_session

Type / Values

number

Details

プライマリスレッドを除き、生成されたエージェントのスレッドを同時に開いておける最大数です。未設定の場合は Codex がデフォルト値を選択します。

Key

agents.max_threads

Type / Values

number

Details

agents.max_concurrent_threads_per_session の従来の別名です。

Key

allow_login_shell

Type / Values

boolean

Details

シェルベースのツールがログインシェルとして動作できるようにします。デフォルトは true です。false の場合、login = true のリクエストは拒否され、login を省略するとデフォルトで非ログインシェルになります。

Key

analytics.enabled

Type / Values

boolean

Details

このマシン／プロファイルのアナリティクスを有効または無効にします。未設定の場合は、クライアントのデフォルトが適用されます。

Key

approval_policy

Type / Values

untrusted | on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }

Details

コマンド実行前に Codex が一時停止して承認を求めるタイミングを指定します。approval_policy = { granular = { ... } } を使用すると、ほかのプロンプトでは対話形式を維持しながら、特定のカテゴリのプロンプトについて表示を許可するか自動拒否するかを指定することもできます。on-failure は非推奨です。対話型の実行では on-request、非対話型の実行では never を使用してください。

Key

approval_policy.granular.mcp_elicitations

Type / Values

boolean

Details

true の場合、MCP の誘発プロンプトは自動拒否されず、表示が許可されます。

Key

approval_policy.granular.request_permissions

Type / Values

boolean

Details

true の場合、request_permissions ツールからのプロンプトの表示が許可されます。

Key

approval_policy.granular.rules

Type / Values

boolean

Details

true の場合、execpolicy の prompt ルールによって発生する承認プロンプトの表示が許可されます。

Key

approval_policy.granular.sandbox_approval

Type / Values

boolean

Details

true の場合、サンドボックスの権限昇格に関する承認プロンプトの表示が許可されます。

Key

approval_policy.granular.skill_approval

Type / Values

boolean

Details

true の場合、スキルスクリプトの承認プロンプトの表示が許可されます。

Key

approvals_reviewer

Type / Values

user | auto_review

Details

on-request またはきめ細かな承認ポリシーで、対象となる承認プロンプトを誰がレビューするかを指定します。デフォルトは user です。auto_review ではレビュー担当のサブエージェントを使用します。この設定はサンドボックスの動作を変更しません。また、サンドボックス内ですでに許可されている操作をレビューの対象にすることもありません。

Key

apps._default.approvals_reviewer

Type / Values

user | auto_review

Details

アプリごとの上書き設定がない場合に、アプリツールの承認プロンプトをレビューするデフォルトの担当者です。省略すると、アプリは最上位の approvals_reviewer の値を継承します。

Key

apps._default.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

アプリ単位またはツール単位の上書き設定がないアプリツールに適用する、承認に関するデフォルトの動作です。

Key

apps._default.destructive_enabled

Type / Values

boolean

Details

destructive_hint = true が設定されたアプリツールを、デフォルトで許可するか拒否するかを指定します。

Key

apps._default.enabled

Type / Values

boolean

Details

アプリごとの上書き設定がない場合に、すべてのアプリに適用する有効／無効のデフォルト設定です。

Key

apps._default.open_world_enabled

Type / Values

boolean

Details

open_world_hint = true が設定されたアプリツールを、デフォルトで許可するか拒否するかを指定します。

Key

apps.<id>.approvals_reviewer

Type / Values

user | auto_review

Details

このアプリのツールの承認リクエストをレビューする担当です。apps._default.approvals_reviewer を上書きします。

Key

apps.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

ツールごとの上書き設定がない場合に、このアプリのツールに適用するデフォルトの承認動作です。

Key

apps.<id>.default_tools_enabled

Type / Values

boolean

Details

ツールごとの上書き設定がない場合に、このアプリのツールに適用するデフォルトの有効・無効の設定です。

Key

apps.<id>.destructive_enabled

Type / Values

boolean

Details

このアプリのツールのうち、destructive_hint = true を示すものを許可またはブロックします。

Key

apps.<id>.enabled

Type / Values

boolean

Details

ID で指定したアプリ／コネクタを有効または無効にします（デフォルト：true）。

Key

apps.<id>.open_world_enabled

Type / Values

boolean

Details

このアプリのツールのうち、open_world_hint = true を示すものを許可またはブロックします。

Key

apps.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

アプリの特定のツールに適用する承認動作の上書き設定です。

Key

apps.<id>.tools.<tool>.enabled

Type / Values

boolean

Details

アプリの個々のツール（例：repos/list）の有効・無効を上書きする設定です。

Key

auto_review.policy

Type / Values

string

Details

自動レビュー用のローカルなポリシー指示を Markdown 形式で指定します。管理設定の guardian_policy_config が優先されます。空の値は無視されます。

Key

background_terminal_max_timeout

Type / Values

number

Details

空の write_stdin ポーリング（バックグラウンドターミナルのポーリング）の最大待機時間（ミリ秒）です。デフォルトは 300000（5 分）です。従来の background_terminal_timeout キーに代わる設定です。

Key

browser_use.allow_history_access

Type / Values

boolean

Details

ブラウザの履歴へのアクセスを制限するには、false に設定します。管理要件によって、この制限を強制することもできます。

Key

browser_use.default_origin_policy

Type / Values

table

Details

フォールバックとして適用する、ブラウザのオリジンに対する制限です。access、uploads、downloads、full_cdp_access に対応しており、それぞれ allow または deny に設定します。

Key

browser_use.origins.<origin>

Type / Values

table

Details

browser_use.default_origin_policy と同じフィールドを使用する、オリジンごとのブラウザ制限です。HTTP または HTTPS スキームを含め、必要に応じてポートを指定します。パス、クエリ、フラグメントは含めません。ローカルの設定値で、管理設定による拒否を緩和することはできません。

Key

chatgpt_base_url

Type / Values

string

Details

ChatGPT のログインフローで使用するベース URL を上書きします。

Key

check_for_update_on_startup

Type / Values

boolean

Details

Codex の起動時に更新を確認します（更新を一元管理している場合にのみ false に設定してください）。

Key

cli_auth_credentials_store

Type / Values

file | keyring | auto | ephemeral

Details

CLI が認証情報をキャッシュする保存先を指定します。

Key

compact_prompt

Type / Values

string

Details

履歴のコンパクション用プロンプトをインラインで上書きします。

Key

computer_use.default_app_access

Type / Values

allow | deny

Details

「コンピューターの使用」で、フォールバックとして適用するネイティブアプリへのアクセスポリシーです。アプリ固有のエントリでポリシーを指定できます。ローカル設定で管理設定による制限を緩和することはできません。

Key

computer_use.macos.bundle_ids

Type / Values

map<string, allow | deny>

Details

バンドル識別子をキーとして指定する、macOS ネイティブアプリへのアクセス設定です。

Key

computer_use.windows.always_allowed_app_ids

Type / Values

array<string>

Details

「コンピューターの使用」で、承認を求めずに開ける Windows アプリの識別子です。一覧にないアプリには承認が必要です。保存済みの項目は、ChatGPT デスクトップアプリの「コンピューターの使用」設定から削除してください。

Key

computer_use.windows.aumids

Type / Values

map<string, allow | deny>

Details

Application User Model ID（AUMID）をキーとして指定する、パッケージ化された Windows アプリへのアクセス設定です。

Key

computer_use.windows.exes

Type / Values

array<table>

Details

Windows 実行ファイルへのアクセスルールです。各ルールには publisher_name、product_name、access（allow または deny）が必要です。binary_name は任意です。

Key

default_permissions

Type / Values

string

Details

サンドボックス内のツール呼び出しに適用するデフォルトの権限プロファイル名です。組み込みのプロファイルは :read-only、:workspace、:danger-full-access です。カスタムプロファイル名には、対応する [permissions.<name>] テーブルが必要です。sandbox_mode または [sandbox_workspace_write] と併用しないでください。

Key

desktop.custom_file_handlers.<id>

Type / Values

table

Details

ユーザーレベルでのみ使用できます。ChatGPT デスクトップアプリの アプリで開く メニューに追加する項目を定義します。例とハンドラー ID の制約については、カスタムファイルハンドラーの追加を参照してください。

Key

desktop.custom_file_handlers.<id>.args

Type / Values

array<string>

Details

コマンドとファイル入力の間に挿入する引数です（デフォルト：[]）。

Key

desktop.custom_file_handlers.<id>.command

Type / Values

string

Details

検出して起動する実行可能ファイルのパスまたはコマンド名です。必須です。

Key

desktop.custom_file_handlers.<id>.icon

Type / Values

string

Details

ハンドラーのアイコンには、バンドル済みアセットのパス、Base64 エンコードされた data:image/... URL、ファイル URI、またはローカルの絶対パスを指定します。必須です。サポートされていないソースの場合は、デフォルトの VS Code アイコンを使用します。

Key

desktop.custom_file_handlers.<id>.input

Type / Values

path | json_argument | json_stdin

Details

アプリがハンドラーにファイル入力を渡す方法です（デフォルト：path）。

Key

desktop.custom_file_handlers.<id>.label

Type / Values

string

Details

アプリで開く メニューに表示される名前です。必須です。

Key

desktop.custom_file_handlers.<id>.supports_ssh

Type / Values

boolean

Details

SSH ワークスペース内のファイルで、このハンドラーを選択可能にします（デフォルト：false）。

Key

developer_instructions

Type / Values

string

Details

セッションに挿入する追加の開発者指示です（任意）。

Key

disable_paste_burst

Type / Values

boolean

Details

TUI のバーストペースト検出を無効にします。

Key

experimental_compact_prompt_file

Type / Values

string (path)

Details

コンパクション用プロンプトの上書き設定をファイルから読み込みます（試験的機能）。

Key

experimental_use_unified_exec_tool

Type / Values

boolean

Details

統合実行を有効にするための旧名称です。[features].unified_exec または codex --enable unified_exec を使用してください。

Key

features.apps

Type / Values

boolean

Details

アプリ（コネクタ）連携を有効にします。安定版の機能で、デフォルトで有効です。アプリとコネクタの通信は、サンドボックス内のコマンド用ネットワークプロキシや、そのドメイン許可リストによる制御の対象外です。

Key

features.code_mode.direct_only_tool_namespaces

Type / Values

array<string>

Details

コードモードで、直接のツール呼び出しを通じてのみ使用できるツールの名前空間です。

Key

features.code_mode.enabled

Type / Values

boolean

Details

コードモード機能の構成を有効にします。この機能は開発中で、デフォルトでは無効です。

Key

features.code_mode.excluded_tool_namespaces

Type / Values

array<string>

Details

コードモードで、ネストされたツールのガイダンスとエグゼキューターへの公開対象から除外するツールの名前空間です。

Key

features.context_management.experimental_mode

Type / Values

boolean

Details

試験的なコンテキスト管理を有効にします。デフォルトでは無効です。コンテキストを繰り返し単一の要約に圧縮する代わりに、メモと検索可能な履歴を使って、蓄積された詳細情報を保持します。Plus、Pro、または Pro Lite の ChatGPT アカウントでのサインインが必要です。

Key

features.enable_request_compression

Type / Values

boolean

Details

サポートされている場合、ストリーミングリクエストのボディを zstd で圧縮します（安定版、デフォルトで有効）。

Key

features.fast_mode

Type / Values

boolean

Details

TUI でモデルカタログのサービスティアを選択できるようにします（安定版、デフォルトで有効）。使用中のモデルが対応を示している場合は、Fast ティアのコマンドも有効にします。

Key

features.goals

Type / Values

boolean

Details

目標の永続化と自動継続を有効にします（安定版、デフォルトで有効）。

Key

features.hooks

Type / Values

boolean

Details

hooks.json またはインラインの [hooks] 構成から読み込むライフサイクルフックを有効にします。features.codex_hooks は非推奨の別名です。

Key

features.memories

Type / Values

boolean

Details

メモリを有効にします。デフォルトでは無効です。

Key

features.multi_agent

Type / Values

boolean

Details

マルチエージェントの連携ツール（spawn_agent、send_input、resume_agent、wait_agent、close_agent）を有効にします（安定版、デフォルトで有効）。

Key

features.network_proxy

Type / Values

boolean | table

Details

サンドボックス内で実行するコマンド用のネットワークプロキシを起動します（実験的機能、デフォルトでは無効）。管理者が管理する experimental_network 要件が有効で、その要件によってプロキシが起動される場合を除き、権限プロファイルのドメインルールを適用するにはこの設定が必要です。domains などの機能レベルのポリシーオプションを設定する場合は、テーブル形式を使用してください。ウェブ検索、アプリ、MCP、その他のホスト型ツールはフィルタリングされません。

Key

features.network_proxy.allow_local_binding

Type / Values

boolean

Details

より広範なローカル／プライベートネットワークへのアクセスを許可します。デフォルトは false です。ただし、ローカル IP アドレスのリテラルまたは localhost に完全一致する許可ルールを使用すれば、特定のローカル宛先へのアクセスを許可できます。

Key

features.network_proxy.allow_upstream_proxy

Type / Values

boolean

Details

環境で設定されたアップストリームプロキシを経由する多段接続を許可します。デフォルトは true です。

Key

features.network_proxy.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

許可リストに含まれる宛先だけに限定せず、任意の Unix ソケット宛先を許可します。デフォルトは false です。厳密に管理された環境でのみ使用してください。

Key

features.network_proxy.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

ループバック以外のリスナーアドレスを許可します。デフォルトは false です。有効にすると、localhost 以外からもプロキシリスナーにアクセスできるようになる可能性があります。

Key

features.network_proxy.domains

Type / Values

map<string, allow | deny>

Details

サンドボックス内のネットワーク接続に適用されるドメインポリシーです。デフォルトでは未設定で、allow ルールを追加するまで外部の宛先は許可されません。ホストへの完全一致、サブドメインのみに一致する *.example.com、ドメイン自体とサブドメインに一致する **.example.com、すべてのホストに一致する * の許可ルールをサポートします。* を使用すると、パブリックネットワークへのアウトバウンドアクセスが広範に開放されるため、範囲を限定したルールを推奨します。ブロックする宛先には deny ルールを追加します。競合した場合は deny が優先されます。

Key

features.network_proxy.enable_socks5

Type / Values

boolean

Details

SOCKS5 サポートを有効にします。デフォルトは true です。

Key

features.network_proxy.enable_socks5_udp

Type / Values

boolean

Details

SOCKS5 経由の UDP 通信を許可します。デフォルトは true です。

Key

features.network_proxy.enabled

Type / Values

boolean

Details

コマンドのネットワークアクセスが有効な場合に、サンドボックス内で実行するコマンド用のネットワークプロキシを起動します。デフォルトは false です。プロキシが無効な間は、権限プロファイルのドメインルールは適用されません。

Key

features.network_proxy.proxy_url

Type / Values

string

Details

サンドボックス内のネットワーク接続に使用する HTTP リスナー URL です。デフォルトは "http://127.0.0.1:3128" です。

Key

features.network_proxy.socks_url

Type / Values

string

Details

SOCKS5 リスナー URL です。デフォルトは "http://127.0.0.1:8081" です。

Key

features.network_proxy.unix_sockets

Type / Values

map<string, allow | deny>

Details

サンドボックス内のネットワーク接続に適用される Unix ソケットポリシーです。デフォルトでは未設定です。許可するソケットには allow エントリを追加してください。

Key

features.personality

Type / Values

boolean

Details

パーソナリティの選択 UI を有効にします（安定版、デフォルトで有効）。

Key

features.prevent_idle_sleep

Type / Values

boolean

Details

ターンの実行中にマシンがスリープしないようにします（実験的機能、デフォルトでは無効）。

Key

features.remote_plugin

Type / Values

boolean

Details

リモートプラグインカタログを有効にします（安定版、デフォルトで有効）。

Key

features.rollout_budget.enabled

Type / Values

boolean

Details

ロールアウト予算の追跡を有効にします。この機能は開発中で、デフォルトでは無効です。有効にする場合は features.rollout_budget.limit_tokens が必須です。

Key

features.rollout_budget.limit_tokens

Type / Values

integer

Details

ロールアウト予算の追跡に使用するトークン数の上限です。正の値で指定します。ロールアウト予算を有効にする場合は必須です。

Key

features.rollout_budget.prefill_token_weight

Type / Values

number

Details

ロールアウト予算の計算で、プリフィルトークンに適用する有限かつ非負の倍率です。デフォルトは 1.0 です。

Key

features.rollout_budget.reminder_interval_tokens

Type / Values

integer

Details

ロールアウト予算のリマインダーの間隔です。正のトークン数で指定します。デフォルトは limit_tokens の 10% で、最小値は 1 トークンです。

Key

features.rollout_budget.sampling_token_weight

Type / Values

number

Details

ロールアウト予算の計算で、サンプリングされたトークンに適用する有限かつ非負の倍率です。デフォルトは 1.0 です。

Key

features.shell_snapshot

Type / Values

boolean

Details

シェル環境のスナップショットを作成し、コマンドの繰り返し実行を高速化します（安定版、デフォルトで有効）。

Key

features.shell_tool

Type / Values

boolean

Details

コマンド実行用のデフォルトの shell ツールを有効にします（安定版、デフォルトで有効）。

Key

features.skill_mcp_dependency_install

Type / Values

boolean

Details

スキルに必要な MCP 依存関係が不足している場合に、確認プロンプトの表示とインストールを許可します（安定版、デフォルトで有効）。

Key

features.unified_exec

Type / Values

boolean

Details

PTY ベースの統合 exec ツールを使用します（安定版、Windows を除きデフォルトで有効）。

Key

features.web_search

Type / Values

boolean

Details

従来の切り替え設定です（非推奨）。代わりにトップレベルの web_search 設定を使用してください。

Key

features.web_search_cached

Type / Values

boolean

Details

従来の切り替え設定です（非推奨）。web_search が未設定の場合、true は web_search = "cached" に対応します。

Key

features.web_search_request

Type / Values

boolean

Details

従来の切り替え設定です（非推奨）。web_search が未設定の場合、true は web_search = "live" に対応します。

Key

feedback.enabled

Type / Values

boolean

Details

すべてのローカルクライアントで /feedback によるフィードバック送信を有効にします（デフォルト：true）。

Key

file_opener

Type / Values

vscode | vscode-insiders | windsurf | cursor | none

Details

Codex の出力に含まれる引用を開くための URI スキームです（デフォルト：vscode）。

Key

forced_chatgpt_workspace_id

Type / Values

string (uuid)

Details

ChatGPT へのログインを特定のワークスペース識別子に限定します。

Key

forced_login_method

Type / Values

chatgpt | api

Details

Codex で使用できる認証方法を特定の方式に限定します。

Key

hide_agent_reasoning

Type / Values

boolean

Details

TUI と codex exec の両方の出力で推論イベントを抑制します。

Key

history.max_bytes

Type / Values

number

Details

設定すると、古いエントリから順に削除し、履歴ファイルのサイズを指定したバイト数以内に制限します。

Key

history.persistence

Type / Values

save-all | none

Details

Codex がセッションの記録を history.jsonl に保存するかどうかを制御します。

Key

hooks

Type / Values

table

Details

config.toml 内でインライン定義するライフサイクルフックです。hooks.json と同じイベントスキーマを使用します。例とサポート対象のイベントについては、フックガイドを参照してください。

Key

hooks.<Event>

Type / Values

array<table>

Details

PreToolUse、PermissionRequest、PostToolUse、PreCompact、PostCompact、SessionStart、SessionEnd、SubagentStart、SubagentStop、UserPromptSubmit、Stop、Interrupt などのフックイベント用のマッチャーグループです。

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

マッチャーグループ用のフックハンドラーです。コマンドフックと MCP ツールフックをサポートしています。プロンプトフックとエージェントフックのハンドラーは解析されますが、実行はスキップされます。

Key

hooks.<Event>[].hooks[].additionalContextLimit

Type / Values

integer

Details

大きすぎる additionalContext をディスクに保存し、モデルには短いプレビューを提示するための、ハンドラーごとのおおよそのトークンしきい値です。デフォルトは 2500 です。0 の場合はコンテキスト全体をモデルに直接渡します。サイズの大きいフック出力を参照してください。

Key

hooks.<Event>[].hooks[].async

Type / Values

boolean

Details

トリガー元の処理を遅らせることなく、コマンドフックをバックグラウンドで実行します。デフォルトは false です。SessionEnd は常に同期実行されます。フックのバックグラウンド実行を参照してください。

Key

hooks.<Event>[].hooks[].commandWindows

Type / Values

string

Details

コマンドフックのコマンドを Windows でのみ上書きする設定です。TOML の別名 command_windows も使用できます。

Key

instructions

Type / Values

string

Details

将来の利用のために予約されています。model_instructions_file または AGENTS.md の使用を推奨します。

Key

log_dir

Type / Values

string (path)

Details

Codex がログファイルを書き込むディレクトリです。デフォルトは $CODEX_HOME/log です。この設定を明示すると、オプトイン方式のプレーンテキスト TUI ログ codex-tui.log も有効になり、同じディレクトリに出力されます。

Key

mcp_oauth_callback_port

Type / Values

integer

Details

MCP OAuth ログインで使用するローカル HTTP コールバックサーバーの固定ポートをグローバルに指定します（任意）。サーバー固有の oauth.callback_port が優先されます。どちらも設定されていない場合、Codex は OS が選択した一時ポートにバインドします。

Key

mcp_oauth_callback_url

Type / Values

string

Details

MCP OAuth ログイン用のベースコールバック URL です（任意）。devbox のイングレス URL などを指定します。認可サーバーが発行者の識別に対応している場合、新しく追加した事前登録済みクライアントはこの URL をそのまま使用します。コールバックが保存されていない既存のクライアントは、サーバー固有のコールバック ID を追加します。発行者の識別に対応していない場合、設定済みのコールバックに必要な ID がない事前登録済み MCP サーバーは、この URL に ID を追加したものにフォールバックします。コールバック URL のポート番号では、リスナーのポートは指定されません。

Key

mcp_oauth_credentials_store

Type / Values

auto | file | keyring

Details

MCP OAuth 認証情報の優先保存先です。

Key

mcp_optional_startup_grace_ms

Type / Values

integer (milliseconds)

Details

初期ツールカタログの構築時に、必須ではない MCP サーバーに共通で適用する待機時間です。デフォルトは 1000 です。0 に設定すると、代わりに各サーバーの startup_timeout_sec に従って待機します。

Key

mcp_servers.<id>.args

Type / Values

array<string>

Details

MCP stdio サーバーのコマンドに渡す引数です。

Key

mcp_servers.<id>.auth

Type / Values

oauth | chatgpt

Details

MCP HTTP サーバーで、設定済みの Bearer トークンと認可ヘッダーに次いで使用する認証フォールバックです。oauth（デフォルト）では、保存済みの MCP OAuth 認証情報があれば使用します。chatgpt では、信頼されたファーストパーティの ChatGPT オリジンに対して現在の ChatGPT セッションを使用し、その後、保存済みの OAuth 認証情報にフォールバックします。いずれの取得元からも認証情報が得られない場合、どちらのモードでも認証なしで接続できます。

Key

mcp_servers.<id>.bearer_token_env_var

Type / Values

string

Details

MCP HTTP サーバーの Bearer トークンの取得元となる環境変数です。

Key

mcp_servers.<id>.command

Type / Values

string

Details

MCP stdio サーバーの起動コマンドです。

Key

mcp_servers.<id>.cwd

Type / Values

string

Details

MCP stdio サーバープロセスの作業ディレクトリです。

Key

mcp_servers.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

ツールごとの上書き設定がない場合に、このサーバーの MCP ツールに適用するデフォルトの承認動作です。

Key

mcp_servers.<id>.disabled_tools

Type / Values

array<string>

Details

MCP サーバーの enabled_tools の適用後に適用する拒否リストです。

Key

mcp_servers.<id>.enabled

Type / Values

boolean

Details

構成を削除せずに MCP サーバーを無効にします。

Key

mcp_servers.<id>.enabled_tools

Type / Values

array<string>

Details

MCP サーバーが公開するツール名の許可リストです。

Key

mcp_servers.<id>.env

Type / Values

map<string,string>

Details

MCP stdio サーバーに転送する環境変数です。

Key

mcp_servers.<id>.env_http_headers

Type / Values

map<string,string>

Details

環境変数から値を設定する、MCP HTTP サーバー用の HTTP ヘッダーです。

Key

mcp_servers.<id>.env_vars

Type / Values

array<string | { name = string, source = "local" | "remote" }>

Details

MCP stdio サーバー向けに許可リストへ追加する環境変数です。文字列で指定したエントリは、デフォルトで source = "local" として扱われます。source = "remote" は、エグゼキューターを介したリモート stdio でのみ使用してください。

Key

mcp_servers.<id>.experimental_environment

Type / Values

local | remote

Details

MCP サーバーの配置先を指定する試験的な設定です。remote は、リモートエグゼキューター環境を介して stdio サーバーを起動します。streamable HTTP のリモート配置は実装されていません。

Key

mcp_servers.<id>.http_headers

Type / Values

map<string,string>

Details

各 MCP HTTP リクエストに含める静的な HTTP ヘッダーです。

Key

mcp_servers.<id>.http_headers_helper

Type / Values

string (command)

Details

HTTP ヘッダーの名前と値を JSON オブジェクトとして出力するローカルコマンドです。ローカル接続の HTTP MCP サーバーでのみサポートされます。明示的に指定した Bearer トークンと OAuth 認証情報は、ヘルパーが提供する Authorization ヘッダーよりも優先されます。

Key

mcp_servers.<id>.oauth_resource

Type / Values

string

Details

MCP へのログイン時に含める、任意指定の RFC 8707 OAuth リソースパラメーターです。

Key

mcp_servers.<id>.oauth.callback_port

Type / Values

integer

Details

この MCP サーバーの OAuth コールバックリスナーで使用する固定ポートです。mcp_oauth_callback_port を上書きします。URL にポートを明示した直接のループバックコールバックを使用する場合は、リスナーポートにも同じポートを設定してください。

Key

mcp_servers.<id>.oauth.callback_url

Type / Values

string

Details

サーバー固有の OAuth コールバックです。発行者の識別がサポートされている場合、または URL の末尾がすでにサーバー固有のコールバック ID である場合、事前登録済みのクライアントはこのコールバックを再利用します。それ以外の場合、Codex はグローバルまたはデフォルトのコールバックにその ID を付加して使用します。事前登録済みの ID がないクライアントは、クライアント登録時にこのコールバックを使用します。

Key

mcp_servers.<id>.oauth.client_id

Type / Values

string

Details

この MCP サーバーでの認可とトークン交換に使用する、事前登録済みの OAuth クライアント ID です。

Key

mcp_servers.<id>.required

Type / Values

boolean

Details

true の場合、有効化されているこの MCP サーバーを初期化できないと、起動または再開に失敗します。

Key

mcp_servers.<id>.scopes

Type / Values

array<string>

Details

その MCP サーバーへの認証時に要求する OAuth スコープです。

Key

mcp_servers.<id>.startup_timeout_ms

Type / Values

number

Details

startup_timeout_sec をミリ秒単位で指定するための別名です。

Key

mcp_servers.<id>.startup_timeout_sec

Type / Values

number

Details

MCP サーバーの起動タイムアウトを上書きします。デフォルトは 10 秒です。

Key

mcp_servers.<id>.tool_timeout_sec

Type / Values

number

Details

MCP サーバーのツールごとのタイムアウトを上書きします。デフォルトは 60 秒です。

Key

mcp_servers.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

このサーバーの特定の MCP ツールに適用する承認動作の上書き設定です。

Key

mcp_servers.<id>.tools.<tool>.output_token_limit

Type / Values

integer (positive)

Details

特定の MCP ツールの出力に割り当てるトークン予算です。シリアライズ用の標準の余裕分 20% を加える前の値です。そのツールについて、モデルがデフォルトで使用する出力切り詰めのトークン予算を上書きします。

Key

mcp_servers.<id>.url

Type / Values

string

Details

MCP streamable HTTP サーバーのエンドポイントです。

Key

memories.consolidation_model

Type / Values

string

Details

全体のメモリ統合に使用するモデルの上書き設定です（任意）。

Key

memories.disable_on_external_context

Type / Values

boolean

Details

true の場合、MCP ツール呼び出し、ウェブ検索、ツール検索などの外部コンテキストを使用するスレッドをメモリ生成の対象から除外します。デフォルトは false です。従来のエイリアスは memories.no_memories_if_mcp_or_web_search です。

Key

memories.extract_model

Type / Values

string

Details

スレッドごとのメモリ抽出に使用するモデルの上書き設定です（任意）。

Key

memories.generate_memories

Type / Values

boolean

Details

false の場合、新しく作成されたスレッドはメモリ生成の入力として保存されません。デフォルトは true です。

Key

memories.max_raw_memories_for_consolidation

Type / Values

number

Details

全体の統合に向けて保持する、最近の未加工メモリの最大数です。デフォルトは 256、上限は 4096 です。

Key

memories.max_rollout_age_days

Type / Values

number

Details

メモリ生成の対象となるスレッドの最大経過期間です。デフォルトは 30 で、0～90 の範囲に制限されます。

Key

memories.max_rollouts_per_startup

Type / Values

number

Details

起動時の 1 回の処理で扱うロールアウト候補の最大数です。デフォルトは 16、上限は 128 です。

Key

memories.max_unused_days

Type / Values

number

Details

メモリを統合対象に含めるための、最終使用日からの最大経過日数です。デフォルトは 30 で、0～365 の範囲に制限されます。

Key

memories.min_rate_limit_remaining_percent

Type / Values

number

Details

メモリ生成を開始するために必要な、Codex のレート制限ウィンドウにおける残量の最小割合です。デフォルトは 25 で、0～100 の範囲に制限されます。

Key

memories.min_rollout_idle_hours

Type / Values

number

Details

スレッドがメモリ生成の対象となるまでに必要な最小アイドル時間です。デフォルトは 6 で、1～48 の範囲に制限されます。

Key

memories.use_memories

Type / Values

boolean

Details

false の場合、Codex は既存のメモリを今後のセッションに組み込みません。デフォルトは true です。

Key

model

Type / Values

string

Details

使用するモデルです（例：gpt-5.5）。

Key

model_auto_compact_token_limit

Type / Values

number

Details

履歴の自動コンパクションを開始するトークン数のしきい値です。未設定の場合は、モデルのデフォルト値を使用します。

Key

model_auto_compact_token_limit_scope

Type / Values

total | body_after_prefix

Details

自動コンパクションのしきい値の計算で、アクティブなコンテキスト全体（デフォルトの total）を数えるか、引き継がれたコンパクションウィンドウのプレフィックスより後の増加分（body_after_prefix）のみを数えるかを指定します。

Key

model_catalog_json

Type / Values

string (path)

Details

起動時に読み込む JSON モデルカタログのパスです（任意）。選択した $CODEX_HOME/profile-name.config.toml プロファイルファイルで、プロファイルごとにこの設定を上書きできます。

Key

model_context_window

Type / Values

number

Details

アクティブなモデルで使用できるコンテキストウィンドウのトークン数です。

Key

model_instructions_file

Type / Values

string (path)

Details

組み込みの指示を置き換える設定です。AGENTS.md の代わりに使用します。

Key

model_provider

Type / Values

string

Details

model_providers のプロバイダー ID です（デフォルト：openai）。

Key

model_providers.<id>

Type / Values

table

Details

カスタムプロバイダーの定義です。組み込みプロバイダーの ID（openai、ollama、lmstudio）は予約済みであり、上書きできません。

Key

model_providers.<id>.auth

Type / Values

table

Details

カスタムプロバイダーで、コマンドを使って Bearer トークンを取得するための設定です。env_key、experimental_bearer_token、requires_openai_auth と併用しないでください。

Key

model_providers.<id>.auth.args

Type / Values

array<string>

Details

トークン取得コマンドに渡す引数です。

Key

model_providers.<id>.auth.command

Type / Values

string

Details

Codex が Bearer トークンを必要とするときに実行するコマンドです。このコマンドはトークンを stdout に出力する必要があります。

Key

model_providers.<id>.auth.cwd

Type / Values

string (path)

Details

トークン取得コマンドの作業ディレクトリです。

Key

model_providers.<id>.auth.refresh_interval_ms

Type / Values

number

Details

Codex がトークンを事前に更新する間隔です（ミリ秒、デフォルト：300000）。認証の再試行後にのみ更新するには 0 に設定します。

Key

model_providers.<id>.auth.timeout_ms

Type / Values

number

Details

トークン取得コマンドの最大実行時間です（ミリ秒、デフォルト：5000）。

Key

model_providers.<id>.base_url

Type / Values

string

Details

モデルプロバイダーの API ベース URL です。

Key

model_providers.<id>.env_http_headers

Type / Values

map<string,string>

Details

環境変数が存在する場合に、その値から設定される HTTP ヘッダーです。

Key

model_providers.<id>.env_key

Type / Values

string

Details

プロバイダーの API キーを指定する環境変数です。

Key

model_providers.<id>.env_key_instructions

Type / Values

string

Details

プロバイダーの API キーに関するセットアップ案内です（任意）。

Key

model_providers.<id>.experimental_bearer_token

Type / Values

string

Details

プロバイダーに直接指定する Bearer トークンです（非推奨。代わりに env_key を使用してください）。

Key

model_providers.<id>.http_headers

Type / Values

map<string,string>

Details

プロバイダーへのリクエストに追加する静的 HTTP ヘッダーです。

Key

model_providers.<id>.name

Type / Values

string

Details

カスタムモデルプロバイダーの表示名です。

Key

model_providers.<id>.query_params

Type / Values

map<string,string>

Details

プロバイダーへのリクエストに追加するクエリパラメーターです。

Key

model_providers.<id>.request_max_retries

Type / Values

number

Details

プロバイダーへの HTTP リクエストの再試行回数です（デフォルト：4 回）。

Key

model_providers.<id>.requires_openai_auth

Type / Values

boolean

Details

プロバイダーで OpenAI 認証を使用します（デフォルト：false）。

Key

model_providers.<id>.stream_idle_timeout_ms

Type / Values

number

Details

SSE ストリームのアイドルタイムアウトです（ミリ秒、デフォルト：300000）。

Key

model_providers.<id>.stream_max_retries

Type / Values

number

Details

SSE ストリーミングが中断した場合の再試行回数です（デフォルト：5 回）。

Key

model_providers.<id>.supports_standalone_web_search

Type / Values

boolean

Details

互換性のあるスタンドアロンのウェブ検索エンドポイントへの対応を宣言します（デフォルト：false）。スタンドアロン検索は開発中であり、デフォルトでは無効です。プロバイダーが対応しているだけでは有効になりません。

Key

model_providers.<id>.supports_websockets

Type / Values

boolean

Details

プロバイダーが Responses API の WebSocket トランスポートに対応しているかどうかを指定します。

Key

model_providers.<id>.wire_api

Type / Values

responses

Details

プロバイダーが使用するプロトコルです。サポートされている値は responses のみで、省略した場合もデフォルトでこの値が使用されます。

Key

model_providers.amazon-bedrock.aws.profile

Type / Values

string

Details

組み込みの amazon-bedrock プロバイダーで使用する AWS プロファイル名です。

Key

model_providers.amazon-bedrock.aws.region

Type / Values

string

Details

組み込みの amazon-bedrock プロバイダーで使用する AWS リージョンです。

Key

model_reasoning_effort

Type / Values

minimal | low | medium | high | xhigh

Details

対応モデルの推論強度を調整します（Responses API のみ。xhigh が利用できるかはモデルによって異なります）。

Key

model_reasoning_summary

Type / Values

auto | concise | detailed | none

Details

推論要約の詳細度を選択するか、要約を完全に無効にします。

Key

model_supports_reasoning_summaries

Type / Values

boolean

Details

Codex が推論メタデータを送信するかどうかを強制的に指定します。

Key

model_verbosity

Type / Values

low | medium | high

Details

GPT-5 Responses API の出力の詳細度を任意で上書きする設定です。未設定の場合、選択したモデルまたはプリセットのデフォルト値が使用されます。

Key

notice.hide_full_access_warning

Type / Values

boolean

Details

フルアクセスの警告プロンプトを確認済みかどうかを記録します。

Key

notice.hide_gpt-5.1-codex-max_migration_prompt

Type / Values

boolean

Details

gpt-5.1-codex-max 移行プロンプトを確認済みかどうかを記録します。

Key

notice.hide_gpt5_1_migration_prompt

Type / Values

boolean

Details

GPT-5.1 移行プロンプトを確認済みかどうかを記録します。

Key

notice.hide_rate_limit_model_nudge

Type / Values

boolean

Details

レート制限に伴うモデル切り替えリマインダーのオプトアウト状態を記録します。

Key

notice.hide_world_writable_warning

Type / Values

boolean

Details

Windows で全ユーザーが書き込み可能なディレクトリに関する警告を確認済みかどうかを記録します。

Key

notice.model_migrations

Type / Values

map<string,string>

Details

確認済みのモデル移行を old->new 形式のマッピングとして記録します。

Key

notify

Type / Values

array<string>

Details

通知時に呼び出されるコマンドです。Codex から JSON ペイロードを受け取ります。

Key

openai_base_url

Type / Values

string

Details

組み込みの openai モデルプロバイダーのベース URL を上書きします。

Key

oss_provider

Type / Values

lmstudio | ollama

Details

--oss で実行する際に使用するデフォルトのローカルプロバイダーです。未設定の場合は、プロバイダーの指定を求めます。

Key

otel.environment

Type / Values

string

Details

送出される OpenTelemetry イベントに適用する環境タグです（デフォルト：dev）。

Key

otel.exporter

Type / Values

none | otlp-http | otlp-grpc

Details

OpenTelemetry エクスポーターを選択し、必要に応じてエンドポイントのメタデータを指定します。

Key

otel.exporter.<id>.endpoint

Type / Values

string

Details

OTEL ログ用エクスポーターのエンドポイントです。

Key

otel.exporter.<id>.headers

Type / Values

map<string,string>

Details

OTEL エクスポーターのリクエストに含める静的ヘッダーです。

Key

otel.exporter.<id>.protocol

Type / Values

binary | json

Details

OTLP/HTTP エクスポーターが使用するプロトコルです。

Key

otel.exporter.<id>.tls.ca-certificate

Type / Values

string

Details

OTEL エクスポーターの TLS 接続で使用する CA 証明書のパスです。

Key

otel.exporter.<id>.tls.client-certificate

Type / Values

string

Details

OTEL エクスポーターの TLS 接続で使用するクライアント証明書のパスです。

Key

otel.exporter.<id>.tls.client-private-key

Type / Values

string

Details

OTEL エクスポーターの TLS 接続で使用するクライアント秘密鍵のパスです。

Key

otel.log_user_prompt

Type / Values

boolean

Details

未加工のユーザープロンプトを OpenTelemetry ログとともにエクスポートする機能を有効にします。

Key

otel.metrics_exporter

Type / Values

none | statsig | otlp-http | otlp-grpc

Details

OpenTelemetry メトリクスエクスポーターを選択します（デフォルト：statsig）。

Key

otel.trace_exporter

Type / Values

none | otlp-http | otlp-grpc

Details

OpenTelemetry トレースエクスポーターを選択し、必要に応じてエンドポイントのメタデータを指定します。

Key

otel.trace_exporter.<id>.endpoint

Type / Values

string

Details

OTEL ログ用トレースエクスポーターのエンドポイントです。

Key

otel.trace_exporter.<id>.headers

Type / Values

map<string,string>

Details

OTEL トレースエクスポーターのリクエストに含める静的ヘッダーです。

Key

otel.trace_exporter.<id>.protocol

Type / Values

binary | json

Details

OTLP/HTTP トレースエクスポーターが使用するプロトコルです。

Key

otel.trace_exporter.<id>.tls.ca-certificate

Type / Values

string

Details

OTEL トレースエクスポーターの TLS 接続で使用する CA 証明書のパスです。

Key

otel.trace_exporter.<id>.tls.client-certificate

Type / Values

string

Details

OTEL トレースエクスポーターの TLS 接続で使用するクライアント証明書のパスです。

Key

otel.trace_exporter.<id>.tls.client-private-key

Type / Values

string

Details

OTEL トレースエクスポーターの TLS 接続で使用するクライアント秘密鍵のパスです。

Key

permissions.<name>.description

Type / Values

string

Details

この名前付きプロファイルの説明文です。extends を使用しても、親プロファイルの説明は継承されません。

Key

permissions.<name>.extends

Type / Values

string

Details

この名前付きプロファイルより先に適用する親プロファイルです（任意）。別の名前付きプロファイル、:read-only、または :workspace を指定します。:danger-full-access、未定義の親プロファイル、循環参照は拒否されます。

Key

permissions.<name>.filesystem

Type / Values

table

Details

名前付きのファイルシステム権限プロファイルです。各キーには、絶対パス、または :minimal や :workspace_roots などの特殊トークンを指定します。

Key

permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>

Type / Values

"read" | "write" | "deny"

Details

実際に適用される各ワークスペースルートを基準に、ファイルシステムアクセスの範囲を設定します。ルート自体には "." を使用します。"**/*.env" などの glob 形式のサブパスでは、"deny" によって読み取りを拒否できます。

Key

permissions.<name>.filesystem.<path-or-glob>

Type / Values

"read" | "write" | "deny" | table

Details

パス、glob パターン、特殊トークンへの直接アクセスを許可するか、そのルート配下のネストされたエントリの適用範囲を設定します。一致するパスの読み取りを拒否するには "deny" を使用します。

Key

permissions.<name>.filesystem.glob_scan_max_depth

Type / Values

number

Details

サンドボックスの起動前に一致するパスのスナップショットを作成するプラットフォームで、読み取り拒否用の glob パターンを展開する際の最大深度です。設定する場合は 1 以上にする必要があります。

Key

permissions.<name>.network.allow_local_binding

Type / Values

boolean

Details

サンドボックス内のネットワーク通信を通じて、ローカルネットワークやプライベートネットワークへの広範なアクセスを許可します。この設定が false のままでも、ローカル IP アドレスのリテラルまたは localhost に完全一致する許可ルールによって、特定のローカル接続先へのアクセスを許可できます。

Key

permissions.<name>.network.allow_upstream_proxy

Type / Values

boolean

Details

サンドボックス内のネットワーク通信が別のアップストリームプロキシを経由することを許可します。

Key

permissions.<name>.network.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Unix ソケットの宛先をデフォルトの限定された範囲に制限せず、任意の宛先を許可します。厳格に管理された環境でのみ使用してください。

Key

permissions.<name>.network.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

サンドボックス内のネットワーク通信のリスナーが、ループバック以外のアドレスにバインドすることを許可します。有効にすると、リスナーが localhost 以外からアクセス可能になる場合があります。

Key

permissions.<name>.network.domains

Type / Values

table

Details

サンドボックス内で実行するコマンドのドメインルールです。features.network_proxy、または有効化された管理者管理のネットワーク要件によってプロキシが起動した場合にのみ適用されます。ホストの完全一致、*.example.com、**.example.com、すべてを対象とする * の許可ルールに対応し、deny が優先されます。ウェブ検索、アプリ、MCP サーバーは制限されません。

Key

permissions.<name>.network.domains.<pattern>

Type / Values

allow | deny

Details

完全一致するホスト、または *.example.com や **.example.com などの範囲を限定したワイルドカードパターンを許可または拒否します。

Key

permissions.<name>.network.enable_socks5

Type / Values

boolean

Details

この権限プロファイルでサンドボックス内のネットワーク通信を有効にした場合に、SOCKS5 を利用可能にします。

Key

permissions.<name>.network.enable_socks5_udp

Type / Values

boolean

Details

有効にすると、SOCKS5 リスナー経由の UDP 通信を許可します。

Key

permissions.<name>.network.enabled

Type / Values

boolean

Details

この権限プロファイルでコマンドのネットワークアクセスを有効にします。この設定ではネットワークプロキシは起動しません。features.network_proxy が有効でなく、管理者が管理するネットワーク要件も有効になっていない場合、コマンドはネットワークに直接アクセスし、プロファイルのドメインルールは適用されません。

Key

permissions.<name>.network.mode

Type / Values

limited | full

Details

サブプロセスの通信に使用するネットワークプロキシモードです。

Key

permissions.<name>.network.proxy_url

Type / Values

string

Details

この権限プロファイルでサンドボックス内のネットワーク通信を有効にした場合に使用する HTTP リスナーの URL です。

Key

permissions.<name>.network.socks_url

Type / Values

string

Details

この権限プロファイルで使用する SOCKS5 プロキシのエンドポイントです。

Key

permissions.<name>.network.unix_sockets

Type / Values

table

Details

サンドボックス内のネットワーク通信に適用する Unix ソケット許可リストのオーバーライド設定です。ソケットパスをキーとして使用し、allow でパスを追加し、deny で拒否します。

Key

permissions.<name>.network.unix_sockets.<path>

Type / Values

allow | deny

Details

allow を使用して Unix ソケットの絶対パスを実際に適用される許可リストに追加するか、deny を使用して拒否します。拒否されたエントリは、実際に適用される許可リストから除外されます。

Key

permissions.<name>.workspace_roots

Type / Values

table

Details

プロファイルで定義するワークスペースルートです。セッション実行時のワークスペースルートとともに、:workspace_roots のファイルシステムルールが適用されます。

Key

permissions.<name>.workspace_roots.<path>

Type / Values

boolean

Details

true の場合、そのパスをプロファイルのワークスペースルートに追加します。無効化されたエントリは適用されません。

Key

personality

Type / Values

none | friendly | pragmatic

Details

supportsPersonality への対応を示すモデルのデフォルトのコミュニケーションスタイルです。スレッド単位、ターン単位、または /personality で上書きできます。

Key

plan_mode_reasoning_effort

Type / Values

Details

プランモード専用の推論強度の上書き設定です。未設定の場合、プランモードでは組み込みプリセットのデフォルト値が使用されます。

Key

plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

プラグインが提供する MCP サーバー上のツールに対するデフォルトの承認動作です。

Key

plugins.<plugin>.mcp_servers.<server>.disabled_tools

Type / Values

array<string>

Details

プラグインが提供する MCP サーバーで、enabled_tools の後に適用する拒否リストです。

Key

plugins.<plugin>.mcp_servers.<server>.enabled

Type / Values

boolean

Details

プラグインのマニフェストを変更せずに、インストール済みプラグインに同梱された MCP サーバーを有効または無効にします。

Key

plugins.<plugin>.mcp_servers.<server>.enabled_tools

Type / Values

array<string>

Details

プラグインが提供する MCP サーバーから公開されるツールの許可リストです。

Key

plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

プラグインが提供する MCP ツールの承認動作をツールごとに上書きします。

Key

project_doc_fallback_filenames

Type / Values

array<string>

Details

AGENTS.md がない場合に追加で探すファイル名です。

Key

project_doc_max_bytes

Type / Values

number

Details

プロジェクトの指示を組み立てる際に AGENTS.md から読み込む最大バイト数です。

Key

project_root_markers

Type / Values

array<string>

Details

プロジェクトルートの判定に使うマーカーファイル名のリストです。親ディレクトリをたどってプロジェクトルートを探すときに使用します。

Key

projects.<path>.trust_level

Type / Values

string

Details

プロジェクトまたは Worktree を信頼済みまたは未信頼としてマークします（"trusted" | "untrusted"）。未信頼のプロジェクトでは、プロジェクトローカルの構成、フック、ルールなど、プロジェクト単位の .codex/ レイヤーがスキップされます。

Key

review_model

Type / Values

string

Details

/review で使用するモデルの上書き設定です（任意）。デフォルトでは、現在のセッションのモデルを使用します。

Key

sandbox_mode

Type / Values

read-only | workspace-write | danger-full-access

Details

コマンド実行時のファイルシステムおよびネットワークアクセスに適用するサンドボックスポリシーです。

Key

sandbox_workspace_write.exclude_slash_tmp

Type / Values

boolean

Details

workspace-write モードで、書き込み可能なルートから /tmp を除外します。

Key

sandbox_workspace_write.exclude_tmpdir_env_var

Type / Values

boolean

Details

workspace-write モードで、書き込み可能なルートから $TMPDIR を除外します。

Key

sandbox_workspace_write.network_access

Type / Values

boolean

Details

workspace-write サンドボックス内で外部へのネットワークアクセスを許可します。

Key

sandbox_workspace_write.writable_roots

Type / Values

array<string>

Details

sandbox_mode = "workspace-write" の場合に追加する、書き込み可能なルートです。

Key

service_tier

Type / Values

string

Details

新しいターンで優先するサービスティアです。fast、またはアクティブなモデルが提示するほかのティアを使用してください。fast はリクエスト値 priority に対応します。

Key

shell_environment_policy.exclude

Type / Values

array<string>

Details

従来の環境変数の除外パターンです。新しい構成では shell_environment_policy.filters を使用してください。同じレイヤーで両方の形式を併用しないでください。

Key

shell_environment_policy.experimental_use_profile

Type / Values

boolean

Details

サブプロセスの起動時に、ユーザーのシェルプロファイルを使用します。

Key

shell_environment_policy.filters

Type / Values

map<string, include | exclude>

Details

大文字と小文字を区別しない、標準形式の環境変数パターンフィルターです。含める対象のエントリは許可リストを作成しますが、除外された値を復元することはできません。明示的な set の値は、除外処理の後に適用されます。同じレイヤーで、フィルターと従来の exclude または include_only 配列を併用しないでください。

Key

shell_environment_policy.ignore_default_excludes

Type / Values

boolean

Details

他のフィルターを適用する前に、名前に KEY、SECRET、TOKEN を含む変数を保持します（デフォルト：true）。シークレットを示す変数名を自動的に除外するには、false に設定します。

Key

shell_environment_policy.include_only

Type / Values

array<string>

Details

従来の環境変数パターンの許可リストです。新しい構成では shell_environment_policy.filters を使用してください。同じレイヤーで両方の形式を併用しないでください。

Key

shell_environment_policy.inherit

Type / Values

all | core | none

Details

サブプロセスの起動時に環境変数を継承するための基本方針です。

Key

shell_environment_policy.set

Type / Values

map<string,string>

Details

除外処理の後に明示的に追加する環境変数の値です。これらの値も、含める対象を指定するフィルターによって削除される場合があります。

Key

show_raw_agent_reasoning

Type / Values

boolean

Details

アクティブなモデルが未加工の推論内容を出力した場合に、それを表示します。

Key

skills.config

Type / Values

array<object>

Details

config.toml に保存される、スキルごとの有効／無効の上書き設定です。

Key

skills.config.<index>.enabled

Type / Values

boolean

Details

参照先のスキルを有効または無効にします。

Key

skills.config.<index>.path

Type / Values

string (path)

Details

SKILL.md を含むスキルフォルダーへのパスです。

Key

skills.max_context_tokens

Type / Values

integer (positive)

Details

利用可能なスキルのカタログに割り当てるトークン数です。デフォルトはモデルのコンテキストウィンドウの 2% です。明示的に指定する値の上限は 10000 トークンです。

Key

sqlite_home

Type / Values

string (path)

Details

Codex が SQLite ベースの状態 DB を保存するディレクトリです。この DB は、エージェントのジョブや、その他の再開可能なランタイム状態に使用されます。

Key

suppress_unstable_features_warning

Type / Values

boolean

Details

開発中の機能フラグを有効にしたときに表示される警告を抑制します。

Key

tool_output_token_limit

Type / Values

number

Details

個々のツールや関数の出力を履歴に保存する際のトークン数の上限です。

Key

tool_suggest.disabled_tools

Type / Values

array<table>

Details

検出可能な特定のコネクタやプラグインの提案を無効にします。各エントリには type = "connector" または "plugin" と、id を指定します。

Key

tool_suggest.discoverables

Type / Values

array<table>

Details

追加で検出できるコネクタやプラグインについて、ツールの提案を許可します。各エントリには type = "connector" または "plugin" と、id を指定します。

Key

tools.view_image

Type / Values

boolean

Details

ローカル画像を添付するツール view_image を有効にします。

Key

tools.web_search

Type / Values

boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }

Details

ウェブ検索ツールの構成です（任意）。オブジェクト形式では、検索コンテキストのサイズ、検索を許可するドメイン、ユーザーのおおよその位置を設定できます。これらの検索ドメインフィルターは、サンドボックス内で実行するコマンドのネットワークドメインルールとは別であり、コネクタや MCP サーバーを制限しません。

Key

tui

Type / Values

table

Details

インラインのデスクトップ通知の有効化など、TUI 固有のオプションです。

Key

tui.alternate_screen

Type / Values

auto | always | never

Details

TUI で代替画面を使用するかどうかを制御します。デフォルトは auto です。auto の場合、Zellij ではスクロールバックを保持するため代替画面を使用しません。

Key

tui.animations

Type / Values

boolean

Details

ターミナルのアニメーション（ウェルカム画面、シマー、スピナー）を有効にします（デフォルト：true）。

Key

tui.keymap.<context>.<action>

Type / Values

string | array<string>

Details

TUI アクションに割り当てるキーボードショートカットです。サポートされるコンテキストには、global、chat、composer、editor、vim_normal、vim_operator、vim_text_object、pager、list、approval があります。一部のコンポーザーアクションでは、対応する tui.keymap.global の割り当てがフォールバックとして使用されます。サポートされている場合は、コンテキスト固有の割り当てが優先されます。

Key

tui.keymap.<context>.<action> = []

Type / Values

empty array

Details

そのキーマップのコンテキストで、アクションの割り当てを解除します。キー名には、ctrl-a、shift-enter、page-down、minus などの正規化された文字列を使用します。

Key

tui.model_availability_nux.<model>

Type / Values

integer

Details

モデルのスラッグをキーとする起動時ツールチップの内部状態です。

Key

tui.notification_condition

Type / Values

unfocused | always

Details

TUI 通知を、ターミナルにフォーカスがない場合のみ送信するか、フォーカスの有無にかかわらず送信するかを制御します。デフォルトは unfocused です。

Key

tui.notification_method

Type / Values

auto | osc9 | bel

Details

ターミナル通知の送信方式です（デフォルト：auto）。

Key

tui.notifications

Type / Values

boolean | array<string>

Details

TUI 通知を有効にします。必要に応じて、特定のイベントタイプに限定できます。

Key

tui.raw_output_mode

Type / Values

boolean

Details

ターミナル上で範囲を選択してコピーしやすくするため、TUI を raw スクロールバックモードで起動します（デフォルト：false）。/raw またはデフォルトの alt-r キーバインドで切り替えられます。

Key

tui.resume_cwd

Type / Values

current | session

Details

セッションを再開またはフォークするときに使用する作業ディレクトリです。未設定の場合、現在のディレクトリがセッションに保存されたディレクトリと異なると、Codex が使用するディレクトリの選択を求めます。

Key

tui.show_tooltips

Type / Values

boolean

Details

TUI のウェルカム画面に初期操作を案内するツールチップを表示します（デフォルト：true）。

Key

tui.status_line

Type / Values

array<string> | null

Details

TUI フッターのステータス行に表示する項目識別子を順番に並べたリストです。null を指定すると、ステータス行が無効になります。

Key

tui.terminal_title

Type / Values

array<string> | null

Details

ターミナルのウィンドウ／タブのタイトルに表示する項目識別子を順番に並べたリストです。デフォルトは ["spinner", "project"] です。null を指定すると、タイトルの更新が無効になります。

Key

tui.theme

Type / Values

string

Details

構文ハイライトのテーマを上書きします（ケバブケースのテーマ名）。

Key

tui.vim_mode_default

Type / Values

boolean

Details

コンポーザーを、挿入モードではなく Vim のノーマルモードで起動します（デフォルト：false）。セッションごとに /vim で切り替えることもできます。

Key

web_search

Type / Values

disabled | cached | indexed | live

Details

ウェブ検索モードです（デフォルト："cached"。cached は外部ウェブにアクセスせず、OpenAI が管理するインデックスを使用します。indexed は検索インデックスで許可された場合に限り外部アクセスを認めます。--yolo または他のフルアクセスのサンドボックス設定を使用する場合、デフォルトは "live" になります）。制限のないリアルタイム取得には "live" を、ツールを削除するには "disabled" を使用します。

Key

windows_wsl_setup_acknowledged

Type / Values

boolean

Details

Windows の初期設定ガイドを確認済みかどうかを記録します（Windows のみ）。

Key

windows.sandbox

Type / Values

unelevated | elevated

Details

Windows 上で Codex をネイティブ実行する場合の、Windows 専用のネイティブサンドボックスモードです。

Key

windows.sandbox_private_desktop

Type / Values

boolean

Details

Windows のネイティブ環境では、サンドボックス化された最終的な子プロセスをデフォルトでプライベートデスクトップ上で実行します。従来の Winsta0\\Default の動作との互換性が必要な場合にのみ false に設定してください。

config.toml の最新の JSON スキーマはこちらで確認できます。

VS Code または Cursor で config.toml を編集する際に自動補完と診断を利用するには、Even Better TOML 拡張機能をインストールし、config.toml の先頭に次の行を追加します。

#:schema https://developers.openai.com/codex/config-schema.json

注：experimental_instructions_file を model_instructions_file に変更してください。Codex では古いキーは非推奨です。既存の構成を新しい名前に更新してください。

`requirements.toml`

requirements.toml は、セキュリティに関わる設定を管理者が強制適用し、ユーザーによる上書きを防ぐ構成ファイルです。詳細、配置場所、例については、管理者が強制適用する要件を参照してください。

ChatGPT Business と ChatGPT Enterprise のユーザーには、Codex でクラウドから取得した要件も適用できます。優先順位の詳細は、セキュリティのページを参照してください。

requirements.toml の [features] を使用すると、 config.toml と同じ正規キーでランタイム機能フラグを固定できます。要件には、config.toml には含まれない、ドキュメントに記載されたアプリ専用キーも指定できます。省略したキーには制約が適用されません。

管理対象の要件には、許可リストではなく、特定の構成値を強制適用するものもあります。ユーザーは、強制適用されたパス、更新設定、ログインシェルのポリシー、フィードバック設定、Windows のプライベートデスクトップ設定を上書きできません。

管理対象の権限プロファイル許可リストには、Codex 0.138.0 以降が必要です。 Codex 0.137.0 以前では、allowed_permission_profiles と管理対象の default_permissions は無視されます。

allowed_sandbox_modes は sandbox_mode と組み合わせて使用します。権限プロファイルを導入する場合は、allowed_permission_profiles を管理対象の default_permissions と組み合わせて使用します。

[models.new_thread] テーブルは管理対象のデフォルト値を提供するもので、設定を強制するものではありません。専用の CLI フラグや --config によるオーバーライドで、起動時に明示的に指定した値が優先されます。モデルまたは推論強度を明示的に上書きすると、管理対象のモデルフィールドは両方とも適用されません。 service_tier は独立しています。

ブラウザの要件は、3 つの異なる操作領域を対象としています。 in_app_browser は、ユーザーが開いて直接操作するブラウザペインを制御します。 browser_use は、エージェントによるブラウザ内の作業を制御します。 computer_use は、エージェントによるネイティブデスクトップアプリでの作業を制御します。

ネストされたブラウザとコンピューターの使用のポリシー値は、それ自体でアクセスを許可するものではありません。オリジンやアプリに固有の allow は、同じポリシーソースのフォールバック値を上書きできますが、通常の機能、承認、その他のポリシーチェックは引き続き適用されます。管理対象の要件と config.toml の両方が適用される場合は、どちらか一方の deny が優先されます。

Key	Type / Values	Details
`allow_appshots`	`boolean`	`false` に設定すると、管理対象ユーザーの Appshots が無効になります。省略した場合、Appshots は要件による制限を受けず、通常の製品の提供条件に従います。
`allow_browser_and_computer_use`	`boolean`	`false` に設定すると、エージェントによるブラウザ操作と、ネイティブアプリでのコンピューターの使用の両方をブロックします。`true` に設定するか省略しても、どちらの機能も有効にはなりません。他の機能、ポリシー、承認のチェックは引き続き適用されます。
`allow_login_shell`	`boolean`	シェルツールがログインシェルを起動できるかどうかの設定を強制適用します。
`allow_managed_hooks_only`	`boolean`	`true` の場合、Codex はユーザー、プロジェクト、セッション、プラグインのフックをスキップしますが、`requirements.toml` やその他の管理対象の構成レイヤーからの管理対象フックは引き続き許可します。
`allow_remote_control`	`boolean`	`false` に設定すると、管理対象ユーザーのデバイスのリモート操作が無効になります。省略した場合、デバイスのリモート操作は要件による制限を受けず、通常の製品の提供条件に従います。
`allowed_approval_policies`	`array<string>`	`approval_policy` に許可する値（例：`untrusted`、`on-request`、`never`、`granular`）。
`allowed_approvals_reviewers`	`array<string>`	`approvals_reviewer` に許可する値（例：`user`、`auto_review`）。
`allowed_chatgpt_workspaces`	`array<string>`	Codex アクセストークンを含む ChatGPT ログインを、リストに記載されたワークスペース ID に制限します。空のリストは ChatGPT ログインを無効にします。API 認証は、許可されていれば引き続き利用できます。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウドで管理される値は無視されます。
`allowed_login_methods`	`array<string>`	`chatgpt`、`api`、またはその両方を許可します。省略した場合、この設定はログイン方法を制限しません。設定する場合、リストには少なくとも 1 つの方法を含める必要があります。`api` は、Amazon Bedrock を含む API 認証を許可します。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウドで管理される値は無視されます。
`allowed_permission_profiles`	`table<boolean>`	許可する権限プロファイルの完全な一覧です。`true` に設定したプロファイルは許可されます。省略したプロファイルや `false` に設定したプロファイルは、将来のバージョンで追加されるものも含めて拒否されます。複数の要件ソースを統合する際は、プロファイル名でエントリを照合します。
`allowed_permission_profiles.<name>`	`boolean`	読み込まれた構成または要件ソースで定義されている、組み込みまたはカスタムの権限プロファイルを許可または拒否します。後から適用される優先順位の高い要件ソースでは、`false` を指定することで、先に適用された優先順位の低いソースで許可されたプロファイルを無効にできます。
`allowed_sandbox_modes`	`array<string>`	`sandbox_mode` に許可する値。
`allowed_web_search_modes`	`array<string>`	`web_search` に許可する値（`disabled`、`cached`、`indexed`、`live`）です。`disabled` は常に許可されます。空のリストを指定すると、実質的に `disabled` のみが許可されます。
`apps`	`table`	アプリ識別子をキーとする、管理対象のアプリ要件です。要件によって、アプリを無効にしたり、個々のツールの承認動作を制限したりできます。
`apps.<id>.enabled`	`boolean`	アプリを無効にするには `false` に設定します。複数の要件ソースをマージした場合も、アプリを無効にする要件による制限は維持されます。
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	アプリの 1 つのツールに対して、管理対象の承認モードを設定します。
`browser_use`	`table`	エージェントによるブラウザ操作に対して管理者が指定する要件。
`browser_use.allow_global_persistent_approval`	`boolean`	`false` に設定すると、任意のサイトからのダウンロードを許可するなど、すべてのサイトを対象とする `Always allow` 承認をブラウザ機能が作成または適用できなくなります。既存の保存済み承認は無視されますが、削除はされません。`true` に設定するか省略しても、承認は作成されません。
`browser_use.allow_history_access`	`boolean`	`false` に設定すると、ブラウザ機能が閲覧履歴を読み取れなくなります。`true` に設定するか省略した場合、通常の履歴設定と利用可否のチェックが引き続き適用されます。
`browser_use.default_origin_policy`	`table`	`browser_use.origins` 内の一致するエントリで定義されていないブラウザ機能の各設定に適用するフォールバックです。一致するオリジンルールがある場合、そのソースのフォールバックはそのルールに置き換えられます。その後、Codex は管理要件とユーザー設定の結果のうち、より厳しい方を適用します。
`browser_use.default_origin_policy.access`	`allow \| deny`	`deny` を指定すると、フォールバックが適用されるオリジンでブラウザ機能をブロックします。拒否されたオリジンでは、アップロード、ダウンロード、ブラウザデバッグへのフルアクセス、自動レビューもブロックされます。`allow` は、通常の承認とポリシーのチェックに進むことだけを許可します。
`browser_use.default_origin_policy.access_approval_lifetime`	`turn \| thread`	永続化されないサイトアクセス承認の有効期間を設定します。`turn` は現在のターンに限定し、`thread` は現在のスレッドが終わるまで承認を維持します。`Always allow` を利用できるかどうかは、`persistent_approval` で別途制御します。製品のデフォルトは `thread` です。
`browser_use.default_origin_policy.auto_review`	`allow \| deny`	`deny` を指定すると、フォールバックが適用されるオリジンで自動レビューをスキップし、代わりにユーザーに承認を求めます。`allow` の場合、他の設定で許可されていれば自動レビューを利用できます。
`browser_use.default_origin_policy.downloads`	`allow \| deny`	`deny` を指定すると、フォールバックが適用されるオリジンでブラウザ機能によるダウンロードをブロックします。`allow` は、通常の承認とポリシーのチェックに進むことだけを許可します。
`browser_use.default_origin_policy.full_cdp_access`	`allow \| deny`	`deny` を指定すると、フォールバックが適用されるオリジンで Chrome DevTools Protocol（CDP）へのフルアクセスをブロックします。`allow` は、通常のオプトインと承認のチェックに進むことだけを許可します。
`browser_use.default_origin_policy.persistent_approval`	`boolean`	`false` に設定すると、フォールバックが適用されるオリジンで、ブラウザ機能が `Always allow` 承認を保存または適用できなくなります。現在のターンまたはスレッドに対する承認は引き続き適用できます。`true` に設定すると、他の条件で許可されていれば `Always allow` を利用できますが、承認が作成されるわけではありません。
`browser_use.default_origin_policy.uploads`	`allow \| deny`	`deny` を指定すると、フォールバックが適用されるオリジンでブラウザ機能によるアップロードをブロックします。`allow` は、通常の承認とポリシーのチェックに進むことだけを許可します。
`browser_use.disable_auto_review`	`boolean`	`true` に設定すると、ブラウザ機能の自動レビューをスキップし、代わりにユーザーに承認を求めます。`false` に設定するか省略した場合、他の設定で許可されていれば自動レビューを利用できます。
`browser_use.origins`	`map<string, table>`	オリジン固有のブラウザポリシーです。キーには、`http` または `https` を使った `<scheme>://<host-pattern>[:<port>]` 形式を使用します。ホストを完全一致で指定するか、サブドメインのみを対象にする場合は `.example.com`、ベースドメインとそのサブドメインを対象にする場合は `.example.com` を使用します。それ以外の `` ワイルドカードはドットをまたいで一致するため、`region.example.com` は `region.api.example.com` にも一致します。ホストに `` を指定すると、そのスキームのすべてのホストに一致します。スキームとデフォルト以外のポートは区別されます。明示的に指定したデフォルトポートは、正規化時に除去されます。パス、クエリ、埋め込まれたユーザー名やパスワード、およびスキームやポートのワイルドカードは無効です。TOML では、`[browser_use.origins."https://**.example.com"]` のようにパターンを引用符で囲んでください。
`browser_use.origins.<pattern>`	`table`	このパターンに一致するオリジンのポリシーです。複数のパターンが一致する場合、Codex は各機能について最も制限の厳しい値を使用します。`allow` より `deny`、`true` より `false`、`thread` より `turn` が優先されます。
`browser_use.origins.<pattern>.access`	`allow \| deny`	`deny` を指定すると、一致するオリジンでブラウザ機能をブロックします。拒否されたオリジンでは、アップロード、ダウンロード、ブラウザデバッグへのフルアクセス、自動レビューもブロックされます。`allow` は、通常の承認とポリシーのチェックに進むことだけを許可します。
`browser_use.origins.<pattern>.access_approval_lifetime`	`turn \| thread`	一致するオリジンに対する、永続化されないサイトアクセス承認の有効期間を設定します。`turn` は現在のターンに限定し、`thread` は現在のスレッドが終了するまで有効にします。`Always allow` を利用できるかどうかは、`persistent_approval` で別途制御します。
`browser_use.origins.<pattern>.auto_review`	`allow \| deny`	`deny` を指定すると、一致するオリジンでは自動レビューを行わず、代わりにユーザーに承認を求めます。`allow` を指定すると、他の設定で許可されている場合に自動レビューを利用できます。
`browser_use.origins.<pattern>.downloads`	`allow \| deny`	`deny` を指定すると、一致するオリジンでブラウザ機能によるダウンロードをブロックします。`allow` は、通常の承認とポリシーのチェックに進むことだけを許可します。
`browser_use.origins.<pattern>.full_cdp_access`	`allow \| deny`	`deny` を指定すると、一致するオリジンで Chrome DevTools Protocol（CDP）へのフルアクセスをブロックします。`allow` は、通常のオプトインと承認のチェックに進むことだけを許可します。
`browser_use.origins.<pattern>.persistent_approval`	`boolean`	`false` に設定すると、ブラウザは一致するオリジンで `Always allow` の承認を保存せず、保存済みの承認も適用しません。現在のターンまたはスレッドに対する承認は引き続き適用できます。`true` に設定すると、他の条件で許可されている場合に `Always allow` を利用できますが、承認そのものが作成されるわけではありません。
`browser_use.origins.<pattern>.uploads`	`allow \| deny`	`deny` を指定すると、一致するオリジンでブラウザ機能によるアップロードをブロックします。`allow` は、通常の承認とポリシーのチェックに進むことだけを許可します。
`chatgpt_base_url`	`string`	認証とクラウドポリシーの取得前に、ChatGPT サービスのベース URL を強制適用します。この設定で Codex のすべてのネットワーク接続先が構成されるわけではありません。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウドで管理される値は無視されます。
`check_for_update_on_startup`	`boolean`	Codex が起動時に更新を確認するかどうかの設定を強制適用します。
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	認証情報の読み込み前に、CLI の認証情報の保存先を強制適用します。`file` は `CODEX_HOME/auth.json` を使用します。`keyring` には OS の認証情報ストアが必要です。`auto` は認証情報ストアが利用できない場合、ファイルにフォールバックします。`ephemeral` は現在のプロセスのメモリ内に認証情報を保持します。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウドで管理される値は無視されます。
`computer_use`	`table`	ネイティブデスクトップアプリでエージェントが行う作業に対する管理要件です。管理対象のアプリルールと `config.toml` のアプリルールの両方が強制適用されます。アプリは各ポリシーソースで許可されている必要があります。
`computer_use.allow_locked_computer_use`	`boolean`	`false` に設定すると、管理対象の macOS デバイスでユーザーがロック中の使用を有効にできなくなります。この要件は有効化用のコントロールを非表示にしますが、すでに有効なロック中の使用を無効にするものではありません。省略すると、通常の製品の提供条件が適用されます。
`computer_use.allow_persistent_approval`	`boolean`	`false` に設定すると、アプリの承認をセッション間で保存するオプションがなくなります。現在のセッションに対する承認は引き続き利用できます。`true` に設定したり省略したりしても、アプリが承認されるわけではありません。
`computer_use.default_app_access`	`allow \| deny`	プラットフォーム固有のルールに一致しないネイティブアプリに適用する、フォールバックのアクセス設定です。`deny` はアクセスをブロックします。`allow` は、通常の承認とポリシーのチェックを続行できるようにするだけです。製品のデフォルトは `allow` です。
`computer_use.macos`	`table`	macOS 向けのコンピューターの使用に関するアプリルールです。
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	macOS のバンドル識別子を完全一致で `allow` または `deny` に対応付けます。一致するルールは、同じポリシーソース内の `computer_use.default_app_access` に優先します。管理要件またはユーザー設定のいずれかで拒否されている場合は、引き続きアクセスがブロックされます。
`computer_use.macos.bundle_ids.<bundle-id>`	`allow \| deny`	`deny` を指定すると、バンドル識別子が完全一致するアプリをブロックします。`allow` が上書きするのはこのポリシーソースのデフォルトだけであり、アプリを利用するには、他のすべてのポリシーソースと通常の承認フローでも許可される必要があります。
`computer_use.windows`	`table`	パッケージ化された Windows アプリとパッケージ化されていない Windows アプリに適用する、コンピューターの使用のアプリルールです。
`computer_use.windows.aumids`	`map<string, allow \| deny>`	署名済みのパッケージアプリに登録されている Application User Model ID（AUMID）を完全一致で `allow` または `deny` に対応付けます。一致するルールは、同じポリシーソース内の `computer_use.default_app_access` に優先します。
`computer_use.windows.aumids.<aumid>`	`allow \| deny`	`deny` を指定すると、識別情報が完全一致するパッケージアプリをブロックします。`allow` が上書きするのはこのポリシーソースのデフォルトだけであり、アプリを利用するには、他のすべてのポリシーソースと通常の承認フローでも許可される必要があります。
`computer_use.windows.exes`	`array<table>`	署名済みでパッケージ化されていない Windows 実行ファイルのルールです。ルールは、実行ファイルのパスや現在のファイル名ではなく、検証済みの発行元と署名済みのバージョン情報に照合されます。一致する拒否ルールは、一致する許可ルールに優先します。署名のない実行ファイルには `computer_use.default_app_access` が適用されます。署名された識別情報を一意に検証できない実行ファイルはブロックされます。
`computer_use.windows.exes[].access`	`allow \| deny`	一致する実行ファイルに対するアクセスの許可または拒否を指定します。必須です。`deny` はアクセスをブロックします。`allow` が上書きするのはこのポリシーソースのデフォルトだけであり、アプリを利用するには、他のすべてのポリシーソースと通常の承認フローでも許可される必要があります。
`computer_use.windows.exes[].binary_name`	`string`	実行ファイルの署名済みバージョン情報に含まれる `OriginalFilename` を指定します。省略可能です。照合では大文字と小文字を区別しません。発行元と製品が一致するルールでこの値が必須とされているにもかかわらず、実行ファイルにこの値がない場合、コンピューターの使用はその実行ファイルをブロックします。
`computer_use.windows.exes[].product_name`	`string`	実行ファイルの署名済みバージョン情報に含まれる `ProductName` を正確に指定します。必須です。
`computer_use.windows.exes[].publisher_name`	`string`	実行ファイルの信頼できる署名証明書に記載された発行元名を、Windows X.500 識別名の形式で正確に指定します。必須です。
`default_permissions`	`string`	管理者が指定するデフォルトの権限プロファイルです。このプロファイルは `allowed_permission_profiles` で許可されている必要があります。動作を予測可能にするため、明示的に設定してください。省略した場合、Codex は `:workspace` と `:read-only` の両方が明示的に許可されている場合に限り、`:workspace` をデフォルトとして使用します。
`enforce_residency`	`string`	Codex サービスの通信に、サポートされているデータレジデンシーの使用を必須にします。現在指定できる値は `us` です。
`experimental_network`	`table`	サンドボックス内のローカルコマンドに適用する、管理者が管理するネットワーク要件です。`requirements.toml` から強制適用されます。有効にすると、`features.network_proxy` がなくてもコマンド用ネットワークプロキシを起動できます。ブラウザツールは、管理対象のネットワーク拒否ルールと排他的な許可リストを別途チェックします。これらの要件は、ブラウザの通信をプロキシ経由にするものではなく、ウェブ検索、アプリ、MCP サーバー、ネイティブアプリの通信、Codex Cloud のネットワーク通信を制御するものでもありません。
`experimental_network.allow_local_binding`	`boolean`	サンドボックス内のネットワーク通信で、ローカルネットワークやプライベートネットワークへのアクセスをより広く許可します。`false` のままでも、正確なローカル IP リテラルまたは `localhost` の許可ルールにより、特定のローカル接続先を許可できます。
`experimental_network.allow_upstream_proxy`	`boolean`	サンドボックス内のネットワーク通信で、環境から取得した上流プロキシへの多段接続を許可します。
`experimental_network.allowed_domains`	`array<string>`	管理対象のネットワークプロキシが有効な間、サンドボックス内のコマンドのネットワーク通信に適用される管理者の許可ルールです。これらのルールは、ウェブ検索、アプリ、MCP サーバーには適用されません。`experimental_network.domains` と併用しないでください。
`experimental_network.dangerously_allow_all_unix_sockets`	`boolean`	アクセス先を許可リストに限定せず、任意の Unix ソケットへのアクセスを許可します。厳密に管理された環境でのみ使用してください。
`experimental_network.dangerously_allow_non_loopback_proxy`	`boolean`	`[experimental_network]` の要件で、ループバック以外のリスナーアドレスを許可します。有効にすると、localhost の外部からリスナーにアクセスできるようになる可能性があります。
`experimental_network.denied_domains`	`array<string>`	サンドボックス内のネットワーク通信に適用する、リスト形式の管理者の拒否ルールです。`experimental_network.domains` と併用しないでください。
`experimental_network.domains`	`map<string, allow \| deny>`	サンドボックス内のネットワーク通信に適用する、マップ形式の管理者ドメインポリシーです。完全一致のホスト、サブドメインのみを対象とする `.example.com`、ドメイン本体とサブドメインを対象とする `.example.com`、すべてを対象とする `` の許可ルールをサポートします。`*` はパブリックネットワークへの外向きアクセスを広く許可するため、範囲を限定したルールを推奨します。競合時は `deny` が優先されます。`experimental_network.allowed_domains` または `experimental_network.denied_domains` と併用しないでください。
`experimental_network.enabled`	`boolean`	サンドボックス内のネットワーク要件を有効にします。使用中のサンドボックスでコマンドのネットワーク通信が無効になっている場合、これによってネットワークアクセスが許可されることはありません。
`experimental_network.http_port`	`integer`	`[experimental_network]` の要件に使用する、ループバック HTTP リスナーのポートです。
`experimental_network.managed_allowed_domains_only`	`boolean`	`true` の場合、サンドボックス内のネットワーク要件が有効な間は、管理者が管理する許可ルールのみが有効になり、ユーザーが許可リストに追加した項目は無視されます。管理対象の許可ルールがない場合も、ユーザーが追加したドメイン許可ルールは有効になりません。
`experimental_network.socks_port`	`integer`	`[experimental_network]` の要件に使用する、ループバック SOCKS5 リスナーのポートです。
`experimental_network.unix_sockets`	`map<string, allow \| deny>`	サンドボックス内のネットワーク通信に適用する、管理者が管理する Unix ソケットポリシーです。
`features`	`table`	固定する機能の値です。ランタイム機能には `config.toml` の正式な名前を使用してください。ドキュメントに記載されているアプリ専用の要件キーも、ここで使用できます。
`features.<name>`	`boolean`	ドキュメントに記載されているランタイム機能またはアプリ機能を、有効または無効の状態に固定します。
`features.apps`	`boolean`	管理対象ユーザーのアプリ連携を、有効または無効に固定します。
`features.browser_use`	`boolean`	`requirements.toml` で `false` に設定すると、エージェントによるブラウザ操作が無効になります。
`features.browser_use_external`	`boolean`	`requirements.toml` で `false` に設定すると、Codex が ChatGPT ブラウザ拡張機能を通じて対応ブラウザを操作できなくなります。既存のタブやサインイン済みセッションの操作も含まれます。
`features.browser_use_full_cdp_access`	`boolean`	`requirements.toml` で `false` に設定すると、ブラウザ開発者モードを含め、ローカルランタイムでの Chrome DevTools Protocol へのフルアクセスが無効になり、ChatGPT デスクトップアプリで対応する設定を有効にできなくなります。省略した場合、通常の製品の提供条件が適用されます。
`features.computer_use`	`boolean`	`requirements.toml` で `false` に設定すると、コンピューターの使用、記録と再生、および関連するインストールや有効化のフローが無効になります。
`features.fast_mode`	`boolean`	管理対象ユーザーについて、正式な機能キー `fast_mode` を有効または無効に固定します。
`features.guardian_approval`	`boolean`	管理対象ユーザーの Guardian 承認を、有効または無効に固定します。
`features.in_app_browser`	`boolean`	`requirements.toml` で `false` に設定すると、ユーザーが開いて直接操作する組み込みブラウザペインが無効になります。
`features.in_app_updates`	`boolean`	`requirements.toml` で `false` に設定すると、アプリ内更新が無効になります。この要件を省略した場合、更新はデフォルトで有効のままです。
`features.memories`	`boolean`	管理対象ユーザーのメモリを、有効または無効に固定します。
`features.multi_agent`	`boolean`	管理対象ユーザーのマルチエージェント機能を、有効または無効に固定します。
`features.plugin_sharing`	`boolean`	クラウドで管理される `requirements.toml` で `false` に設定すると、ローカルで作成したプラグインのワークスペース共有が無効になります。
`features.plugins`	`boolean`	管理対象ユーザーのプラグインを、有効または無効に固定します。
`features.remote_plugin`	`boolean`	管理対象ユーザーのリモートプラグインカタログを、有効または無効に固定します。
`features.workspace_dependencies`	`boolean`	管理対象ユーザーについて、同梱のワークスペース依存関係用ランタイムを、有効または無効に固定します。
`feedback`	`table`	管理対象のフィードバック設定です。
`feedback.enabled`	`boolean`	各 Codex クライアントでユーザーがフィードバックを送信できるかどうかを強制的に設定します。
`guardian_policy_config`	`string`	自動レビュー用に管理者が指定する Markdown 形式のポリシー指示です。ローカルの `[auto_review].policy` より優先されます。空白の値は無視されます。
`hooks`	`table`	管理者が強制適用する、管理対象のライフサイクルフックです。管理対象のフック用ディレクトリが必要です。`config.toml` にインラインで記述する `[hooks]` と同じイベントスキーマを使用します。
`hooks.<Event>`	`array<table>`	`PreToolUse`、`PermissionRequest`、`PostToolUse`、`PreCompact`、`PostCompact`、`SessionStart`、`SessionEnd`、`SubagentStart`、`SubagentStop`、`UserPromptSubmit`、`Stop` などのフックイベントに対するマッチャーグループです。
`hooks.<Event>[].hooks`	`array<table>`	マッチャーグループのフックハンドラーです。コマンドフックと MCP ツールフックがサポートされています。プロンプトフックとエージェントフックのハンドラーは解析されますが、実行はスキップされます。
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	サイズの大きい `additionalContext` をディスクに保存し、短いプレビューをモデルに表示するための、ハンドラーごとのおおよそのトークンしきい値です。デフォルトは `2500` です。`0` を指定すると、コンテキスト全体を直接モデルに渡します。大きなフック出力を参照してください。
`hooks.<Event>[].hooks[].async`	`boolean`	トリガーとなった操作を遅らせずに、コマンドフックをバックグラウンドで実行します。デフォルトは `false` です。`SessionEnd` は常に同期実行されます。フックのバックグラウンド実行を参照してください。
`hooks.<Event>[].hooks[].commandWindows`	`string`	コマンドフックに対する Windows 専用のコマンド上書き設定です。TOML の別名 `command_windows` も使用できます。
`hooks.managed_dir`	`string (absolute path)`	macOS と Linux で管理対象のフックスクリプトを格納するディレクトリです。Codex は、管理対象のフックを読み込む前に、パスが絶対パスであり、ディレクトリが存在することを検証します。
`hooks.windows_managed_dir`	`string (absolute path)`	Windows で管理対象のフックスクリプトを格納するディレクトリです。Codex は、管理対象のフックを読み込む前に、パスが絶対パスであり、ディレクトリが存在することを検証します。
`in_app_browser`	`table`	組み込みブラウザペインの要件です。これらの設定は、エージェントによるブラウザ操作を制御しません。
`in_app_browser.allow_external_browser_settings_import`	`boolean`	`false` に設定すると、ユーザーは外部ブラウザの設定や閲覧データを組み込みブラウザにインポートできなくなります。`true` に設定するか省略した場合、製品の他のチェックで許可されていればインポートを利用できます。これは管理専用の設定で、`config.toml` では上書きできません。
`log_dir`	`string (path)`	Codex がローカルログファイルを書き込むディレクトリを固定します。
`marketplaces`	`table`	プラグインマーケットプレイスのソースに関する管理者要件です。`restrict_to_allowed_sources` が `true` の場合にルールが適用されます。
`marketplaces.allowed_sources`	`table`	管理者が選んだルール名をキーとする、許可されたマーケットプレイスソースです。異なる名前のルールは要件レイヤー間で累積されます。同じ名前の配下にあるフィールドには、通常のレイヤーの優先順位が適用されます。
`marketplaces.allowed_sources.<name>`	`table`	ソースを許可する 1 つのルールです。要件のマージ後の最終的な `source` 値によって、Codex が解釈する同階層のフィールドが決まります。
`marketplaces.allowed_sources.<name>.host_pattern`	`string`	`source = "host_pattern"` の場合に必須の正規表現です。Codex は、HTTPS、SSH、または SCP 形式の Git ソースから解析した小文字のホスト名と照合します。ホスト名全体の一致を要求するには、`^` と `$` を使用します。
`marketplaces.allowed_sources.<name>.path`	`string (absolute path)`	`source = "local"` の場合に必須のローカルマーケットプレイスのディレクトリです。Codex は絶対パスを要求し、正規化後にパスを比較します。
`marketplaces.allowed_sources.<name>.ref`	`string`	`git` ルールで完全一致を求める Git ref です。省略可能です。省略すると、一致するリポジトリのすべての ref が許可されます。
`marketplaces.allowed_sources.<name>.source`	`git \| host_pattern \| local`	マーケットプレイスソースのマッチャーの種類です。単一のリポジトリには `git`、正規表現で照合する Git ホストには `host_pattern`、単一のディレクトリには `local` を使用します。
`marketplaces.allowed_sources.<name>.url`	`string`	`source = "git"` の場合に必須の Git リポジトリ URL です。Codex は、設定された URL と許可された URL を正規化したうえで、リポジトリの完全一致を要求します。
`marketplaces.restrict_to_allowed_sources`	`boolean`	`true` の場合、マーケットプレイスの追加、プラグインのインストール、設定済み Git マーケットプレイスの更新時に、ユーザーが設定したマーケットプレイスのソースが `allowed_sources` に一致することを要求します。Codex が管理する OpenAI マーケットプレイスは、予約済みのソースと名前が一致していれば引き続き許可されます。この設定は、ユーザーがすでに設定したマーケットプレイスを実行時にフィルタリングするものではありません。
`mcp_servers`	`table`	有効化できる MCP サーバーの許可リストです。MCP サーバーを有効にするには、サーバー名（`<id>`）とその識別情報の両方が一致する必要があります。構成済みの MCP サーバーでも、許可リストにない場合や識別情報が一致しない場合は無効になります。
`mcp_servers.<id>.identity`	`table`	単一の MCP サーバーを識別するためのルールです。`command`（stdio）または `url`（ストリーミング可能な HTTP）のどちらかを設定します。
`mcp_servers.<id>.identity.command`	`string \| table`	コマンド文字列の完全一致で MCP stdio サーバーを許可するか、マッチャーテーブルを使って実行ファイルの完全一致と順序付き引数マッチャーによる照合を必須にします。文字列形式では、引数、`cwd`、`env`、`env_vars` は検査されません。
`mcp_servers.<id>.identity.command.args`	`array<table>`	stdio サーバーの順序付き引数マッチャーです。設定された引数リストはマッチャーのリストと同じ長さで、すべての位置で一致する必要があります。コマンドマッチャーは `cwd`、`env`、`env_vars` を検査しません。
`mcp_servers.<id>.identity.command.args[].expression`	`string`	`regex` 引数マッチャーで使用する正規表現です。有効な正規表現であり、引数の値全体に一致する必要があります。
`mcp_servers.<id>.identity.command.args[].match`	`exact \| prefix \| regex`	この位置の引数に使用する照合方法です。
`mcp_servers.<id>.identity.command.args[].value`	`string`	`exact` または `prefix` 引数マッチャーで使用する値です。
`mcp_servers.<id>.identity.command.executable`	`string`	stdio サーバーに設定された `command` が完全一致する必要のある実行ファイルです。
`mcp_servers.<id>.identity.url`	`string \| table`	URL 文字列の完全一致で MCP のストリーミング可能な HTTP サーバーを許可するか、`exact`、`prefix`、`regex` の値マッチャーテーブルを使用します。
`mcp_servers.<id>.identity.url.expression`	`string`	`regex` URL マッチャーで使用する正規表現です。有効な正規表現であり、URL の値全体に一致する必要があります。
`mcp_servers.<id>.identity.url.match`	`exact \| prefix \| regex`	設定された MCP サーバーの URL に使用する照合方法です。
`mcp_servers.<id>.identity.url.value`	`string`	`exact` または `prefix` URL マッチャーで使用する値です。
`model_catalog_json`	`string (path)`	Codex が起動時に使用する JSON モデルカタログを固定します。
`models`	`table`	新しいスレッド用に管理者が指定するモデルのデフォルト値です。ユーザーやプロジェクトのデフォルト値より優先されますが、新しいスレッドで明示的に選択することで上書きできます。
`models.new_thread`	`table`	新しいローカルスレッドの開始時に適用するデフォルト値です。各モデル設定は省略可能です。
`models.new_thread.model`	`string`	新しいスレッドのデフォルトモデルです。`--model`、またはモデルや推論を指定する `--config` による明示的な上書きが優先されます。
`models.new_thread.model_reasoning_effort`	`string`	新しいスレッドのデフォルトの推論強度です。モデルまたは推論強度を明示的に上書きすると、管理者が指定するモデル関連の両フィールドは適用されません。
`models.new_thread.service_tier`	`string`	新しいスレッドのデフォルトのサービスティアです。サービスティアの明示的な上書きは、モデル関連のフィールドとは独立して優先されます。
`permissions`	`table`	プロファイル名をキーとする、管理者定義の権限プロファイルです。`config.toml` と同じプロファイルフィールドを使用します。
`permissions.<name>`	`table`	管理者定義の権限プロファイルです。名前を `:` で始めたり、予約名 `filesystem` を使用したり、読み込まれた構成内のプロファイル名と重複させたりすることはできません。`config.toml` と同じプロファイルフィールドを使用します。プロファイルの完全なスキーマについては、権限ガイドを参照してください。
`permissions.filesystem.deny_read`	`array<string>`	管理者が強制適用するファイルシステムの読み取り拒否設定です。各項目にはパスまたは glob パターンを指定でき、ユーザーがローカル設定で制限を緩めることはできません。
`plugins`	`table`	プラグイン識別子をキーとする、プラグインごとの MCP サーバー許可リストです。このテーブルが存在する場合、プラグインに同梱されたサーバーのうち、一致するプラグインとサーバーの項目がないものは無効になります。
`plugins.<plugin>.mcp_servers`	`table`	単一のプラグインに同梱された MCP サーバーの許可リストです。プラグインのサーバー要件には、最上位の `mcp_servers` 要件と同じ、識別情報の完全一致形式とマッチャー形式を使用します。
`plugins.<plugin>.mcp_servers.<server>.identity`	`table`	プラグインに同梱された単一の MCP サーバーを識別するためのルールです。`command`（stdio）または `url`（ストリーミング可能な HTTP）のどちらかを設定します。
`plugins.<plugin>.mcp_servers.<server>.identity.command`	`string \| table`	コマンド文字列の完全一致でプラグインの stdio MCP サーバーを許可するか、マッチャーテーブルを使って実行ファイルの完全一致と順序付き引数マッチャーによる照合を必須にします。
`plugins.<plugin>.mcp_servers.<server>.identity.command.args`	`array<table>`	プラグインに同梱された stdio サーバーの順序付き引数マッチャーです。設定された引数リストはマッチャーのリストと同じ長さで、すべての位置で一致する必要があります。
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression`	`string`	`regex` 引数マッチャーで使用する正規表現です。引数の値全体に一致する必要があります。
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match`	`exact \| prefix \| regex`	この位置の引数に使用する照合方法です。
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value`	`string`	`exact` または `prefix` 引数マッチャーで使用する値です。
`plugins.<plugin>.mcp_servers.<server>.identity.command.executable`	`string`	プラグインに同梱された stdio サーバーに設定されたコマンドが完全一致する必要のある実行ファイルです。
`plugins.<plugin>.mcp_servers.<server>.identity.url`	`string \| table`	URL 文字列の完全一致でプラグインのストリーミング可能な HTTP MCP サーバーを許可するか、`exact`、`prefix`、`regex` の値マッチャーテーブルを使用します。
`plugins.<plugin>.mcp_servers.<server>.identity.url.expression`	`string`	`regex` URL マッチャーで使用する正規表現です。URL 値全体に一致する必要があります。
`plugins.<plugin>.mcp_servers.<server>.identity.url.match`	`exact \| prefix \| regex`	プラグインに同梱された MCP サーバーの URL に使用する照合方法です。
`plugins.<plugin>.mcp_servers.<server>.identity.url.value`	`string`	`exact` または `prefix` URL マッチャーで使用する値です。
`remote_sandbox_config`	`array<table>`	ホスト固有のサンドボックス要件です。`hostname_patterns` が解決されたホスト名に一致する最初のエントリが、その要件ソースのトップレベルの `allowed_sandbox_modes` を上書きします。現在、ホスト固有のエントリで上書きできるのはサンドボックスモードのみです。
`remote_sandbox_config[].allowed_sandbox_modes`	`array<string>`	このホスト固有のエントリが一致した場合に適用する、許可されるサンドボックスモード。
`remote_sandbox_config[].hostname_patterns`	`array<string>`	大文字と小文字を区別しないホスト名パターンです。任意の文字列を表す `*` と、1 文字を表す `?` をサポートします。
`rules`	`table`	`.rules` ファイルとマージされる、管理者が強制適用するコマンドルールです。要件として指定するルールは、制限を課すものである必要があります。
`rules.prefix_rules`	`array<table>`	強制適用されるプレフィックスルールの一覧です。各ルールには `pattern` と `decision` を含める必要があります。
`rules.prefix_rules[].decision`	`prompt \| forbidden`	必須です。要件として指定するルールでは、承認を求めるか禁止することのみが可能で、許可することはできません。
`rules.prefix_rules[].justification`	`string`	承認プロンプトや拒否メッセージに表示する理由です。省略可能ですが、指定する場合は空でない値が必要です。
`rules.prefix_rules[].pattern`	`array<table>`	パターントークンで表したコマンドプレフィックスです。各トークンには `token` または `any_of` のいずれかを設定します。
`rules.prefix_rules[].pattern[].any_of`	`array<string>`	この位置で許可される代替トークンの一覧です。
`rules.prefix_rules[].pattern[].token`	`string`	この位置に指定する単一のリテラルトークンです。
`sqlite_home`	`string (path)`	Codex が SQLite ベースのランタイム状態を保存するディレクトリを固定します。
`windows`	`table`	ネイティブ Windows サンドボックスの要件。
`windows.allowed_sandbox_implementations`	`array<string>`	`windows.sandbox` で許可するネイティブ Windows サンドボックスの実装（`elevated` と `unelevated`）です。空のリストは指定できません。両方が許可され、モードが選択されていない場合、Codex は `elevated` を優先します。
`windows.sandbox_private_desktop`	`boolean`	ネイティブ Windows サンドボックスがプライベートデスクトップで子プロセスを起動するかどうかを強制的に設定します。

Key

allow_appshots

Type / Values

boolean

Details

false に設定すると、管理対象ユーザーの Appshots が無効になります。省略した場合、Appshots は要件による制限を受けず、通常の製品の提供条件に従います。

Key

allow_browser_and_computer_use

Type / Values

boolean

Details

false に設定すると、エージェントによるブラウザ操作と、ネイティブアプリでのコンピューターの使用の両方をブロックします。true に設定するか省略しても、どちらの機能も有効にはなりません。他の機能、ポリシー、承認のチェックは引き続き適用されます。

Key

allow_login_shell

Type / Values

boolean

Details

シェルツールがログインシェルを起動できるかどうかの設定を強制適用します。

Key

allow_managed_hooks_only

Type / Values

boolean

Details

true の場合、Codex はユーザー、プロジェクト、セッション、プラグインのフックをスキップしますが、requirements.toml やその他の管理対象の構成レイヤーからの管理対象フックは引き続き許可します。

Key

allow_remote_control

Type / Values

boolean

Details

false に設定すると、管理対象ユーザーのデバイスのリモート操作が無効になります。省略した場合、デバイスのリモート操作は要件による制限を受けず、通常の製品の提供条件に従います。

Key

allowed_approval_policies

Type / Values

array<string>

Details

approval_policy に許可する値（例：untrusted、on-request、never、granular）。

Key

allowed_approvals_reviewers

Type / Values

array<string>

Details

approvals_reviewer に許可する値（例：user、auto_review）。

Key

allowed_chatgpt_workspaces

Type / Values

array<string>

Details

Codex アクセストークンを含む ChatGPT ログインを、リストに記載されたワークスペース ID に制限します。空のリストは ChatGPT ログインを無効にします。API 認証は、許可されていれば引き続き利用できます。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウドで管理される値は無視されます。

Key

allowed_login_methods

Type / Values

array<string>

Details

chatgpt、api、またはその両方を許可します。省略した場合、この設定はログイン方法を制限しません。設定する場合、リストには少なくとも 1 つの方法を含める必要があります。api は、Amazon Bedrock を含む API 認証を許可します。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウドで管理される値は無視されます。

Key

allowed_permission_profiles

Type / Values

table<boolean>

Details

許可する権限プロファイルの完全な一覧です。true に設定したプロファイルは許可されます。省略したプロファイルや false に設定したプロファイルは、将来のバージョンで追加されるものも含めて拒否されます。複数の要件ソースを統合する際は、プロファイル名でエントリを照合します。

Key

allowed_permission_profiles.<name>

Type / Values

boolean

Details

読み込まれた構成または要件ソースで定義されている、組み込みまたはカスタムの権限プロファイルを許可または拒否します。後から適用される優先順位の高い要件ソースでは、false を指定することで、先に適用された優先順位の低いソースで許可されたプロファイルを無効にできます。

Key

allowed_sandbox_modes

Type / Values

array<string>

Details

sandbox_mode に許可する値。

Key

allowed_web_search_modes

Type / Values

array<string>

Details

web_search に許可する値（disabled、cached、indexed、live）です。disabled は常に許可されます。空のリストを指定すると、実質的に disabled のみが許可されます。

Key

apps

Type / Values

table

Details

アプリ識別子をキーとする、管理対象のアプリ要件です。要件によって、アプリを無効にしたり、個々のツールの承認動作を制限したりできます。

Key

apps.<id>.enabled

Type / Values

boolean

Details

アプリを無効にするには false に設定します。複数の要件ソースをマージした場合も、アプリを無効にする要件による制限は維持されます。

Key

apps.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

アプリの 1 つのツールに対して、管理対象の承認モードを設定します。

Key

browser_use

Type / Values

table

Details

エージェントによるブラウザ操作に対して管理者が指定する要件。

Key

browser_use.allow_global_persistent_approval

Type / Values

boolean

Details

false に設定すると、任意のサイトからのダウンロードを許可するなど、すべてのサイトを対象とする Always allow 承認をブラウザ機能が作成または適用できなくなります。既存の保存済み承認は無視されますが、削除はされません。true に設定するか省略しても、承認は作成されません。

Key

browser_use.allow_history_access

Type / Values

boolean

Details

false に設定すると、ブラウザ機能が閲覧履歴を読み取れなくなります。true に設定するか省略した場合、通常の履歴設定と利用可否のチェックが引き続き適用されます。

Key

browser_use.default_origin_policy

Type / Values

table

Details

browser_use.origins 内の一致するエントリで定義されていないブラウザ機能の各設定に適用するフォールバックです。一致するオリジンルールがある場合、そのソースのフォールバックはそのルールに置き換えられます。その後、Codex は管理要件とユーザー設定の結果のうち、より厳しい方を適用します。

Key

browser_use.default_origin_policy.access

Type / Values

allow | deny

Details

deny を指定すると、フォールバックが適用されるオリジンでブラウザ機能をブロックします。拒否されたオリジンでは、アップロード、ダウンロード、ブラウザデバッグへのフルアクセス、自動レビューもブロックされます。allow は、通常の承認とポリシーのチェックに進むことだけを許可します。

Key

browser_use.default_origin_policy.access_approval_lifetime

Type / Values

turn | thread

Details

永続化されないサイトアクセス承認の有効期間を設定します。turn は現在のターンに限定し、thread は現在のスレッドが終わるまで承認を維持します。Always allow を利用できるかどうかは、persistent_approval で別途制御します。製品のデフォルトは thread です。

Key

browser_use.default_origin_policy.auto_review

Type / Values

allow | deny

Details

deny を指定すると、フォールバックが適用されるオリジンで自動レビューをスキップし、代わりにユーザーに承認を求めます。allow の場合、他の設定で許可されていれば自動レビューを利用できます。

Key

browser_use.default_origin_policy.downloads

Type / Values

allow | deny

Details

deny を指定すると、フォールバックが適用されるオリジンでブラウザ機能によるダウンロードをブロックします。allow は、通常の承認とポリシーのチェックに進むことだけを許可します。

Key

browser_use.default_origin_policy.full_cdp_access

Type / Values

allow | deny

Details

deny を指定すると、フォールバックが適用されるオリジンで Chrome DevTools Protocol（CDP）へのフルアクセスをブロックします。allow は、通常のオプトインと承認のチェックに進むことだけを許可します。

Key

browser_use.default_origin_policy.persistent_approval

Type / Values

boolean

Details

false に設定すると、フォールバックが適用されるオリジンで、ブラウザ機能が Always allow 承認を保存または適用できなくなります。現在のターンまたはスレッドに対する承認は引き続き適用できます。true に設定すると、他の条件で許可されていれば Always allow を利用できますが、承認が作成されるわけではありません。

Key

browser_use.default_origin_policy.uploads

Type / Values

allow | deny

Details

deny を指定すると、フォールバックが適用されるオリジンでブラウザ機能によるアップロードをブロックします。allow は、通常の承認とポリシーのチェックに進むことだけを許可します。

Key

browser_use.disable_auto_review

Type / Values

boolean

Details

true に設定すると、ブラウザ機能の自動レビューをスキップし、代わりにユーザーに承認を求めます。false に設定するか省略した場合、他の設定で許可されていれば自動レビューを利用できます。

Key

browser_use.origins

Type / Values

map<string, table>

Details

オリジン固有のブラウザポリシーです。キーには、http または https を使った <scheme>://<host-pattern>[:<port>] 形式を使用します。ホストを完全一致で指定するか、サブドメインのみを対象にする場合は *.example.com、ベースドメインとそのサブドメインを対象にする場合は **.example.com を使用します。それ以外の * ワイルドカードはドットをまたいで一致するため、region*.example.com は region.api.example.com にも一致します。ホストに * を指定すると、そのスキームのすべてのホストに一致します。スキームとデフォルト以外のポートは区別されます。明示的に指定したデフォルトポートは、正規化時に除去されます。パス、クエリ、埋め込まれたユーザー名やパスワード、およびスキームやポートのワイルドカードは無効です。TOML では、[browser_use.origins."https://**.example.com"] のようにパターンを引用符で囲んでください。

Key

browser_use.origins.<pattern>

Type / Values

table

Details

このパターンに一致するオリジンのポリシーです。複数のパターンが一致する場合、Codex は各機能について最も制限の厳しい値を使用します。allow より deny、true より false、thread より turn が優先されます。

Key

browser_use.origins.<pattern>.access

Type / Values

allow | deny

Details

deny を指定すると、一致するオリジンでブラウザ機能をブロックします。拒否されたオリジンでは、アップロード、ダウンロード、ブラウザデバッグへのフルアクセス、自動レビューもブロックされます。allow は、通常の承認とポリシーのチェックに進むことだけを許可します。

Key

browser_use.origins.<pattern>.access_approval_lifetime

Type / Values

turn | thread

Details

一致するオリジンに対する、永続化されないサイトアクセス承認の有効期間を設定します。turn は現在のターンに限定し、thread は現在のスレッドが終了するまで有効にします。Always allow を利用できるかどうかは、persistent_approval で別途制御します。

Key

browser_use.origins.<pattern>.auto_review

Type / Values

allow | deny

Details

deny を指定すると、一致するオリジンでは自動レビューを行わず、代わりにユーザーに承認を求めます。allow を指定すると、他の設定で許可されている場合に自動レビューを利用できます。

Key

browser_use.origins.<pattern>.downloads

Type / Values

allow | deny

Details

deny を指定すると、一致するオリジンでブラウザ機能によるダウンロードをブロックします。allow は、通常の承認とポリシーのチェックに進むことだけを許可します。

Key

browser_use.origins.<pattern>.full_cdp_access

Type / Values

allow | deny

Details

deny を指定すると、一致するオリジンで Chrome DevTools Protocol（CDP）へのフルアクセスをブロックします。allow は、通常のオプトインと承認のチェックに進むことだけを許可します。

Key

browser_use.origins.<pattern>.persistent_approval

Type / Values

boolean

Details

false に設定すると、ブラウザは一致するオリジンで Always allow の承認を保存せず、保存済みの承認も適用しません。現在のターンまたはスレッドに対する承認は引き続き適用できます。true に設定すると、他の条件で許可されている場合に Always allow を利用できますが、承認そのものが作成されるわけではありません。

Key

browser_use.origins.<pattern>.uploads

Type / Values

allow | deny

Details

deny を指定すると、一致するオリジンでブラウザ機能によるアップロードをブロックします。allow は、通常の承認とポリシーのチェックに進むことだけを許可します。

Key

chatgpt_base_url

Type / Values

string

Details

認証とクラウドポリシーの取得前に、ChatGPT サービスのベース URL を強制適用します。この設定で Codex のすべてのネットワーク接続先が構成されるわけではありません。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウドで管理される値は無視されます。

Key

check_for_update_on_startup

Type / Values

boolean

Details

Codex が起動時に更新を確認するかどうかの設定を強制適用します。

Key

cli_auth_credentials_store

Type / Values

file | keyring | auto | ephemeral

Details

認証情報の読み込み前に、CLI の認証情報の保存先を強制適用します。file は CODEX_HOME/auth.json を使用します。keyring には OS の認証情報ストアが必要です。auto は認証情報ストアが利用できない場合、ファイルにフォールバックします。ephemeral は現在のプロセスのメモリ内に認証情報を保持します。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウドで管理される値は無視されます。

Key

computer_use

Type / Values

table

Details

ネイティブデスクトップアプリでエージェントが行う作業に対する管理要件です。管理対象のアプリルールと config.toml のアプリルールの両方が強制適用されます。アプリは各ポリシーソースで許可されている必要があります。

Key

computer_use.allow_locked_computer_use

Type / Values

boolean

Details

false に設定すると、管理対象の macOS デバイスでユーザーがロック中の使用を有効にできなくなります。この要件は有効化用のコントロールを非表示にしますが、すでに有効なロック中の使用を無効にするものではありません。省略すると、通常の製品の提供条件が適用されます。

Key

computer_use.allow_persistent_approval

Type / Values

boolean

Details

false に設定すると、アプリの承認をセッション間で保存するオプションがなくなります。現在のセッションに対する承認は引き続き利用できます。true に設定したり省略したりしても、アプリが承認されるわけではありません。

Key

computer_use.default_app_access

Type / Values

allow | deny

Details

プラットフォーム固有のルールに一致しないネイティブアプリに適用する、フォールバックのアクセス設定です。deny はアクセスをブロックします。allow は、通常の承認とポリシーのチェックを続行できるようにするだけです。製品のデフォルトは allow です。

Key

computer_use.macos

Type / Values

table

Details

macOS 向けのコンピューターの使用に関するアプリルールです。

Key

computer_use.macos.bundle_ids

Type / Values

map<string, allow | deny>

Details

macOS のバンドル識別子を完全一致で allow または deny に対応付けます。一致するルールは、同じポリシーソース内の computer_use.default_app_access に優先します。管理要件またはユーザー設定のいずれかで拒否されている場合は、引き続きアクセスがブロックされます。

Key

computer_use.macos.bundle_ids.<bundle-id>

Type / Values

allow | deny

Details

deny を指定すると、バンドル識別子が完全一致するアプリをブロックします。allow が上書きするのはこのポリシーソースのデフォルトだけであり、アプリを利用するには、他のすべてのポリシーソースと通常の承認フローでも許可される必要があります。

Key

computer_use.windows

Type / Values

table

Details

パッケージ化された Windows アプリとパッケージ化されていない Windows アプリに適用する、コンピューターの使用のアプリルールです。

Key

computer_use.windows.aumids

Type / Values

map<string, allow | deny>

Details

署名済みのパッケージアプリに登録されている Application User Model ID（AUMID）を完全一致で allow または deny に対応付けます。一致するルールは、同じポリシーソース内の computer_use.default_app_access に優先します。

Key

computer_use.windows.aumids.<aumid>

Type / Values

allow | deny

Details

deny を指定すると、識別情報が完全一致するパッケージアプリをブロックします。allow が上書きするのはこのポリシーソースのデフォルトだけであり、アプリを利用するには、他のすべてのポリシーソースと通常の承認フローでも許可される必要があります。

Key

computer_use.windows.exes

Type / Values

array<table>

Details

署名済みでパッケージ化されていない Windows 実行ファイルのルールです。ルールは、実行ファイルのパスや現在のファイル名ではなく、検証済みの発行元と署名済みのバージョン情報に照合されます。一致する拒否ルールは、一致する許可ルールに優先します。署名のない実行ファイルには computer_use.default_app_access が適用されます。署名された識別情報を一意に検証できない実行ファイルはブロックされます。

Key

computer_use.windows.exes[].access

Type / Values

allow | deny

Details

一致する実行ファイルに対するアクセスの許可または拒否を指定します。必須です。deny はアクセスをブロックします。allow が上書きするのはこのポリシーソースのデフォルトだけであり、アプリを利用するには、他のすべてのポリシーソースと通常の承認フローでも許可される必要があります。

Key

computer_use.windows.exes[].binary_name

Type / Values

string

Details

実行ファイルの署名済みバージョン情報に含まれる OriginalFilename を指定します。省略可能です。照合では大文字と小文字を区別しません。発行元と製品が一致するルールでこの値が必須とされているにもかかわらず、実行ファイルにこの値がない場合、コンピューターの使用はその実行ファイルをブロックします。

Key

computer_use.windows.exes[].product_name

Type / Values

string

Details

実行ファイルの署名済みバージョン情報に含まれる ProductName を正確に指定します。必須です。

Key

computer_use.windows.exes[].publisher_name

Type / Values

string

Details

実行ファイルの信頼できる署名証明書に記載された発行元名を、Windows X.500 識別名の形式で正確に指定します。必須です。

Key

default_permissions

Type / Values

string

Details

管理者が指定するデフォルトの権限プロファイルです。このプロファイルは allowed_permission_profiles で許可されている必要があります。動作を予測可能にするため、明示的に設定してください。省略した場合、Codex は :workspace と :read-only の両方が明示的に許可されている場合に限り、:workspace をデフォルトとして使用します。

Key

enforce_residency

Type / Values

string

Details

Codex サービスの通信に、サポートされているデータレジデンシーの使用を必須にします。現在指定できる値は us です。

Key

experimental_network

Type / Values

table

Details

サンドボックス内のローカルコマンドに適用する、管理者が管理するネットワーク要件です。requirements.toml から強制適用されます。有効にすると、features.network_proxy がなくてもコマンド用ネットワークプロキシを起動できます。ブラウザツールは、管理対象のネットワーク拒否ルールと排他的な許可リストを別途チェックします。これらの要件は、ブラウザの通信をプロキシ経由にするものではなく、ウェブ検索、アプリ、MCP サーバー、ネイティブアプリの通信、Codex Cloud のネットワーク通信を制御するものでもありません。

Key

experimental_network.allow_local_binding

Type / Values

boolean

Details

サンドボックス内のネットワーク通信で、ローカルネットワークやプライベートネットワークへのアクセスをより広く許可します。false のままでも、正確なローカル IP リテラルまたは localhost の許可ルールにより、特定のローカル接続先を許可できます。

Key

experimental_network.allow_upstream_proxy

Type / Values

boolean

Details

サンドボックス内のネットワーク通信で、環境から取得した上流プロキシへの多段接続を許可します。

Key

experimental_network.allowed_domains

Type / Values

array<string>

Details

管理対象のネットワークプロキシが有効な間、サンドボックス内のコマンドのネットワーク通信に適用される管理者の許可ルールです。これらのルールは、ウェブ検索、アプリ、MCP サーバーには適用されません。experimental_network.domains と併用しないでください。

Key

experimental_network.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

アクセス先を許可リストに限定せず、任意の Unix ソケットへのアクセスを許可します。厳密に管理された環境でのみ使用してください。

Key

experimental_network.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

[experimental_network] の要件で、ループバック以外のリスナーアドレスを許可します。有効にすると、localhost の外部からリスナーにアクセスできるようになる可能性があります。

Key

experimental_network.denied_domains

Type / Values

array<string>

Details

サンドボックス内のネットワーク通信に適用する、リスト形式の管理者の拒否ルールです。experimental_network.domains と併用しないでください。

Key

experimental_network.domains

Type / Values

map<string, allow | deny>

Details

サンドボックス内のネットワーク通信に適用する、マップ形式の管理者ドメインポリシーです。完全一致のホスト、サブドメインのみを対象とする *.example.com、ドメイン本体とサブドメインを対象とする **.example.com、すべてを対象とする * の許可ルールをサポートします。* はパブリックネットワークへの外向きアクセスを広く許可するため、範囲を限定したルールを推奨します。競合時は deny が優先されます。experimental_network.allowed_domains または experimental_network.denied_domains と併用しないでください。

Key

experimental_network.enabled

Type / Values

boolean

Details

サンドボックス内のネットワーク要件を有効にします。使用中のサンドボックスでコマンドのネットワーク通信が無効になっている場合、これによってネットワークアクセスが許可されることはありません。

Key

experimental_network.http_port

Type / Values

integer

Details

[experimental_network] の要件に使用する、ループバック HTTP リスナーのポートです。

Key

experimental_network.managed_allowed_domains_only

Type / Values

boolean

Details

true の場合、サンドボックス内のネットワーク要件が有効な間は、管理者が管理する許可ルールのみが有効になり、ユーザーが許可リストに追加した項目は無視されます。管理対象の許可ルールがない場合も、ユーザーが追加したドメイン許可ルールは有効になりません。

Key

experimental_network.socks_port

Type / Values

integer

Details

[experimental_network] の要件に使用する、ループバック SOCKS5 リスナーのポートです。

Key

experimental_network.unix_sockets

Type / Values

map<string, allow | deny>

Details

サンドボックス内のネットワーク通信に適用する、管理者が管理する Unix ソケットポリシーです。

Key

features

Type / Values

table

Details

固定する機能の値です。ランタイム機能には config.toml の正式な名前を使用してください。ドキュメントに記載されているアプリ専用の要件キーも、ここで使用できます。

Key

features.<name>

Type / Values

boolean

Details

ドキュメントに記載されているランタイム機能またはアプリ機能を、有効または無効の状態に固定します。

Key

features.apps

Type / Values

boolean

Details

管理対象ユーザーのアプリ連携を、有効または無効に固定します。

Key

features.browser_use

Type / Values

boolean

Details

requirements.toml で false に設定すると、エージェントによるブラウザ操作が無効になります。

Key

features.browser_use_external

Type / Values

boolean

Details

requirements.toml で false に設定すると、Codex が ChatGPT ブラウザ拡張機能を通じて対応ブラウザを操作できなくなります。既存のタブやサインイン済みセッションの操作も含まれます。

Key

features.browser_use_full_cdp_access

Type / Values

boolean

Details

requirements.toml で false に設定すると、ブラウザ開発者モードを含め、ローカルランタイムでの Chrome DevTools Protocol へのフルアクセスが無効になり、ChatGPT デスクトップアプリで対応する設定を有効にできなくなります。省略した場合、通常の製品の提供条件が適用されます。

Key

features.computer_use

Type / Values

boolean

Details

requirements.toml で false に設定すると、コンピューターの使用、記録と再生、および関連するインストールや有効化のフローが無効になります。

Key

features.fast_mode

Type / Values

boolean

Details

管理対象ユーザーについて、正式な機能キー fast_mode を有効または無効に固定します。

Key

features.guardian_approval

Type / Values

boolean

Details

管理対象ユーザーの Guardian 承認を、有効または無効に固定します。

Key

features.in_app_browser

Type / Values

boolean

Details

requirements.toml で false に設定すると、ユーザーが開いて直接操作する組み込みブラウザペインが無効になります。

Key

features.in_app_updates

Type / Values

boolean

Details

requirements.toml で false に設定すると、アプリ内更新が無効になります。この要件を省略した場合、更新はデフォルトで有効のままです。

Key

features.memories

Type / Values

boolean

Details

管理対象ユーザーのメモリを、有効または無効に固定します。

Key

features.multi_agent

Type / Values

boolean

Details

管理対象ユーザーのマルチエージェント機能を、有効または無効に固定します。

Key

features.plugin_sharing

Type / Values

boolean

Details

クラウドで管理される requirements.toml で false に設定すると、ローカルで作成したプラグインのワークスペース共有が無効になります。

Key

features.plugins

Type / Values

boolean

Details

管理対象ユーザーのプラグインを、有効または無効に固定します。

Key

features.remote_plugin

Type / Values

boolean

Details

管理対象ユーザーのリモートプラグインカタログを、有効または無効に固定します。

Key

features.workspace_dependencies

Type / Values

boolean

Details

管理対象ユーザーについて、同梱のワークスペース依存関係用ランタイムを、有効または無効に固定します。

Key

feedback

Type / Values

table

Details

管理対象のフィードバック設定です。

Key

feedback.enabled

Type / Values

boolean

Details

各 Codex クライアントでユーザーがフィードバックを送信できるかどうかを強制的に設定します。

Key

guardian_policy_config

Type / Values

string

Details

自動レビュー用に管理者が指定する Markdown 形式のポリシー指示です。ローカルの [auto_review].policy より優先されます。空白の値は無視されます。

Key

hooks

Type / Values

table

Details

管理者が強制適用する、管理対象のライフサイクルフックです。管理対象のフック用ディレクトリが必要です。config.toml にインラインで記述する [hooks] と同じイベントスキーマを使用します。

Key

hooks.<Event>

Type / Values

array<table>

Details

PreToolUse、PermissionRequest、PostToolUse、PreCompact、PostCompact、SessionStart、SessionEnd、SubagentStart、SubagentStop、UserPromptSubmit、Stop などのフックイベントに対するマッチャーグループです。

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

マッチャーグループのフックハンドラーです。コマンドフックと MCP ツールフックがサポートされています。プロンプトフックとエージェントフックのハンドラーは解析されますが、実行はスキップされます。

Key

hooks.<Event>[].hooks[].additionalContextLimit

Type / Values

integer

Details

サイズの大きい additionalContext をディスクに保存し、短いプレビューをモデルに表示するための、ハンドラーごとのおおよそのトークンしきい値です。デフォルトは 2500 です。0 を指定すると、コンテキスト全体を直接モデルに渡します。大きなフック出力を参照してください。

Key

hooks.<Event>[].hooks[].async

Type / Values

boolean

Details

トリガーとなった操作を遅らせずに、コマンドフックをバックグラウンドで実行します。デフォルトは false です。SessionEnd は常に同期実行されます。フックのバックグラウンド実行を参照してください。

Key

hooks.<Event>[].hooks[].commandWindows

Type / Values

string

Details

コマンドフックに対する Windows 専用のコマンド上書き設定です。TOML の別名 command_windows も使用できます。

Key

hooks.managed_dir

Type / Values

string (absolute path)

Details

macOS と Linux で管理対象のフックスクリプトを格納するディレクトリです。Codex は、管理対象のフックを読み込む前に、パスが絶対パスであり、ディレクトリが存在することを検証します。

Key

hooks.windows_managed_dir

Type / Values

string (absolute path)

Details

Windows で管理対象のフックスクリプトを格納するディレクトリです。Codex は、管理対象のフックを読み込む前に、パスが絶対パスであり、ディレクトリが存在することを検証します。

Key

in_app_browser

Type / Values

table

Details

組み込みブラウザペインの要件です。これらの設定は、エージェントによるブラウザ操作を制御しません。

Key

in_app_browser.allow_external_browser_settings_import

Type / Values

boolean

Details

false に設定すると、ユーザーは外部ブラウザの設定や閲覧データを組み込みブラウザにインポートできなくなります。true に設定するか省略した場合、製品の他のチェックで許可されていればインポートを利用できます。これは管理専用の設定で、config.toml では上書きできません。

Key

log_dir

Type / Values

string (path)

Details

Codex がローカルログファイルを書き込むディレクトリを固定します。

Key

marketplaces

Type / Values

table

Details

プラグインマーケットプレイスのソースに関する管理者要件です。restrict_to_allowed_sources が true の場合にルールが適用されます。

Key

marketplaces.allowed_sources

Type / Values

table

Details

管理者が選んだルール名をキーとする、許可されたマーケットプレイスソースです。異なる名前のルールは要件レイヤー間で累積されます。同じ名前の配下にあるフィールドには、通常のレイヤーの優先順位が適用されます。

Key

marketplaces.allowed_sources.<name>

Type / Values

table

Details

ソースを許可する 1 つのルールです。要件のマージ後の最終的な source 値によって、Codex が解釈する同階層のフィールドが決まります。

Key

marketplaces.allowed_sources.<name>.host_pattern

Type / Values

string

Details

source = "host_pattern" の場合に必須の正規表現です。Codex は、HTTPS、SSH、または SCP 形式の Git ソースから解析した小文字のホスト名と照合します。ホスト名全体の一致を要求するには、^ と $ を使用します。

Key

marketplaces.allowed_sources.<name>.path

Type / Values

string (absolute path)

Details

source = "local" の場合に必須のローカルマーケットプレイスのディレクトリです。Codex は絶対パスを要求し、正規化後にパスを比較します。

Key

marketplaces.allowed_sources.<name>.ref

Type / Values

string

Details

git ルールで完全一致を求める Git ref です。省略可能です。省略すると、一致するリポジトリのすべての ref が許可されます。

Key

marketplaces.allowed_sources.<name>.source

Type / Values

git | host_pattern | local

Details

マーケットプレイスソースのマッチャーの種類です。単一のリポジトリには git、正規表現で照合する Git ホストには host_pattern、単一のディレクトリには local を使用します。

Key

marketplaces.allowed_sources.<name>.url

Type / Values

string

Details

source = "git" の場合に必須の Git リポジトリ URL です。Codex は、設定された URL と許可された URL を正規化したうえで、リポジトリの完全一致を要求します。

Key

marketplaces.restrict_to_allowed_sources

Type / Values

boolean

Details

true の場合、マーケットプレイスの追加、プラグインのインストール、設定済み Git マーケットプレイスの更新時に、ユーザーが設定したマーケットプレイスのソースが allowed_sources に一致することを要求します。Codex が管理する OpenAI マーケットプレイスは、予約済みのソースと名前が一致していれば引き続き許可されます。この設定は、ユーザーがすでに設定したマーケットプレイスを実行時にフィルタリングするものではありません。

Key

mcp_servers

Type / Values

table

Details

有効化できる MCP サーバーの許可リストです。MCP サーバーを有効にするには、サーバー名（<id>）とその識別情報の両方が一致する必要があります。構成済みの MCP サーバーでも、許可リストにない場合や識別情報が一致しない場合は無効になります。

Key

mcp_servers.<id>.identity

Type / Values

table

Details

単一の MCP サーバーを識別するためのルールです。command（stdio）または url（ストリーミング可能な HTTP）のどちらかを設定します。

Key

mcp_servers.<id>.identity.command

Type / Values

string | table

Details

コマンド文字列の完全一致で MCP stdio サーバーを許可するか、マッチャーテーブルを使って実行ファイルの完全一致と順序付き引数マッチャーによる照合を必須にします。文字列形式では、引数、cwd、env、env_vars は検査されません。

Key

mcp_servers.<id>.identity.command.args

Type / Values

array<table>

Details

stdio サーバーの順序付き引数マッチャーです。設定された引数リストはマッチャーのリストと同じ長さで、すべての位置で一致する必要があります。コマンドマッチャーは cwd、env、env_vars を検査しません。

Key

mcp_servers.<id>.identity.command.args[].expression

Type / Values

string

Details

regex 引数マッチャーで使用する正規表現です。有効な正規表現であり、引数の値全体に一致する必要があります。

Key

mcp_servers.<id>.identity.command.args[].match

Type / Values

exact | prefix | regex

Details

この位置の引数に使用する照合方法です。

Key

mcp_servers.<id>.identity.command.args[].value

Type / Values

string

Details

exact または prefix 引数マッチャーで使用する値です。

Key

mcp_servers.<id>.identity.command.executable

Type / Values

string

Details

stdio サーバーに設定された command が完全一致する必要のある実行ファイルです。

Key

mcp_servers.<id>.identity.url

Type / Values

string | table

Details

URL 文字列の完全一致で MCP のストリーミング可能な HTTP サーバーを許可するか、exact、prefix、regex の値マッチャーテーブルを使用します。

Key

mcp_servers.<id>.identity.url.expression

Type / Values

string

Details

regex URL マッチャーで使用する正規表現です。有効な正規表現であり、URL の値全体に一致する必要があります。

Key

mcp_servers.<id>.identity.url.match

Type / Values

exact | prefix | regex

Details

設定された MCP サーバーの URL に使用する照合方法です。

Key

mcp_servers.<id>.identity.url.value

Type / Values

string

Details

exact または prefix URL マッチャーで使用する値です。

Key

model_catalog_json

Type / Values

string (path)

Details

Codex が起動時に使用する JSON モデルカタログを固定します。

Key

models

Type / Values

table

Details

新しいスレッド用に管理者が指定するモデルのデフォルト値です。ユーザーやプロジェクトのデフォルト値より優先されますが、新しいスレッドで明示的に選択することで上書きできます。

Key

models.new_thread

Type / Values

table

Details

新しいローカルスレッドの開始時に適用するデフォルト値です。各モデル設定は省略可能です。

Key

models.new_thread.model

Type / Values

string

Details

新しいスレッドのデフォルトモデルです。--model、またはモデルや推論を指定する --config による明示的な上書きが優先されます。

Key

models.new_thread.model_reasoning_effort

Type / Values

string

Details

新しいスレッドのデフォルトの推論強度です。モデルまたは推論強度を明示的に上書きすると、管理者が指定するモデル関連の両フィールドは適用されません。

Key

models.new_thread.service_tier

Type / Values

string

Details

新しいスレッドのデフォルトのサービスティアです。サービスティアの明示的な上書きは、モデル関連のフィールドとは独立して優先されます。

Key

permissions

Type / Values

table

Details

プロファイル名をキーとする、管理者定義の権限プロファイルです。config.toml と同じプロファイルフィールドを使用します。

Key

permissions.<name>

Type / Values

table

Details

管理者定義の権限プロファイルです。名前を : で始めたり、予約名 filesystem を使用したり、読み込まれた構成内のプロファイル名と重複させたりすることはできません。config.toml と同じプロファイルフィールドを使用します。プロファイルの完全なスキーマについては、権限ガイドを参照してください。

Key

permissions.filesystem.deny_read

Type / Values

array<string>

Details

管理者が強制適用するファイルシステムの読み取り拒否設定です。各項目にはパスまたは glob パターンを指定でき、ユーザーがローカル設定で制限を緩めることはできません。

Key

plugins

Type / Values

table

Details

プラグイン識別子をキーとする、プラグインごとの MCP サーバー許可リストです。このテーブルが存在する場合、プラグインに同梱されたサーバーのうち、一致するプラグインとサーバーの項目がないものは無効になります。

Key

plugins.<plugin>.mcp_servers

Type / Values

table

Details

単一のプラグインに同梱された MCP サーバーの許可リストです。プラグインのサーバー要件には、最上位の mcp_servers 要件と同じ、識別情報の完全一致形式とマッチャー形式を使用します。

Key

plugins.<plugin>.mcp_servers.<server>.identity

Type / Values

table

Details

プラグインに同梱された単一の MCP サーバーを識別するためのルールです。command（stdio）または url（ストリーミング可能な HTTP）のどちらかを設定します。

Key

plugins.<plugin>.mcp_servers.<server>.identity.command

Type / Values

string | table

Details

コマンド文字列の完全一致でプラグインの stdio MCP サーバーを許可するか、マッチャーテーブルを使って実行ファイルの完全一致と順序付き引数マッチャーによる照合を必須にします。

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args

Type / Values

array<table>

Details

プラグインに同梱された stdio サーバーの順序付き引数マッチャーです。設定された引数リストはマッチャーのリストと同じ長さで、すべての位置で一致する必要があります。

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression

Type / Values

string

Details

regex 引数マッチャーで使用する正規表現です。引数の値全体に一致する必要があります。

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match

Type / Values

exact | prefix | regex

Details

この位置の引数に使用する照合方法です。

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value

Type / Values

string

Details

exact または prefix 引数マッチャーで使用する値です。

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.executable

Type / Values

string

Details

プラグインに同梱された stdio サーバーに設定されたコマンドが完全一致する必要のある実行ファイルです。

Key

plugins.<plugin>.mcp_servers.<server>.identity.url

Type / Values

string | table

Details

URL 文字列の完全一致でプラグインのストリーミング可能な HTTP MCP サーバーを許可するか、exact、prefix、regex の値マッチャーテーブルを使用します。

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.expression

Type / Values

string

Details

regex URL マッチャーで使用する正規表現です。URL 値全体に一致する必要があります。

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.match

Type / Values

exact | prefix | regex

Details

プラグインに同梱された MCP サーバーの URL に使用する照合方法です。

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.value

Type / Values

string

Details

exact または prefix URL マッチャーで使用する値です。

Key

remote_sandbox_config

Type / Values

array<table>

Details

ホスト固有のサンドボックス要件です。hostname_patterns が解決されたホスト名に一致する最初のエントリが、その要件ソースのトップレベルの allowed_sandbox_modes を上書きします。現在、ホスト固有のエントリで上書きできるのはサンドボックスモードのみです。

Key

remote_sandbox_config[].allowed_sandbox_modes

Type / Values

array<string>

Details

このホスト固有のエントリが一致した場合に適用する、許可されるサンドボックスモード。

Key

remote_sandbox_config[].hostname_patterns

Type / Values

array<string>

Details

大文字と小文字を区別しないホスト名パターンです。任意の文字列を表す * と、1 文字を表す ? をサポートします。

Key

rules

Type / Values

table

Details

.rules ファイルとマージされる、管理者が強制適用するコマンドルールです。要件として指定するルールは、制限を課すものである必要があります。

Key

rules.prefix_rules

Type / Values

array<table>

Details

強制適用されるプレフィックスルールの一覧です。各ルールには pattern と decision を含める必要があります。

Key

rules.prefix_rules[].decision

Type / Values

prompt | forbidden

Details

必須です。要件として指定するルールでは、承認を求めるか禁止することのみが可能で、許可することはできません。

Key

rules.prefix_rules[].justification

Type / Values

string

Details

承認プロンプトや拒否メッセージに表示する理由です。省略可能ですが、指定する場合は空でない値が必要です。

Key

rules.prefix_rules[].pattern

Type / Values

array<table>

Details

パターントークンで表したコマンドプレフィックスです。各トークンには token または any_of のいずれかを設定します。

Key

rules.prefix_rules[].pattern[].any_of

Type / Values

array<string>

Details

この位置で許可される代替トークンの一覧です。

Key

rules.prefix_rules[].pattern[].token

Type / Values

string

Details

この位置に指定する単一のリテラルトークンです。

Key

sqlite_home

Type / Values

string (path)

Details

Codex が SQLite ベースのランタイム状態を保存するディレクトリを固定します。

Key

windows

Type / Values

table

Details

ネイティブ Windows サンドボックスの要件。

Key

windows.allowed_sandbox_implementations

Type / Values

array<string>

Details

windows.sandbox で許可するネイティブ Windows サンドボックスの実装（elevated と unelevated）です。空のリストは指定できません。両方が許可され、モードが選択されていない場合、Codex は elevated を優先します。

Key

windows.sandbox_private_desktop

Type / Values

boolean

Details

ネイティブ Windows サンドボックスがプライベートデスクトップで子プロセスを起動するかどうかを強制的に設定します。

おすすめ

はじめに

Core concepts

SDKs and CLI

リソース

Legacy APIs

Choose a model

Text and code

プロンプト

Reasoning

Images and video

Realtime and audio

Specialized models

Agents SDK

ChatKit

Search and retrieval

Connect tools and data

Build tool workflows

Computer and code

Media

はじめに

Audio

Connection methods

Sessions and operations

Go live

Performance and quality

Cost and throughput

Safety and governance

Infrastructure and access

オペレーション

Core concepts

Plan

Build

Test and publish

Conversion specs

ガイド

リソース

はじめに

ガイド

File Upload

API

Measurement

Advertiser API

API リファレンス

はじめに

基礎

詳しく見る

利用可能な環境

リリース

ワークフロー

できること

リファレンス

カスタマイズ

設定ファイル

エージェントの構成

ChatGPT と Codex の機能拡張

Linux

Windows

開発ワークフロー

拡張と自動化

環境

Codex を使った開発

サードパーティ連携

リファレンス

権限

Codex Security

サイバーセーフティ

はじめに

ChatGPT Work

ID と認証

ワークスペースのアクセス、ポリシー、モデル

プラグインとコネクタの制御

利用状況、ガバナンス、コンプライアンス

展開とモデルプロバイダー

コミュニティ

ブログ

コミュニティ

ブログ

最近の検索

Topics

`config.toml`

`requirements.toml`