entelix-auth-claude-code 0.6.1

entelix Claude Code OAuth credential provider — reuses the Claude.ai access token managed by the Claude Code CLI for direct Anthropic API calls
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! Error variants for the Claude Code OAuth provider.

use thiserror::Error;

/// Failure modes specific to Claude Code OAuth credential resolution.
///
/// Each variant maps onto a [`entelix_core::auth::AuthError`] when
/// surfaced through the [`entelix_core::auth::CredentialProvider`]
/// trait.
#[derive(Debug, Error)]
#[non_exhaustive]
pub enum ClaudeCodeAuthError {
    /// The credential file is absent — typically the operator hasn't
    /// run `claude login` yet.
    #[error("Claude Code credentials not found at `{path}` — run `claude login` first")]
    CredentialsMissing {
        /// Resolved storage path that was checked.
        path: String,
    },
    /// The credential file exists but contains no OAuth section.
    #[error("Claude Code credential file `{path}` has no OAuth section")]
    OAuthSectionMissing {
        /// Resolved storage path of the credential file.
        path: String,
    },
    /// The OAuth credential payload had no `refresh_token` — the
    /// access token is expired and cannot be renewed.
    #[error("Claude Code OAuth refresh token absent — re-authenticate via `claude login`")]
    RefreshTokenMissing,
    /// The token-refresh HTTP call failed.
    #[error("Claude Code OAuth refresh failed: {message}")]
    RefreshHttp {
        /// Human-readable cause forwarded from `reqwest` or the OAuth
        /// server's error body.
        message: String,
    },
    /// The credential file failed to parse as JSON.
    #[error("Claude Code credential file `{path}` is not valid JSON: {source}")]
    InvalidStorage {
        /// Resolved storage path of the credential file.
        path: String,
        /// Underlying serde error.
        #[source]
        source: serde_json::Error,
    },
    /// Filesystem error reading or writing the credential file.
    #[error("Claude Code credential file `{path}` IO failed: {source}")]
    Io {
        /// Resolved storage path of the credential file.
        path: String,
        /// Underlying IO error.
        #[source]
        source: std::io::Error,
    },
    /// `HOME` (or platform equivalent) is unset, so the default
    /// `~/.claude/.credentials.json` location cannot be resolved.
    #[error("home directory not resolvable — supply the credentials path explicitly")]
    HomeUnresolved,
}

/// Convenience result alias.
pub type ClaudeCodeAuthResult<T> = Result<T, ClaudeCodeAuthError>;

impl From<ClaudeCodeAuthError> for entelix_core::Error {
    fn from(err: ClaudeCodeAuthError) -> Self {
        use entelix_core::auth::AuthError;
        let message = err.to_string();
        match err {
            ClaudeCodeAuthError::CredentialsMissing { .. }
            | ClaudeCodeAuthError::OAuthSectionMissing { .. }
            | ClaudeCodeAuthError::HomeUnresolved => Self::Auth(AuthError::missing_from(message)),
            ClaudeCodeAuthError::RefreshTokenMissing => {
                Self::Auth(AuthError::expired_with(message))
            }
            ClaudeCodeAuthError::RefreshHttp { .. } => {
                Self::Auth(AuthError::source_unreachable(message))
            }
            ClaudeCodeAuthError::InvalidStorage { .. } | ClaudeCodeAuthError::Io { .. } => {
                Self::Auth(AuthError::refused(message))
            }
        }
    }
}