Claude Code - Granular Cost Tracking
Track Claude Code usage by customer or tags using LiteLLM proxy. This enables granular cost attribution for billing, budgeting, and analytics.
How It Worksβ
Claude Code supports custom headers via ANTHROPIC_CUSTOM_HEADERS. LiteLLM automatically tracks requests with specific headers for cost attribution.
Tracking Optionsβ
Choose how you want to attribute costs:
| Track By | Header | Use Case |
|---|---|---|
| Customer | x-litellm-customer-id | Bill customers, per-user budgets |
| Tags | x-litellm-tags | Project tracking, cost centers, environments |
Environment Variablesβ
| Variable | Description | Example |
|---|---|---|
ANTHROPIC_BASE_URL | LiteLLM proxy URL | http://localhost:4000 |
ANTHROPIC_API_KEY | LiteLLM API key | sk-1234 |
ANTHROPIC_CUSTOM_HEADERS | Custom headers (header-name: value format) | See examples below |
Option 1: Track by Customerβ
Use this to attribute costs to specific customers or end-users.
export ANTHROPIC_BASE_URL=http://localhost:4000
export ANTHROPIC_API_KEY=sk-1234
export ANTHROPIC_CUSTOM_HEADERS="x-litellm-customer-id: claude-ishaan-local"
Option 2: Track by Tagsβ
Use this to attribute costs to projects, cost centers, or environments. Pass comma-separated tags.
export ANTHROPIC_BASE_URL=http://localhost:4000
export ANTHROPIC_API_KEY=sk-1234
export ANTHROPIC_CUSTOM_HEADERS="x-litellm-tags: project:acme,env:prod,team:backend"
Quick Startβ
1. Set Environment Variablesβ
export ANTHROPIC_BASE_URL=http://localhost:4000
export ANTHROPIC_API_KEY=sk-1234
export ANTHROPIC_CUSTOM_HEADERS="x-litellm-customer-id: claude-ishaan-local"
2. Use Claude Codeβ
claude
All requests will now be tracked under the customer ID claude-ishaan-local.
3. View Usage in LiteLLM UIβ
Navigate to the Logs tab in the LiteLLM UI.
Click on a request to see details.
Filter by customer ID to see all requests for that customer.
Supported Headersβ
| Header | Description |
|---|---|
x-litellm-customer-id | Track by customer/end-user ID |
x-litellm-end-user-id | Alternative customer ID header |
x-litellm-tags | Comma-separated tags for cost attribution |