ChatGPT ドキュメント
日本語
お問い合わせ goolvyouyou@gmail.com

設定リファレンス

Codex config.toml と requirements.toml の完全なリファレンス

このページは、Codex の設定ファイルを検索できるリファレンスとして使用してください。概念的な説明や例については、まず設定の基本と高度な設定を参照してください。

Work Cloud でのローカルコンピューターアクセスの設定

Work Cloud でのローカルコンピューターアクセスを有効にすると、OpenAI のクラウドがタスクを調整し、対応するツールがクラウドまたは接続されたコンピューターで実行されます。要件は制限を定め、設定値はデフォルト値を指定します。

Global 設定の管理にはポリシー API を使用します。Local または Codex Cloud の設定を管理するには、Agent Security UI を使用します。既存の Global API ワークフローは移行後も利用できます。スクリプトと Terraform 連携をテストし、ポリシーの割り当てと順序が変わっていないことを確認してください。requirements.toml のフィールドがサポートされているだけでは、API との互換性が保証されるわけではありません。

設定または設定グループ Work Cloud でのローカルコンピューターアクセスにおける適用範囲 ガイダンス
承認ポリシーとレビュー要件 管理ポリシーが有効な場合の Global オーケストレーターポリシー 承認とレビューの制御は Global に保持してください。環境ごとの上書きではオーケストレーターの制御を変更できません。ローカル実行とクラウドコンテナーでの実行には、それぞれ別のポリシー適用範囲があります。
管理対象のアプリ、MCP server、プラグイン、マーケットプレイス、コマンドルール Global ポリシー これらの制御は Global に保持してください。スキーマにフィールドが存在することを、そのフィールドを環境ごとに編集できる根拠としないでください。
ファイル、サンドボックス、環境間で適用可能なネットワークの要件 ローカル実行 ローカル実行では、MDM と従来の管理対象デバイスの要件が Agent Security よりも優先されます。デバイスのシステム要件ファイルの優先順位は Agent Security よりも低くなります。新しいエンタープライズ向けの requirements.toml 設定は Work のクラウドコンテナーには適用されず、既存の Work Cloud ポリシーが引き続き適用されます。
プラットフォーム固有の実行環境の制御 ステップを実行するコンピューター サポート状況は実行環境とプラットフォームによって異なります。
管理対象のフック 有効になっている場合、対応するライフサイクルイベントとツールイベントに対してクラウドコーディネーター（オーケストレーター）上で実行される、管理者定義の MCP フック。 これらのフックを運用で使用する前に、コールバック接続をテストし、受信するイベントを確認して、障害がタスクに与える影響を調べてください。MCP フックでは、完全な Compliance API の監査証跡は得られません。クラウドオーケストレーションでは、ツールがローカルで実行される場合でも、コマンドフック、ローカル設定のフック、プラグインのフックはサポートされません。オーケストレーションと実行の両方がローカルで行われる、ローカル専用の Work および Codex スレッドには、既存のサポート対象フックが引き続き適用されます。
プロキシのリスナーアドレス、ポート、プロセスの設定 環境間で適用可能なポリシーの対象外 管理対象の HTTP/SOCKS リスナーポートとループバック以外のプロキシリスナーは、クラウドランタイムではサポートされません。ソケットルールのサポート状況は実行経路によって異なります。カスタムプロキシ設定は、サポートされている接続先の制限とは別のものです。
アプリ専用の設定と通常のローカルのデフォルト値 クラウドでのタスク調整に必ずしも使用されるわけではありません Work Cloud でのローカルコンピューターアクセスがこれらの設定を使用しない場合でも、アプリが適用する制御は引き続き有効な場合があります。クラウド経由の配信とクラウドブラウザーの動作は、個別に検証する必要があります。

Work Cloud でのローカルコンピューターアクセスに関する Agent Security の要件

ローカルアクセスを使用する Work と dots では、管理ポリシーが有効な場合、サポート対象の Global ポリシーが共有クラウドオーケストレーターに適用されます。接続されたコンピューターには、ローカル実行の要件が適用されます。Work のクラウドコンテナーと dots のクラウドコンピューターは、それぞれ独自の実行設定と要件を使用します。ローカルとクラウドの制御は個別にテストしてください。

Agent Security UI で設定できる項目

  • 許可される承認ポリシー
  • 許可されるウェブ検索モード

TOML で設定する項目

  • allowed_approvals_reviewers
  • auto_review
  • guardian_policy_config
  • apps
  • mcp_servers
  • plugins
  • rules

これらのオーケストレーターの要件は Global に保持されます。共有クラウド機能の権限を設定するものではなく、ローカル実行の設定を Work のクラウドコンテナーや dots のクラウドコンピューターに適用できるようにするものでもありません。

Work Cloud でのローカルコンピューターアクセスの互換性に関する制限

サポート状況は、フィールド、ポリシーの配信方法、タスクの実行場所によって異なります。同期を有効にする前に、メンバーに実際に適用されるポリシーを確認してください。表に記載されているとおり、一部の制御は導入先の環境でテストする必要があります。

ポリシー内の優先順位は、高い順に OS 固有の環境オーバーライド → 全 OS 共通の環境オーバーライド → Global です。優先順位の低いポリシーのほうが具体的な場合でも、優先順位の高いポリシーが適用されます。

ローカル実行では、MDM と従来の管理対象デバイスの要件が Agent Security より優先され、Agent Security はデバイスのシステム要件ファイルより優先されます。ネットワーク要件を含む一部の要件には、フィールド固有のマージルールとランタイムの制限があります。例については、管理対象の構成を参照してください。

設定または設定グループ Work Cloud でのローカルコンピューターアクセスとの互換性 管理者向けのガイダンス
sqlite_home, log_dir, model_catalog_json 管理対象のクラウドオーバーライドとしてはサポートされていません。 ローカルパスではクラウドのストレージやログを移動できません。ローカルのモデルカタログは引き継がれません。
model_provider, model_providers Work Cloud でのローカルコンピューターアクセスの管理対象要件や構成ではサポートされていません。 カスタム推論ゲートウェイやプロバイダー接続は、これらのフィールドでは引き継がれません。これはモデル選択とは別のものです。
enforce_residency いずれかのクラウドポリシーで有効になっていると、Work Cloud でのローカルコンピューターアクセスをブロックします。 いずれかのクラウドポリシーで enforce_residency が有効になっている場合、Work と dots の両方で ローカルコンピューターへのアクセスを許可 が無効になります。この保護措置は、ワークスペースのデータレジデンシーを設定するものではなく、それ自体で Work Cloud や dots を無効にするものでもありません。
application.network.enabled および application.network.domains Work Cloud でのローカルコンピューターアクセスではサポートされていません。 これらのアプリケーションの接続先制限を、Work Cloud でのローカルコンピューターアクセスにおけるコマンドのネットワーク通信の制御に使用しないでください。
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions クラウドポリシーの配信は検証が必要です。Work Cloud でのローカルコンピューターアクセスは、これらの管理対象要件キーを拒否します。 ブラウザーの制限にはアプリ側のチェックがあります。ただし、それだけではクラウドへの配信やクラウドブラウザーでの適用を確認したことにはなりません。additional_developer_instructions にはオーケストレーターのサポートが必要です。
experimental_network および permissions.<profile>.network 一部対応しています。サポートされる接続先と実行主体の制限は、カスタムプロキシ構成とは異なります。 管理対象の HTTP/SOCKS リスナーポートと非ループバックのプロキシリスナーは、クラウドランタイムではサポートされていません。ソケットルールのサポートは実行経路によって異なります。ローカル実行時のマージ動作は別です。コマンドのネットワーク制限は、ホスト型検索、MCP、アプリツールを無効にしません。
features / feature_requirements, models, computer_use 一部対応しています。 tool_search = false、tool_search_always_defer_mcp_tools = false、js_repl = true、remote_control = true などの廃止されたスイッチは拒否されます。コンピューター操作の一部の設定には、引き続きエンドツーエンドの検証が必要です。
browser_use, allow_appshots, feedback, allow_remote_control, マーケットプレイスのソース制限 一部のポリシー配信経路では、アプリまたは app-server がこれらの制御を適用します。 Work Cloud でのローカルコンピューターアクセスがフィールドを無視する場合でも、アプリの制御は適用されることがあります。デスクトップブラウザーのサイトルールは、Work のクラウドコンテナーには適用されません。実際の利用環境とポリシー配信経路を検証してください。

構成スキーマには、Work Cloud でのローカルコンピューターアクセスで機能しない場合や、環境オーバーライドをサポートしない場合があるキーが含まれています。グローバルな基本設定と優先順位については、管理対象の構成を参照してください。

config.toml

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

プロジェクト単位の設定では、マシンローカルのプロバイダー、認証、ホスト所有のアプリリクエストメタデータ、通知、設定プロファイルの選択、テレメトリルーティングのキーをオーバーライドできません。プロジェクトローカルの .codex/config.toml に 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 と同じ場所に $CODEX_HOME/profile-name.config.toml として配置します。 --profile profile-name を使用して 1 つ選択します。

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

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

model には、サインイン中のアカウントまたはワークスペースで利用可能なモデルを設定してください。例に示した値を使用する前に、GPT-6.1 Sol の提供状況を確認してください。

キー 型 / 値 詳細
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 このマシンまたはプロファイルの分析を有効または無効にします。Codex CLI では、falseによりカスタム OTLP メトリクスエクスポーターも無効になります。未設定の場合はクライアントのデフォルトが適用されます。
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.extra_policy string メインのポリシーと併せて使用する、自動審査用の追加のローカル Markdown ポリシー。管理対象のguardian_extra_policyが優先されます。空の値は無視されます。
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 のネイティブアプリへのアクセスに適用するフォールバックポリシー。アプリ固有のエントリでポリシーを指定できます。ローカル設定で管理対象の制限を緩和することはできません。
computer_use.macos.bundle_ids map<string, allow | deny> バンドル識別子をキーとする、macOS ネイティブアプリへのアクセス設定。
computer_use.windows.always_allowed_app_ids array<string> Computer Use が確認なしで開ける Windows アプリの識別子。リストにないアプリには承認が必要です。保存済みのエントリは、ChatGPT デスクトップアプリの Computer Use 設定から削除できます。
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.disable_paste_burstの従来のフォールバックです。[tui]配下の設定を優先して使用してください。
experimental_compact_prompt_file string (path) 圧縮プロンプトの上書き内容をファイルから読み込みます（実験的機能）。
experimental_use_unified_exec_tool boolean 統合 exec を有効にするための従来の名前。[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 実験的なコンテキスト管理設定。この機能は現在利用できません。
features.enable_request_compression boolean サポートされている場合、ストリーミングリクエストの本文を zstd で圧縮します（安定版、デフォルトで有効）。
features.fast_mode boolean features.ultrafast_modeとは独立して、使用中のモデルが対応を示す 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.prefer_mxc boolean ネイティブ機能とポリシーで許可される場合、Windows のローカル実行で MXC を優先します。それ以外の場合は、設定済みの従来のサンドボックスとセットアップを維持します。単体の CLI ではデフォルトで無効です。デスクトップアプリではロールアウト設定を通じて有効にできます。コマンドの失敗によってフォールバックが発生することはありません。
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 コマンド実行ツールを有効にします（安定版。デフォルトで有効）。
features.skill_mcp_dependency_install boolean スキルに不足している MCP 依存関係について、確認の表示とインストールを許可します（安定版、デフォルトで有効）。
features.ultrafast_mode boolean features.fast_modeとは独立して、Ultrafast モードのコントロールを有効にします（安定版。デフォルトで有効）。利用できるかどうかは、引き続きモデルとアカウントによって決まります。
features.unified_exec boolean 再開可能なコマンド実行を使用します（安定版。すべてのプラットフォームで有効）。ユーザーによる無効化は無視されます。管理要件によって再開可能なプロセスとwrite_stdinを無効にできます。その場合も単発実行のexec_commandは利用できます。
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 serverは、この URL に ID を付加したものにフォールバックします。コールバック URL のポートは、リスナーポートを指定するものではありません。
mcp_oauth_credentials_store auto | file | keyring MCP OAuth 認証情報の優先保存先。
mcp_optional_startup_grace_ms integer (milliseconds) 初期ツールカタログの作成時に、任意の MCP serverに共通で適用する待機時間。デフォルトは1000です。代わりに各サーバーのstartup_timeout_secを待機時間として使用するには、0に設定します。
mcp_servers.<id>.args array<string> MCP stdio serverのコマンドに渡す引数。
mcp_servers.<id>.auth oauth | chatgpt MCP HTTP serverで、設定済みの bearer トークンと認証ヘッダーの後に試す認証フォールバック。oauth（デフォルト）では、保存済みの MCP OAuth 認証情報があれば使用します。chatgptでは、信頼されたファーストパーティの ChatGPT オリジンに対して現在の ChatGPT セッションを使用し、その後、保存済みの OAuth にフォールバックします。どちらのモードも、いずれの認証情報ソースからも情報を取得できない場合は、認証なしで接続できます。
mcp_servers.<id>.bearer_token_env_var string MCP HTTP serverの bearer トークンを取得する環境変数。
mcp_servers.<id>.command string MCP stdio serverの起動コマンド。
mcp_servers.<id>.cwd string MCP stdio serverプロセスの作業ディレクトリ。
mcp_servers.<id>.default_tools_approval_mode auto | prompt | writes | approve ツールごとの上書きがない場合に適用する、このサーバーの MCP ツールのデフォルトの承認動作。
mcp_servers.<id>.disabled_tools array<string> MCP serverのenabled_toolsの後に適用する拒否リスト。
mcp_servers.<id>.enabled boolean 設定を削除せずに MCP serverを無効にします。
mcp_servers.<id>.enabled_tools array<string> MCP serverが公開するツール名の許可リスト。
mcp_servers.<id>.env map<string,string> MCP stdio serverに転送する環境変数。
mcp_servers.<id>.env_http_headers map<string,string> MCP HTTP server用に、環境変数から値を設定する HTTP ヘッダー。
mcp_servers.<id>.env_vars array<string | { name = string, source = "local" | "remote" }> MCP stdio serverの許可リストに追加する環境変数。文字列エントリのデフォルトはsource = "local"です。source = "remote"は、実行環境を介したリモート stdio でのみ使用してください。
mcp_servers.<id>.experimental_environment local | remote MCP serverの実験的な配置設定。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 serverでのみサポートされます。明示的な bearer トークンと OAuth 認証情報は、ヘルパーが提供する Authorization ヘッダーより優先されます。
mcp_servers.<id>.oauth_resource string MCP ログイン時に含める、任意の RFC 8707 OAuth リソースパラメーター。
mcp_servers.<id>.oauth.callback_port integer この MCP server用の固定 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 serverでの認可とトークン交換に使用する、事前登録済みの OAuth クライアント ID。
mcp_servers.<id>.oauth.client_secret string 事前登録済みクライアントとのトークン交換に使用する OAuth クライアントシークレットです。空でないoauth.client_idが必要で、シークレットも空にできません。設定内に保存されます。
mcp_servers.<id>.required boolean true の場合、有効になっているこの MCP serverを初期化できなければ、起動／再開を失敗させます。
mcp_servers.<id>.scopes array<string> その MCP serverへの認証時に要求する OAuth スコープ。
mcp_servers.<id>.startup_timeout_ms number startup_timeout_secをミリ秒で指定するエイリアス。
mcp_servers.<id>.startup_timeout_sec number MCP serverの起動タイムアウトを、デフォルトの 10 秒から上書きします。
mcp_servers.<id>.tool_timeout_sec number MCP serverのツールごとのタイムアウトを、デフォルトの 60 秒から上書きします。
mcp_servers.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve このサーバーの個々の MCP ツールの承認動作を上書きします。
mcp_servers.<id>.tools.<tool>.output_token_limit integer (positive) 標準のシリアライズ用の 20% の追加枠を適用する前の、個々の MCP ツール出力のトークン予算。そのツールに対する、モデルのデフォルトの出力切り詰め予算を上書きします。
mcp_servers.<id>.url string MCP streamable HTTP serverのエンドポイント。
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-6.1-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 トークンを必要とするときに実行するコマンド。コマンドはトークンを stdout に出力する必要があります。
model_providers.<id>.auth.cwd string (path) トークン取得コマンドの作業ディレクトリ。
model_providers.<id>.auth.refresh_interval_ms number Codex がトークンを事前に更新する間隔（ミリ秒、デフォルト：300000）。認証の再試行後にのみ更新するには、0に設定します。
model_providers.<id>.auth.timeout_ms number トークン取得コマンドの最大実行時間（ミリ秒、デフォルト：5000）。
model_providers.<id>.base_url string モデルプロバイダーの API ベース URL。
model_providers.<id>.capabilities.external_web_access boolean プロバイダーのホスト型ウェブ検索がライブウェブにアクセスできるかどうかを指定します。プロバイダーのデフォルトを維持するには省略します。モデルやターンの設定によって、アクセスがさらに制限される場合があります。
model_providers.<id>.capabilities.remote_compaction unsupported | v2 プロバイダーの圧縮プロトコルです。unsupportedはローカルで圧縮し、v2は Responses を通じて圧縮トリガーを送信します。プロバイダーのデフォルトを維持するには省略します。モデルやターンの設定によって、サポートがさらに制限される場合があります。
model_providers.<id>.env_http_headers map<string,string> 環境変数が存在する場合に、その値を設定する HTTP ヘッダー。
model_providers.<id>.env_key string プロバイダーの API key を提供する環境変数。
model_providers.<id>.env_key_instructions string プロバイダーの API key に関する任意のセットアップガイダンス。
model_providers.<id>.experimental_bearer_token string プロバイダーの bearer トークンを直接指定します（非推奨、env_keyを使用してください）。
model_providers.<id>.http_headers map<string,string> プロバイダーへのリクエストに追加する固定の HTTP ヘッダー。
model_providers.<id>.model_catalog_url string Codex ネイティブのモデルカタログの完全な URL です。プロバイダーのデフォルトのモデル検出を維持するには省略します。
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 string 選択したモデルが対応を示す推論労力。low、medium、high、xhigh、max、ultraなどがあります。利用可能なレベルはモデルとクライアントによって異なります。
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）。Codex CLI では、analytics.enabled = falseにより、カスタム OTLP エクスポーターを含め、このエクスポーターが無効になります。メトリクスのエクスポートを個別に無効にするには、noneに設定します。
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 serverは制限しません。
permissions.<name>.network.domains.<pattern> allow | deny 完全一致のホスト、または*.example.comや**.example.comなどの範囲を限定したワイルドカードパターンを許可または拒否します。
permissions.<name>.network.enable_socks5 boolean この権限プロファイルでサンドボックス内のネットワーク通信を有効にした場合に、SOCKS5 サポートを公開します。
permissions.<name>.network.enable_socks5_udp boolean 有効な場合、SOCKS5 リスナー経由の UDP を許可します。
permissions.<name>.network.enabled boolean この権限プロファイルのコマンドに対して、ネットワークアクセスを有効にします。ネットワークプロキシは起動しません。features.network_proxyまたは有効な管理者管理のネットワーク要件がない場合、コマンドはネットワークに直接アクセスし、プロファイルのドメインルールは適用されません。
permissions.<name>.network.mode limited | full サブプロセスの通信に使用するネットワークプロキシモード。
permissions.<name>.network.proxy_url string この権限プロファイルでサンドボックス内のネットワーク通信を有効にした場合に使用する HTTP リスナー URL。
permissions.<name>.network.socks_url string この権限プロファイルが使用する SOCKS5 プロキシエンドポイント。
permissions.<name>.network.unix_sockets table サンドボックス内のネットワーク通信に対する Unix ソケット許可リストの上書き。ソケットのパスをキーに使用します。allowはパスを追加し、denyは拒否します。
permissions.<name>.network.unix_sockets.<path> allow | deny allowで Unix ソケットの絶対パスを有効な許可リストに追加するか、denyで拒否します。拒否されたエントリは、有効な許可リストから除外されます。
permissions.<name>.workspace_roots table セッションの実行時ワークスペースルートとともに、:workspace_rootsファイルシステムルールが適用される、プロファイルで定義したワークスペースルート。
permissions.<name>.workspace_roots.<path> boolean trueの場合に、パスをプロファイルのワークスペースルート集合に追加します。無効なエントリは非アクティブのままです。
personality none | friendly | pragmatic 非推奨の互換性設定です。friendlyとpragmaticではスタイルを選択できなくなりました。noneは、モデルへの指示から組み込みの Personality セクションを省略します。明示的な指示の上書きは変更されません。
plan_mode_reasoning_effort string 選択したモデルがサポートするレベルを使用して、プランモード専用の推論設定を上書きします。未設定の場合、プランモードは組み込みプリセットのデフォルト値を使用します。
plugins.<plugin>.enabled boolean plugin-name@marketplace-nameキーを使用して、ローカルマーケットプレイスのプラグインを有効または無効にします。有効なマージ済み設定から読み取られます。信頼されたプロジェクトの設定は、ユーザー、クラウド管理、システムのデフォルトを上書きできます。マーケットプレイスを更新すると、無効になっている場合でも、設定済みのプラグインがインストールまたは更新されることがあります。ワークスペースで管理される有効状態は上書きしません。
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode auto | prompt | writes | approve プラグインが提供する MCP serverのツールに対する、デフォルトの承認動作。
plugins.<plugin>.mcp_servers.<server>.disabled_tools array<string> プラグインが提供する MCP serverのenabled_toolsの後に適用する拒否リスト。
plugins.<plugin>.mcp_servers.<server>.enabled boolean プラグインマニフェストを変更せずに、インストール済みプラグインに同梱された MCP serverを有効または無効にします。
plugins.<plugin>.mcp_servers.<server>.enabled_tools array<string> プラグインが提供する MCP serverから公開するツールの許可リスト。
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 プロジェクトまたはワークツリーを信頼済み、または信頼されていないものとして指定します（"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 serverを制限しません。
tui table インラインのデスクトップ通知の有効化など、TUI 固有のオプション。
tui.alternate_screen auto | always | never TUI での代替画面の使用を制御します（デフォルト：auto。auto では、スクロールバックを保持するために Zellij での使用をスキップします）。
tui.animations boolean ターミナルのアニメーション（ウェルカム画面、きらめき、スピナー）を有効にします（デフォルト：true）。
tui.auto_recap boolean ターミナルにフォーカスがない間、会話の振り返りを自動生成します（デフォルト：true）。自動生成を無効にするには、falseに設定します。/recapは引き続き利用できます。
tui.disable_paste_burst boolean TUI で連続入力による貼り付けの検出を無効にします（デフォルト：false）。従来のトップレベルのdisable_paste_burst設定より優先されます。
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 ターミナル上でコピーする範囲を選択しやすい、raw スクロールバックモードで TUI を開始します（デフォルト：false）。/rawまたはデフォルトのalt-rキーバインドで切り替えられます。
tui.resume_cwd current | session セッションの再開または分岐時に使用する作業ディレクトリ。未設定で、現在のディレクトリがセッションに保存されたディレクトリと異なる場合、Codex は選択を求めます。
tui.show_server_version_notice boolean 接続先の app-server のバージョン差に関する情報通知を表示します（デフォルト：true）。互換性エラーやバージョン状態は非表示になりません。
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 mxc | elevated | unelevated Windows ネイティブのサンドボックス実装。MXC が利用できないか、管理対象の要件で禁止されている場合、mxcを明示的に選択すると失敗します。フォールバック付きで MXC を自動選択するには、従来の実装の選択と併せてfeatures.prefer_mxcを使用してください。

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 には含まれない、文書化されたアプリ専用キーも含めることができます。省略されたキーには制約が適用されません。

一部の管理対象の要件では、許可リストではなく、特定の設定値を強制します。ユーザーは、強制されたパス、更新設定、ログインシェルのポリシー、フィードバック設定を上書きできません。

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

allowed_sandbox_modes は sandbox_mode と併用してください。権限プロファイルをデプロイする場合は、allowed_permission_profiles を管理対象の default_permissions と併用してください。

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

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

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

ネストされた Browser Use および Computer Use のポリシー値だけでは、アクセスは許可されません。オリジンまたはアプリ固有の allow は、同じポリシーソースのフォールバックを上書きできますが、通常の機能、承認、その他のポリシーチェックは引き続き適用されます。管理対象要件と config.toml の両方が適用される場合は、いずれかで指定された deny が優先されます。

キー 型 / 値 詳細
additional_developer_instructions string 個別の開発者メッセージとして追加される、管理対象の開発者指示です。Codex は、コンテキストマーカーを含めた推定トークン数が上限の 10,000 を超える指示を拒否します。
allow_appshots boolean false に設定すると、管理対象ユーザーの Appshots を無効にします。省略した場合、Appshots は要件による制約を受けず、通常の製品の提供状況に従います。
allow_browser_and_computer_use boolean false に設定すると、エージェントによる Browser Use とネイティブアプリの Computer Use の両方をブロックします。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> approvals_reviewer に許可する値です。たとえば、user や auto_review です。
allowed_chatgpt_workspaces array<string> Codex アクセストークンを含む ChatGPT ログインを、リストに記載されたワークスペース ID に制限します。空のリストは ChatGPT ログインを無効にします。API 認証は、許可されていれば引き続き利用できます。ローカルのシステム要件ファイルまたは macOS MDM で設定します。クラウド管理の値は無視されます。
allowed_login_methods array<string> chatgpt、api、またはその両方を許可します。省略した場合、この設定はログイン方法を制限しません。設定する場合、リストには少なくとも 1 つの方法を含める必要があります。api は、Amazon Bedrock を含む API 認証を許可します。ローカルのシステム要件ファイルまたは macOS MDM で設定します。クラウド管理の値は無視されます。
allowed_permission_profiles table<boolean> 許可する権限プロファイルの完全なリストです。true に設定されたプロファイルは許可されます。省略されたプロファイルや false に設定されたプロファイルは、将来のバージョンで追加されるプロファイルも含めて拒否されます。要件ソースを結合する際は、プロファイル名でエントリを照合します。
allowed_permission_profiles.<name> boolean 読み込まれた設定または要件ソースで定義された、組み込みまたはカスタムの権限プロファイルを許可または拒否します。後から適用される優先順位の高い要件ソースでは、false を使用して、先に適用された優先順位の低いソースで許可されたプロファイルを無効にできます。
allowed_sandbox_modes array<string> sandbox_mode に許可する値です。
allowed_web_search_modes array<string> web_search に許可する値（disabled、cached、indexed、live）です。disabled は常に許可されます。空のリストでは、実質的に disabled のみが許可されます。
application table 管理対象のデスクトップアプリケーション要件です。
application.network table デスクトップアプリのネットワークリクエストに対する接続先の制限です。コマンドのネットワーク通信やブラウザのオリジンルールとは別に適用されます。ネイティブモジュールや起動されたプロセスには、接続先の制限を課しません。
application.network.domains table<allow | deny> デスクトップアプリのリクエストに対する、完全一致のドメインルールです。有効なポリシーでは、明示的に許可されたドメインへの HTTPS と WSS リクエストのみが許可されます。サブドメインは暗黙には許可されません。
application.network.domains.<domain> allow | deny 完全一致のドメインを許可または拒否します。URL スキーム、ポート、ワイルドカードを含まないドメイン名を使用します。
application.network.enabled boolean テーブルが存在する場合、デフォルトは true です。true の場合、デスクトップアプリの外部リクエストには、明示的に許可されたドメインが必要です。ドメインマップが空の場合、外部の接続先は一切許可されません。アプリケーションのネットワークポリシーが存在しない場合、または値が false の場合、このポリシーによる接続先の制限はありません。
apps table アプリ識別子をキーとする、管理対象のアプリ要件です。要件によって、アプリを無効にしたり、個々のツールの承認動作を制限したりできます。
apps.<id>.enabled boolean false に設定すると、アプリを無効にします。複数の要件ソースをマージしても、無効化の要件による制限は維持されます。
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve 1 つのアプリツールの管理対象承認モードを設定します。
auto_review table 管理対象の自動レビュー要件です。
auto_review.ignore_rules array<string> コマンド実行ポリシーで Codex が allow プレフィックスルールを無視する、完全なモデルスラッグです。プロバイダーの名前空間がある場合はそれも含め、スラッグを完全一致させます。required_on_models と異なり、名前空間を省略したエイリアスは受け付けません。拒否ルールとネットワークルールは引き続き適用されます。
auto_review.required_on_models array<string> 自動レビューを必須とするモデルスラッグです。スラッグは空にできず、プロバイダーの名前空間を含めず、前後に空白を付けないようにします。複数の要件ソースのリストは結合されます。
browser_use table エージェントによる Browser Use の管理対象要件です。
browser_use.allow_global_persistent_approval boolean false に設定すると、任意のサイトからのダウンロードの許可など、すべてのサイトを対象とする Always allow 承認を Browser Use が作成または適用できないようにします。既存の保存済み承認は削除されず、無視されます。true に設定するか省略しても、承認は作成されません。
browser_use.allow_history_access boolean false に設定すると、Browser Use によるブラウザ履歴の読み取りを防ぎます。true に設定するか省略すると、通常の履歴設定と利用可否のチェックが引き続き適用されます。
browser_use.allow_webmcp boolean デスクトップアプリの組み込みブラウザで Site tools（WebMCP）の利用を有効にするには、true に設定します。false に設定するか省略すると、通常の機能提供状況のチェックが引き続き適用されます。false はブロックを強制しません。ユーザー設定とサイト権限も引き続き適用されます。
browser_use.default_origin_policy table browser_use.origins の下に一致するエントリがなく、設定が定義されていない場合に使用する、各 Browser Use 設定のフォールバックです。一致するオリジンルールが、そのソースのフォールバックを置き換えます。その後、Codex は管理対象要件とユーザー設定のうち、より厳しい結果を適用します。
browser_use.default_origin_policy.access allow | deny deny を使用すると、フォールバックを使用するオリジンで Browser Use をブロックします。拒否されたオリジンでは、アップロード、ダウンロード、完全なブラウザデバッグアクセス、自動レビューもブロックされます。allow は、通常の承認とポリシーのチェックを続行できるようにするだけです。
browser_use.default_origin_policy.access_approval_lifetime turn | thread 永続化しないサイトアクセス承認の有効期間を設定します。turn は現在のターンに限定し、thread は現在のスレッドの残りの期間にわたって維持します。persistent_approval は、Always allow を利用できるかどうかを別途制御します。製品のデフォルトは thread です。
browser_use.default_origin_policy.auto_review allow | deny deny を使用すると、フォールバックを使用するオリジンで自動レビューをスキップし、代わりにユーザーに承認を求めます。allow は、その他の設定で許可される場合に自動レビューを利用可能なままにします。
browser_use.default_origin_policy.downloads allow | deny deny を使用すると、フォールバックを使用するオリジンで Browser Use によるダウンロードをブロックします。allow は、通常の承認とポリシーのチェックを続行できるようにするだけです。
browser_use.default_origin_policy.full_cdp_access allow | deny deny を使用すると、フォールバックを使用するオリジンで完全な Chrome DevTools Protocol（CDP）アクセスをブロックします。allow は、通常のオプトインと承認のチェックを続行できるようにするだけです。
browser_use.default_origin_policy.persistent_approval boolean false に設定すると、フォールバックを使用するオリジンで Browser Use が Always allow 承認を保存または適用できないようにします。現在のターンまたはスレッドの承認は引き続き適用できます。true は、ほかの条件で許可される場合に Always allow を利用可能にしますが、承認は作成しません。
browser_use.default_origin_policy.uploads allow | deny deny を使用すると、フォールバックを使用するオリジンで Browser Use によるアップロードをブロックします。allow は、通常の承認とポリシーのチェックを続行できるようにするだけです。
browser_use.disable_auto_review boolean true に設定すると、Browser Use の自動レビューをスキップし、代わりにユーザーに承認を求めます。false に設定するか省略すると、その他の設定で許可される場合に自動レビューを利用できます。
browser_use.origins map<string, table> オリジン固有の Browser Use ポリシーです。キーには <scheme>://<host-pattern>[:<port>] を使用し、http または https を指定します。完全一致のホスト、サブドメインのみに一致する *.example.com、またはベースドメインとそのサブドメインに一致する **.example.com を使用します。その他の * ワイルドカードはドットをまたいで一致するため、region*.example.com は region.api.example.com にも一致します。ホストが * の場合、そのスキームのすべてのホストに一致します。スキームとデフォルト以外のポートは区別されます。明示されたデフォルトポートは正規化時に除去されます。パス、クエリ、埋め込まれたユーザー名やパスワード、スキームやポートのワイルドカードは無効です。TOML では、たとえば [browser_use.origins."https://**.example.com"] のようにパターンを引用符で囲みます。
browser_use.origins.<pattern> table このパターンに一致するオリジンのポリシーです。複数のパターンに一致する場合、Codex は各機能で最も制限の厳しい値を使用します。deny は allow より、false は true より、turn は thread より優先されます。
browser_use.origins.<pattern>.access allow | deny deny を使用すると、一致するオリジンで Browser Use をブロックします。拒否すると、そのオリジンでのアップロード、ダウンロード、完全なブラウザデバッグアクセス、自動レビューもブロックされます。allow は、通常の承認とポリシーのチェックを続行できるようにするだけです。
browser_use.origins.<pattern>.access_approval_lifetime turn | thread 一致するオリジンに対する、永続化しないサイトアクセス承認の有効期間を設定します。turn は現在のターンに限定し、thread は現在のスレッドの残りの期間にわたって維持します。persistent_approval は、Always allow を利用できるかどうかを別途制御します。
browser_use.origins.<pattern>.auto_review allow | deny deny を使用すると、一致するオリジンで自動レビューをスキップし、代わりにユーザーに承認を求めます。allow は、その他の設定で許可される場合に自動レビューを利用可能なままにします。
browser_use.origins.<pattern>.downloads allow | deny deny を使用すると、一致するオリジンで Browser Use によるダウンロードをブロックします。allow は、通常の承認とポリシーのチェックを続行できるようにするだけです。
browser_use.origins.<pattern>.full_cdp_access allow | deny deny を使用すると、一致するオリジンで完全な Chrome DevTools Protocol（CDP）アクセスをブロックします。allow は、通常のオプトインと承認のチェックを続行できるようにするだけです。
browser_use.origins.<pattern>.persistent_approval boolean false に設定すると、一致するオリジンで Browser Use が Always allow 承認を保存または適用できないようにします。現在のターンまたはスレッドの承認は引き続き適用できます。true は、ほかの条件で許可される場合に Always allow を利用可能にしますが、承認は作成しません。
browser_use.origins.<pattern>.uploads allow | deny deny を使用すると、一致するオリジンで Browser Use によるアップロードをブロックします。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 デバイスでユーザーが Locked Use を有効にできないようにします。この要件は有効化のコントロールを削除しますが、すでに有効な Locked Use は無効にしません。省略した場合、通常の製品の提供状況に従います。
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 アプリルールです。
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 アプリルールです。
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 を使用すると、完全一致するパッケージアプリの ID をブロックします。allow は、このポリシーソースのデフォルトのみを上書きします。アプリを許可するには、その他のポリシーソースと通常の承認フローでも許可される必要があります。
computer_use.windows.exes array<table> 署名済みでパッケージ化されていない Windows 実行ファイルのルールです。ルールは、パスや現在のファイル名ではなく、実行ファイルの検証済みの発行元と署名済みバージョン情報に照合されます。一致する拒否ルールは、一致する許可ルールより優先されます。署名のない実行ファイルには computer_use.default_app_access が使用されます。署名された ID を一意に検証できない実行ファイルはブロックされます。
computer_use.windows.exes[].access allow | deny 一致する実行ファイルに対する、必須のアクセス判断です。deny はアクセスをブロックします。allow は、このポリシーソースのデフォルトのみを上書きします。アプリを許可するには、その他のポリシーソースと通常の承認フローでも許可される必要があります。
computer_use.windows.exes[].binary_name string 実行ファイルの署名済みバージョン情報に含まれる、任意の OriginalFilename です。照合では大文字と小文字を区別しません。一致する発行元と製品のルールでこの値が必須なのに、実行ファイルがこの値を提供していない場合、Computer Use はその実行ファイルをブロックします。
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 をデフォルトにしますが、これは :workspace と :read-only の両方が明示的に許可されている場合に限ります。
enforce_residency string Codex サービスの通信に、サポートされているデータレジデンシーの使用を必須とします。現在は us を受け付けます。
experimental_network table サンドボックス内のローカルコマンドに対する、管理者が管理するネットワーク要件です。requirements.toml から強制適用されます。有効にすると、これらの要件は features.network_proxy なしでコマンド用ネットワークプロキシを起動できます。ブラウザツールは、管理対象のネットワーク拒否ルールと排他的許可リストを別途確認します。これらの要件は、ブラウザの通信をプロキシ経由にせず、ウェブ検索、アプリ、MCP server、ネイティブアプリの通信、その他の機能固有の通信も制御しません。サポートされている管理対象の Codex Cloud の実行経路では、これらの要件は、別途設定される Cloud 環境のインターネット設定とともに、コマンドのネットワーク通信を制限します。サンドボックスの制限を全面的に解除する承認済みの権限昇格では、ポリシーで許可されている場合にコマンドプロキシを回避できます。Work Cloud はこれらの要件を継承しません。
experimental_network.allow_local_binding boolean サンドボックス内のネットワーク通信で、より広範なローカルネットワークやプライベートネットワークへのアクセスを許可します。サポートされている Codex Cloud のプロキシ経路では、明示的な false により、ドメインが許可されていても上流プロキシへのアクセスを防ぐことができます。適用される要件、選択されたネットワークプロファイル、プロキシ機能設定のいずれにも値がない場合にのみ、デフォルトは true になります。継承された false は明示的な値のままです。サポートされている優先順位の高い Cloud の上書き設定であれば、Local 向けの Global の範囲を広げたり、ドメインの Allow エントリを追加したりせずに、この値を変更できます。実行環境が対応していることを確認してください。この Cloud のデフォルトを Local に適用しないでください。
experimental_network.allow_upstream_proxy boolean サンドボックス内のネットワーク通信が、環境で指定された上流プロキシを経由することを許可します。
experimental_network.allowed_domains array<string> 管理対象ネットワークプロキシが有効な間に適用する、サンドボックス内のコマンドのネットワーク通信に対する管理者の許可ルールです。これらのルールは、ウェブ検索、アプリ、MCP serverには適用されません。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、全体を対象とする * 許可ルールをサポートします。* は外部へのパブリックアクセスを広く開放するため、範囲を限定したルールを優先してください。環境ルールは、ポリシー内の同じ Global ドメインキーを置き換えることができます。優先順位の高い値が同じキーを置き換え、継承されたその他のキーは維持されます。結合後も、継承されたワイルドカードを含む別の deny に一致すれば、リクエストはブロックされます。空の環境マップで Global ルールが消去されることはありません。実行環境が対応していることを確認してください。experimental_network.allowed_domains または experimental_network.denied_domains と組み合わせないでください。
experimental_network.domains.<pattern> allow | deny 一致するドメインパターンに対して、サンドボックス内のネットワークアクセスを許可または拒否します。複数のパターンに一致する場合、拒否ルールが優先されます。
experimental_network.enabled boolean サンドボックス内のネットワーク要件を有効にします。アクティブなサンドボックスがコマンドのネットワーク通信を無効にしている場合、これによってネットワークアクセスが付与されることはありません。
experimental_network.http_port integer [experimental_network] 要件に使用するループバック HTTP リスナーポートです。
experimental_network.managed_allowed_domains_only boolean ネットワーク要件が有効で、この値が true の場合、通常のユーザー設定やドメインごとの承認では、管理対象プロキシの許可リストを拡張できません。設定済みまたは継承された有効な Allow エントリがない場合、通常の管理対象コマンドには許可された接続先がありません。拒否のみのポリシーでは、インターネットの残りの部分は許可されません。これは、すべてのツールや、サンドボックスの制限を全面的に解除する承認済みの権限昇格を対象とするものではありません。
experimental_network.socks_port integer [experimental_network] 要件に使用するループバック SOCKS5 リスナーポートです。
experimental_network.unix_sockets map<string, allow | deny> macOS でのサンドボックス内のネットワーク通信に対する、管理者が管理する Unix ソケットの許可リストです。パスは絶対パスである必要があります。
experimental_network.unix_sockets.<path> allow | deny macOS では、allow は Unix ソケットの絶対パスを許可リストに追加し、deny は追加しません。すべての Unix ソケットの許可が有効な場合、deny エントリでソケットをブロックすることはできません。
features table 固定する機能の値です。ランタイム機能には config.toml の正規名を使用します。ドキュメントに記載されたアプリ専用の要件キーもここでサポートされます。
features.<name> boolean ドキュメントに記載されたランタイム機能またはアプリ機能を、有効または無効のままにすることを必須とします。
features.apps boolean 管理対象ユーザーの Apps 連携の利用可否を、オンまたはオフに固定します。
features.browser_use boolean requirements.toml で false に設定すると、エージェントによる Browser Use を無効にします。
features.browser_use_external boolean requirements.toml で false に設定すると、既存のタブやログイン済みセッションを含め、Codex が ChatGPT ブラウザ拡張機能を通じて対応ブラウザを操作するのを防ぎます。
features.browser_use_full_cdp_access boolean requirements.toml で false に設定すると、Browser Developer モードを含むローカルランタイムでの完全な Chrome DevTools Protocol アクセスを無効にし、ChatGPT デスクトップアプリで対応する設定を有効にできないようにします。省略した場合、通常の製品の提供状況に従います。
features.computer_use boolean requirements.toml で false に設定すると、Computer Use、Record & Replay、および関連するインストールや有効化のフローを無効にします。
features.fast_mode boolean 管理対象ユーザーの正規の fast_mode 機能を、オンまたはオフに固定します。
features.guardian_approval boolean 管理対象ユーザーの Guardian 承認の利用可否を、オンまたはオフに固定します。
features.in_app_browser boolean requirements.toml で false に設定すると、ユーザーが直接開いて操作する組み込みブラウザペインを無効にします。
features.in_app_chat boolean false に設定すると、ChatGPT デスクトップアプリの ChatGPT と ChatGPT Work の会話画面、および関連するクラウド自動化 UI を非表示にします。この設定は ChatGPT Voice をブロックせず、既存のクラウドタスクも停止しません。true に設定しても、アカウント、ワークスペース権限、ロールアウトのチェックは回避できません。
features.in_app_dictation boolean false に設定すると、デスクトップアプリのアプリ内音声入力を無効にします。true に設定しても、その他の利用可否のチェックは回避できません。
features.in_app_local_automation boolean false に設定すると、デスクトップアプリのローカルのスケジュールタスクを無効にします。true に設定しても、その他の利用可否のチェックは回避できません。
features.in_app_updates boolean requirements.toml で false に設定すると、アプリ内更新を無効にします。この要件を省略した場合、更新はデフォルトで有効のままです。
features.memories boolean 管理対象ユーザーの Memories の利用可否を、オンまたはオフに固定します。
features.multi_agent boolean 管理対象ユーザーのマルチエージェントの利用可否を、オンまたはオフに固定します。
features.plugin_sharing boolean クラウド管理の requirements.toml で false に設定すると、ローカルで作成したプラグインのワークスペース共有を無効にします。
features.plugins boolean 管理対象ユーザーのプラグインの利用可否を、オンまたはオフに固定します。
features.realtime_conversation boolean false に設定すると、Codex CLI の実験的な /voice コマンドを無効にします。デスクトップアプリの ChatGPT Voice や app-server の音声セッションをブロックするために、この設定に頼らないでください。true に設定しても、クライアントやロールアウトのチェックは回避できません。
features.remote_plugin boolean 管理対象ユーザーのリモートプラグインカタログの利用可否を、オンまたはオフに固定します。
features.workspace_dependencies boolean 管理対象ユーザーの、同梱されたワークスペース依存関係ランタイムの利用可否を、オンまたはオフに固定します。
feedback table 管理対象のフィードバック設定です。
feedback.enabled boolean Codex の各クライアントでユーザーがフィードバックを送信できるかどうかを強制指定します。
guardian_extra_policy string メインポリシーとともに含める、自動レビュー用の追加の管理対象 Markdown ポリシーです。ローカルの [auto_review].extra_policy より優先されます。空の値は無視されます。
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 組み込みブラウザペインの要件です。これらの設定は、エージェントによる Browser Use を制御しません。
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 key カタログを含む、OpenAI が選定した Git カタログも許可リストに一致する必要があります。同梱のワークスペースプラグインとリモートでインストールされたワークスペースプラグインは、この選定済み Git ソースポリシーとは別に扱われます。
mcp_servers table 有効化できる MCP serverの許可リストです。MCP serverを有効にするには、サーバー名（<id>）とその ID の両方が一致する必要があります。設定済みの MCP serverで、許可リストに含まれないもの、または ID が一致しないものは無効になります。
mcp_servers.<id>.identity table 単一の MCP serverの ID ルールです。command（stdio）または url（streamable HTTP）のいずれかを設定します。
mcp_servers.<id>.identity.command string | table 完全一致のコマンド文字列で MCP stdio serverを許可するか、マッチャーテーブルを使用して、実行ファイルの完全一致と順序付き引数マッチャーによる一致を必須にします。文字列形式では、引数、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 serverを許可するか、exact、prefix、regex のいずれかの値マッチャーテーブルを使用します。
mcp_servers.<id>.identity.url.expression string regex URL マッチャーが使用する正規表現です。式は有効で、URL の値全体に一致する必要があります。
mcp_servers.<id>.identity.url.match exact | prefix | regex 設定された MCP server URL の照合操作です。
mcp_servers.<id>.identity.url.value string exact または prefix URL マッチャーが使用する値です。
model_catalog_json string (path) Codex が起動時に使用する JSON モデルカタログを強制指定します。
model_provider string ローカル設定とセッション設定を上書きして、モデルプロバイダー ID を強制指定します。
model_providers map<string, table> 管理対象のモデルプロバイダー定義です。各エントリは、同じ ID を持つ設定済みプロバイダー全体を置き換えます。フィールドはユーザーの定義とマージされません。ほかの ID を持つプロバイダーは引き続き利用できます。
model_providers.<id> table 管理対象プロバイダーの完全な定義です。config.toml と同じプロバイダーフィールドを使用し、name、base_url、認証、トランスポート設定を含みます。
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 server許可リストです。このテーブルが存在する場合、一致するプラグインとサーバーのエントリがないプラグイン同梱サーバーは無効になります。
plugins.<plugin>.mcp_servers table 1 つのプラグインに同梱された MCP serverの許可リストです。プラグインサーバー要件では、トップレベルの mcp_servers 要件と同じ、完全一致の ID 形式とマッチャー形式を使用します。
plugins.<plugin>.mcp_servers.<server>.identity table プラグインに同梱された 1 つの MCP serverの ID ルールです。command（stdio）または url（streamable HTTP）のいずれかを設定します。
plugins.<plugin>.mcp_servers.<server>.identity.command string | table 完全一致のコマンド文字列でプラグインの stdio MCP serverを許可するか、マッチャーテーブルを使用して、実行ファイルの完全一致と順序付き引数マッチャーによる一致を必須にします。
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 serverを許可するか、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 server 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.allow_mxc boolean false に設定すると、MXC の明示的な選択と、features.prefer_mxc による自動選択の両方を禁止します。この要件を省略するか true に設定すると、MXC は許可されますが、有効化も必須化もされません。フォールバックには従来の実装に対する制限が引き続き適用されます。
windows.allowed_sandbox_implementations array<string> 許可する従来のネイティブ Windows サンドボックス実装（elevated と unelevated）です。リストは空にできません。両方が許可され、モードが選択されていない場合、Codex は elevated を優先します。このリストは、利用可能な場合の mxc サンドボックスを制限しません。