> 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-team-plan-on-prem.md).

# Claude team plan: On-Prem

Hivel tracks your team's Claude Code usage through Claude's organization-managed settings configured for your on-prem collector. You paste a settings snippet into Claude.ai once. Then usage telemetry flows to your collector automatically.

### **Prerequisites**

* Your organization is on the Claude Team plan (claude.ai)
* You are an Owner or Admin of your Claude organization
* You have the IP address of your on-prem VM ready

### **In Hivel:**

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 **Team** and click **Continue**.

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FnBY92oFLqh23BgxqrfEQ%2FScreenshot%202026-08-19%20at%205.00.14%E2%80%AFAM.png?alt=media&amp;token=d818049b-cef2-4351-8880-a4da45fc1a92" alt=""><figcaption></figcaption></figure>

4. Copy the settings script displayed in the UI.
5. You can then directly open **Claude organization settings** from Hivel's Ui or refer to Step 1 in the next section.

![](https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FuVD64ee0dZ9O8IzrNcv2%2FScreenshot%202026-08-19%20at%205.01.18%E2%80%AFAM.png?alt=media\&token=48b74f26-3e28-47a1-8a85-565f58a95a5e)

### **In Claude.ai:**

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)