Struct Client 

pub struct Client { /* private fields */ }

Available on crate feature async only.

HTTP client for the Anthropic API.

Implementations

impl Client

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

Construct a Client with default settings and the given API key.

Panics

Panics if reqwest fails to build its default HTTP client (extremely unusual; would indicate a broken TLS stack). Use Client::builder for a fallible alternative.

pub fn builder() -> ClientBuilder

Begin configuring a Client.

pub fn messages(&self) -> Messages<'_>

Namespace handle for the Messages API.

pub fn models(&self) -> Models<'_>

Namespace handle for the Models API.

pub fn batches(&self) -> Batches<'_>

Namespace handle for the Batches API.

pub fn files(&self) -> Files<'_>

Namespace handle for the Files API (beta).

pub fn managed_agents(&self) -> ManagedAgents<'_>

Available on crate feature managed-agents-preview only.

Namespace handle for the Managed Agents API (preview).

Gated on the managed-agents-preview feature.

pub fn admin(&self) -> Admin<'_>

Available on crate feature admin only.

Namespace handle for the Admin API. Requires an admin API key.

Gated on the admin feature.

pub fn skills(&self) -> Skills<'_>

Available on crate feature skills only.

Namespace handle for the Skills API (beta).

Gated on the skills feature.

pub fn user_profiles(&self) -> UserProfiles<'_>

Available on crate feature user-profiles only.

Namespace handle for the User Profiles API (beta).

Gated on the user-profiles feature.

impl Client

pub async fn run( &self, conversation: &mut Conversation, registry: &ToolRegistry, options: RunOptions, ) -> Result<Message>

Available on crate feature conversation only.

Drive a multi-turn agent loop against this client.

Each iteration:

1. Builds a CreateMessageRequest from conversation, overriding its tools field with registry.to_messages_tools().
2. Sends it (retries handled by the client’s configured retry policy).
3. Records the response’s Usage on the conversation.
4. Appends the assistant’s full response (text + tool_use blocks) to the conversation history.
5. If stop_reason != ToolUse, returns the response.
6. Otherwise dispatches each tool_use block via registry, builds matching tool_result blocks (with is_error = true for failures), appends them as a user turn, and loops.

Returns Error::MaxIterationsExceeded if the loop hits options.max_iterations without the model terminating. Tool execution errors do not propagate; they are surfaced back to the model as is_error = true tool results so it can recover.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.