openai/codex · error · io::Error

unknown configuration field `{ignored_path}` in -c/--config

Error message

unknown configuration field `{ignored_path}` in -c/--config override

What it means

Error "unknown configuration field `{ignored_path}` in -c/--config override" thrown in openai/codex.

Source

Thrown at codex-rs/config/src/loader/mod.rs:667

    ) {
        Err(io_error_from_config_error(
            io::ErrorKind::InvalidData,
            config_error,
            /*source*/ None,
        ))
    } else {
        Ok(())
    }
}

fn validate_cli_overrides_strictly(
    cli_overrides_layer: &TomlValue,
    base_dir: &Path,
) -> io::Result<()> {
    let _guard = AbsolutePathBufGuard::new(base_dir);
    if let Some(ignored_path) = ignored_toml_value_field::<ConfigToml>(cli_overrides_layer.clone())
    {
        return Err(io::Error::new(
            io::ErrorKind::InvalidData,
            format!("unknown configuration field `{ignored_path}` in -c/--config override"),
        ));
    }

    if let Some(ignored_path) = unknown_feature_toml_value_field(cli_overrides_layer) {
        return Err(io::Error::new(
            io::ErrorKind::InvalidData,
            format!("unknown configuration field `{ignored_path}` in -c/--config override"),
        ));
    }

    Ok(())
}

/// If available, load requirements from the platform's system `requirements.toml`
/// location as a requirements layer.
pub async fn load_requirements_toml(

View on GitHub (pinned to 339751715c)

Solutions

1. Remove the unknown key from the -c/--config override or correct the field name.

When it happens

Trigger: Thrown at codex-rs/config/src/loader/mod.rs:667 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of openai/codex@339751715c (2026-08-25). Data as JSON: /api/errors/0195e69119ce3c52. Report an issue: GitHub.