設定リファレンス
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_reviewersauto_reviewguardian_policy_configappsmcp_serverspluginsrules
これらのオーケストレーターの要件は 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 |
このマシンまたはプロファイルの分析を有効または無効にします。未設定の場合は、クライアントのデフォルトが適用されます。 |
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 でバースト貼り付けの検出を無効にします。 |
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 |
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 serverは、この URL に ID を付加したものにフォールバックします。コールバック URL のポートは、リスナーポートの選択には使用されません。 |
mcp_oauth_credentials_store |
auto | file | keyring |
MCP OAuth 認証情報の優先保存先。 |
mcp_optional_startup_grace_ms |
integer (milliseconds) |
初期ツールカタログの構築時に、任意の MCP serverを待機する共通の時間です。デフォルトは1000です。0に設定すると、代わりに各サーバーのstartup_timeout_secに従って待機します。 |
mcp_servers.<id>.args |
array<string> |
MCP stdio サーバーのコマンドに渡す引数。 |
mcp_servers.<id>.auth |
oauth | chatgpt |
設定済みの bearer トークンと認証ヘッダーの後に使用する、MCP HTTP サーバーの認証フォールバックです。oauth(デフォルト)では、保存済みの MCP OAuth 認証情報があれば使用します。chatgptでは、信頼できるファーストパーティの ChatGPT オリジンに現在の ChatGPT セッションを使用し、その後、保存済みの OAuth にフォールバックします。どちらのモードも、利用できる認証情報がなければ認証なしで接続できます。 |
mcp_servers.<id>.bearer_token_env_var |
string |
MCP HTTP サーバーの bearer トークンを取得する環境変数。 |
mcp_servers.<id>.command |
string |
MCP stdio サーバーを起動するコマンド。 |
mcp_servers.<id>.cwd |
string |
MCP stdio サーバープロセスの作業ディレクトリ。 |
mcp_servers.<id>.default_tools_approval_mode |
auto | prompt | writes | approve |
ツールごとの上書き設定がない場合に、このサーバーの MCP ツールに適用するデフォルトの承認動作。 |
mcp_servers.<id>.disabled_tools |
array<string> |
MCP 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 サーバーに転送する環境変数。 |
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 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>.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 サーバーのエンドポイント。 |
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 トークンを必要とするときに実行するコマンドです。コマンドはトークンを標準出力に出力する必要があります。 |
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 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>.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)。 |
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 |
supportsPersonalityへの対応を表明するモデルのデフォルトのコミュニケーションスタイルです。スレッドやターンごとに、または/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.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 を開始します(デフォルト: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 | mxc |
Windows 上で Codex をネイティブに実行する際の、Windows 専用のネイティブサンドボックスモード。 |
一致する設定オプションはありません。
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 と併用してください。
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 |
管理対象ユーザーの Appshots を無効にするには、false に設定します。省略した場合、Appshots は要件による制限を受けず、通常の製品の利用可否に従います。 |
allow_browser_and_computer_use |
boolean |
エージェントによる Browser Use とネイティブアプリの Computer Use の両方をブロックするには、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> |
approvals_reviewer に許可される値です。たとえば、user や auto_review です。 |
allowed_chatgpt_workspaces |
array<string> |
Codex アクセストークンを含む ChatGPT ログインを、リストに記載されたワークスペース ID に制限します。空のリストは ChatGPT ログインを無効にします。API 認証は、許可されていれば引き続き利用できます。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウド管理の値は無視されます。 |
allowed_login_methods |
array<string> |
chatgpt、api、または両方を許可します。省略した場合、この設定はログイン方法を制限しません。設定する場合、リストには少なくとも 1 つの方法を含める必要があります。api は、Amazon Bedrock を含む API 認証を許可します。ローカルのシステム要件ファイルまたは macOS MDM を通じて設定します。クラウド管理の値は無視されます。 |
allowed_permission_profiles |
table<boolean> |
許可される権限プロファイルの完全なリストです。true に設定されたプロファイルは許可されます。省略されたプロファイルや false に設定されたプロファイルは、将来のバージョンで追加されるものも含めて拒否されます。要件ソースを結合する際は、プロファイル名でエントリを照合します。 |
allowed_permission_profiles.<name> |
boolean |
読み込まれた設定または要件ソースで定義されている、組み込みまたはカスタムの権限プロファイルを許可または拒否します。後から適用される優先順位の高い要件ソースは、false を使用して、先に適用された優先順位の低いソースが許可したプロファイルを無効にできます。 |
allowed_sandbox_modes |
array<string> |
sandbox_mode に許可される値です。 |
allowed_web_search_modes |
array<string> |
web_search に許可される値(disabled、cached、indexed、live)です。disabled は常に許可されます。空のリストは、実質的に disabled のみを許可します。 |
apps |
table |
アプリ識別子をキーとする、管理対象のアプリ要件です。要件でアプリを無効にしたり、個々のツールの承認動作を制限したりできます。 |
apps.<id>.enabled |
boolean |
アプリを無効にするには、false に設定します。無効化の要件は、複数の要件ソースをマージしても制限として維持されます。 |
apps.<id>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
1 つのアプリツールに対する、管理対象の承認モードを設定します。 |
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 |
任意のサイトからのダウンロードを許可するなど、すべてのサイトを対象とする Always allow 承認を Browser Use が作成または適用できないようにするには、false に設定します。保存済みの既存の承認は削除されず、無視されます。true に設定するか省略しても、承認は作成されません。 |
browser_use.allow_history_access |
boolean |
Browser Use がブラウザー履歴を読み取れないようにするには、false に設定します。true に設定するか省略した場合、通常の履歴設定と利用可否のチェックが維持されます。 |
browser_use.default_origin_policy |
table |
browser_use.origins 内に、その設定を定義する一致したエントリがない場合の、各 Browser Use 設定のフォールバックです。一致するオリジンルールが、そのソースのフォールバックを置き換えます。その後、Codex は管理対象要件とユーザー設定のうち、より厳しい結果を適用します。 |
browser_use.default_origin_policy.access |
allow | deny |
フォールバックを使用するオリジンで Browser Use をブロックするには、deny を使用します。拒否されたオリジンでは、アップロード、ダウンロード、完全なブラウザーデバッグアクセス、自動レビューもブロックされます。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 |
フォールバックを使用するオリジンで Browser Use のダウンロードをブロックするには、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 |
フォールバックを使用するオリジンで、Browser Use が Always allow 承認を保存または適用できないようにするには、false に設定します。現在のターンまたはスレッドに対する承認は引き続き適用できます。true は、ほかの条件で許可されていれば Always allow を利用可能にしますが、承認は作成しません。 |
browser_use.default_origin_policy.uploads |
allow | deny |
フォールバックを使用するオリジンで Browser Use のアップロードをブロックするには、deny を使用します。allow は、通常の承認とポリシーのチェックの続行のみを許可します。 |
browser_use.disable_auto_review |
boolean |
Browser Use の自動レビューをスキップし、代わりにユーザーに承認を求めるには、true に設定します。false に設定するか省略した場合、ほかの設定で許可されていれば自動レビューを利用できます。 |
browser_use.origins |
map<string, table> |
オリジン固有の Browser Use ポリシーです。キーには、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 は各機能について最も制限の厳しい値を使用します。deny は allow より、false は true より、turn は thread より優先されます。 |
browser_use.origins.<pattern>.access |
allow | deny |
一致するオリジンで Browser Use をブロックするには、deny を使用します。拒否すると、そのオリジンでのアップロード、ダウンロード、完全なブラウザーデバッグアクセス、自動レビューもブロックされます。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 |
一致するオリジンで Browser Use のダウンロードをブロックするには、deny を使用します。allow は、通常の承認とポリシーのチェックの続行のみを許可します。 |
browser_use.origins.<pattern>.full_cdp_access |
allow | deny |
一致するオリジンで完全な Chrome DevTools Protocol(CDP)アクセスをブロックするには、deny を使用します。allow は、通常のオプトインと承認のチェックの続行のみを許可します。 |
browser_use.origins.<pattern>.persistent_approval |
boolean |
一致するオリジンで、Browser Use が Always allow 承認を保存または適用できないようにするには、false に設定します。現在のターンまたはスレッドに対する承認は引き続き適用できます。true は、ほかの条件で許可されていれば Always allow を利用可能にしますが、承認は作成しません。 |
browser_use.origins.<pattern>.uploads |
allow | deny |
一致するオリジンで Browser Use のアップロードをブロックするには、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 |
管理対象の macOS デバイスでユーザーが Locked Use を有効にできないようにするには、false に設定します。この要件は有効化のコントロールを削除しますが、すでに有効になっている 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 IDs(AUMIDs)を allow または deny に対応付けます。一致するルールは、同じポリシーソース内の computer_use.default_app_access を置き換えます。 |
computer_use.windows.aumids.<aumid> |
allow | deny |
完全一致するパッケージアプリの ID をブロックするには、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 はその実行ファイルをブロックします。 |
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 |
エージェントによる Browser Use を無効にするには、false を requirements.toml 内に設定します。 |
features.browser_use_external |
boolean |
ChatGPT ブラウザー拡張機能を通じて、Codex が既存のタブやログイン済みセッションを含む対応ブラウザーを操作できないようにするには、false を requirements.toml 内に設定します。 |
features.browser_use_full_cdp_access |
boolean |
Browser Developer モードを含む、ローカルランタイムでの完全な Chrome DevTools Protocol アクセスを無効にし、ChatGPT デスクトップアプリが対応する設定を有効にできないようにするには、false を requirements.toml 内に設定します。省略した場合、通常の製品の利用可否が適用されます。 |
features.computer_use |
boolean |
Computer Use、Record & Replay、および関連するインストールや有効化のフローを無効にするには、false を requirements.toml 内に設定します。 |
features.fast_mode |
boolean |
管理対象ユーザーの正式な fast_mode 機能を、有効または無効に固定します。 |
features.guardian_approval |
boolean |
管理対象ユーザーの Guardian 承認の利用可否を、有効または無効に固定します。 |
features.in_app_browser |
boolean |
ユーザーが直接開いて操作する組み込みブラウザーペインを無効にするには、false を requirements.toml 内に設定します。 |
features.in_app_chat |
boolean |
ChatGPT デスクトップアプリで ChatGPT と ChatGPT Work の会話画面、および関連するクラウド自動化 UI を非表示にするには、false に設定します。この設定は ChatGPT Voice をブロックせず、既存のクラウドタスクも停止しません。true に設定しても、アカウント、ワークスペースの権限、ロールアウトのチェックは回避されません。 |
features.in_app_dictation |
boolean |
デスクトップアプリのアプリ内音声入力を無効にするには、false に設定します。true に設定しても、ほかの利用可否のチェックは回避されません。 |
features.in_app_local_automation |
boolean |
デスクトップアプリのローカルのスケジュールタスクを無効にするには、false に設定します。true に設定しても、ほかの利用可否のチェックは回避されません。 |
features.in_app_updates |
boolean |
アプリ内更新を無効にするには、false を requirements.toml 内に設定します。この要件を省略した場合、更新はデフォルトで有効のままです。 |
features.memories |
boolean |
管理対象ユーザーの Memories の利用可否を、有効または無効に固定します。 |
features.multi_agent |
boolean |
管理対象ユーザーのマルチエージェントの利用可否を、有効または無効に固定します。 |
features.plugin_sharing |
boolean |
ローカルで作成されたプラグインのワークスペース共有を無効にするには、クラウド管理の設定で false を requirements.toml 内に設定します。 |
features.plugins |
boolean |
管理対象ユーザーのプラグインの利用可否を、有効または無効に固定します。 |
features.realtime_conversation |
boolean |
Codex CLI の試験的な /voice コマンドを無効にするには、false に設定します。デスクトップアプリの 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 |
マーケットプレイスのソースマッチャーの種類です。1 つのリポジトリには git、正規表現で照合する Git ホストには host_pattern、1 つのディレクトリには 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>)とその識別情報の両方が一致する必要があります。設定されている MCP serverのうち、許可リストにないもの、または識別情報が一致しないものは無効になります。 |
mcp_servers.<id>.identity |
table |
単一の MCP serverの識別ルールです。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 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 要件と同じ、完全一致の識別情報とマッチャー形式を使用します。 |
plugins.<plugin>.mcp_servers.<server>.identity |
table |
1 つのプラグイン同梱 MCP serverの識別ルールです。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.allowed_sandbox_implementations |
array<string> |
許可される従来のネイティブ Windows サンドボックス実装(elevated と unelevated)です。リストは空にできません。両方が許可され、モードが選択されていない場合、Codex は elevated を優先します。このリストは、mxc サンドボックスが利用可能な場合に、その利用を制限しません。 |
一致する設定オプションはありません。