Claude Code is Anthropic’s agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster through natural language commands. With Portkey integration, you can enhance Claude Code with enterprise features:

Unified AI Gateway - Route Claude Code through multiple providers (Anthropic, Bedrock, Vertex AI)
Centralized AI observability: Real-time usage tracking for 40+ key metrics and logs for every request
Governance - Real-time spend tracking, set budget limits and RBAC in your Claude Code setup

1. Setting up Portkey

Portkey allows you to use 1600+ LLMs with your Claude Code setup, with minimal configuration required. Let’s set up the core components in Portkey that you’ll need for integration.

Create an Integration

Navigate to the Integrations section on Portkey’s Sidebar. This is where you’ll connect your LLM providers.

Find your preferred provider (Anthropic, Bedrock, and Vertex AI)
Click Connect on the provider card
In the “Create New Integration” window:
- Enter a Name for reference
- Enter a Slug for the integration
- Enter your API Key and other provider-specific details for the provider
Click Next Step

In your next step you’ll see workspace provisioning options. You can select the default “Shared Team Workspace” if this is your first time OR chose your current one.

Configure Models

On the model provisioning page:

Leave all models selected (or customize)
Toggle Automatically enable new models if desired

Click Create Integration to complete the integration

Make sure you enable the models that work with Claude Code

Copy the Provider Slug

Once your Integration is created:

Go to Model Catalog → Models tab
Find and click on you your model button (if your model is not visible, you need to edit your integration from the last step). Make Sure you use Claude models that are supported by Claude Code: sonnet 4/3.7, opus 4, etc.
Copy the slug (e.g., @anthropic-claude-code/claude-4-sonnet-latest)

We recommend clicking the Run Test Request button on this step to verify your integration. If you see the error: You do not have enough permissions to execute this request, you’ll need to create a User API Key for this step to work properly. Create one here.
Currently you can only use Claude models on Claude code using any provider (Bedrock, Vertexl, and Anthtropic)

This is your unique identifier - you’ll need it for the next step. This slug is basically @your-provider-slug/your-model-name

Create Default Config

Portkey’s config is a JSON object used to define routing rules for requests to your gateway. You can create these configs in the Portkey app and reference them in requests via the config ID. For this setup, we’ll create a simple config using your provider (Anthropic) and model (claude-sonnet-latest).

Go to Configs in Portkey dashboard

Create new config with:

{
    "override_params": {
      "model": "@YOUR_SLUG-FROM-LAST_STEP" // example: @Anthropic-test/claude-sonnet-latest-mini
    }
}

Save and note the Config ID & Name for the next step

Configure Portkey API Key

Finally, create a Portkey API key:

Go to API Keys in Portkey
Create a new API key
Select the config that you created from the previous step
Generate and save your API key

Save your API key securely - you’ll need it for Claude Code integration.

🎉 Voila, Setup complete! You now have everything needed to integrate Portkey with your application.

2. Integrate Portkey with Claude Code

Claude Code uses a settings.json file for configuration. You’ll need to modify the environment variables to route requests through Portkey.

For more details on Claude Code proxy configuration, see Anthropic’s documentation.

Edit your Claude Code settings file (~/.claude/settings.json for global or .claude/settings.json in your project):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
    "ANTHROPIC_AUTH_TOKEN": "dummy",
    "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY"
  }
}

This same JSON will work for Anthropic, Bedrock and Vertex. You will need your Portkey API key created in Step 1 for this integration

3. Set Up Enterprise Governance for Claude Code

Why Enterprise Governance? If you are using Claude Code inside your organization, you need to consider several governance aspects:

Cost Management: Controlling and tracking AI spending across teams
Access Control: Managing team access and workspaces
Usage Analytics: Understanding how AI is being used across the organization
Security & Compliance: Maintaining enterprise security standards
Reliability: Ensuring consistent service across all users
Model Management: Managing what models are being used in your setup

Portkey adds a comprehensive governance layer to address these enterprise Enterprise Implementation Guide

Step 1: Implement Budget Controls & Rate Limits

Step 2: Define Model Access Rules

Step 4: Set Routing Configuration

Portkey allows you to control your routing logic very simply with its Configs feature. Portkey Configs provide this control layer with things like:

Data Protection: Implement guardrails for sensitive code and data
Reliability Controls: Add fallbacks, load-balance, retry ,and smart conditional routing logic
Caching: Implement Simple and Semantic Caching. and more…

Example Configuration:

Here’s a basic configuration to load-balance requests to Anthropic and Anthropic:

{
	"strategy": {
		"mode": "load-balance"
	},
	"targets": [
		{
			"override_params": {
				"model": "@YOUR_Anthropic_PROVIDER_SLUG/gpt-model"
			}
		},
		{
			"override_params": {
				"model": "@YOUR_ANTHROPIC_PROVIDER/claude-sonnet-model"
			}
		}
	]
}

Create your config on the Configs page in your Portkey dashboard. You’ll need the config ID for connecting to Claude Code’s setup.

Configs can be updated anytime to adjust controls without affecting running applications.

Step 4: Implement Access Controls

Step 3: Implement Access Controls

Create User-specific API keys that automatically:

Track usage per developer/team with the help of metadata
Apply appropriate configs to route requests
Collect relevant metadata to filter logs
Enforce access permissions

Create API keys through:

Example using Python SDK:

from portkey_ai import Portkey

portkey = Portkey(api_key="YOUR_ADMIN_API_KEY")

api_key = portkey.api_keys.create(
    name="frontend-engineering",
    type="organisation",
    workspace_id="YOUR_WORKSPACE_ID",
    defaults={
        "config_id": "your-config-id",
        "metadata": {
            "environment": "development",
            "department": "engineering",
            "team": "frontend"
        }
    },
    scopes=["logs.view", "configs.read"]
)

For detailed key management instructions, see our API Keys documentation.

Step 5: Deploy & Monitor

Max Plan and Anthropic Oauth (Enterprise Only)

If you are using max plan or logging in with anthropic, you can still use Portkey to track usage and cost, apply ratelimiting and more. Here is an example of how to configure your ~/.claude/settings.json to use Portkey with max plan or anthropic oauth:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
    "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY",
  }
}

Enterprise Features Now Available

Claude Code now has:

Per-developer budget controls
Model access governance
Usage tracking & attribution
Code security guardrails
Reliability features for development workflows

Portkey Features

Now that you have enterprise-grade Claude Code setup, let’s explore the comprehensive features Portkey provides to ensure secure, efficient, and cost-effective AI-assisted development.

1. Comprehensive Metrics

Using Portkey you can track 40+ key metrics including cost, token usage, response time, and performance across all your LLM providers in real time. Filter these metrics by developer, team, or project using custom metadata.

2. Advanced Logs

Portkey’s logging dashboard provides detailed logs for every request made by Claude Code. These logs include:

Complete request and response tracking
Code context and generation metrics
Developer attribution
Cost breakdown per coding session

3. Unified Access to 250+ LLMs

Easily switch between 250+ LLMs for different coding tasks. Use GPT-4 for complex architecture decisions, Claude for detailed code reviews, or specialized models for specific languages - all through a single interface.

4. Advanced Metadata Tracking

Track coding patterns and productivity metrics with custom metadata:

Language and framework usage
Code generation vs completion tasks
Time-of-day productivity patterns
Project-specific metrics

Custom Metadata

5. Enterprise Access Management

Budget Controls

Set and manage spending limits per developer or team. Prevent budget overruns with automatic cutoffs.

Single Sign-On (SSO)

Enterprise-grade SSO integration for seamless developer onboarding and offboarding.

Organization Management

Hierarchical structure with teams, projects, and role-based access control for development organizations.

Access Rules & Audit Logs

Comprehensive audit logging for security compliance and code generation tracking.

6. Reliability Features

Fallbacks

Automatically switch between models if one fails, ensuring uninterrupted coding.

Conditional Routing

Route requests based on code complexity or language requirements.

Load Balancing

Distribute requests across multiple API keys or providers.

Caching

Cache common code patterns to reduce costs and improve response times.

Smart Retries

Automatic retry handling for failed requests with exponential backoff.

Budget Limits

Enforce spending limits to control development costs.

7. Advanced Guardrails

Protect your codebase and enhance security with real-time checks on AI interactions:

Prevent exposure of API keys and secrets
Block generation of malicious code patterns
Enforce coding standards and best practices
Custom security rules for your organization
License compliance checks

Guardrails

Implement real-time protection for your development environment with automatic detection and filtering of sensitive code, credentials, and security vulnerabilities.

Next Steps

Join our Community

Schedule a Demo

Schedule a 1:1 call with our team to see how Portkey can transform your development workflow with Claude Code. Get personalized recommendations for your team’s specific needs.

For enterprise support and custom features for your development teams, contact our enterprise team.

Ecosystem

LLM Integrations

Cloud Platforms

Guardrails

Plugins

Vector Databases

Agents

AI Apps

Libraries

Tracing Providers

​1. Setting up Portkey

​2. Integrate Portkey with Claude Code

​3. Set Up Enterprise Governance for Claude Code

​Max Plan and Anthropic Oauth (Enterprise Only)

​Enterprise Features Now Available

​Portkey Features

​1. Comprehensive Metrics

​2. Advanced Logs

​3. Unified Access to 250+ LLMs

​4. Advanced Metadata Tracking

Custom Metadata

​5. Enterprise Access Management

Budget Controls

Single Sign-On (SSO)

Organization Management

Access Rules & Audit Logs

​6. Reliability Features

Fallbacks

Conditional Routing

Load Balancing

Caching

Smart Retries

Budget Limits

​7. Advanced Guardrails

Guardrails

​Next Steps

Schedule a Demo

1. Setting up Portkey

2. Integrate Portkey with Claude Code

3. Set Up Enterprise Governance for Claude Code

Max Plan and Anthropic Oauth (Enterprise Only)

Enterprise Features Now Available

Portkey Features

1. Comprehensive Metrics

2. Advanced Logs

3. Unified Access to 250+ LLMs

4. Advanced Metadata Tracking

5. Enterprise Access Management

6. Reliability Features

7. Advanced Guardrails

Next Steps