Enum Error 

pub enum Error {
    BinaryNotFound,
    Spawn(Error),
    Timeout,
    Parse(Error),
    Cli {
        status: Option<i32>,
        stderr: String,
    },
    Api {
        status: Option<u16>,
        message: String,
    },
    Isolation(Error),
}

Errors that can occur while building, spawning, or parsing output from the claude CLI subprocess.

Variants

BinaryNotFound

The claude binary could not be located (via CLAUDE_BINARY or PATH).

Spawn(Error)

Spawning or communicating with the child process failed.

Timeout

The call exceeded its configured timeout.

Parse(Error)

The CLI’s JSON output could not be parsed into the expected shape.

Cli

The claude CLI itself failed before producing a response envelope — bad arguments, a missing prompt, a crash. Diagnosed by an empty stdout; the message is on stderr.

Distinct from Error::Api: here the CLI never reached the API.

Fields

status: Option<i32>

Process exit code, if the process was not killed by a signal.

stderr: String

The CLI’s stderr, trimmed.

Api

The CLI ran and emitted a well-formed envelope reporting a failure (is_error: true) — e.g. an unroutable model, or an API outage.

Distinct from Error::Cli: the CLI worked; the API call did not. Note the message arrives on stdout, inside the JSON’s result field — stderr is empty on this path.

Fields

status: Option<u16>

HTTP status from the envelope’s api_error_status, when reported.

message: String

Human-readable message from the envelope’s result field.

Isolation(Error)

Setting up an isolated CLAUDE_CONFIG_DIR (temp dir creation, or a credentials/.claude.json source that exists but could not be read or copied) failed.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.