From 244720d8a3d80456324667486818f141eead4cc9 Mon Sep 17 00:00:00 2001 From: Ishaan Jaffer Date: Thu, 15 Jan 2026 18:16:22 -0800 Subject: [PATCH] v1 guide --- .../claude_code_customer_tracking.md | 69 +++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 docs/my-website/docs/tutorials/claude_code_customer_tracking.md diff --git a/docs/my-website/docs/tutorials/claude_code_customer_tracking.md b/docs/my-website/docs/tutorials/claude_code_customer_tracking.md new file mode 100644 index 00000000000..78a9a644fcf --- /dev/null +++ b/docs/my-website/docs/tutorials/claude_code_customer_tracking.md @@ -0,0 +1,69 @@ +# Claude Code - Track Customer Usage + +Track usage per customer when using Claude Code with LiteLLM proxy. This enables per-customer cost tracking and budget management for Claude Code users. + +## How It Works + +LiteLLM supports standard customer ID headers that work out-of-the-box with Claude Code's custom headers feature. Set `ANTHROPIC_CUSTOM_HEADERS` to pass a customer ID with every request. + +## Environment Variables + +| Variable | Description | Example | +|----------|-------------|---------| +| `ANTHROPIC_BASE_URL` | LiteLLM proxy URL | `http://localhost:4000` | +| `ANTHROPIC_API_KEY` | LiteLLM API key (master key or virtual key) | `sk-1234` | +| `ANTHROPIC_CUSTOM_HEADERS` | Custom headers in `header-name: value` format | `x-litellm-customer-id: my-customer` | + +## Quick Start + +### 1. Set Environment Variables + +```bash +export ANTHROPIC_BASE_URL=http://localhost:4000 +export ANTHROPIC_API_KEY=sk-1234 +export ANTHROPIC_CUSTOM_HEADERS="x-litellm-customer-id: claude-ishaan-local" +``` + +The `ANTHROPIC_CUSTOM_HEADERS` format is `header-name: value`. LiteLLM automatically tracks requests with `x-litellm-customer-id` or `x-litellm-end-user-id` headers. + +### 2. Use Claude Code + +```bash +claude +``` + +All requests will now be tracked under the customer ID `claude-ishaan-local`. + +![](https://colony-recorder.s3.amazonaws.com/files/2026-01-16/8f45872e-2d00-4d01-bf3d-4d6ae11d1396/ascreenshot_d2a745b8da4f4a56aaf2cac02871ef53_text_export.jpeg) + +![](https://colony-recorder.s3.amazonaws.com/files/2026-01-16/dd41eae3-2592-4bc9-a8d2-d6d02614cd2d/ascreenshot_43ec9ee48ad946cca49732f007e786fc_text_export.jpeg) + +![](https://colony-recorder.s3.amazonaws.com/files/2026-01-16/0c30309e-7117-4999-a3df-d22a2d5629c1/ascreenshot_d76a48c53b9a4fad8f6727baf4aa6a9c_text_export.jpeg) + +### 3. View Customer Usage + +Navigate to the **Logs** tab in the LiteLLM UI. + +![](https://colony-recorder.s3.amazonaws.com/files/2026-01-16/ff774392-69f5-483e-83e2-fb749c94ee90/ascreenshot_d264fc04c9ee47edb047f61b6eb8c4d7_text_export.jpeg) + +Click on a request to see details. + +![](https://colony-recorder.s3.amazonaws.com/files/2026-01-16/5f71589b-5fdd-4759-9b6e-e6874be0eb21/ascreenshot_92dd86dadccb4764b1169c29c10dfe65_text_export.jpeg) + +Filter by customer ID to see all requests for that customer. + +![](https://colony-recorder.s3.amazonaws.com/files/2026-01-16/dd1c8aba-e75b-4714-9eee-c785e9db99af/ascreenshot_36aaec0fe12f4189b64f704a551e6729_text_export.jpeg) + +## Supported Headers + +LiteLLM checks these headers automatically (no configuration required): + +- `x-litellm-customer-id` +- `x-litellm-end-user-id` + +## Related + +- [Claude Code Quickstart](./claude_responses_api.md) +- [Customer Budgets](../proxy/customers.md) +- [Track Usage for Coding Tools](./cost_tracking_coding.md) +