{"record":{"id":"d3605bfd7bdeb14b","repo":"openai/codex","slug":"codex-access-token-is-required-when-use-agent-id","errorCode":null,"errorMessage":"CODEX_ACCESS_TOKEN is required when --use-agent-identity-auth is set","messagePattern":"CODEX_ACCESS_TOKEN is required when --use-agent-identity-auth is set","errorType":"validation","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"codex-rs/cli/src/main.rs","lineNumber":1979,"sourceCode":"                )\n                .await\n            },\n            exec_server_telemetry::ParentLifetime::Independent,\n            exec_server_telemetry::ShutdownBehavior::Immediate,\n        )\n        .await\n        .map_err(anyhow::Error::from_boxed)\n    }\n}\n\nasync fn load_exec_server_remote_auth_provider(\n    config: &codex_core::config::Config,\n    base_url: &str,\n    use_agent_identity_auth: bool,\n) -> anyhow::Result<codex_api::SharedAuthProvider> {\n    if use_agent_identity_auth {\n        read_codex_access_token_from_env().ok_or_else(|| {\n            anyhow::anyhow!(\"CODEX_ACCESS_TOKEN is required when --use-agent-identity-auth is set\")\n        })?;\n        let auth = AuthManager::shared_from_config(config, /*enable_codex_api_key_env*/ false)\n            .await?\n            .auth()\n            .await\n            .ok_or_else(|| anyhow::anyhow!(\"Agent Identity authentication is unavailable\"))?;\n        if !matches!(auth, CodexAuth::AgentIdentity(_)) {\n            anyhow::bail!(\n                \"CODEX_ACCESS_TOKEN did not provide permitted Agent Identity authentication\"\n            );\n        }\n        return Ok(codex_model_provider::auth_provider_from_auth(&auth));\n    }\n\n    let (auth_manager, auth) = load_exec_server_remote_auth(\n        config,\n        \"remote exec-server registration requires ChatGPT authentication or API key authentication; run `codex login` or set CODEX_API_KEY\",\n    )","sourceCodeStart":1961,"sourceCodeEnd":1997,"githubUrl":"https://github.com/openai/codex/blob/339751715c64496cb86246bfb3935f40e309dd3d/codex-rs/cli/src/main.rs#L1961-L1997","documentation":"Error \"CODEX_ACCESS_TOKEN is required when --use-agent-identity-auth is set\" thrown in openai/codex.","triggerScenarios":"Thrown at codex-rs/cli/src/main.rs:1979 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"339751715c64496cb86246bfb3935f40e309dd3d","analyzedAt":"2026-08-25T05:35:09.876Z","schemaVersion":2},"datasetVersion":"2026-08-25T06:17:31.827Z"}