> ## 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

# 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](https://console.latitude.so/login) with a project
* Claude Code installed locally
* Node.js available on your `PATH`

<Note>
  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.
</Note>

## 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:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export LATITUDE_CLAUDE_CODE_ENABLED=0
```

Restart Claude Code for the change to take effect.

To remove the integration:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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`:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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.