Configuring Claude Code (OpenTelemetry)

Overview

LinearB integrates with Claude Code to capture development metrics through OpenTelemetry instrumentation. You can configure this integration at the individual user level or organization-wide using Claude's managed settings.

Configure organization-wide integration using Claude managed settings

Use Claude's managed settings to deploy the LinearB OpenTelemetry configuration to all users in your organization automatically.

1. In LinearB, navigate to Settings > Integrations.
2. Select Claude Code.
3. Copy your organization's OpenTelemetry endpoint URL and API key.
4. In your Claude organization settings, navigate to the managed settings configuration.
5. Add the LinearB OpenTelemetry configuration to your organization's Claude settings file.
6. Deploy the managed settings to your organization.

All users in your organization will receive the LinearB integration automatically when they sync their Claude settings.

Configure individual user integration

Individual users can configure the LinearB integration directly in their Claude Code settings based on their Claude deployment type.

Configure Claude Code with Anthropic API

When using Claude Code with the Anthropic API, the application automatically includes user identifiers in the telemetry data.

Get your OpenTelemetry credentials

1. In LinearB, navigate to Settings > Integrations.
2. Select Claude Code.
3. Copy your OpenTelemetry endpoint URL.
4. Copy your API key.

Add the configuration to Claude Code

1. Open Claude Code.
2. Navigate to Settings.
3. Locate the OpenTelemetry configuration section.
4. Paste your endpoint URL in the Endpoint field.
5. Paste your API key in the API Key field.
6. Save your settings.

[SCREENSHOT NEEDS UPDATING]

Configure Claude Code with AWS Bedrock

When using Claude Code with AWS Bedrock, the transmitted data does not include user identifiers by default. You must manually add your email identifier to enable proper attribution in LinearB.

Get your OpenTelemetry credentials

1. In LinearB, navigate to Settings > Integrations.
2. Select Claude Code.
3. Copy your OpenTelemetry endpoint URL.
4. Copy your API key.

Add the configuration to Claude Code

1. Locate your Claude settings file at ~/.claude/settings.json
2. Open the file in a text editor
3. Add the OpenTelemetry endpoint URL and API key configuration provided by your LinearB administrator
4. Add the following JSON section inside the top-level brackets { ... }:

"env": { "OTEL_RESOURCE_ATTRIBUTES": "user.email=USER.EMAIL@USER_ORG.COM" }

5. Replace USER.EMAIL@USER_ORG.COM with your actual email address
6. Save the file
7. Restart Claude Code for the changes to take effect

Example configuration:

{
  "env": { "OTEL_RESOURCE_ATTRIBUTES": "user.email=jane.smith@company.com" },
  "other_settings": "..."
}

Verify the integration

After you configure the integration, verify that LinearB receives telemetry data from Claude Code.

1. Use Claude Code to perform development activities (code generation, chat interactions, edits).
2. In LinearB, navigate to Activity or your metrics dashboard.
3. Confirm that Claude Code activity appears in your metrics within a few minutes.

Troubleshoot connection issues

If LinearB doesn't receive data from Claude Code:

• Verify your API key is correct and hasn't expired.
• Confirm your endpoint URL matches exactly (including https://).
• Check that your network allows outbound connections to the LinearB endpoint.
• For AWS Bedrock deployments, verify you added your email address to the OTEL_RESOURCE_ATTRIBUTES field.
• Restart Claude Code after updating your configuration.
• For organization-wide deployments, verify users have synced their managed settings.

If issues persist, contact LinearB support with your organization ID and the approximate time you attempted to send data.