Setup Guide

Open your Terminal

On your Mac, press ⌘ Command + Space to open Spotlight Search, type Terminal, and press Enter.

💡 Terminal is a text-based way to control your computer. You only need to paste one command — no experience required.

Run the setup command

There are two ways to run this command — choose whichever feels easier:

This writes your settings directly to Claude Code's config file (~/.claude/settings.json), so tracking works whether you open Claude from the Dock, Spotlight, or Terminal.

Open Claude Code, copy the command below, and send Claude a message like: "Please run this command in my terminal exactly as written:" followed by the copied command. Claude may display a permission prompt before executing it — this is expected. Click Allow to proceed.

Open Terminal (⌘ + Space, type Terminal, press Enter), paste the command, and press Enter.

python3 - << 'SETUP'
import json, pathlib
p = pathlib.Path.home() / '.claude' / 'settings.json'
p.parent.mkdir(exist_ok=True)
s = json.loads(p.read_text()) if p.exists() else {}
s.setdefault('env', {}).update({
    'CLAUDE_CODE_ENABLE_TELEMETRY': '1',
    'CLAUDE_CODE_ENHANCED_TELEMETRY_BETA': '1',
    'OTEL_TRACES_EXPORTER': 'otlp',
    'OTEL_EXPORTER_OTLP_ENDPOINT': 'https://telemetry.usagetracker.luxrnd.tech',
    'OTEL_EXPORTER_OTLP_PROTOCOL': 'http/protobuf',
    'OTEL_RESOURCE_ATTRIBUTES': 'user.email=YOUR_EMAIL',
})
p.write_text(json.dumps(s, indent=2))
print('Done:', p)
SETUP

💡 Enter your email above to personalize this command before copying.

Restart Claude Code

Fully quit Claude Code and reopen it. On Mac, right-click the Claude Code icon in your Dock and choose Quit — or press ⌘ Command + Q while Claude Code is focused.

Then reopen Claude Code as normal.

💡 Closing the window is not enough — you need to fully quit the app so it picks up the new settings.

Verify it's working

Use Claude Code for anything — ask it a question, start a project, or just say "hello". Then come back to this dashboard and check the Dashboard or 5-Hour page.

Your name and token usage should appear within 30–60 seconds.

💡 If nothing shows up after a minute, make sure you entered your email above before copying the command, and that you fully quit and reopened Claude Code.