config-sample.md +20 −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)
124# - danger-full-access (no sandbox; extremely risky)125# - danger-full-access (no sandbox; extremely risky)
125sandbox_mode = "read-only"126sandbox_mode = "read-only"
126 127
128[windows]
129# Native Windows sandbox mode (Windows only): unelevated | elevated
130sandbox = "unelevated"
131
127################################################################################132################################################################################
128# Authentication & Login133# Authentication & Login
129################################################################################134################################################################################
216# max_threads = 6221# max_threads = 6
217# Maximum nested spawn depth. Root session starts at depth 0. Default: 1222# Maximum nested spawn depth. Root session starts at depth 0. Default: 1
218# max_depth = 1223# max_depth = 1
224# Default timeout per worker for spawn_agents_on_csv jobs. When unset, the tool defaults to 1800 seconds.
225# job_max_runtime_seconds = 1800
219 226
220# [agents.reviewer]227# [agents.reviewer]
221# description = "Find security, correctness, and test risks in code."228# description = "Find security, correctness, and test risks in code."
227 234
228# Disable or re-enable a specific skill without deleting it.235# Disable or re-enable a specific skill without deleting it.
229[[skills.config]]236[[skills.config]]
230237# path = "/path/to/skill"# path = "/path/to/skill/SKILL.md"
231# enabled = false238# enabled = false
232 239
233################################################################################240################################################################################
348# request_rule = true355# request_rule = true
349# collaboration_modes = true356# collaboration_modes = true
350# use_linux_sandbox_bwrap = false357# use_linux_sandbox_bwrap = false
351# experimental_windows_sandbox = false
352# elevated_windows_sandbox = false
353# remote_models = false358# remote_models = false
354# runtime_metrics = false359# runtime_metrics = false
355# powershell_utf8 = true360# powershell_utf8 = true
522# client-certificate = "/etc/codex/certs/client.pem"527# client-certificate = "/etc/codex/certs/client.pem"
523# client-private-key = "/etc/codex/certs/client-key.pem"528# client-private-key = "/etc/codex/certs/client-key.pem"
524```529```
530
531################################################################################
532
533# Windows
534
535################################################################################
536
537[windows]
538
539# Native Windows sandbox mode (Windows only): unelevated | elevated
540
541sandbox = "unelevated"