Vertex Claude Provider for Pi

April 15, 2026 ยท View on GitHub

Access Claude models via Google Vertex AI.

Installation

pi install npm:@isaacraja/pi-vertex-claude

Setup

Authenticate with Google Cloud:

gcloud auth application-default login

Set your project:

export GOOGLE_CLOUD_PROJECT=your-project-id

Use the provider:

pi --provider google-vertex-claude --model claude-sonnet-4-6

Shell Helper

Add to ~/.bashrc or ~/.zshrc:

piv() {
  GOOGLE_CLOUD_PROJECT=your-project-id \
  pi --provider google-vertex-claude --model claude-sonnet-4-6 "$@"
}

Available Models

ModelContextOutput
claude-opus-4-6200K128K
claude-sonnet-4-6200K64K
claude-opus-4-5@20251101200K32K
claude-opus-4-1@20250805200K32K
claude-opus-4@20250514200K32K
claude-sonnet-4-5@20250929200K64K
claude-sonnet-4@20250514200K64K
claude-3-7-sonnet@20250219200K64K
claude-haiku-4-5@20251001200K64K
claude-3-5-sonnet-v2@20241022200K8K
claude-3-5-haiku@20241022200K8K

1M Context Window

Claude Opus 4.6 and Sonnet 4.6 support up to 1M tokens of context via the context-1m-2025-08-07 beta header.

To enable 1M model variants, set:

export VERTEX_CLAUDE_1M=true

This adds -1m variants alongside the standard models:

ModelContextOutput
claude-opus-4-6-1m1M128K
claude-sonnet-4-6-1m1M64K

Use them like any other model:

pi --provider google-vertex-claude --model claude-opus-4-6-1m

Prerequisites

  • Google Cloud project with Vertex AI API enabled
  • Claude models enabled in Model Garden
  • gcloud CLI installed

License

MIT