> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/integrations/ai-tools/claude-integrations/claude-on-prem/claude-enterprise-plan-on-prem.md).

# Claude Enterprise plan : On-Prem

Hivel tracks your enterprise's Claude Code usage through an Enterprise API key and organization-managed settings configured for your on-prem collector. You create an API key in Claude.ai, paste it in Hivel, then apply a settings snippet back in Claude.ai. Usage telemetry flows to your collector automatically. 

### **Prerequisites**

* Your organization is on the Claude Enterprise plan (claude.ai)
* You are the **Primary Owner** (Admin access is not sufficient) of your Claude organization.
* You have the IP address of your on-prem VM ready

### **In Claude.ai, Create API Key:**

1. Go to [Claude API access settings](https://claude.ai/admin-settings/api-access).
2. Click **+ Create key**.
3. Give it a descriptive name (e.g., "Hivel Enterprise On-Prem").
4. Select these read-only scopes:
   * `read:org_audit`
   * `read:analytics`
   * `read:spend_limits`
   * `read:members`
   * `read:rbac_groups`
5. Click **Create** to generate the key.
6. Copy and securely save the API key.

### **In Hivel, Add API Key:**

1. Go to [Hivel](https://app.hivel.ai/settings/) → **Settings** → **Integrations** tab.

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FBmr0wKVXridd3vsOMGf0%2FScreenshot%202026-08-18%20at%205.28.40%E2%80%AFPM.png?alt=media&amp;token=bcb84e79-eca3-470e-a077-ac43462fb941" alt=""><figcaption></figcaption></figure>

2. Search for **Claude Code** and click **Connect**.

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FQYyEmmh9AdDCxbtuJLA2%2FScreenshot%202026-08-19%20at%204.49.27%E2%80%AFAM.png?alt=media&amp;token=47fef553-5e36-43e3-ae20-4337c1bf587e" alt=""><figcaption></figcaption></figure>

3. Select **Enterprise** and click **Continue**.

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F02FyoHpzrusVM1xTf5IB%2FScreenshot%202026-08-19%20at%204.51.04%E2%80%AFAM.png?alt=media&amp;token=23a97f21-9ad9-486d-9683-6376a7c0d77d" alt=""><figcaption></figcaption></figure>

4. Paste the API key and click **Verify & continue**.

![](https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FKeDX4kI7n3OCf6ZZu1zt%2FScreenshot%202026-08-19%20at%204.52.42%E2%80%AFAM.png?alt=media\&token=2993b009-d32e-46bd-8fe5-35b4dd16ff9b)

5. Copy the settings script displayed in the UI.

### **In Claude.ai, Apply Settings:**

1. Go to [Claude organization settings](https://claude.ai/admin-settings/claude-code).
2. Next to **Managed settings** (settings.json), click **Manage**.

![](https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FZg69OIlUo1lyPoU3b27Q%2Funknown.png?alt=media\&token=64c61d1b-e0ba-4c3f-a589-115053752c58)

3. Paste the script from Hivel into the Managed settings editor.

> **Critical: Update On-Prem Endpoint:**\
> Before clicking Update settings, you must manually change the `OTEL_EXPORTER_OTLP_ENDPOINT` field to point to your on-prem VM:
>
> ```
> "OTEL_EXPORTER_OTLP_ENDPOINT": "http://<your-on-prem-VM-IP>:4317"
> ```
>
> This value does not update automatically and must be edited before use.

**Complete the Setup:**

4. Click **Update settings**.
5. Return to Hivel and click **I've pasted it on the UI** to confirm.

### **Important:**

Verify `"OTEL_RESOURCE_ATTRIBUTES": "org.HivelId=1"` is set to `1`. Contact <support@hivel.ai> if missing.

### **What Happens Next**

The settings roll out to your team's Claude Code automatically. Usage data flows to your on-prem collector as your team runs Claude Code sessions.

#### **To continue setting up your integrations →** [Back to Integrations](/integrations.md)