> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/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.

<Badge icon="code-branch" color="orange">
  <Tooltip tip="Introduced in v2.1.3" cta="View release notes" href="https://github.com/agno-agi/agno/releases/tag/v2.1.3">v2.1.3</Tooltip>
</Badge>

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.

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

  ```bash Windows theme={null}
  setx GOOGLE_CLOUD_PROJECT ***
  setx CLOUD_ML_REGION ***
  ```
</CodeGroup>

And then authenticate your CLI session:

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

## Example

Use `Claude` with your `Agent`:

<CodeGroup>
  ```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.")
  ```
</CodeGroup>

<Note>View more examples [here](/models/providers/cloud/vertexai-claude/usage/basic-stream). </Note>

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