Claude to GCP Vertex AI Proxy

English | 中文

A proxy service that converts Claude API requests to Google Cloud Vertex AI format, enabling Claude Code clients to access Claude models through GCP Vertex AI.

Disclaimer

This project is a protocol conversion tool designed for **Google Cloud Vertex AI enterprise customers** to simplify the integration between Claude Code client and GCP Vertex AI.

**This project:**

• ✅ Is a legitimate API protocol conversion tool
• ✅ Is intended for users with existing GCP Vertex AI Claude model access
• ✅ Complies with Google Cloud and Anthropic terms of service
• ❌ Does not provide any functionality to bypass authorization or network restrictions
• ❌ Does not provide free access to paid services

**Prerequisites:**

• You must have a valid Google Cloud account
• You must have enabled Vertex AI API in your GCP project
• You must have access to Claude models (via Vertex AI Model Garden)

**Compliance Requirements:**

• Users must comply with Google Cloud Platform Terms of Service
• Users must comply with Anthropic Usage Policy
• Users must comply with applicable local laws and regulations

Environment Variables

This program supports the following environment variables:

Variable	Description	Default
GCP_KEY_FILE	Path to GCP service account JSON credentials file	key/key.json
GCP_REGION	GCP Vertex AI region (e.g., global, us-east5, europe-west1)	global
SSL_VERIFY	Whether to verify SSL certificates (set to false for Charles/Fiddler debugging)	true

Credentials Configuration

Place your GCP service account JSON credentials file at `key/key.json` (default path).

To customize, set the environment variable:

# Windows
set GCP_KEY_FILE=path/to/your-credentials.json

# Linux/Mac
export GCP_KEY_FILE=path/to/your-credentials.json

Region Configuration

Default region is `global`. To specify a different region:

# Windows
set GCP_REGION=us-east5

# Linux/Mac
export GCP_REGION=us-east5

Quick Start

Step 1: Insta