Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Available on crate feature async only.

Builder for Client.

Implementations

impl ClientBuilder

pub fn api_key(self, k: impl Into<String>) -> Self

API key; required.

pub fn base_url(self, url: impl Into<String>) -> Self

Override the base URL. Useful for proxies and wiremock-based tests. Defaults to https://api.anthropic.com.

pub fn beta(self, header_value: impl Into<String>) -> Self

Append an anthropic-beta value. May be called multiple times; values are comma-joined per Anthropic convention.

pub fn timeout(self, d: Duration) -> Self

Per-request timeout applied to the underlying reqwest client. Ignored if a custom HTTP client is supplied via Self::http_client.

pub fn retry(self, policy: RetryPolicy) -> Self

Override the default retry policy.

pub fn http_client(self, c: Client) -> Self

Supply your own reqwest::Client. Lets callers reuse a connection pool, install custom middleware, or configure proxy / TLS settings outside the SDK.

pub fn user_agent(self, ua: impl Into<String>) -> Self

Override the User-Agent header. Defaults to claude-api-rs/<version>.

pub fn signer(self, signer: Arc<dyn RequestSigner>) -> Self

Install a custom RequestSigner. If unset, the builder defaults to ApiKeySigner from the configured api_key. Setting both is allowed: the explicit signer takes precedence (useful for tests that want a no-op signer with an unused placeholder key).

pub fn build(self) -> Result<Client>

Construct the Client. Returns Error::InvalidConfig if neither an api_key nor a custom signer was provided.

Trait Implementations

impl Debug for ClientBuilder

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

Formats the value using the given formatter.

impl Default for ClientBuilder

fn default() -> ClientBuilder

Returns the “default value” for a type.