> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vertex AI Claude

> Use Claude models through Vertex AI with Agno agents.

v2.1.3 (Introduced in v2.1.3)

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

```bash theme={null}
uv pip install -U 'anthropic[vertex]' agno
```

## Authentication

Set your `GOOGLE_CLOUD_PROJECT` and `CLOUD_ML_REGION` environment variables.

```bash Mac theme={null}
export GOOGLE_CLOUD_PROJECT=***
export CLOUD_ML_REGION=***
```

```bash Windows theme={null}
setx GOOGLE_CLOUD_PROJECT ***
setx CLOUD_ML_REGION ***
```

And then authenticate your CLI session:

```bash theme={null}
gcloud auth application-default login
```

## Example

Use `Claude` with your `Agent`:

```python agent.py theme={null}
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.")
```

> [!NOTE]
>
> View more examples [here](https://agno-v2.mintlify.site/models/providers/cloud/vertexai-claude/usage/basic-stream.md).

## 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](https://agno-v2.mintlify.site/models/providers/native/anthropic/overview.md) model with Vertex AI integration and has access to most of the same parameters.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.