Vertex AI Claude

Use Claude models through Vertex AI. Agno sends synchronous and asynchronous requests with Anthropic’s AnthropicVertex clients. We recommend experimenting to find the best-suited model for your use case. Here are some general recommendations:

claude-sonnet-4-6 is the newer Sonnet model (Claude Sonnet 4.6). Current-generation models use bare IDs on Vertex AI, with no @date suffix.
claude-sonnet-4@20250514 is the Agno default. It is deprecated on Vertex AI; use claude-sonnet-4-6 for new work.

Installation

uv pip install -U 'anthropic[vertex]' agno

Authentication

Set your GOOGLE_CLOUD_PROJECT and CLOUD_ML_REGION environment variables.

export GOOGLE_CLOUD_PROJECT=***
export CLOUD_ML_REGION=***

setx GOOGLE_CLOUD_PROJECT ***
setx CLOUD_ML_REGION ***

And then authenticate your CLI session:

gcloud auth application-default login

Example

Use Claude with your Agent:

from agno.agent import Agent
from agno.models.vertexai.claude import Claude

agent = Agent(
    model=Claude(id="claude-sonnet-4@20250514"),
)

# Print the response on the terminal
agent.print_response("Share a 2 sentence dramatic story.")

View more examples here.

Parameters

Parameter	Type	Default	Description
`id`	`str`	`"claude-sonnet-4@20250514"`	The specific Vertex AI Claude model ID to use
`name`	`str`	`"Claude"`	The name identifier for the Vertex AI Claude model
`provider`	`str`	`"VertexAI"`	The provider of the model
`region`	`Optional[str]`	`None`	The region to use for the model (defaults to CLOUD_ML_REGION env var)
`project_id`	`Optional[str]`	`None`	The project ID to use for the model (defaults to ANTHROPIC_VERTEX_PROJECT_ID env var)
`base_url`	`Optional[str]`	`None`	The base URL to use for the model (defaults to ANTHROPIC_VERTEX_BASE_URL env var)

Claude (Vertex AI) extends the Anthropic Claude model with Vertex AI integration and has access to most of the same parameters.

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Vertex AI Claude

Installation

Authentication

Example

Parameters

​Installation

​Authentication

​Example

​Parameters

Installation

Authentication

Example

Parameters