openai/codex · error · anyhow::Error

--environment-id is required when --remote is set

Error message

--environment-id is required when --remote is set

What it means

Error "--environment-id is required when --remote is set" thrown in openai/codex.

Source

Thrown at codex-rs/cli/src/main.rs:1872

async fn run_exec_server_command(
    cmd: ExecServerCommand,
    arg0_paths: &Arg0DispatchPaths,
    root_config_overrides: &CliConfigOverrides,
    strict_config: bool,
) -> anyhow::Result<()> {
    let codex_self_exe = arg0_paths
        .codex_self_exe
        .clone()
        .ok_or_else(|| anyhow::anyhow!("Codex executable path is not configured"))?;
    let runtime_paths = codex_exec_server::ExecServerRuntimePaths::new(
        codex_self_exe,
        arg0_paths.codex_linux_sandbox_exe.clone(),
    )?;
    if let Some(base_url) = cmd.remote {
        let environment_id = cmd
            .environment_id
            .ok_or_else(|| anyhow::anyhow!("--environment-id is required when --remote is set"))?;
        let config = load_exec_server_config(
            root_config_overrides,
            strict_config,
            /*enable_workload_identity*/ true,
        )
        .await?;
        let (_otel, telemetry) = exec_server_telemetry::init(Some(&config));
        let auth_provider =
            load_exec_server_remote_auth_provider(&config, &base_url, cmd.use_agent_identity_auth)
                .await?;
        let mut remote_config = codex_exec_server::RemoteEnvironmentConfig::new(
            base_url,
            environment_id,
            auth_provider,
            config.http_client_factory(),
        )?;
        if let Some(name) = cmd.name {
            remote_config.name = name;

View on GitHub (pinned to 339751715c)

When it happens

Trigger: Thrown at codex-rs/cli/src/main.rs:1872 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/8c1bedbd86d76f00. Report an issue: GitHub.