Vertex AI Claude

Use Claude models through Vertex AI with Agno agents.

v2.1.3

Use Claude models through Vertex AI. This provides a native Claude integration optimized for Vertex AI infrastructure.

We recommend experimenting to find the best-suited model for your use-case. Here are some general recommendations:

• claude-sonnet-4@20250514 model is good for most use-cases.
• claude-opus-4@20250805 model is their best model.

Authentication

Set your GOOGLE_CLOUD_PROJECT and CLOUD_ML_REGION environment variables.

Mac

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:

agent.py

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	str	"None	The region to use for the model
project_id	str	None	The project ID to use for the model
base_url	str	None	The base URL to use for the model

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