Enum ClaudeCodeError 

pub enum ClaudeCodeError {
    Io(Error),
    Json(Error),
    Yaml(Error),
    Process(String),
    Http(Error),
    InvalidConfig(String),
    Provider(String),
    Validation(String),
    Setup(String),
    CredentialsNotFound {
        path: String,
    },
    InvalidCredentials(String),
    Time(ParseError),
    Notification(String),
    Systemd(String),
    DaemonNotRunning,
    DaemonAlreadyRunning,
    AccessDenied {
        target_type: String,
        name: String,
    },
    TargetNotFound {
        target_type: String,
        name: String,
    },
    InvalidRepoFormat {
        repo: String,
    },
    Generic(String),
}

Main error type for the Claude Code Toolkit.

This enum covers all possible error conditions that can occur during toolkit operations, from file I/O and network errors to configuration and validation failures. Each variant provides specific context about the error condition.

Examples

use claude_code_toolkit::{ClaudeCodeError, Result};

fn validate_repo_format(repo: &str) -> Result<()> {
    if !repo.contains('/') {
        return Err(ClaudeCodeError::InvalidRepoFormat {
            repo: repo.to_string(),
        });
    }
    Ok(())
}

Variants

Io(Error)

File system I/O operation failed

Json(Error)

JSON serialization or deserialization failed

Yaml(Error)

YAML parsing or generation failed

Process(String)

External process execution failed

Http(Error)

HTTP request or response error

InvalidConfig(String)

Configuration file or settings validation failed

Provider(String)

External provider (GitHub, etc.) integration error

Validation(String)

Input validation or constraint violation

Setup(String)

Initial setup or configuration wizard error

CredentialsNotFound

Claude Code credentials file not found

Fields

path: String

File system path where credentials were expected

InvalidCredentials(String)

Credentials file format is invalid or corrupted

Time(ParseError)

Date/time parsing failed

Notification(String)

Desktop notification system error

Systemd(String)

Systemd service management error (Linux only)

DaemonNotRunning

Daemon service is not currently running

DaemonAlreadyRunning

Daemon service is already running

AccessDenied

Access denied to specified resource

Fields

target_type: String

Type of target (organization, repository, etc.)

name: String

Name of the target that access was denied to

TargetNotFound

Specified target (org, repo) not found

Fields

target_type: String

Type of target that was not found

name: String

Name of the target that was not found

InvalidRepoFormat

Repository name format is invalid (should be “owner/repo”)

Fields

repo: String

The invalid repository string provided

Generic(String)

Catch-all for other error conditions

Trait Implementations

impl Debug for ClaudeCodeError

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

Formats the value using the given formatter.

impl Display for ClaudeCodeError

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

Formats the value using the given formatter.

impl Error for ClaudeCodeError

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<&str> for ClaudeCodeError

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<Error> for ClaudeCodeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ClaudeCodeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ClaudeCodeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ClaudeCodeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for ClaudeCodeError

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl From<String> for ClaudeCodeError

fn from(s: String) -> Self

Converts to this type from the input type.