Enum Auth 

pub enum Auth {
    ApiKey(String),
    FromEnv,
    ClaudeCli,
    OAuth {
        token: String,
    },
    Resolved(Credential),
    Bedrock {
        region: String,
    },
    Vertex {
        project: String,
        region: String,
    },
    Foundry {
        resource: String,
    },
}

Primary authentication configuration for SDK usage.

Auth provides a unified interface for all authentication methods. Use this enum to configure how the SDK authenticates with Claude API.

Variants

• ApiKey: Direct API key authentication
• FromEnv: Load API key from ANTHROPIC_API_KEY environment variable
• ClaudeCli: Use credentials from Claude Code CLI (requires cli-integration feature)
• OAuth: OAuth token authentication
• Resolved: Pre-resolved credential (for testing or credential reuse)
• Bedrock: AWS Bedrock (requires aws feature)
• Vertex: GCP Vertex AI (requires gcp feature)
• Foundry: Azure Foundry (requires azure feature)

Variants

ApiKey(String)

Direct API key authentication.

FromEnv

Load API key from ANTHROPIC_API_KEY environment variable.

ClaudeCli

Available on crate feature cli-integration only.

Use credentials from Claude Code CLI (~/.claude/credentials.json). Requires cli-integration feature.

OAuth

OAuth token authentication.

Fields

token: String

Resolved(Credential)

Use a pre-resolved credential directly. Useful for testing, credential reuse, or custom credential sources.

Bedrock

Available on crate feature aws only.

Fields

region: String

Vertex

Available on crate feature gcp only.

Fields

project: String

region: String

Foundry

Available on crate feature azure only.

Fields

resource: String

Implementations

impl Auth

pub fn api_key(key: impl Into<String>) -> Self

pub fn from_env() -> Self

pub fn claude_cli() -> Self

Available on crate feature cli-integration only.

pub fn oauth(token: impl Into<String>) -> Self

pub fn bedrock(region: impl Into<String>) -> Self

Available on crate feature aws only.

pub fn vertex(project: impl Into<String>, region: impl Into<String>) -> Self

Available on crate feature gcp only.

pub fn foundry(resource: impl Into<String>) -> Self

Available on crate feature azure only.

pub fn resolved(credential: Credential) -> Self

Use a pre-resolved credential directly.

pub async fn resolve(&self) -> Result<Credential>

Resolve authentication to internal credential format.

pub async fn resolve_with_provider( &self, ) -> Result<(Credential, Option<Arc<dyn CredentialProvider>>)>

Resolve authentication and return both credential and provider.

Returns the credential provider for auth methods that support token refresh. This enables automatic 401 retry with credential refresh.

pub fn is_cloud_provider(&self) -> bool

pub fn is_oauth(&self) -> bool

pub fn supports_server_tools(&self) -> bool

Check if Anthropic’s server-side tools (WebSearch, WebFetch) are available.

Server-side tools are available with Anthropic direct API (API Key or OAuth) but NOT with cloud providers (Bedrock, Vertex, Foundry).

Trait Implementations

impl Clone for Auth

fn clone(&self) -> Auth

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Auth

fn default() -> Auth

Returns the “default value” for a type.

impl From<&str> for Auth

fn from(key: &str) -> Self

Converts to this type from the input type.

impl From<Credential> for Auth

fn from(credential: Credential) -> Self

Converts to this type from the input type.

impl From<String> for Auth

fn from(key: String) -> Self

Converts to this type from the input type.