Enum StartupFailureReason 

pub enum StartupFailureReason {
    OrgPinApiKeyConflict,
    ProviderNotAllowed,
    OrgVerifyFailed,
    OrgPinMismatch,
    ManagedSettingsInvalid,
    RemoteSettingsRequiredUnavailable,
    GatewaySigninRequired,
    GatewayAccessDenied,
    ProxyInvalid,
    TempDirUnusable,
    CwdUnavailable,
    ShellToolMissing,
    SessionHeldByBackground,
    WorktreeResumeRefused,
    WorktreeUnverified,
    CliVersionTooOld,
    BypassRoot,
    Unknown(String),
}

Why Claude Code refused to start, carried as ResultMessage::startup_failure_reason so a host can offer the fix instead of a retry (CLI 2.1.274+).

Variants

OrgPinApiKeyConflict

Managed settings pin a first-party or Cloud gateway sign-in, and an Anthropic API key or auth token is configured instead.

ProviderNotAllowed

Managed settings list the API providers this machine may use (allowedProviders), and the session is set up for one that is not listed (CLI 2.1.285+).

OrgVerifyFailed

The sign-in’s organization could not be verified against the pin (network, or a revoked token).

OrgPinMismatch

The sign-in belongs to an organization the pin does not allow.

ManagedSettingsInvalid

Managed policy settings could not be read, the pin names no organization, or managed model settings (deniedModels, or an availableModels list matched exactly) block the default model and leave no allowed model to use instead.

RemoteSettingsRequiredUnavailable

Managed settings the organization requires could not be loaded.

GatewaySigninRequired

The Cloud gateway ended this sign-in.

GatewayAccessDenied

The Cloud gateway refused managed settings for this account.

ProxyInvalid

A proxy setting is not a complete URL.

TempDirUnusable

The per-user temp directory is unsafe or could not be created.

CwdUnavailable

The working directory was deleted, moved or cannot be read.

ShellToolMissing

Windows has no shell tool: Git Bash is missing, and PowerShell is missing or turned off by CLAUDE_CODE_USE_POWERSHELL_TOOL.

SessionHeldByBackground

The conversation to resume or continue is running as a background session.

WorktreeResumeRefused

The resume was refused because the session’s worktree failed its safety checks or the resume was launched from inside it; errors says whether a re-run continues without the worktree.

WorktreeUnverified

The session’s worktree could not be verified right now; retrying may succeed.

CliVersionTooOld

This Claude Code version is below the minimum Anthropic requires.

BypassRoot

Bypass permissions mode was requested while running as root.

Unknown(String)

A cause not yet known to this version of the crate.

Implementations

impl StartupFailureReason

pub fn as_str(&self) -> &str

Trait Implementations

impl Clone for StartupFailureReason

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StartupFailureReason

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StartupFailureReason

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for StartupFailureReason

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for StartupFailureReason

impl From<&str> for StartupFailureReason

fn from(s: &str) -> Self

Converts to this type from the input type.

impl Hash for StartupFailureReason

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for StartupFailureReason

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for StartupFailureReason

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for StartupFailureReason