> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-update-deprecated-models.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.

<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. 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.

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