構成リファレンス

このページは、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.*）については、このリファレンスとあわせてサンドボックスと承認、書き込み可能なルート内の保護されたパス、ネットワークアクセスを参照してください。ベータ版の権限プロファイルについては、権限を参照してください。

Codex と ChatGPT Work では、approval_policy = "untrusted" はサポートされなくなりました。この設定を削除するか、サポートされているポリシーを選択してください。ユーザーレベルの ~/.codex/config.toml にある、 trust_level = "untrusted" を指定したプロジェクトエントリは引き続きサポートされます。例や承認に関するトレードオフについては、廃止された untrusted 承認ポリシーからの移行を参照してください。

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`	`on-request \| never \| { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }`	コマンドを実行する前に、Codex がどのタイミングで一時停止して承認を求めるかを指定します。`approval_policy = { granular = { ... } }` を使用すると、特定のカテゴリの承認プロンプトを許可または自動拒否しつつ、他のプロンプトでは対話による確認を維持できます。`untrusted` はサポートされておらず、`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`	パーソナリティの選択コントロールを有効にします（安定版。デフォルトで有効）。
`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` も同じディレクトリで有効になります。
`marketplaces.<name>.ref`	`string`	マーケットプレイスの Git ブランチ、タグ、またはコミットを指定する任意の設定です。
`marketplaces.<name>.source`	`string`	Git リポジトリの場所、またはローカルマーケットプレイスのルートディレクトリです。ローカルソースには絶対パスを使用してください。このディレクトリには .agents/plugins/marketplace.json が含まれます。
`marketplaces.<name>.source_type`	`git \| local`	設定されたプラグインマーケットプレイスのソースの種類です。マーケットプレイスは、システム、クラウド管理、ユーザー、または信頼済みプロジェクトの config.toml で定義できます。
`marketplaces.<name>.sparse_paths`	`array<string>`	Git マーケットプレイスのスパースチェックアウト用パスを指定する任意の設定です。マーケットプレイスのカタログと、そのカタログが参照するすべてのローカルプラグインディレクトリを含めてください。
`mcp_oauth_callback_port`	`integer`	MCP OAuth ログイン時に使用するローカル HTTP コールバックサーバーの固定ポートを、全体設定として任意で指定します。サーバー固有の `oauth.callback_port` が優先されます。どちらも設定されていない場合、Codex は OS が選択した一時ポートにバインドします。
`mcp_oauth_callback_url`	`string`	MCP OAuth ログイン用のベースコールバック URL を任意で指定します。たとえば、devbox の ingress 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 サーバーの認証フォールバックです。`oauth`（デフォルト）は、保存済みの MCP OAuth 認証情報があれば使用します。`chatgpt` は、信頼されたファーストパーティの ChatGPT オリジンに対して現在の ChatGPT セッションを使用し、その後、保存済みの OAuth 認証情報にフォールバックします。どちらのモードも、どの取得元からも認証情報を取得できなければ、認証なしで接続できます。
`mcp_servers.<id>.bearer_token_env_var`	`string`	MCP HTTP サーバーのベアラートークンの取得元となる環境変数です。
`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 サーバーでのみサポートされます。明示的なベアラートークンと 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.6-sol`）。
`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 トークンを必要とする際に実行するコマンドです。このコマンドはトークンを標準出力に出力する必要があります。
`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>`	確認済みのモデル移行を旧モデルから新モデルへの対応関係として記録します。
`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`	Unix ソケットの絶対パスを `allow` で有効な許可リストに追加するか、`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>.enabled`	`boolean`	`plugin-name@marketplace-name` キーを使用して、ローカルマーケットプレイスのプラグインを有効または無効にします。マージ後の実効設定から読み取られます。信頼済みプロジェクトの設定は、ユーザー、クラウド管理、システムのデフォルト値を上書きできます。マーケットプレイスを更新すると、設定されたプラグインが無効であっても、インストールまたは更新される場合があります。この設定は、ワークスペースで管理されている有効・無効の状態を上書きしません。
`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)`	エージェントのジョブや、再開可能なその他のランタイム状態に使用する SQLite ベースの状態 DB を Codex が保存するディレクトリです。
`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

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

Details

コマンドを実行する前に、Codex がどのタイミングで一時停止して承認を求めるかを指定します。approval_policy = { granular = { ... } } を使用すると、特定のカテゴリの承認プロンプトを許可または自動拒否しつつ、他のプロンプトでは対話による確認を維持できます。untrusted はサポートされておらず、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

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

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

marketplaces.<name>.ref

Type / Values

string

Details

マーケットプレイスの Git ブランチ、タグ、またはコミットを指定する任意の設定です。

Key

marketplaces.<name>.source

Type / Values

string

Details

Git リポジトリの場所、またはローカルマーケットプレイスのルートディレクトリです。ローカルソースには絶対パスを使用してください。このディレクトリには .agents/plugins/marketplace.json が含まれます。

Key

marketplaces.<name>.source_type

Type / Values

git | local

Details

設定されたプラグインマーケットプレイスのソースの種類です。マーケットプレイスは、システム、クラウド管理、ユーザー、または信頼済みプロジェクトの config.toml で定義できます。

Key

marketplaces.<name>.sparse_paths

Type / Values

array<string>

Details

Git マーケットプレイスのスパースチェックアウト用パスを指定する任意の設定です。マーケットプレイスのカタログと、そのカタログが参照するすべてのローカルプラグインディレクトリを含めてください。

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 の ingress 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 サーバーの認証フォールバックです。oauth（デフォルト）は、保存済みの MCP OAuth 認証情報があれば使用します。chatgpt は、信頼されたファーストパーティの ChatGPT オリジンに対して現在の ChatGPT セッションを使用し、その後、保存済みの OAuth 認証情報にフォールバックします。どちらのモードも、どの取得元からも認証情報を取得できなければ、認証なしで接続できます。

Key

mcp_servers.<id>.bearer_token_env_var

Type / Values

string

Details

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

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 サーバーでのみサポートされます。明示的なベアラートークンと 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.6-sol）。

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 トークンを必要とする際に実行するコマンドです。このコマンドはトークンを標準出力に出力する必要があります。

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

確認済みのモデル移行を旧モデルから新モデルへの対応関係として記録します。

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

Unix ソケットの絶対パスを allow で有効な許可リストに追加するか、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>.enabled

Type / Values

boolean

Details

plugin-name@marketplace-name キーを使用して、ローカルマーケットプレイスのプラグインを有効または無効にします。マージ後の実効設定から読み取られます。信頼済みプロジェクトの設定は、ユーザー、クラウド管理、システムのデフォルト値を上書きできます。マーケットプレイスを更新すると、設定されたプラグインが無効であっても、インストールまたは更新される場合があります。この設定は、ワークスペースで管理されている有効・無効の状態を上書きしません。

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

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

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 および 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 と組み合わせて使用します。

allowed_approval_policies 内の untrusted エントリは、プロジェクトが trust_level = "untrusted" を使用する場合に Codex が導き出すより厳格な承認動作に対して、引き続き有効です。ただし、approval_policy = "untrusted" を明示的に設定することは許可されません。

[models.new_thread] テーブルは、管理対象のデフォルト値を提供しますが、値を強制するものではありません。 --model、--config、または --profile を使用してモデルまたは推論強度を明示的に上書きした場合、Codex は [models.new_thread] 内の model と model_reasoning_effort の両方を無視します。service_tier は独立しています。

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

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

Key	Type / Values	Details
`allow_appshots`	`boolean`	管理対象ユーザーの Appshots を無効にするには、`false` に設定します。省略した場合、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>`	`on-request`、`never`、`granular` など、許可する承認ポリシーです。信頼されていないプロジェクトから導出される、より厳しいポリシーを許可するには、`untrusted` を含めます。このポリシーは `approval_policy` で直接選択できません。
`allowed_approvals_reviewers`	`array<string>`	`user` や `auto_review` など、`approvals_reviewer` に許可する値です。
`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`	単一のアプリツールに対する管理対象の承認モードを設定します。
`browser_use`	`table`	エージェントによるブラウザ機能の管理対象要件です。
`browser_use.allow_global_persistent_approval`	`boolean`	任意のサイトからのダウンロードを許可するなど、すべてのサイトを対象とする `Always allow` 承認をブラウザ機能が作成または適用できないようにするには、`false` に設定します。既存の保存済み承認は無視されますが、削除はされません。`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`	フォールバック値を使用するオリジンで Chrome DevTools Protocol（CDP）のフルアクセスをブロックするには、`deny` を使用します。`allow` は、通常のオプトインと承認のチェックを続行できるようにするだけです。
`browser_use.default_origin_policy.persistent_approval`	`boolean`	フォールバック値を使用するオリジンで、ブラウザ機能が `Always allow` 承認を保存または適用できないようにするには、`false` に設定します。現在のターンまたはスレッドに対する承認は引き続き適用できます。`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`	Codex が ChatGPT ブラウザ拡張機能を通じて、既存のタブやログイン済みセッションを含む対応ブラウザを操作できないようにするには、`requirements.toml` で `false` に設定します。
`features.browser_use_full_cdp_access`	`boolean`	ブラウザ開発者モードを含む、ローカルランタイムでの Chrome DevTools Protocol のフルアクセスを無効にし、ChatGPT デスクトップアプリで対応する設定を有効にできないようにするには、`requirements.toml` で `false` に設定します。省略した場合、通常の製品の提供条件が適用されます。
`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` の場合、マーケットプレイスの追加、プラグインのインストール、更新、ランタイムでの読み込み時に、設定されたマーケットプレイスのソースが `allowed_sources` に一致することを必須とします。API キー用カタログを含む、OpenAI が選定した Git カタログも許可リストに一致する必要があります。同梱のワークスペースプラグインとリモートでインストールされたワークスペースプラグインは、この選定済み Git ソースに対するポリシーとは別扱いです。
`mcp_servers`	`table`	有効化できる MCP サーバーの許可リストです。MCP サーバーを有効にするには、サーバー名（`<id>`）とその識別情報の両方が一致する必要があります。設定済みの MCP サーバーでも、許可リストに含まれない場合や識別情報が一致しない場合は無効になります。
`mcp_servers.<id>.identity`	`table`	単一の MCP サーバーの識別ルールです。`command`（stdio）または `url`（streamable 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 streamable 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]` テーブルを含みます。
`models.new_thread`	`table`	新しいローカルスレッドの開始時に適用する、省略可能なデフォルト設定です。ユーザーやプロジェクトのデフォルト設定より優先されますが、明示的な指定で上書きできます。
`models.new_thread.model`	`string`	新しいスレッドのデフォルトモデルです。モデルまたは推論強度のいずれかを明示的に上書きすると、両方のフィールドが無視されます。
`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`（streamable 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 文字列の完全一致でプラグインの Streamable 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

管理対象ユーザーの Appshots を無効にするには、false に設定します。省略した場合、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

on-request、never、granular など、許可する承認ポリシーです。信頼されていないプロジェクトから導出される、より厳しいポリシーを許可するには、untrusted を含めます。このポリシーは approval_policy で直接選択できません。

Key

allowed_approvals_reviewers

Type / Values

array<string>

Details

user や auto_review など、approvals_reviewer に許可する値です。

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

単一のアプリツールに対する管理対象の承認モードを設定します。

Key

browser_use

Type / Values

table

Details

エージェントによるブラウザ機能の管理対象要件です。

Key

browser_use.allow_global_persistent_approval

Type / Values

boolean

Details

任意のサイトからのダウンロードを許可するなど、すべてのサイトを対象とする Always allow 承認をブラウザ機能が作成または適用できないようにするには、false に設定します。既存の保存済み承認は無視されますが、削除はされません。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

フォールバック値を使用するオリジンで Chrome DevTools Protocol（CDP）のフルアクセスをブロックするには、deny を使用します。allow は、通常のオプトインと承認のチェックを続行できるようにするだけです。

Key

browser_use.default_origin_policy.persistent_approval

Type / Values

boolean

Details

フォールバック値を使用するオリジンで、ブラウザ機能が Always allow 承認を保存または適用できないようにするには、false に設定します。現在のターンまたはスレッドに対する承認は引き続き適用できます。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

Codex が ChatGPT ブラウザ拡張機能を通じて、既存のタブやログイン済みセッションを含む対応ブラウザを操作できないようにするには、requirements.toml で false に設定します。

Key

features.browser_use_full_cdp_access

Type / Values

boolean

Details

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

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 の場合、マーケットプレイスの追加、プラグインのインストール、更新、ランタイムでの読み込み時に、設定されたマーケットプレイスのソースが allowed_sources に一致することを必須とします。API キー用カタログを含む、OpenAI が選定した Git カタログも許可リストに一致する必要があります。同梱のワークスペースプラグインとリモートでインストールされたワークスペースプラグインは、この選定済み Git ソースに対するポリシーとは別扱いです。

Key

mcp_servers

Type / Values

table

Details

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

Key

mcp_servers.<id>.identity

Type / Values

table

Details

単一の MCP サーバーの識別ルールです。command（stdio）または url（streamable 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 streamable 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

[models.new_thread] テーブルを含みます。

Key

models.new_thread

Type / Values

table

Details

新しいローカルスレッドの開始時に適用する、省略可能なデフォルト設定です。ユーザーやプロジェクトのデフォルト設定より優先されますが、明示的な指定で上書きできます。

Key

models.new_thread.model

Type / Values

string

Details

新しいスレッドのデフォルトモデルです。モデルまたは推論強度のいずれかを明示的に上書きすると、両方のフィールドが無視されます。

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（streamable 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 文字列の完全一致でプラグインの Streamable 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 ネイティブサンドボックスがプライベートデスクトップで子プロセスを起動するかどうかの設定を強制適用します。

おすすめ

はじめに

基本コンセプト

SDK と CLI

リソース

レガシー API

モデルの選び方

テキストとコード

プロンプト

推論

画像と動画

リアルタイムと音声

特化型モデル

Agents API

Agents SDK

ChatKit

検索と取得

ツールとデータの接続

ツールを使ったワークフローの構築

コンピューターとコード

メディア

GPT-Live

Realtime API

音声を活用した開発

接続

音声処理

本番運用の開始

性能と品質

コストとスループット

安全性とガバナンス

インフラとアクセス

オペレーション

基本コンセプト

Plan

Build

Test and publish

Conversion specs

ガイド

リソース

はじめに

ガイド

File Upload

API

Measurement

Advertiser API

API リファレンス

はじめに

基礎

詳しく見る

利用可能な環境

リリース

ワークフロー

できること

リファレンス

カスタマイズ

設定ファイル

エージェントの構成

ChatGPT と Codex の機能拡張

Linux

Windows

開発ワークフロー

拡張と自動化

環境

Codex を使った開発

サードパーティ連携

リファレンス

権限

Codex Security

サイバーセーフティ

はじめに

ChatGPT Work

ID と認証

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

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

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

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

コミュニティ

ブログ

コミュニティ

ブログ

`config.toml`

`requirements.toml`