config-sample.md Codex Docs, 2026-05-02 00:48 UTC → 2026-05-18 22:01 UTC

42# Default OSS provider for --oss sessions. When unset, Codex prompts. Default: unset.42# Default OSS provider for --oss sessions. When unset, Codex prompts. Default: unset.

43# oss_provider = "ollama"43# oss_provider = "ollama"

44 44 

45# Preferred service tier. `fast` is honored only when enabled in [features].45# Preferred service tier. Built-in examples: fast | flex; model catalogs can add more.

46# service_tier = "flex" # fast | flex46# service_tier = "flex"

47 47 

48# Optional manual model metadata. When unset, Codex uses model or preset defaults.48# Optional manual model metadata. When unset, Codex uses model or preset defaults.

49# model_context_window = 128000 # tokens; default: auto for model49# model_context_window = 128000 # tokens; default: auto for model

83# Inline override for the history compaction prompt. Default: unset.83# Inline override for the history compaction prompt. Default: unset.

84# compact_prompt = ""84# compact_prompt = ""

85 85 

86# Override the default commit co-author trailer. Set to "" to disable it.86# Override the default commit co-author trailer. This only takes effect when

87# [features].codex_git_commit is enabled. When enabled and unset, Codex uses

88# "Codex <noreply@openai.com>". Set to "" to disable it.

87# commit_attribution = "Jane Doe <jane@example.com>"89# commit_attribution = "Jane Doe <jane@example.com>"

88 90 

89# Override built-in base instructions with a file path. Default: unset.91# Override built-in base instructions with a file path. Default: unset.

286experimental_use_profile = false288experimental_use_profile = false

287 289 

288################################################################################290################################################################################

289# Managed network proxy settings291# Sandboxed networking settings

290################################################################################292################################################################################

291 293 

294# Enable the feature before configuring sandboxed networking rules.

295# [features.network_proxy]

296# enabled = true

297# domains = { "api.openai.com" = "allow", "example.com" = "deny" }

298#

299# Exact hosts match only themselves.

300# "*.example.com" matches subdomains only; "**.example.com" matches the apex plus subdomains.

301# "*" allows any public host that is not denied, so prefer scoped rules when possible.

302# `allow_local_binding = false` blocks loopback and private destinations by default.

303# Add an exact local IP literal or `localhost` allow rule for one target, or set it to true only when broader local access is required.

304#

292# Set `default_permissions = "workspace"` before enabling this profile.305# Set `default_permissions = "workspace"` before enabling this profile.

293# [permissions.workspace.network]306# [permissions.workspace.network]

294# enabled = true307# enabled = true

301# dangerously_allow_non_loopback_proxy = false314# dangerously_allow_non_loopback_proxy = false

302# dangerously_allow_non_loopback_admin = false315# dangerously_allow_non_loopback_admin = false

303# dangerously_allow_all_unix_sockets = false316# dangerously_allow_all_unix_sockets = false

304# mode = "limited" # limited | full

305# allow_local_binding = false317# allow_local_binding = false

306#318#

307# [permissions.workspace.network.domains]319# [permissions.workspace.network.domains]

398# Leave this table empty to accept defaults. Set explicit booleans to opt in/out.410# Leave this table empty to accept defaults. Set explicit booleans to opt in/out.

399# shell_tool = true411# shell_tool = true

400# apps = false412# apps = false

401# codex_hooks = false413# hooks = false

414# plugin_hooks = false # Default off; set true to opt into plugin-bundled hooks.

415# codex_git_commit = false

402# unified_exec = true416# unified_exec = true

403# shell_snapshot = true417# shell_snapshot = true

404# multi_agent = true418# multi_agent = true

405# personality = true419# personality = true

420# network_proxy = false

406# fast_mode = true421# fast_mode = true

407# enable_request_compression = true422# enable_request_compression = true

408# skill_mcp_dependency_install = true423# skill_mcp_dependency_install = true

577# model_provider = "openai"592# model_provider = "openai"

578# approval_policy = "on-request"593# approval_policy = "on-request"

579# sandbox_mode = "read-only"594# sandbox_mode = "read-only"

580# service_tier = "flex"595# service_tier = "flex" # or another supported service tier id

581# oss_provider = "ollama"596# oss_provider = "ollama"

582# model_reasoning_effort = "medium"597# model_reasoning_effort = "medium"

583# plan_mode_reasoning_effort = "high"598# plan_mode_reasoning_effort = "high"