Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.latitude.so/llms.txt

Use this file to discover all available pages before exploring further.

​
Claude Code telemetry

Stream Claude Code conversations into Latitude as traces. After setup, Claude Code turns appear in your project’s Traces view with prompts, responses, tool calls, and tool results.

​
Prerequisites

  • A Latitude account with a project
  • Claude Code installed locally
  • Node.js available on your PATH
This integration works with local Claude Code surfaces that support hooks, including the CLI, desktop app, and IDE extensions. It does not run inside the hosted Claude web app.

​
Install

  1. In Latitude, copy your project slug from the project sidebar.
  2. Create or copy an API key from Settings → API Keys.
  3. Run the installer:
npx -y @latitude-data/claude-code-telemetry install
The installer prompts for your API key and project slug, then configures Claude Code to export telemetry after each turn. You can also pass values directly: 
npx -y @latitude-data/claude-code-telemetry install \
  --api-key=lat_xxx \
  --project=your-project-slug \
  --yes

​
Restart and verify

Fully quit and relaunch Claude Code, then run any prompt. Open your Latitude project and go to Traces. The new trace should appear within a few seconds.

​
Disable or uninstall

To pause telemetry temporarily: 
export LATITUDE_CLAUDE_CODE_ENABLED=0
Restart Claude Code for the change to take effect. To remove the integration: 
npx -y @latitude-data/claude-code-telemetry uninstall

​
Manual configuration

If you manage Claude Code settings yourself, add the telemetry command to ~/.claude/settings.json: 
{
  "env": {
    "LATITUDE_API_KEY": "lat_xxx",
    "LATITUDE_PROJECT": "your-project-slug"
  },
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "npx -y @latitude-data/claude-code-telemetry",
            "async": true
          }
        ]
      }
    ]
  }
}
Restart Claude Code after saving.

​
Captured data and privacy

Treat this as full-fidelity telemetry. Latitude receives the content needed to reconstruct Claude Code turns, including prompts, responses, tool input/output, and system context when available.
  • Telemetry runs for each turn until disabled or uninstalled.
  • Latitude does not redact secrets from captured content.
  • Disable telemetry before working with sensitive material you do not want sent to Latitude.

​
Troubleshooting

No traces appear. Fully quit and relaunch Claude Code, then run a new prompt. Confirm the API key and project slug are correct. Need more diagnostics. Set LATITUDE_DEBUG=1 before running Claude Code. The telemetry command prints diagnostic output when uploads fail. Wrong project receives traces. Re-run the installer with the correct project slug, or uninstall and install again.