Skip to main content
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. 
export GOOGLE_CLOUD_PROJECT=***
export 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

ParameterTypeDefaultDescription
idstr"claude-sonnet-4@20250514"The specific Vertex AI Claude model ID to use
namestr"Claude"The name identifier for the Vertex AI Claude model
providerstr"VertexAI"The provider of the model
regionstr"NoneThe region to use for the model
project_idstrNoneThe project ID to use for the model
base_urlstrNoneThe 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.
⌘I