構成リファレンス

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

`config.toml`

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

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

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

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

Key

agents

Type / Values

table

Details

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

Key

agents.<name>.config_file

Type / Values

string (path)

Details

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

Key

agents.<name>.description

Type / Values

string

Details

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

Key

agents.default_subagent_model

Type / Values

string

Details

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

Key

agents.default_subagent_reasoning_effort

Type / Values

string

Details

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

Key

agents.enabled

Type / Values

boolean

Details

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

Key

agents.interrupt_message

Type / Values

boolean

Details

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

Key

agents.max_concurrent_threads_per_session

Type / Values

number

Details

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

Key

agents.max_threads

Type / Values

number

Details

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

Key

allow_login_shell

Type / Values

boolean

Details

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

Key

analytics.enabled

Type / Values

boolean

Details

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

Key

approval_policy

Type / Values

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

Details

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

Key

approval_policy.granular.mcp_elicitations

Type / Values

boolean

Details

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

Key

approval_policy.granular.request_permissions

Type / Values

boolean

Details

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

Key

approval_policy.granular.rules

Type / Values

boolean

Details

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

Key

approval_policy.granular.sandbox_approval

Type / Values

boolean

Details

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

Key

approval_policy.granular.skill_approval

Type / Values

boolean

Details

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

Key

approvals_reviewer

Type / Values

user | auto_review

Details

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

Key

apps._default.approvals_reviewer

Type / Values

user | auto_review

Details

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

Key

apps._default.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

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

Key

apps._default.destructive_enabled

Type / Values

boolean

Details

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

Key

apps._default.enabled

Type / Values

boolean

Details

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

Key

apps._default.open_world_enabled

Type / Values

boolean

Details

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

Key

apps.<id>.approvals_reviewer

Type / Values

user | auto_review

Details

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

Key

apps.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

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

Key

apps.<id>.default_tools_enabled

Type / Values

boolean

Details

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

Key

apps.<id>.destructive_enabled

Type / Values

boolean

Details

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

Key

apps.<id>.enabled

Type / Values

boolean

Details

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

Key

apps.<id>.open_world_enabled

Type / Values

boolean

Details

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

Key

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

Type / Values

auto | prompt | writes | approve

Details

個々のアプリツールについて、承認に関する動作をツール単位で上書きする設定です。

Key

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

Type / Values

boolean

Details

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

Key

auto_review.policy

Type / Values

string

Details

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

Key

background_terminal_max_timeout

Type / Values

number

Details

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

Key

chatgpt_base_url

Type / Values

string

Details

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

Key

check_for_update_on_startup

Type / Values

boolean

Details

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

Key

cli_auth_credentials_store

Type / Values

file | keyring | auto

Details

CLI がキャッシュした認証情報の保存先（auth.json ファイルまたは OS のキーチェーン）を制御します。

Key

compact_prompt

Type / Values

string

Details

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

Key

computer_use.windows.always_allowed_app_ids

Type / Values

array<string>

Details

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

Key

default_permissions

Type / Values

string

Details

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

Key

desktop.custom_file_handlers.<id>

Type / Values

table

Details

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

Key

desktop.custom_file_handlers.<id>.args

Type / Values

array<string>

Details

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

Key

desktop.custom_file_handlers.<id>.command

Type / Values

string

Details

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

Key

desktop.custom_file_handlers.<id>.icon

Type / Values

string

Details

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

Key

desktop.custom_file_handlers.<id>.input

Type / Values

path | json_argument | json_stdin

Details

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

Key

desktop.custom_file_handlers.<id>.label

Type / Values

string

Details

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

Key

desktop.custom_file_handlers.<id>.supports_ssh

Type / Values

boolean

Details

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

Key

developer_instructions

Type / Values

string

Details

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

Key

disable_paste_burst

Type / Values

boolean

Details

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

Key

experimental_compact_prompt_file

Type / Values

string (path)

Details

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

Key

experimental_use_unified_exec_tool

Type / Values

boolean

Details

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

Key

features.apps

Type / Values

boolean

Details

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

Key

features.code_mode.direct_only_tool_namespaces

Type / Values

array<string>

Details

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

Key

features.code_mode.enabled

Type / Values

boolean

Details

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

Key

features.code_mode.excluded_tool_namespaces

Type / Values

array<string>

Details

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

Key

features.enable_request_compression

Type / Values

boolean

Details

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

Key

features.fast_mode

Type / Values

boolean

Details

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

Key

features.goals

Type / Values

boolean

Details

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

Key

features.hooks

Type / Values

boolean

Details

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

Key

features.memories

Type / Values

boolean

Details

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

Key

features.multi_agent

Type / Values

boolean

Details

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

Key

features.network_proxy

Type / Values

boolean | table

Details

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

Key

features.network_proxy.allow_local_binding

Type / Values

boolean

Details

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

Key

features.network_proxy.allow_upstream_proxy

Type / Values

boolean

Details

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

Key

features.network_proxy.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

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

Key

features.network_proxy.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

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

Key

features.network_proxy.domains

Type / Values

map<string, allow | deny>

Details

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

Key

features.network_proxy.enable_socks5

Type / Values

boolean

Details

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

Key

features.network_proxy.enable_socks5_udp

Type / Values

boolean

Details

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

Key

features.network_proxy.enabled

Type / Values

boolean

Details

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

Key

features.network_proxy.proxy_url

Type / Values

string

Details

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

Key

features.network_proxy.socks_url

Type / Values

string

Details

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

Key

features.network_proxy.unix_sockets

Type / Values

map<string, allow | deny>

Details

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

Key

features.personality

Type / Values

boolean

Details

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

Key

features.prevent_idle_sleep

Type / Values

boolean

Details

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

Key

features.remote_plugin

Type / Values

boolean

Details

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

Key

features.rollout_budget.enabled

Type / Values

boolean

Details

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

Key

features.rollout_budget.limit_tokens

Type / Values

integer

Details

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

Key

features.rollout_budget.prefill_token_weight

Type / Values

number

Details

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

Key

features.rollout_budget.reminder_interval_tokens

Type / Values

integer

Details

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

Key

features.rollout_budget.sampling_token_weight

Type / Values

number

Details

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

Key

features.shell_snapshot

Type / Values

boolean

Details

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

Key

features.shell_tool

Type / Values

boolean

Details

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

Key

features.skill_mcp_dependency_install

Type / Values

boolean

Details

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

Key

features.unified_exec

Type / Values

boolean

Details

PTY ベースの統合 exec ツールを使用します。安定版の機能で、Windows 以外ではデフォルトで有効です。

Key

features.web_search

Type / Values

boolean

Details

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

Key

features.web_search_cached

Type / Values

boolean

Details

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

Key

features.web_search_request

Type / Values

boolean

Details

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

Key

feedback.enabled

Type / Values

boolean

Details

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

Key

file_opener

Type / Values

vscode | vscode-insiders | windsurf | cursor | none

Details

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

Key

forced_chatgpt_workspace_id

Type / Values

string (uuid)

Details

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

Key

forced_login_method

Type / Values

chatgpt | api

Details

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

Key

hide_agent_reasoning

Type / Values

boolean

Details

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

Key

history.max_bytes

Type / Values

number

Details

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

Key

history.persistence

Type / Values

save-all | none

Details

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

Key

hooks

Type / Values

table

Details

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

Key

hooks.<Event>

Type / Values

array<table>

Details

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

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

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

Key

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

Type / Values

integer

Details

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

Key

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

Type / Values

boolean

Details

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

Key

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

Type / Values

string

Details

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

Key

instructions

Type / Values

string

Details

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

Key

log_dir

Type / Values

string (path)

Details

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

Key

mcp_oauth_callback_port

Type / Values

integer

Details

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

Key

mcp_oauth_callback_url

Type / Values

string

Details

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

Key

mcp_oauth_credentials_store

Type / Values

auto | file | keyring

Details

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

Key

mcp_servers.<id>.args

Type / Values

array<string>

Details

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

Key

mcp_servers.<id>.auth

Type / Values

oauth | chatgpt

Details

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

Key

mcp_servers.<id>.bearer_token_env_var

Type / Values

string

Details

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

Key

mcp_servers.<id>.command

Type / Values

string

Details

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

Key

mcp_servers.<id>.cwd

Type / Values

string

Details

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

Key

mcp_servers.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

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

Key

mcp_servers.<id>.disabled_tools

Type / Values

array<string>

Details

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

Key

mcp_servers.<id>.enabled

Type / Values

boolean

Details

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

Key

mcp_servers.<id>.enabled_tools

Type / Values

array<string>

Details

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

Key

mcp_servers.<id>.env

Type / Values

map<string,string>

Details

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

Key

mcp_servers.<id>.env_http_headers

Type / Values

map<string,string>

Details

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

Key

mcp_servers.<id>.env_vars

Type / Values

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

Details

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

Key

mcp_servers.<id>.experimental_environment

Type / Values

local | remote

Details

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

Key

mcp_servers.<id>.http_headers

Type / Values

map<string,string>

Details

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

Key

mcp_servers.<id>.oauth_resource

Type / Values

string

Details

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

Key

mcp_servers.<id>.oauth.callback_port

Type / Values

integer

Details

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

Key

mcp_servers.<id>.oauth.callback_url

Type / Values

string

Details

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

Key

mcp_servers.<id>.oauth.client_id

Type / Values

string

Details

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

Key

mcp_servers.<id>.required

Type / Values

boolean

Details

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

Key

mcp_servers.<id>.scopes

Type / Values

array<string>

Details

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

Key

mcp_servers.<id>.startup_timeout_ms

Type / Values

number

Details

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

Key

mcp_servers.<id>.startup_timeout_sec

Type / Values

number

Details

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

Key

mcp_servers.<id>.tool_timeout_sec

Type / Values

number

Details

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

Key

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

Type / Values

auto | prompt | writes | approve

Details

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

Key

mcp_servers.<id>.url

Type / Values

string

Details

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

Key

memories.consolidation_model

Type / Values

string

Details

メモリのグローバル統合に使用するモデルを上書きする任意の設定です。

Key

memories.disable_on_external_context

Type / Values

boolean

Details

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

Key

memories.extract_model

Type / Values

string

Details

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

Key

memories.generate_memories

Type / Values

boolean

Details

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

Key

memories.max_raw_memories_for_consolidation

Type / Values

number

Details

グローバル統合のために保持する、最近の未加工メモリの最大件数です。デフォルトは 256 で、上限は 4096 です。

Key

memories.max_rollout_age_days

Type / Values

number

Details

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

Key

memories.max_rollouts_per_startup

Type / Values

number

Details

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

Key

memories.max_unused_days

Type / Values

number

Details

メモリが最後に使用されてから、統合の対象外となるまでの最大日数です。デフォルトは 30 で、0～365 の範囲内に補正されます。

Key

memories.min_rate_limit_remaining_percent

Type / Values

number

Details

Codex のレート制限ウィンドウで、メモリ生成の開始に必要な残り利用枠の最小割合（%）です。デフォルトは 25 で、0～100 の範囲内に補正されます。

Key

memories.min_rollout_idle_hours

Type / Values

number

Details

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

Key

memories.use_memories

Type / Values

boolean

Details

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

Key

model

Type / Values

string

Details

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

Key

model_auto_compact_token_limit

Type / Values

number

Details

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

Key

model_auto_compact_token_limit_scope

Type / Values

total | body_after_prefix

Details

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

Key

model_catalog_json

Type / Values

string (path)

Details

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

Key

model_context_window

Type / Values

number

Details

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

Key

model_instructions_file

Type / Values

string (path)

Details

AGENTS.md ではなく、組み込みの指示を置き換える設定です。

Key

model_provider

Type / Values

string

Details

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

Key

model_providers.<id>

Type / Values

table

Details

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

Key

model_providers.<id>.auth

Type / Values

table

Details

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

Key

model_providers.<id>.auth.args

Type / Values

array<string>

Details

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

Key

model_providers.<id>.auth.command

Type / Values

string

Details

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

Key

model_providers.<id>.auth.cwd

Type / Values

string (path)

Details

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

Key

model_providers.<id>.auth.refresh_interval_ms

Type / Values

number

Details

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

Key

model_providers.<id>.auth.timeout_ms

Type / Values

number

Details

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

Key

model_providers.<id>.base_url

Type / Values

string

Details

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

Key

model_providers.<id>.env_http_headers

Type / Values

map<string,string>

Details

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

Key

model_providers.<id>.env_key

Type / Values

string

Details

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

Key

model_providers.<id>.env_key_instructions

Type / Values

string

Details

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

Key

model_providers.<id>.experimental_bearer_token

Type / Values

string

Details

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

Key

model_providers.<id>.http_headers

Type / Values

map<string,string>

Details

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

Key

model_providers.<id>.name

Type / Values

string

Details

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

Key

model_providers.<id>.query_params

Type / Values

map<string,string>

Details

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

Key

model_providers.<id>.request_max_retries

Type / Values

number

Details

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

Key

model_providers.<id>.requires_openai_auth

Type / Values

boolean

Details

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

Key

model_providers.<id>.stream_idle_timeout_ms

Type / Values

number

Details

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

Key

model_providers.<id>.stream_max_retries

Type / Values

number

Details

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

Key

model_providers.<id>.supports_standalone_web_search

Type / Values

boolean

Details

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

Key

model_providers.<id>.supports_websockets

Type / Values

boolean

Details

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

Key

model_providers.<id>.wire_api

Type / Values

responses

Details

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

Key

model_providers.amazon-bedrock.aws.profile

Type / Values

string

Details

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

Key

model_providers.amazon-bedrock.aws.region

Type / Values

string

Details

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

Key

model_reasoning_effort

Type / Values

minimal | low | medium | high | xhigh

Details

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

Key

model_reasoning_summary

Type / Values

auto | concise | detailed | none

Details

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

Key

model_supports_reasoning_summaries

Type / Values

boolean

Details

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

Key

model_verbosity

Type / Values

low | medium | high

Details

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

Key

notice.hide_full_access_warning

Type / Values

boolean

Details

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

Key

notice.hide_gpt-5.1-codex-max_migration_prompt

Type / Values

boolean

Details

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

Key

notice.hide_gpt5_1_migration_prompt

Type / Values

boolean

Details

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

Key

notice.hide_rate_limit_model_nudge

Type / Values

boolean

Details

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

Key

notice.hide_world_writable_warning

Type / Values

boolean

Details

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

Key

notice.model_migrations

Type / Values

map<string,string>

Details

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

Key

notify

Type / Values

array<string>

Details

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

Key

openai_base_url

Type / Values

string

Details

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

Key

oss_provider

Type / Values

lmstudio | ollama

Details

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

Key

otel.environment

Type / Values

string

Details

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

Key

otel.exporter

Type / Values

none | otlp-http | otlp-grpc

Details

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

Key

otel.exporter.<id>.endpoint

Type / Values

string

Details

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

Key

otel.exporter.<id>.headers

Type / Values

map<string,string>

Details

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

Key

otel.exporter.<id>.protocol

Type / Values

binary | json

Details

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

Key

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

Type / Values

string

Details

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

Key

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

Type / Values

string

Details

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

Key

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

Type / Values

string

Details

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

Key

otel.log_user_prompt

Type / Values

boolean

Details

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

Key

otel.metrics_exporter

Type / Values

none | statsig | otlp-http | otlp-grpc

Details

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

Key

otel.trace_exporter

Type / Values

none | otlp-http | otlp-grpc

Details

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

Key

otel.trace_exporter.<id>.endpoint

Type / Values

string

Details

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

Key

otel.trace_exporter.<id>.headers

Type / Values

map<string,string>

Details

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

Key

otel.trace_exporter.<id>.protocol

Type / Values

binary | json

Details

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

Key

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

Type / Values

string

Details

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

Key

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

Type / Values

string

Details

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

Key

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

Type / Values

string

Details

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

Key

permissions.<name>.description

Type / Values

string

Details

この名前付きプロファイルに付ける、人が読める形式の説明です。プロファイルは extends を通じて親プロファイルの説明を継承しません。

Key

permissions.<name>.extends

Type / Values

string

Details

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

Key

permissions.<name>.filesystem

Type / Values

table

Details

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

Key

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

Type / Values

"read" | "write" | "deny"

Details

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

Key

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

Type / Values

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

Details

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

Key

permissions.<name>.filesystem.glob_scan_max_depth

Type / Values

number

Details

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

Key

permissions.<name>.network.allow_local_binding

Type / Values

boolean

Details

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

Key

permissions.<name>.network.allow_upstream_proxy

Type / Values

boolean

Details

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

Key

permissions.<name>.network.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

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

Key

permissions.<name>.network.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

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

Key

permissions.<name>.network.domains

Type / Values

table

Details

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

Key

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

Type / Values

allow | deny

Details

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

Key

permissions.<name>.network.enable_socks5

Type / Values

boolean

Details

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

Key

permissions.<name>.network.enable_socks5_udp

Type / Values

boolean

Details

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

Key

permissions.<name>.network.enabled

Type / Values

boolean

Details

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

Key

permissions.<name>.network.mode

Type / Values

limited | full

Details

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

Key

permissions.<name>.network.proxy_url

Type / Values

string

Details

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

Key

permissions.<name>.network.socks_url

Type / Values

string

Details

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

Key

permissions.<name>.network.unix_sockets

Type / Values

table

Details

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

Key

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

Type / Values

allow | deny

Details

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

Key

permissions.<name>.workspace_roots

Type / Values

table

Details

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

Key

permissions.<name>.workspace_roots.<path>

Type / Values

boolean

Details

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

Key

personality

Type / Values

none | friendly | pragmatic

Details

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

Key

plan_mode_reasoning_effort

Type / Values

Details

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

Key

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

Type / Values

auto | prompt | writes | approve

Details

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

Key

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

Type / Values

array<string>

Details

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

Key

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

Type / Values

boolean

Details

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

Key

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

Type / Values

array<string>

Details

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

Key

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

Type / Values

auto | prompt | writes | approve

Details

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

Key

project_doc_fallback_filenames

Type / Values

array<string>

Details

AGENTS.md が見つからない場合に試す追加のファイル名です。

Key

project_doc_max_bytes

Type / Values

number

Details

プロジェクト用の指示を構築する際に AGENTS.md から読み取る最大バイト数です。

Key

project_root_markers

Type / Values

array<string>

Details

プロジェクトルートを示すマーカーファイル名の一覧です。親ディレクトリをたどってプロジェクトルートを探す際に使用します。

Key

projects.<path>.trust_level

Type / Values

string

Details

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

Key

review_model

Type / Values

string

Details

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

Key

sandbox_mode

Type / Values

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

Details

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

Key

sandbox_workspace_write.exclude_slash_tmp

Type / Values

boolean

Details

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

Key

sandbox_workspace_write.exclude_tmpdir_env_var

Type / Values

boolean

Details

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

Key

sandbox_workspace_write.network_access

Type / Values

boolean

Details

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

Key

sandbox_workspace_write.writable_roots

Type / Values

array<string>

Details

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

Key

service_tier

Type / Values

string

Details

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

Key

shell_environment_policy.exclude

Type / Values

array<string>

Details

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

Key

shell_environment_policy.experimental_use_profile

Type / Values

boolean

Details

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

Key

shell_environment_policy.filters

Type / Values

map<string, include | exclude>

Details

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

Key

shell_environment_policy.ignore_default_excludes

Type / Values

boolean

Details

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

Key

shell_environment_policy.include_only

Type / Values

array<string>

Details

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

Key

shell_environment_policy.inherit

Type / Values

all | core | none

Details

サブプロセスの生成時に継承する環境の基本設定です。

Key

shell_environment_policy.set

Type / Values

map<string,string>

Details

除外処理後に挿入される、明示的に指定した環境変数の値です。ただし、include フィルターによって除外される場合があります。

Key

show_raw_agent_reasoning

Type / Values

boolean

Details

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

Key

skills.config

Type / Values

array<object>

Details

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

Key

skills.config.<index>.enabled

Type / Values

boolean

Details

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

Key

skills.config.<index>.path

Type / Values

string (path)

Details

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

Key

sqlite_home

Type / Values

string (path)

Details

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

Key

suppress_unstable_features_warning

Type / Values

boolean

Details

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

Key

tool_output_token_limit

Type / Values

number

Details

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

Key

tool_suggest.disabled_tools

Type / Values

array<table>

Details

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

Key

tool_suggest.discoverables

Type / Values

array<table>

Details

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

Key

tools.view_image

Type / Values

boolean

Details

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

Key

tools.web_search

Type / Values

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

Details

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

Key

tui

Type / Values

table

Details

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

Key

tui.alternate_screen

Type / Values

auto | always | never

Details

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

Key

tui.animations

Type / Values

boolean

Details

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

Key

tui.keymap.<context>.<action>

Type / Values

string | array<string>

Details

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

Key

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

Type / Values

empty array

Details

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

Key

tui.model_availability_nux.<model>

Type / Values

integer

Details

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

Key

tui.notification_condition

Type / Values

unfocused | always

Details

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

Key

tui.notification_method

Type / Values

auto | osc9 | bel

Details

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

Key

tui.notifications

Type / Values

boolean | array<string>

Details

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

Key

tui.raw_output_mode

Type / Values

boolean

Details

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

Key

tui.resume_cwd

Type / Values

current | session

Details

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

Key

tui.show_tooltips

Type / Values

boolean

Details

TUI のウェルカム画面にオンボーディングのツールチップを表示します。デフォルトは true です。

Key

tui.status_line

Type / Values

array<string> | null

Details

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

Key

tui.terminal_title

Type / Values

array<string> | null

Details

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

Key

tui.theme

Type / Values

string

Details

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

Key

tui.vim_mode_default

Type / Values

boolean

Details

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

Key

web_search

Type / Values

disabled | cached | indexed | live

Details

ウェブ検索のモードです。デフォルトは "cached" です。cached は外部ウェブにアクセスせず、OpenAI が管理するインデックスを使用します。indexed は、検索インデックスによる制御の下でのみ外部アクセスを許可します。--yolo またはその他のフルアクセスサンドボックス設定を使用すると、デフォルトは "live" になります。制限のないライブ取得には "live" を使用し、ツールを削除するには "disabled" を使用します。

Key

windows_wsl_setup_acknowledged

Type / Values

boolean

Details

Windows のオンボーディングを確認済みかどうかを記録します（Windows のみ）。

Key

windows.sandbox

Type / Values

unelevated | elevated

Details

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

Key

windows.sandbox_private_desktop

Type / Values

boolean

Details

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

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

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

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

注：experimental_instructions_file の名前を model_instructions_file に変更してください。Codex では古いキーが非推奨となっているため、既存の構成を新しい名前に更新してください。

`requirements.toml`

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

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

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

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

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

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

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

Key	Type / Values	Details
`allow_appshots`	`boolean`	`false` に設定すると、管理対象ユーザーの Appshots が無効になります。省略した場合、Appshots は要件による制約を受けず、製品の通常の提供状況に従います。
`allow_login_shell`	`boolean`	シェルツールがログインシェルを起動できるかどうかの設定を強制適用します。
`allow_managed_hooks_only`	`boolean`	`true` の場合、Codex はユーザー、プロジェクト、セッション、プラグインの各フックをスキップしますが、`requirements.toml` およびその他の管理対象設定レイヤーからの管理対象フックは引き続き許可します。
`allow_remote_control`	`boolean`	`false` に設定すると、管理対象ユーザーのデバイスのリモート制御が無効になります。省略した場合、デバイスのリモート制御は要件による制約を受けず、製品の通常の提供状況に従います。
`allowed_approval_policies`	`array<string>`	`approval_policy` で許可される値（例：`untrusted`、`on-request`、`never`、`granular`）です。
`allowed_approvals_reviewers`	`array<string>`	`approvals_reviewer` で許可される値（`user`、`auto_review` など）です。
`allowed_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`	アプリの個別ツールに適用する、管理者指定の承認モードを設定します。
`check_for_update_on_startup`	`boolean`	Codex が起動時に更新を確認するかどうかの設定を強制適用します。
`computer_use`	`table`	`requirements.toml` によって強制される、コンピューターの使用に関する要件です。
`computer_use.allow_locked_computer_use`	`boolean`	管理対象の macOS デバイスがロックされた後にコンピューターの使用が動作しないようにするには、`false` に設定します。省略した場合、ロック中の使用は要件による制約を受けません。
`default_permissions`	`string`	管理対象のデフォルト権限プロファイルです。このプロファイルは `allowed_permission_profiles` で許可されている必要があります。動作を予測しやすくするため、明示的に設定してください。省略した場合、`:workspace` と `:read-only` の両方が明示的に許可されている場合に限り、Codex は `:workspace` をデフォルトにします。
`enforce_residency`	`string`	Codex サービスのトラフィックで、サポート対象のデータレジデンシーを使用することを必須とします。現在は `us` を指定できます。
`experimental_network`	`table`	サンドボックス内のローカルコマンドに対して管理者が管理するネットワーク要件で、`requirements.toml` によって強制されます。これらの要件を有効にすると、`features.network_proxy` がなくてもコマンド用ネットワークプロキシを起動できます。これらの要件は、ウェブ検索、アプリ、MCP サーバー、ブラウザ、Codex Cloud のネットワーク通信を制御しません。
`experimental_network.allow_local_binding`	`boolean`	サンドボックス内のネットワーク通信で、より広範なローカルネットワークまたはプライベートネットワークへのアクセスを許可します。これが `false` のままでも、ローカル IP アドレスのリテラルまたは `localhost` を完全一致で指定する許可ルールにより、特定のローカル宛先へのアクセスを許可できます。
`experimental_network.allow_upstream_proxy`	`boolean`	サンドボックス内のネットワーク通信が、環境で指定されたアップストリームプロキシを経由してチェーン接続できるようにします。
`experimental_network.allowed_domains`	`array<string>`	管理対象のネットワークプロキシが有効な場合に、サンドボックス内のコマンドのネットワーク通信に適用される管理者の許可ルールです。これらのルールは、ウェブ検索、アプリ、MCP サーバーには適用されません。`experimental_network.domains` と併用しないでください。
`experimental_network.dangerously_allow_all_unix_sockets`	`boolean`	アクセス先を許可リストに限定せず、任意の Unix ソケットへのアクセスを許可します。厳密に管理された環境でのみ使用してください。
`experimental_network.dangerously_allow_non_loopback_proxy`	`boolean`	`[experimental_network]` 要件でループバック以外のリスナーアドレスを許可します。有効にすると、localhost 以外からリスナーにアクセスできるようになる可能性があります。
`experimental_network.denied_domains`	`array<string>`	サンドボックス内のネットワーク通信に対する、リスト形式の管理者の拒否ルールです。`experimental_network.domains` と併用しないでください。
`experimental_network.domains`	`map<string, allow \| deny>`	サンドボックス内のネットワーク通信に対して管理者が設定する、マップ形式のドメインポリシーです。完全一致のホスト指定、サブドメインのみを対象とする `.example.com`、ルートドメインとサブドメインを対象とする `.example.com`、すべてを対象とする `` の許可ルールに対応しています。`*` はパブリックネットワークへのアウトバウンドアクセスを広く許可するため、対象を限定したルールを推奨します。競合時は `deny` が優先されます。`experimental_network.allowed_domains` または `experimental_network.denied_domains` と併用しないでください。
`experimental_network.enabled`	`boolean`	サンドボックス内のネットワーク通信に関する要件を有効にします。使用中のサンドボックスでコマンドのネットワーク通信が無効な場合、この設定によってネットワークアクセスが許可されることはありません。
`experimental_network.http_port`	`integer`	`[experimental_network]` 要件で使用するループバック HTTP リスナーポートです。
`experimental_network.managed_allowed_domains_only`	`boolean`	`true` の場合、サンドボックス内のネットワーク通信に関する要件が有効な間は、管理者が管理する許可ルールだけが有効となり、ユーザーが許可リストに追加したルールは無視されます。管理対象の許可ルールがない場合でも、ユーザーが追加したドメイン許可ルールは無効です。
`experimental_network.socks_port`	`integer`	`[experimental_network]` 要件で使用するループバック SOCKS5 リスナーポートです。
`experimental_network.unix_sockets`	`map<string, allow \| deny>`	サンドボックス内のネットワーク通信に対して管理者が管理する Unix ソケットポリシーです。
`features`	`table`	機能の固定値です。ランタイム機能には `config.toml` の正規名を使用します。ドキュメントに記載されたアプリ専用の要件キーにも対応しています。
`features.<name>`	`boolean`	ドキュメントに記載されたランタイム機能またはアプリ機能を、有効または無効の状態に固定します。
`features.apps`	`boolean`	管理対象ユーザー向けに、アプリ連携の利用可否を固定します。
`features.browser_use`	`boolean`	`requirements.toml` で `false` に設定すると、ブラウザでのコンピューターの使用とブラウザエージェントの利用が無効になります。
`features.browser_use_external`	`boolean`	`requirements.toml` で `false` に設定すると、外部ブラウザでのコンピューターの使用が無効になります。
`features.browser_use_full_cdp_access`	`boolean`	`requirements.toml` で `false` に設定すると、ブラウザ開発者モードを含むローカルランタイムでの Chrome DevTools Protocol へのフルアクセスが無効になり、ChatGPT デスクトップアプリで対応する設定を有効にできなくなります。省略した場合は、製品の通常の提供状況が適用されます。
`features.computer_use`	`boolean`	`requirements.toml` で `false` に設定すると、コンピューターの使用、記録と再生、および関連するインストールや有効化のフローが無効になります。
`features.fast_mode`	`boolean`	管理対象ユーザー向けに、正規の `fast_mode` 機能の有効・無効を固定します。
`features.guardian_approval`	`boolean`	管理対象ユーザー向けに、Guardian 承認の利用可否を固定します。
`features.in_app_browser`	`boolean`	`requirements.toml` で `false` に設定すると、組み込みのブラウザペインが無効になります。
`features.in_app_updates`	`boolean`	`requirements.toml` で `false` に設定すると、アプリ内アップデートが無効になります。この要件を省略した場合、アップデートはデフォルトで有効なままです。
`features.memories`	`boolean`	管理対象ユーザー向けに、メモリの利用可否を固定します。
`features.multi_agent`	`boolean`	管理対象ユーザー向けに、マルチエージェント機能の利用可否を固定します。
`features.plugin_sharing`	`boolean`	クラウドで管理される `requirements.toml` で `false` に設定すると、ローカルでビルドしたプラグインのワークスペース共有が無効になります。
`features.plugins`	`boolean`	管理対象ユーザー向けに、プラグインの利用可否を固定します。
`features.remote_plugin`	`boolean`	管理対象ユーザー向けに、リモートプラグインカタログの利用可否を固定します。
`features.workspace_dependencies`	`boolean`	管理対象ユーザー向けに、同梱のワークスペース依存関係用ランタイムの利用可否を固定します。
`feedback`	`table`	管理対象のフィードバック設定です。
`feedback.enabled`	`boolean`	Codex のすべてのクライアントで、ユーザーがフィードバックを送信できるかどうかの設定を強制適用します。
`guardian_policy_config`	`string`	自動レビューに使用する、管理対象の Markdown 形式のポリシー指示です。ローカルの `[auto_review].policy` より優先されます。空の値は無視されます。
`hooks`	`table`	管理者によって強制される管理対象のライフサイクルフックです。管理対象フックのディレクトリが必要で、`config.toml` にインラインで記述する `[hooks]` と同じイベントスキーマを使用します。
`hooks.<Event>`	`array<table>`	`PreToolUse`、`PermissionRequest`、`PostToolUse`、`PreCompact`、`PostCompact`、`SessionStart`、`SessionEnd`、`SubagentStart`、`SubagentStop`、`UserPromptSubmit`、`Stop` などのフックイベント用マッチャーグループです。
`hooks.<Event>[].hooks`	`array<table>`	マッチャーグループのフックハンドラーです。コマンドフックと MCP ツールフックがサポートされています。プロンプトフックとエージェントフックのハンドラーは解析されますが、スキップされます。
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	サイズの大きい `additionalContext` をディスクに保存し、モデルには短いプレビューを提示するための、ハンドラーごとのおおよそのトークン数のしきい値です。デフォルトは `2500` です。`0` を指定すると、コンテキスト全体がモデルに直接渡されます。サイズの大きいフック出力を参照してください。
`hooks.<Event>[].hooks[].async`	`boolean`	トリガーとなった処理を遅らせず、コマンドフックをバックグラウンドで実行します。デフォルトは `false` です。`SessionEnd` は常に同期的に実行されます。バックグラウンドでのフック実行を参照してください。
`hooks.<Event>[].hooks[].commandWindows`	`string`	コマンドフックのコマンドを Windows 用に上書きする設定です。TOML のエイリアス `command_windows` も使用できます。
`hooks.managed_dir`	`string (absolute path)`	macOS および Linux で管理対象フックスクリプトを格納するディレクトリです。Codex は管理対象フックを読み込む前に、そのパスが絶対パスであり、ディレクトリが存在することを検証します。
`hooks.windows_managed_dir`	`string (absolute path)`	Windows で管理対象フックスクリプトを格納するディレクトリです。Codex は管理対象フックを読み込む前に、そのパスが絶対パスであり、ディレクトリが存在することを検証します。
`log_dir`	`string (path)`	Codex がローカルログファイルを書き込むディレクトリを固定します。
`marketplaces`	`table`	プラグインマーケットプレイスのソースに関する管理者要件です。`restrict_to_allowed_sources` が `true` の場合にルールが適用されます。
`marketplaces.allowed_sources`	`table`	管理者が選択したルール名をキーとする、許可されたマーケットプレイスソースです。異なる名前のエントリは要件レイヤー間で集約されます。同じ名前のエントリ内のフィールドには、通常のレイヤーの優先順位が適用されます。
`marketplaces.allowed_sources.<name>`	`table`	許可するソースを定義する単一のルールです。要件のマージ後に確定した `source` の値によって、Codex が同じ階層のどのフィールドを解釈するかが決まります。
`marketplaces.allowed_sources.<name>.host_pattern`	`string`	`source = "host_pattern"` の場合に必要な正規表現です。Codex は、HTTPS、SSH または SCP 形式の Git ソースから抽出した小文字のホスト名に対して照合します。ホスト名全体との一致を必須にするには、`^` と `$` を使用します。
`marketplaces.allowed_sources.<name>.path`	`string (absolute path)`	`source = "local"` の場合に必要なローカルマーケットプレイスのディレクトリです。Codex では絶対パスが必須で、正規化後のパス同士を比較します。
`marketplaces.allowed_sources.<name>.ref`	`string`	`git` ルールで完全一致させる Git ref です（省略可）。省略すると、一致するリポジトリのすべての ref が許可されます。
`marketplaces.allowed_sources.<name>.source`	`git \| host_pattern \| local`	マーケットプレイスソースのマッチャーの種類です。単一のリポジトリには `git`、正規表現で照合する Git ホストには `host_pattern`、単一のディレクトリには `local` を使用します。
`marketplaces.allowed_sources.<name>.url`	`string`	`source = "git"` の場合に必要な Git リポジトリの URL です。Codex は設定された URL と許可された URL を正規化したうえで、リポジトリの完全一致を必須とします。
`marketplaces.restrict_to_allowed_sources`	`boolean`	`true` の場合、マーケットプレイスの追加、プラグインのインストール、設定済み Git マーケットプレイスの更新を行うには、ユーザーが設定したマーケットプレイスのソースが `allowed_sources` と一致している必要があります。Codex が管理する OpenAI マーケットプレイスは、ソースと名前が予約済みの値に一致していれば、引き続き許可されます。この設定では、ユーザーが設定済みのマーケットプレイスは実行時にフィルタリングされません。
`mcp_servers`	`table`	有効化できる MCP サーバーの許可リストです。MCP サーバーを有効にするには、サーバー名（`<id>`）と識別情報の両方が一致する必要があります。設定済みの MCP サーバーであっても、許可リストに含まれない場合や識別情報が一致しない場合は無効になります。
`mcp_servers.<id>.identity`	`table`	単一の MCP サーバーの識別ルールです。`command`（stdio）または `url`（streamable HTTP）のいずれかを設定します。
`mcp_servers.<id>.identity.command`	`string \| table`	コマンド文字列の完全一致により stdio 方式の MCP サーバーを許可するか、マッチャーテーブルを使用して、実行可能ファイルの完全一致と順序付き引数マッチャーによる照合を必須にします。文字列形式では、引数、`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 文字列の完全一致により streamable HTTP 方式の MCP サーバーを許可するか、`exact`、`prefix`、`regex` の値マッチャーテーブルを使用します。
`mcp_servers.<id>.identity.url.expression`	`string`	`regex` URL マッチャーで使用する正規表現です。正規表現は有効で、URL 値全体に一致する必要があります。
`mcp_servers.<id>.identity.url.match`	`exact \| prefix \| regex`	設定された MCP サーバーの URL に対する照合方法です。
`mcp_servers.<id>.identity.url.value`	`string`	`exact` または `prefix` URL マッチャーで使用する値です。
`model_catalog_json`	`string (path)`	Codex が起動時に使用する JSON モデルカタログを固定します。
`models`	`table`	新しいスレッドに適用する、管理者が指定したモデルのデフォルト値です。これらの値はユーザーおよびプロジェクトのデフォルト値より優先されますが、新しいスレッドで明示的に選択すれば上書きできます。
`models.new_thread`	`table`	新しいローカルスレッドの開始時に適用するデフォルト値です。各モデル設定は省略できます。
`models.new_thread.model`	`string`	新しいスレッドのデフォルトモデルです。明示的に指定した `--model`、またはモデルや推論に関する `--config` のオーバーライドが優先されます。
`models.new_thread.model_reasoning_effort`	`string`	新しいスレッドのデフォルトの推論強度です。モデルまたは推論強度を明示的にオーバーライドすると、管理対象のモデルフィールドは両方ともスキップされます。
`models.new_thread.service_tier`	`string`	新しいスレッドのデフォルトのサービスティアです。モデルフィールドとは独立して、明示的なサービスティアのオーバーライドが優先されます。
`permissions`	`table`	プロファイル名をキーとする、管理者定義の権限プロファイルです。`config.toml` と同じプロファイルフィールドを使用します。
`permissions.<name>`	`table`	管理者定義の権限プロファイルです。名前を `:` で始めたり、予約名の `filesystem` を使用したり、読み込まれた構成のプロファイル名と重複させたりすることはできません。`config.toml` と同じプロファイルフィールドを使用します。完全なプロファイルスキーマについては、権限ガイドを参照してください。
`permissions.filesystem.deny_read`	`array<string>`	管理者が強制するファイルシステムの読み取り拒否ルールです。エントリにはパスまたは glob パターンを指定でき、ユーザーがローカル設定で制約を緩和することはできません。
`plugins`	`table`	プラグイン識別子をキーとする、プラグイン固有の MCP サーバー許可リストです。このテーブルが存在する場合、プラグインとサーバーの両方に対応するエントリが揃っていないプラグイン同梱サーバーは無効になります。
`plugins.<plugin>.mcp_servers`	`table`	1 つのプラグインに同梱された MCP サーバーの許可リストです。プラグインサーバーの要件では、識別情報の完全一致とマッチャーによる照合に、最上位の `mcp_servers` 要件と同じ形式を使用します。
`plugins.<plugin>.mcp_servers.<server>.identity`	`table`	プラグインに同梱された 1 つの MCP サーバーの識別ルールです。`command`（stdio）または `url`（streamable HTTP）のいずれかを設定します。
`plugins.<plugin>.mcp_servers.<server>.identity.command`	`string \| table`	プラグインの stdio MCP サーバーをコマンド文字列の完全一致で許可するか、マッチャーテーブルを使用して実行ファイルの完全一致と引数ごとの順序どおりの照合を必須にします。
`plugins.<plugin>.mcp_servers.<server>.identity.command.args`	`array<table>`	プラグインにバンドルされた stdio サーバーの引数を順序どおりに照合するマッチャーです。設定された引数リストはマッチャーのリストと同じ長さで、すべての位置で一致する必要があります。
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression`	`string`	`regex` 引数マッチャーで使用する正規表現です。引数の値全体に一致する必要があります。
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match`	`exact \| prefix \| regex`	この引数位置で使用する照合操作です。
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value`	`string`	`exact` または `prefix` の引数マッチャーで使用する値です。
`plugins.<plugin>.mcp_servers.<server>.identity.command.executable`	`string`	プラグインにバンドルされた stdio サーバーの設定済みコマンドと完全一致させる実行ファイルです。
`plugins.<plugin>.mcp_servers.<server>.identity.url`	`string \| table`	プラグインのストリーミング対応 HTTP MCP サーバーを完全一致の URL 文字列で許可するか、`exact`、`prefix`、`regex` のいずれかを指定した値マッチャーテーブルを使用します。
`plugins.<plugin>.mcp_servers.<server>.identity.url.expression`	`string`	`regex` URL マッチャーで使用する正規表現です。URL の値全体に一致する必要があります。
`plugins.<plugin>.mcp_servers.<server>.identity.url.match`	`exact \| prefix \| regex`	プラグインにバンドルされた MCP サーバーの URL に対する照合操作です。
`plugins.<plugin>.mcp_servers.<server>.identity.url.value`	`string`	`exact` または `prefix` の URL マッチャーで使用する値です。
`remote_sandbox_config`	`array<table>`	ホスト固有のサンドボックス要件です。解決されたホスト名に `hostname_patterns` が一致する最初のエントリが、その要件ソースの最上位の `allowed_sandbox_modes` を上書きします。現在、ホスト固有のエントリが上書きするのはサンドボックスモードのみです。
`remote_sandbox_config[].allowed_sandbox_modes`	`array<string>`	このホスト固有のエントリに一致した場合に適用される、許可されたサンドボックスモードです。
`remote_sandbox_config[].hostname_patterns`	`array<string>`	大文字と小文字を区別しないホスト名パターンです。任意の文字列に一致する `*` と、1 文字に一致する `?` に対応しています。
`rules`	`table`	`.rules` ファイルとマージされる、管理者が強制適用するコマンドルールです。要件のルールは制限を課すものでなければなりません。
`rules.prefix_rules`	`array<table>`	強制適用されるプレフィックスルールのリストです。各ルールには `pattern` と `decision` を含める必要があります。
`rules.prefix_rules[].decision`	`prompt \| forbidden`	必須です。要件のルールで指定できるのは、承認を求めるか禁止するかのいずれかだけで、許可は指定できません。
`rules.prefix_rules[].justification`	`string`	承認プロンプトまたは拒否メッセージに表示する理由です。省略できますが、指定する場合は空にできません。
`rules.prefix_rules[].pattern`	`array<table>`	パターントークンで表現するコマンドプレフィックスです。各トークンには `token` または `any_of` のいずれかを設定します。
`rules.prefix_rules[].pattern[].any_of`	`array<string>`	この位置で選択肢として許可するトークンのリストです。
`rules.prefix_rules[].pattern[].token`	`string`	この位置に指定する単一のリテラルトークンです。
`sqlite_home`	`string (path)`	Codex が SQLite ベースのランタイム状態を保存するディレクトリを固定します。
`windows`	`table`	ネイティブの Windows サンドボックスに関する要件です。
`windows.allowed_sandbox_implementations`	`array<string>`	`windows.sandbox` で許可される、ネイティブの Windows サンドボックスの実装（`elevated` と `unelevated`）です。リストを空にすることはできません。両方が許可され、モードが選択されていない場合、Codex は `elevated` を優先します。
`windows.sandbox_private_desktop`	`boolean`	ネイティブ Windows サンドボックスがプライベートデスクトップで子プロセスを起動するかどうかの設定を強制します。

Key

allow_appshots

Type / Values

boolean

Details

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

Key

allow_login_shell

Type / Values

boolean

Details

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

Key

allow_managed_hooks_only

Type / Values

boolean

Details

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

Key

allow_remote_control

Type / Values

boolean

Details

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

Key

allowed_approval_policies

Type / Values

array<string>

Details

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

Key

allowed_approvals_reviewers

Type / Values

array<string>

Details

approvals_reviewer で許可される値（user、auto_review など）です。

Key

allowed_permission_profiles

Type / Values

table<boolean>

Details

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

Key

allowed_permission_profiles.<name>

Type / Values

boolean

Details

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

Key

allowed_sandbox_modes

Type / Values

array<string>

Details

sandbox_mode で許可される値です。

Key

allowed_web_search_modes

Type / Values

array<string>

Details

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

Key

apps

Type / Values

table

Details

アプリ識別子をキーとする、管理者が設定するアプリ要件です。要件を使用して、アプリを無効にしたり、個々のツールの承認動作を制限したりできます。

Key

apps.<id>.enabled

Type / Values

boolean

Details

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

Key

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

Type / Values

auto | prompt | writes | approve

Details

アプリの個別ツールに適用する、管理者指定の承認モードを設定します。

Key

check_for_update_on_startup

Type / Values

boolean

Details

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

Key

computer_use

Type / Values

table

Details

requirements.toml によって強制される、コンピューターの使用に関する要件です。

Key

computer_use.allow_locked_computer_use

Type / Values

boolean

Details

管理対象の macOS デバイスがロックされた後にコンピューターの使用が動作しないようにするには、false に設定します。省略した場合、ロック中の使用は要件による制約を受けません。

Key

default_permissions

Type / Values

string

Details

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

Key

enforce_residency

Type / Values

string

Details

Codex サービスのトラフィックで、サポート対象のデータレジデンシーを使用することを必須とします。現在は us を指定できます。

Key

experimental_network

Type / Values

table

Details

サンドボックス内のローカルコマンドに対して管理者が管理するネットワーク要件で、requirements.toml によって強制されます。これらの要件を有効にすると、features.network_proxy がなくてもコマンド用ネットワークプロキシを起動できます。これらの要件は、ウェブ検索、アプリ、MCP サーバー、ブラウザ、Codex Cloud のネットワーク通信を制御しません。

Key

experimental_network.allow_local_binding

Type / Values

boolean

Details

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

Key

experimental_network.allow_upstream_proxy

Type / Values

boolean

Details

サンドボックス内のネットワーク通信が、環境で指定されたアップストリームプロキシを経由してチェーン接続できるようにします。

Key

experimental_network.allowed_domains

Type / Values

array<string>

Details

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

Key

experimental_network.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

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

Key

experimental_network.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

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

Key

experimental_network.denied_domains

Type / Values

array<string>

Details

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

Key

experimental_network.domains

Type / Values

map<string, allow | deny>

Details

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

Key

experimental_network.enabled

Type / Values

boolean

Details

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

Key

experimental_network.http_port

Type / Values

integer

Details

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

Key

experimental_network.managed_allowed_domains_only

Type / Values

boolean

Details

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

Key

experimental_network.socks_port

Type / Values

integer

Details

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

Key

experimental_network.unix_sockets

Type / Values

map<string, allow | deny>

Details

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

Key

features

Type / Values

table

Details

機能の固定値です。ランタイム機能には config.toml の正規名を使用します。ドキュメントに記載されたアプリ専用の要件キーにも対応しています。

Key

features.<name>

Type / Values

boolean

Details

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

Key

features.apps

Type / Values

boolean

Details

管理対象ユーザー向けに、アプリ連携の利用可否を固定します。

Key

features.browser_use

Type / Values

boolean

Details

requirements.toml で false に設定すると、ブラウザでのコンピューターの使用とブラウザエージェントの利用が無効になります。

Key

features.browser_use_external

Type / Values

boolean

Details

requirements.toml で false に設定すると、外部ブラウザでのコンピューターの使用が無効になります。

Key

features.browser_use_full_cdp_access

Type / Values

boolean

Details

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

Key

features.computer_use

Type / Values

boolean

Details

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

Key

features.fast_mode

Type / Values

boolean

Details

管理対象ユーザー向けに、正規の fast_mode 機能の有効・無効を固定します。

Key

features.guardian_approval

Type / Values

boolean

Details

管理対象ユーザー向けに、Guardian 承認の利用可否を固定します。

Key

features.in_app_browser

Type / Values

boolean

Details

requirements.toml で false に設定すると、組み込みのブラウザペインが無効になります。

Key

features.in_app_updates

Type / Values

boolean

Details

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

Key

features.memories

Type / Values

boolean

Details

管理対象ユーザー向けに、メモリの利用可否を固定します。

Key

features.multi_agent

Type / Values

boolean

Details

管理対象ユーザー向けに、マルチエージェント機能の利用可否を固定します。

Key

features.plugin_sharing

Type / Values

boolean

Details

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

Key

features.plugins

Type / Values

boolean

Details

管理対象ユーザー向けに、プラグインの利用可否を固定します。

Key

features.remote_plugin

Type / Values

boolean

Details

管理対象ユーザー向けに、リモートプラグインカタログの利用可否を固定します。

Key

features.workspace_dependencies

Type / Values

boolean

Details

管理対象ユーザー向けに、同梱のワークスペース依存関係用ランタイムの利用可否を固定します。

Key

feedback

Type / Values

table

Details

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

Key

feedback.enabled

Type / Values

boolean

Details

Codex のすべてのクライアントで、ユーザーがフィードバックを送信できるかどうかの設定を強制適用します。

Key

guardian_policy_config

Type / Values

string

Details

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

Key

hooks

Type / Values

table

Details

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

Key

hooks.<Event>

Type / Values

array<table>

Details

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

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

Key

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

Type / Values

integer

Details

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

Key

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

Type / Values

boolean

Details

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

Key

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

Type / Values

string

Details

コマンドフックのコマンドを Windows 用に上書きする設定です。TOML のエイリアス command_windows も使用できます。

Key

hooks.managed_dir

Type / Values

string (absolute path)

Details

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

Key

hooks.windows_managed_dir

Type / Values

string (absolute path)

Details

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

Key

log_dir

Type / Values

string (path)

Details

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

Key

marketplaces

Type / Values

table

Details

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

Key

marketplaces.allowed_sources

Type / Values

table

Details

管理者が選択したルール名をキーとする、許可されたマーケットプレイスソースです。異なる名前のエントリは要件レイヤー間で集約されます。同じ名前のエントリ内のフィールドには、通常のレイヤーの優先順位が適用されます。

Key

marketplaces.allowed_sources.<name>

Type / Values

table

Details

許可するソースを定義する単一のルールです。要件のマージ後に確定した source の値によって、Codex が同じ階層のどのフィールドを解釈するかが決まります。

Key

marketplaces.allowed_sources.<name>.host_pattern

Type / Values

string

Details

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

Key

marketplaces.allowed_sources.<name>.path

Type / Values

string (absolute path)

Details

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

Key

marketplaces.allowed_sources.<name>.ref

Type / Values

string

Details

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

Key

marketplaces.allowed_sources.<name>.source

Type / Values

git | host_pattern | local

Details

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

Key

marketplaces.allowed_sources.<name>.url

Type / Values

string

Details

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

Key

marketplaces.restrict_to_allowed_sources

Type / Values

boolean

Details

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

Key

mcp_servers

Type / Values

table

Details

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

Key

mcp_servers.<id>.identity

Type / Values

table

Details

単一の MCP サーバーの識別ルールです。command（stdio）または url（streamable HTTP）のいずれかを設定します。

Key

mcp_servers.<id>.identity.command

Type / Values

string | table

Details

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

Key

mcp_servers.<id>.identity.command.args

Type / Values

array<table>

Details

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

Key

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

Type / Values

string

Details

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

Key

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

Type / Values

exact | prefix | regex

Details

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

Key

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

Type / Values

string

Details

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

Key

mcp_servers.<id>.identity.command.executable

Type / Values

string

Details

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

Key

mcp_servers.<id>.identity.url

Type / Values

string | table

Details

URL 文字列の完全一致により streamable HTTP 方式の MCP サーバーを許可するか、exact、prefix、regex の値マッチャーテーブルを使用します。

Key

mcp_servers.<id>.identity.url.expression

Type / Values

string

Details

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

Key

mcp_servers.<id>.identity.url.match

Type / Values

exact | prefix | regex

Details

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

Key

mcp_servers.<id>.identity.url.value

Type / Values

string

Details

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

Key

model_catalog_json

Type / Values

string (path)

Details

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

Key

models

Type / Values

table

Details

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

Key

models.new_thread

Type / Values

table

Details

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

Key

models.new_thread.model

Type / Values

string

Details

新しいスレッドのデフォルトモデルです。明示的に指定した --model、またはモデルや推論に関する --config のオーバーライドが優先されます。

Key

models.new_thread.model_reasoning_effort

Type / Values

string

Details

新しいスレッドのデフォルトの推論強度です。モデルまたは推論強度を明示的にオーバーライドすると、管理対象のモデルフィールドは両方ともスキップされます。

Key

models.new_thread.service_tier

Type / Values

string

Details

新しいスレッドのデフォルトのサービスティアです。モデルフィールドとは独立して、明示的なサービスティアのオーバーライドが優先されます。

Key

permissions

Type / Values

table

Details

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

Key

permissions.<name>

Type / Values

table

Details

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

Key

permissions.filesystem.deny_read

Type / Values

array<string>

Details

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

Key

plugins

Type / Values

table

Details

プラグイン識別子をキーとする、プラグイン固有の MCP サーバー許可リストです。このテーブルが存在する場合、プラグインとサーバーの両方に対応するエントリが揃っていないプラグイン同梱サーバーは無効になります。

Key

plugins.<plugin>.mcp_servers

Type / Values

table

Details

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

Key

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

Type / Values

table

Details

プラグインに同梱された 1 つの MCP サーバーの識別ルールです。command（stdio）または url（streamable HTTP）のいずれかを設定します。

Key

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

Type / Values

string | table

Details

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

Key

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

Type / Values

array<table>

Details

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

Key

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

Type / Values

string

Details

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

Key

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

Type / Values

exact | prefix | regex

Details

この引数位置で使用する照合操作です。

Key

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

Type / Values

string

Details

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

Key

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

Type / Values

string

Details

プラグインにバンドルされた stdio サーバーの設定済みコマンドと完全一致させる実行ファイルです。

Key

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

Type / Values

string | table

Details

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

Key

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

Type / Values

string

Details

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

Key

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

Type / Values

exact | prefix | regex

Details

プラグインにバンドルされた MCP サーバーの URL に対する照合操作です。

Key

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

Type / Values

string

Details

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

Key

remote_sandbox_config

Type / Values

array<table>

Details

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

Key

remote_sandbox_config[].allowed_sandbox_modes

Type / Values

array<string>

Details

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

Key

remote_sandbox_config[].hostname_patterns

Type / Values

array<string>

Details

大文字と小文字を区別しないホスト名パターンです。任意の文字列に一致する * と、1 文字に一致する ? に対応しています。

Key

rules

Type / Values

table

Details

.rules ファイルとマージされる、管理者が強制適用するコマンドルールです。要件のルールは制限を課すものでなければなりません。

Key

rules.prefix_rules

Type / Values

array<table>

Details

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

Key

rules.prefix_rules[].decision

Type / Values

prompt | forbidden

Details

必須です。要件のルールで指定できるのは、承認を求めるか禁止するかのいずれかだけで、許可は指定できません。

Key

rules.prefix_rules[].justification

Type / Values

string

Details

承認プロンプトまたは拒否メッセージに表示する理由です。省略できますが、指定する場合は空にできません。

Key

rules.prefix_rules[].pattern

Type / Values

array<table>

Details

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

Key

rules.prefix_rules[].pattern[].any_of

Type / Values

array<string>

Details

この位置で選択肢として許可するトークンのリストです。

Key

rules.prefix_rules[].pattern[].token

Type / Values

string

Details

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

Key

sqlite_home

Type / Values

string (path)

Details

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

Key

windows

Type / Values

table

Details

ネイティブの Windows サンドボックスに関する要件です。

Key

windows.allowed_sandbox_implementations

Type / Values

array<string>

Details

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

Key

windows.sandbox_private_desktop

Type / Values

boolean

Details

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

おすすめ

はじめに

Core concepts

SDKs and CLI

リソース

Legacy APIs

Choose a model

Text and code

プロンプト

Reasoning

Images and video

Realtime and audio

Specialized models

Agents SDK

ChatKit

Search and retrieval

Connect tools and data

Build tool workflows

Computer and code

Media

はじめに

Audio

Connection methods

Sessions and operations

Go live

Performance and quality

Cost and throughput

Safety and governance

Infrastructure and access

オペレーション

Core concepts

Plan

Build

Test and publish

Conversion specs

ガイド

リソース

はじめに

ガイド

File Upload

API

Measurement

Advertiser API

API リファレンス

はじめに

基礎

詳しく見る

利用可能な環境

リリース

ワークフロー

できること

リファレンス

カスタマイズ

設定ファイル

エージェントの構成

ChatGPT と Codex の機能拡張

Linux

Windows

開発ワークフロー

拡張と自動化

環境

Codex を使った開発

サードパーティ連携

リファレンス

権限

Codex Security

サイバーセーフティ

はじめに

ID と認証

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

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

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

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

コミュニティ

ブログ

コミュニティ

ブログ

最近の検索

Topics

Topics

`config.toml`

`requirements.toml`