Struct AnthropicProvider 

pub struct AnthropicProvider { /* private fields */ }

Available on crate feature anthropic only.

Anthropic LLM provider using the Messages API.

Implementations

impl AnthropicProvider

pub const API_KEY_ENV: &'static str = "ANTHROPIC_API_KEY"

The conventional environment variable holding the Anthropic API key.

pub fn new( api_key: impl Into<String>, model: impl Into<String>, ) -> AnthropicProvider

Create a new Anthropic provider with the specified API key and model.

Automatically detects OAuth tokens (sk-ant-oat-*) and switches to Bearer auth with Claude Code identity headers.

pub const fn is_oauth(&self) -> bool

Returns whether this provider is using OAuth authentication.

pub fn from_env() -> AnthropicProvider

Create a provider using Claude Sonnet, reading the API key from the conventional ANTHROPIC_API_KEY environment variable.

This is the zero-ceremony on-ramp for the quickstart. Use try_from_env if you want to handle a missing key without a panic.

Panics

Panics if ANTHROPIC_API_KEY is not set. Prefer try_from_env outside of examples/tests.

pub fn try_from_env() -> Result<AnthropicProvider, Error>

Create a provider using Claude Sonnet, reading the API key from the conventional ANTHROPIC_API_KEY environment variable.

Errors

Returns an error if ANTHROPIC_API_KEY is unset or not valid UTF-8.

pub fn haiku(api_key: impl Into<String>) -> AnthropicProvider

Create a provider using Claude Haiku 4.5.

pub fn sonnet(api_key: impl Into<String>) -> AnthropicProvider

Create a provider using Claude Sonnet 4.6.

pub fn sonnet_45(api_key: impl Into<String>) -> AnthropicProvider

Create a provider using Claude Sonnet 4.5.

pub fn sonnet_46(api_key: impl Into<String>) -> AnthropicProvider

Create a provider using Claude Sonnet 4.6.

pub fn opus(api_key: impl Into<String>) -> AnthropicProvider

Create a provider using Claude Opus 4.6.

pub fn opus_47(api_key: impl Into<String>) -> AnthropicProvider

Create a provider using Claude Opus 4.7.

Note: Opus 4.7 requires adaptive thinking. Passing a ThinkingConfig with ThinkingMode::Enabled { budget_tokens } will return an InvalidRequest — use ThinkingConfig::adaptive() or ThinkingConfig::adaptive_with_effort(_) instead.

pub fn opus_48(api_key: impl Into<String>) -> AnthropicProvider

Create a provider using Claude Opus 4.8.

Note: Opus 4.8 requires adaptive thinking. Passing a ThinkingConfig with ThinkingMode::Enabled { budget_tokens } will return an InvalidRequest — use ThinkingConfig::adaptive() or ThinkingConfig::adaptive_with_effort(_) instead.

pub fn fable(api_key: impl Into<String>) -> AnthropicProvider

Create a provider using Claude Fable 5.

Note: Fable 5 is adaptive-only — the API applies adaptive thinking even when no thinking config is sent, and raw chain of thought is never returned (thinking blocks arrive with empty content). Passing a ThinkingConfig with ThinkingMode::Enabled { budget_tokens } will return an InvalidRequest — use ThinkingConfig::adaptive() or ThinkingConfig::adaptive_with_effort(_) instead.

pub const fn with_thinking(self, thinking: ThinkingConfig) -> AnthropicProvider

Set the provider-owned thinking configuration for this model.

pub fn with_base_url(self, base_url: impl Into<String>) -> AnthropicProvider

Override the base URL (default: https://api.anthropic.com).

pub fn with_extra_headers( self, headers: Vec<(String, String)>, ) -> AnthropicProvider

Add extra HTTP headers applied to every request.

Trait Implementations

impl Clone for AnthropicProvider

fn clone(&self) -> AnthropicProvider

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl LlmProvider for AnthropicProvider

fn chat<'life0, 'async_trait>( &'life0 self, request: ChatRequest, ) -> Pin<Box<dyn Future<Output = Result<ChatOutcome, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, AnthropicProvider: 'async_trait,

Non-streaming chat completion.

fn chat_stream( &self, request: ChatRequest, ) -> Pin<Box<dyn Stream<Item = Result<StreamDelta, Error>> + Send + '_>>

Streaming chat completion.

fn validate_thinking_config( &self, thinking: Option<&ThinkingConfig>, ) -> Result<(), Error>

Validate a thinking configuration against the provider/model capabilities.

fn model(&self) -> &str

fn provider(&self) -> &'static str

fn configured_thinking(&self) -> Option<&ThinkingConfig>

Provider-owned thinking configuration, if any.

fn default_max_tokens(&self) -> u32

Default maximum output tokens for this provider/model when the caller does not explicitly override AgentConfig.max_tokens.

fn capabilities(&self) -> Option<&'static ModelCapabilities>

Canonical capability metadata for this provider/model, if known.

fn resolve_thinking_config( &self, request_thinking: Option<&ThinkingConfig>, ) -> Result<Option<ThinkingConfig>, Error>

Resolve the effective thinking configuration for a request.

fn structured_output_support(&self) -> StructuredOutputSupport

How this provider satisfies a structured-output (ResponseFormat) request.