Installation

Plugin with managed settings

Claude Code’s server-managed settings let you deliver configuration from Anthropic’s admin console to every authenticated user in your organization, with no MDM and no per-device work, and it follows the user to whatever machine they sign in on.

This is the fastest path to a working rollout. The trade-off is that it has no targeting: the configuration applies to every authenticated user in the organization as soon as you save it, so you can’t pilot with a single team first.

Requires Claude for Teams or Enterprise.

If you want to stage the rollout (one team first, then widen), use MDM instead. That’s our general recommendation, and it’s also the path to use if your developers are on personal Claude accounts or you need to cover machines whose accounts you don’t control.

Generate the configuration

You can hand-write the JSON, but the product will build it for you, including any cost policies you’ve already configured.

In Opik, go to Cost Intelligence → Organization Policies and use Copy settings file. The generated JSON contains the plugin bootstrap that you can use in the Claude Code admin console.

Apply it in the admin console

1

Open the managed settings editor

In Claude.ai, go to Admin Settings → Claude Code → Managed settings.

2

Paste your configuration

If you generated it above, paste it as-is. Otherwise start from this template:

1{
2  "extraKnownMarketplaces": {
3    "opik-enterprise": {
4      "source": { "source": "github", "repo": "comet-ml/cost-intelligence-proxy" },
5      "autoUpdate": true
6    }
7  },
8  "enabledPlugins": {
9    "opik-cipx@opik-enterprise": true
10  },
11  "env": {
12    "OPIK_CIPX_BASE_URL": "https://www.comet.com/opik/api",
13    "OPIK_CIPX_WORKSPACE": "your-org-cc-workspace",
14    "OPIK_CIPX_API_KEY": "<workspace-scoped API key>",
15    "OPIK_CIPX_PROJECT": "claude-code"
16  },
17  "forceRemoteSettingsRefresh": true
18}
3

Save

Clients pick the configuration up at their next startup, or within the hourly poll for sessions already running.

What each part does

KeyEffect
extraKnownMarketplacesRegisters the Comet plugin marketplace. autoUpdate: true keeps the plugin current without another admin action.
enabledPluginsForce-enables the plugin for every user. It appears to them as managed and cannot be disabled.
OPIK_CIPX_BASE_URLThe Opik installation traces are shipped to.
OPIK_CIPX_WORKSPACETarget workspace. Keeps fleet traffic isolated from developers’ personal Opik projects.
OPIK_CIPX_API_KEYWorkspace-scoped service-account key.
OPIK_CIPX_PROJECTOpik project the traces land in.
forceRemoteSettingsRefreshMakes clients re-read settings promptly rather than waiting out the cache.

Use a service-account API key scoped to ingest, never a personal token. Managed settings are readable by the Claude Code process on each device, so treat the key as distributed the moment you save. Rotate it by updating this configuration.

What happens on a developer’s machine

Nothing they have to do. On the next Claude Code launch:

  1. The plugin installs and registers a SessionStart hook.
  2. The hook runs opik-cipx sync, which is idempotent: it installs an OS supervisor (launchd on macOS, systemd on Linux) so the daemon restarts on crash, starts the daemon if it isn’t running, and points Claude Code at the local proxy by setting ANTHROPIC_BASE_URL in ~/.claude/settings.json.
  3. Capture begins. Every subsequent session is picked up automatically.

The proxy binds loopback only and Claude Code talks plain HTTP to it, so no certificate is installed and no TLS is intercepted.

The hook tolerates a missing binary: if anything about the install is incomplete it prints a hint and lets the session continue. Cost Intelligence is designed never to be the reason a developer can’t work.

Verify

On a developer machine, in a fresh Claude Code session:

$claude plugin list        # opik-cipx@opik-enterprise -> enabled / managed
$opik-cipx status          # daemon up, config resolved, spans shipped

Then confirm traces are landing in the target Opik workspace. That’s the check that actually proves the rollout worked.

Using your own gateway

If your traffic goes through a corporate LLM gateway, LiteLLM, or an AWS Bedrock access gateway rather than straight to the provider, add its origin:

1{
2  "env": {
3    "OPIK_CIPX_UPSTREAM_BASE_URL": "https://gateway.internal.example.com"
4  }
5}

The gateway must expose the Anthropic Messages API. Because a gateway bills under its own account, sessions are reported as API-priced with no subscription plan, and user identity comes from the environment channel rather than an OAuth profile. Set OPIK_CIPX_USER_EMAIL and OPIK_CIPX_USERNAME alongside it if git and OS identity aren’t reliable on your fleet.

Next steps

Reduce coding agent spend

Now that data is flowing, find and cut the waste.

Install with MDM

Cover machines whose Claude accounts you don’t centrally manage.