Cmd. /debug-config
Inspect Codex config layers, policy sources, and requirements diagnostics.
Key takeaways
/debug-configprints configuration layer diagnostics and policy details: approval policies, sandbox modes, MCP servers, rules, residency, and experimental network settings.- Run it when
config.tomldoes not appear to match runtime behavior, or before changing managed or project-scoped config. - Newer releases show effective sandbox modes more clearly and make network proxy enforcement visible inside the sandbox path.
- Diagnostics may expose paths or policy details, so share the output carefully.
Original Command Declaration
/debug-configOfficial Summary
/debug-config prints configuration layer diagnostics and policy details, including approval
policies, sandbox modes, MCP servers, rules, residency, and experimental network settings.
Usage
/debug-configGood Examples
- Run
/debug-configwhenconfig.tomldoes not appear to match runtime behavior. - Use it before changing managed or project-scoped configuration.
Similar Commands
| Command | Difference | Choose It When |
|---|---|---|
/debug-config | Explains config layers and policy sources | You need root-cause diagnostics |
/status | Shows current session state | You need a quick snapshot |
/permissions | Changes approval policy | You need to adjust behavior |
Use Cases
- Debugging profile precedence.
- Understanding managed policy requirements.
- Verifying MCP and rule configuration sources.
v0.138.0 to v0.139.0 Changes
/debug-configcan show effective sandbox modes more clearly, which helps explain runtime behavior across config, managed requirements, and sandbox helpers.codex sandbox -P <profile>adds a shorter permissions-profile alias for validating named permission profiles through the sandbox helper.- Network proxy enforcement now matters inside the sandbox path, so teams should verify proxy policy with both
/debug-configand a real sandbox run.
Cautions
- Diagnostics may expose paths or policy details; share output carefully.
- Do not change managed policy locally without understanding ownership.
Release Basis
- Judgment: confirmed addition
- First evidence version:
rust-v0.97.0 - Date (UTC): 2026-02-05
- Release link: https://github.com/openai/codex/releases/tag/rust-v0.97.0
Sources
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex config reference: https://developers.openai.com/codex/config-reference