developer-roadmap/roadmaps/codex/content/configtoml@EeiWNgiUJ_DkbeSCe6ruK.md

config.toml

config.toml is Codex's main settings file, found at ~/.codex/config.toml. A trusted project can add its own .codex/config.toml for project-specific settings. It holds the model, sandbox mode, approval policy, MCP servers, hooks and many other options. The CLI, desktop app and IDE extension share it, and --config overrides a value for one run.

Visit the following resources to learn more:

• @official@Codex configuration
• @official@Config basics
• @article@Codex config.toml (2026): Add Any Custom Provider in 6 Lines
• @article@Codex CLI config.toml Guide 2026