config-sample.md +16 −3
52# model_catalog_json = "/absolute/path/to/models.json" # optional startup-only model catalog override52# model_catalog_json = "/absolute/path/to/models.json" # optional startup-only model catalog override
53# background_terminal_max_timeout = 300000 # ms; max empty write_stdin poll window (default 5m)53# background_terminal_max_timeout = 300000 # ms; max empty write_stdin poll window (default 5m)
54# log_dir = "/absolute/path/to/codex-logs" # directory for Codex logs; default: "$CODEX_HOME/log"54# log_dir = "/absolute/path/to/codex-logs" # directory for Codex logs; default: "$CODEX_HOME/log"
55# sqlite_home = "/absolute/path/to/codex-state" # optional SQLite-backed runtime state directory
55 56
56################################################################################57################################################################################
57# Reasoning & Verbosity (Responses API capable models)58# Reasoning & Verbosity (Responses API capable models)
216# max_threads = 6217# max_threads = 6
217# Maximum nested spawn depth. Root session starts at depth 0. Default: 1218# Maximum nested spawn depth. Root session starts at depth 0. Default: 1
218# max_depth = 1219# max_depth = 1
220# Default timeout per worker for spawn_agents_on_csv jobs. When unset, the tool defaults to 1800 seconds.
221# job_max_runtime_seconds = 1800
219 222
220# [agents.reviewer]223# [agents.reviewer]
221# description = "Find security, correctness, and test risks in code."224# description = "Find security, correctness, and test risks in code."
227 230
228# Disable or re-enable a specific skill without deleting it.231# Disable or re-enable a specific skill without deleting it.
229[[skills.config]]232[[skills.config]]
230233# path = "/path/to/skill"# path = "/path/to/skill/SKILL.md"
231# enabled = false234# enabled = false
232 235
233################################################################################236################################################################################
348# request_rule = true351# request_rule = true
349# collaboration_modes = true352# collaboration_modes = true
350# use_linux_sandbox_bwrap = false353# use_linux_sandbox_bwrap = false
351# experimental_windows_sandbox = false
352# elevated_windows_sandbox = false
353# remote_models = false354# remote_models = false
354# runtime_metrics = false355# runtime_metrics = false
355# powershell_utf8 = true356# powershell_utf8 = true
522# client-certificate = "/etc/codex/certs/client.pem"523# client-certificate = "/etc/codex/certs/client.pem"
523# client-private-key = "/etc/codex/certs/client-key.pem"524# client-private-key = "/etc/codex/certs/client-key.pem"
524```525```
526
527################################################################################
528
529# Windows
530
531################################################################################
532
533[windows]
534
535# Native Windows sandbox mode (Windows only): unelevated | elevated
536
537sandbox = "unelevated"