Skip to main content
reopt Handbook
reopt Handbook
Codex Command MasterLabels and command selectionHow to read a detail guideComplete command listTerminal CLI Commands and Options

Task guides

Core Command GroupSession Command GroupCustom Command GuideMCP Command and Integration GuideDesign Workflows

Conversation and context

Cmd. /clearCmd. /renameCmd. /archiveCmd. /deleteCmd. /compactCmd. /copyCmd. /memoriesCmd. /importCmd. /initCmd. /mentionCmd. /forkCmd. /sideCmd. /resumeCmd. /newCmd. /cdCmd. /exportCmd. /recap

Planning and execution

Cmd. /planCmd. /goalCmd. /psCmd. /stopCmd. /app

Review and verification

Cmd. /review

Models and settings

Cmd. /modelCmd. /fast

Permissions and integrations

Cmd. /permissionsCmd. /ideCmd. /setup-default-sandboxCmd. /sandbox-add-read-dirCmd. /pluginsCmd. /hooksCmd. /approveCmd. /skillsCmd. /mcp

Status and diagnostics

Cmd. /agentCmd. /appsCmd. /diffCmd. /feedbackCmd. /personalityCmd. /rawCmd. /statusCmd. /debug-configCmd. /title

Display and input

Cmd. /keymapCmd. /vimCmd. /experimentalCmd. /statuslineCmd. /themeCmd. /petsCmd. /voiceCmd. /worktree

Account and usage

Cmd. /exitCmd. /logoutCmd. /quitCmd. /usage

Legacy

Cmd. /approvals

Verification and history

Current verification scopeHandbook updatesRelease coverage historyEarlier verification recordsCommand change history
Handbook›Codex Command Master›Cmd. /debug-config
한국어English

Cmd. /debug-config

Inspect Codex config layers, policy sources, and requirements diagnostics.

Key takeaways

  • Inspect Codex config layers, policy sources, and requirements diagnostics.
  • Check the input surface and availability before using the examples below.

Purpose

Inspect Codex config layers, policy sources, and requirements diagnostics.

/debug-config

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusCurrent reference
Aliases—
Documented minimumNot specified
Reviewed against2026-09-22 · Codex CLI 0.155.1

The installed command menu and account or organization settings determine availability.

Examples

/debug-config

When to use it

  1. Run /debug-config when config.toml does not appear to match runtime behavior.
  2. Use it before changing managed or project-scoped configuration.

Choosing related commands

CommandDifferenceChoose It When
/debug-configExplains config layers and policy sourcesYou need root-cause diagnostics
/statusShows current session stateYou need a quick snapshot
/permissionsChanges approval policyYou need to adjust behavior

Effects and persistence

Displays effective configuration and its sources without editing configuration files.

/debug-config prints configuration layer diagnostics and policy details, including approval policies, sandbox modes, MCP servers, rules, residency, and experimental network settings.

to v0.139.0 Changes

  • /debug-config can 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-config and a real sandbox run.

Cautions

  • Diagnostics may expose paths or policy details; share output carefully.
  • Do not change managed policy locally without understanding ownership.

Official sources

  • Developer Commands
  • Config Reference
  • Cli

Complete command list · Verification scope · History for this command

Related docs

Cmd. /status

Inspect session configuration, token usage, model, and policy.

Cmd. /feedback

Send feedback and diagnostics to Codex maintainers.

Config

Advanced Codex Usage · Design Codex configuration layers, profiles, and safe defaults for team usage.

Cmd. /settings

Claude Code Command Master · Alias for the /config settings interface.

Cmd. /sandbox

Claude Code Command Master · Toggle sandbox mode on supported platforms.

Cmd. /status

Inspect session configuration, token usage, model, and policy.

Cmd. /title

Configure terminal window or tab title fields.

On this page

PurposeAvailabilityExamplesWhen to use itChoosing related commandsEffects and persistenceto v0.139.0 ChangesCautionsOfficial sources