Vertex Claude Provider for Pi

Access Claude models via Google Vertex AI.

Installation

pi install npm:@myk-org/pi-vertex-claude

Setup

Authenticate with Google Cloud:

gcloud auth application-default login

Set your project (any of these, checked in this order):

export GOOGLE_CLOUD_PROJECT=your-project-id
# or
export GCLOUD_PROJECT=your-project-id
# or
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

Use the provider:

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

Shell Helper

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

# Set project ID via GOOGLE_CLOUD_PROJECT, GCLOUD_PROJECT, or ANTHROPIC_VERTEX_PROJECT_ID
piv() {
  GOOGLE_CLOUD_PROJECT=your-project-id \
  pi --provider google-vertex-claude --model claude-sonnet-4-6 "$@"
}

Available Models

| Model | Context | Output | |-------|---------|--------| | claude-opus-4-6 | 200K | 128K | | claude-sonnet-4-6 | 200K | 64K | | claude-opus-4-5@20251101 | 200K | 32K | | claude-opus-4-1@20250805 | 200K | 32K | | claude-opus-4@20250514 | 200K | 32K | | claude-sonnet-4-5@20250929 | 200K | 64K | | claude-sonnet-4@20250514 | 200K | 64K | | claude-3-7-sonnet@20250219 | 200K | 64K | | claude-haiku-4-5@20251001 | 200K | 64K | | claude-3-5-sonnet-v2@20241022 | 200K | 8K | | claude-3-5-haiku@20241022 | 200K | 8K |

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:

| Model | Context | Output | |-------|---------|--------| | claude-opus-4-6-1m | 1M | 128K | | claude-sonnet-4-6-1m | 1M | 64K |

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