Codex Config Viewer

General

Core model, approval, auth, and UI behavior.

Model

Default session model.

Review model

Optional override used by /review.

Model provider

Provider ID selected from [model_providers].

Approval policy

When Codex requests approval for tool actions.

Sandbox mode

Filesystem and network access policy.

Service tier

Preferred service tier when supported.

Profile

Name of the applied profile.

Reasoning effort

Reasoning effort for normal mode.

Plan mode reasoning

Optional reasoning override used in plan mode.

Reasoning summary mode

Optional summary mode for reasoning output.

Model verbosity

Text verbosity override for GPT-5 family models.

Personality

Communication style for supported models.

Approvals reviewer

Who reviews eligible approval prompts.

OSS provider

Default provider for --oss sessions.

CLI auth credential store

Where CLI login credentials should be stored.

MCP OAuth credential store

Preferred store for MCP OAuth credentials.

MCP OAuth callback port

Local port used for MCP OAuth callback redirects.

MCP OAuth callback URL

Optional full callback URL override for MCP OAuth.

Forced login method

Force Codex to use ChatGPT or API login.

ChatGPT base URL

Base URL for the ChatGPT auth flow.

OpenAI base URL

Optional override for API traffic.

Forced ChatGPT workspace

Optional workspace restriction for ChatGPT login.

File opener

URI scheme used for clickable citations.

Project doc max bytes

Maximum size of project documentation loaded into context.

Context window

Manual context window tokens for the model.

Auto compact token limit

Token threshold that triggers automatic history compaction.

Tool output token limit

Token budget stored per tool output.

Model catalog JSON

Startup-only model catalog JSON path.

Model instructions file

Path to a file replacing built-in model instructions.

Default permissions

Named permissions profile to apply by default.

Project doc fallback filenames

Fallback filenames to check when no primary project doc is found.

No values yet.

Project root markers

Extra filenames or directories used to detect project roots.

No values yet.

Notify command

Command array run after Codex finishes.

No values yet.

Allow login shell

Allow login-shell semantics for commands when needed.

Supports reasoning summaries

Force reasoning summary metadata for the current model.

Hide agent reasoning

Suppress reasoning events from output.

Show raw reasoning

Display raw reasoning content when available.

Disable paste burst

Turn off burst-paste detection in the TUI.

WSL setup acknowledged

Track that the Windows WSL setup notice has been acknowledged.

Check for updates on startup

Allow Codex to check for app updates when it starts.

Suppress unstable feature warning

Hide the warning shown for unstable feature flags.

History

Compaction and persistence controls.

Persistence

save-all or none.

Max history bytes

Trim oldest history entries after this size.

Features

Current [features] overrides from the config reference. Leave blank to use Codex defaults.

Shell tool

Enable the default shell tool for running commands.

Apps/connectors

Enable ChatGPT Apps and connector support.

Hooks

Enable lifecycle hooks from hooks.json or inline [hooks].

Codex git commit

Allow Codex-generated git commits and optional commit attribution.

Unified exec

Use the PTY-backed unified exec tool.

Shell snapshot

Cache shell environment snapshots to speed up repeated commands.

Multi-agent

Enable multi-agent collaboration tools such as spawn and resume.

Personality controls

Enable personality selection controls in supported Codex surfaces.

Fast mode

Enable fast-tier model selection when advertised by the model catalog.

Request compression

Compress streaming request bodies with zstd when supported.

Skill MCP dependency install

Allow prompting to install missing MCP dependencies required by skills.

Prevent idle sleep

Keep the machine awake while a turn is actively running.

Memories

Enable Codex memories.

Undo

Enable undo support.

Sandbox

Workspace-write settings used when sandbox mode allows them.

This section only applies when sandbox mode is set to workspace-write, but you can still preconfigure it.

Writable roots

Extra writable roots beyond the current workspace.

No values yet.

Network access

Allow outbound network access in workspace-write mode.

Exclude TMPDIR env var

Do not pass TMPDIR through in workspace-write mode.

Exclude /tmp

Avoid mapping /tmp into the writable sandbox roots.

Shell Environment

Environment inheritance and include/exclude lists.

Inherit

Which environment baseline to inherit.

Ignore default excludes

Disable the built-in shell environment exclusion list.

Exclude

Environment variables to exclude.

No values yet.

Set

Environment variables that should be set explicitly.

No key/value pairs yet.

Include only

Explicit allow-list of environment variables.

No values yet.

Experimental use profile

Let Codex source your shell profile before command execution.

Tools

Tool-related behavior from the sample schema.

Web search

Use disabled, cached, or live web search results.

View image

Enable image-view tooling when supported.

Agents

Subagent concurrency and runtime limits under [agents].

Max threads

Maximum concurrent subagent threads. Leave blank to use Codex defaults.

Max depth

Maximum subagent nesting depth. Root sessions start at depth 0.

Job max runtime (sec)

Maximum runtime per subagent job in seconds.

Model Providers

Provider presets under [model_providers].

No model providers yet.

MCP Servers

Configured MCP transports under [mcp_servers].

No MCP servers yet.

Profiles

Saved profile presets under [profiles].

No profiles yet.

Projects

Per-project trust configuration under [projects].

No project trust rules yet.

Advanced

Preserved unsupported TOML fragment.

Advanced unsupported TOML

Paste only the unsupported fragment here. Visual form fields always override conflicts in generated output.