Usage

Basic Agent

Run a Claude agent through Vertex AI and print its response.

Create an Agno agent backed by Claude on Vertex AI.

Code

from agno.agent import Agent, RunOutput  # noqa
from agno.models.vertexai.claude import Claude

agent = Agent(model=Claude(id="claude-sonnet-4-6"), markdown=True)

# Get the response in a variable
# run: RunOutput = agent.run("Share a 2 sentence horror story")
# print(run.content)

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

Usage

Complete the Vertex project, model enablement, permissions, and CLI prerequisites first. Use a region that serves Sonnet 4.6.

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

Set your environment variables

export CLOUD_ML_REGION="us-east5"
export GOOGLE_CLOUD_PROJECT=xxx

Authenticate your CLI session

gcloud auth application-default login
You don't need to authenticate your CLI every time.

Install dependencies

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

Run Agent

Save the code above as basic.py, then run:

python basic.py