Setup guide

Overview

Aimeterly is a managed service. You distribute a single Claude Code configuration snippet (an env block) across your organization; Claude Code then sends usage telemetry to your dedicated endpoint, and it appears on your dashboard within a few minutes. There are two ways to distribute it: push it from the Claude Team / Enterprise admin console, or place managed-settings.json on each machine. Enabling telemetry and distributing the settings within your organization are performed by your organization's administrators.

1. Sign up and create an organization

Create an account and your organization. A dedicated ingest endpoint and an ingest token are issued immediately. Every new organization starts with a 14-day Pro trial.

2. Get your configuration snippet

On the setup screen inside the app, copy your configuration snippet. It looks like the example below, with your real endpoint and token filled in. The snippet is the single source of the required environment variables, so you never assemble them by hand. The same content works as-is with either distribution option in the next section.

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_INGEST_ENDPOINT>",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer <YOUR_INGEST_TOKEN>",
    "OTEL_RESOURCE_ATTRIBUTES": "department=<チーム名>"
  }
}

Replace <YOUR_INGEST_ENDPOINT> with the ingest endpoint shown on your setup screen, and <YOUR_INGEST_TOKEN> with the token shown when you issue it. The plaintext token is displayed only once at issue time; if you lose it, rotate the token to get a new one.

3. Distribute the settings (two options)

There are two ways to distribute the snippet. If your organization uses Claude Code on a Claude Team / Enterprise plan (signing in via claude.ai), option A is the simplest: paste it once in the admin console and it reaches everyone. Use option B if you manage devices with MDM, or in environments where option A is unavailable (for example, third-party providers such as Amazon Bedrock or Google Cloud). The distributed content (the env block) is identical either way.

Option A: Distribute from the Claude Team / Enterprise admin console

On Claude Team / Enterprise plans, an administrator registers the settings JSON in claude.ai, and it is delivered automatically to every member's Claude Code via Anthropic's servers (server-managed settings). No MDM or per-machine file distribution is needed.

1. Sign in to claude.ai with an Owner or Primary Owner account and open Admin Settings → Claude Code → Managed settings. Other roles cannot view or edit this page.
2. Paste the snippet (JSON in the same format as settings.json) into the editor, replace the ingest token with your real value, and save.
3. Members' Claude Code receives the settings on the next startup or through the hourly automatic refresh. Telemetry settings require a full restart of Claude Code to take effect, so ask members to restart.
4. Depending on the contents, members may see a managed-settings approval dialog at startup. Ask them to review and approve it.

Server-managed settings apply uniformly to the whole organization and are delivered when members authenticate with an organization account (claude.ai sign-in or an organization API key). They are not delivered when using third-party providers such as Amazon Bedrock, Google Cloud, or Microsoft Foundry. Also, while server-managed settings deliver any keys, managed-settings.json on the machine is ignored — take care when combining both options.

Option B: Place managed-settings.json on each machine

Save the snippet as managed-settings.json and put it at the OS-level managed settings path on each machine, then distribute it across your organization with your usual device management tooling. Settings at this path take precedence and cannot be overridden by individual users.

• macOS: /Library/Application Support/ClaudeCode/managed-settings.json
• Linux: /etc/claude-code/managed-settings.json
• Windows: C:\ProgramData\ClaudeCode\managed-settings.json

Distributing the file to employee machines is the responsibility of your organization's administrators.

4. Confirm the connection

On a machine that has received the settings, run claude and use it for a few minutes. Telemetry is exported in the background. Return to the setup screen; once data arrives, the status changes to connected, usually within about five minutes.

If the status stays on waiting, double-check that the settings have arrived (for option A, restart Claude Code and sign in with an organization account; for option B, verify the file path) and that the endpoint and token were filled in correctly.

5. Break usage down by team (optional)

To see usage by team or department, set the OTEL_RESOURCE_ATTRIBUTES line in the snippet to your team name — for example department=engineering. The snippet already includes an OTEL_RESOURCE_ATTRIBUTES line with a placeholder team name for you to replace. Values you set here are preserved as an aggregation axis on your dashboards.

6. Enable content capture (optional)

Content capture records the text of prompts, responses, and tool input and output. All four categories are off by default; your organization opts in per category. When you enable a category on the capture settings screen, the snippet gains the matching Claude Code logging settings, so you must update the distributed settings (the JSON in the admin console, or managed-settings.json) for the change to take effect.

Enabling content capture, notifying employees, and obtaining any required consent are the responsibility of your organization. See the Privacy Policy for exactly what is recorded. Privacy Policy