CODEX CONFIGURATION

Make Codex work your way

From your first connection to project instructions and tool integrations. Pick a problem, follow the example, and verify what actually changed.

Setting up for the first time? Start here

8 configuration guides

Find the configuration Codex actually loads, separate user and project settings, and verify changes with a minimal TOML example.

Map your provider’s URL, model ID, and credential variable to user-level Codex configuration, then verify Responses compatibility.

Keep scenario-specific differences in separate profile files, understand precedence, and migrate the retired inline profile format.

Separate authentication from provider routing and credential storage, including why exporting a key is not the same as signing in.

Turn project structure, validation commands, and working agreements into reusable instructions, with a template and a loading check.

Distinguish HTTP from STDIO, configure authentication, discover tools, and validate one small call before expanding access.

Separate what commands can do from when approval is requested, with read-only and workspace-editing examples and a migration note.

Narrow down configuration, authentication, routing, and execution failures one layer at a time, with a redacted reproduction template.