Cost Visibility
See exactly what each user, team, or department is spending through the add-ins. Set hard budget limits before bills surprise you.
Governance & Access Control
No raw API keys handed to employees. One Portkey API key controls access. Revoke or rotate centrally.
Multi-Provider Routing
Route to Anthropic directly, AWS Bedrock, or Google Vertex AI — switch providers with a single config change.
Full Request Logs
Every prompt and response logged in Portkey. Search, filter, and audit usage across your organization.
How It Works
The add-ins connect to any Anthropic Messages API-compatible endpoint. You give each user:- Gateway URL:
https://api.portkey.ai - API token: A Portkey API key (optionally scoped with a Config)
Setup
Step 1: Add Your Provider in Model Catalog
- Go to Model Catalog → Add Provider
- Select your provider — Anthropic, AWS Bedrock, or Google Vertex AI
- Enter your credentials and save with a slug (e.g.,
anthropic-prod)
Model Catalog Setup Guide →
Full instructions for adding providers and managing credentials
Step 2: Create a Config (Recommended)
Create a Config to set the default provider and model, and to forward the required headers. This ensures the add-in works correctly without any additional configuration from end users.Forwarding
anthropic-beta and anthropic-version headers is required. The add-ins use these headers to enable beta features and specify the API version. If your gateway doesn’t forward them, the add-ins may not work correctly.Step 3: Create a Portkey API Key
- Go to API Keys → Create new key
- (Optional) Attach your Config from Step 2
- (Optional) Set a budget limit for this key
- Copy the API key
Step 4: Configure the Add-In
Share the following credentials with your users:- Gateway URL:
https://api.portkey.ai - API token: The Portkey API key from Step 3
- Open the Claude add-in
- On the sign-in screen, select “Enterprise gateway”
- Enter the Gateway URL and API token
- Click Test connection — the add-in validates the connection and discovers available models
Credentials are stored locally in the add-in’s browser
localStorage. They are never sent to Anthropic. Only distribute gateway-issued tokens — not raw cloud provider credentials.Provider Configurations
Route to Anthropic Directly
@anthropic-prod in Model Catalog with your Anthropic API key.
Route to Amazon Bedrock
@bedrock-prod in Model Catalog with your AWS credentials. Portkey handles the translation from Anthropic Messages API format to Bedrock’s InvokeModel format.
Route to Google Vertex AI
@vertex-prod in Model Catalog with your GCP service account credentials.
Multi-Provider Fallback
For high availability, configure automatic fallback across providers:Enterprise Governance
Budget Controls Per Team
Create separate API keys for different teams, each with their own budget:- Go to API Keys → Create key for each team
- Attach a budget limit (e.g., $500/month per team)
- Distribute the team-specific key to that team’s employees
Workspace Isolation
Use Portkey Workspaces to fully isolate teams. Each workspace gets its own:- Logs and analytics
- Budget limits
- API keys and access controls
Add Metadata for Chargeback
Add metadata to track usage by department, cost center, or user. Attach this to your Config or API key:What’s Supported Through the Gateway
Connectors, file uploads, memory, and skills require a Claude account sign-in. These are not available through any LLM gateway (including Portkey). If your users need these features, they should sign in with a Claude account instead.
Troubleshooting
Next Steps
Gateway Configs
Learn about fallbacks, load balancing, and routing strategies
Budget & Rate Limits
Set spending controls per team or user
Observability
Logs, traces, and analytics for all add-in requests
Workspaces
Isolate teams with separate budgets and access controls

