Claude Code Integration

Automatically track telemetry events when using Claude Code.

Overview

The Arden CLI provides built-in hooks for Claude Code that automatically send telemetry events when you start, stop, or interact with Claude sessions.

Setup

1. Install Arden CLI

npm install -g arden

2. Configure Claude Hooks

Add hooks to your Claude Code configuration file:

{
  "hooks": {
    "start": "arden claude start",
    "stop": "arden claude stop",
    "message": "arden claude message"
  }
}

3. Test the Integration

Start a Claude Code session. Arden will automatically:

Send a telemetry event when the session starts
Track each message exchange
Log session end events

Hook Types

Hook	Triggered When	Agent ID
`start`	Claude session begins	`claude.start`
`stop`	Claude session ends	`claude.stop`
`message`	User sends message	`claude.message`

Event Data

Each Claude hook automatically enriches telemetry with:

{
  "provider": "claude_code",
  "hook": "start|stop|message",
  "timestamp": "2024-01-15T10:30:00Z",
  "payload": {
    // Original Claude payload data
  }
}

CLI Options

# Dry run (don't send events)
arden claude start --dry-run

# Print enriched payload
arden claude start --print

# Custom API host
arden claude start --host "https://api.example.com"

Troubleshooting

Hook not triggering?

Verify Claude Code hook configuration
Check Arden CLI is installed globally
Run arden --version to confirm installation

Events not appearing?

Check network connectivity
Verify API token if using authentication
Use --dry-run --print to debug payload

Manual Integration

You can also manually send Claude-related events:

arden events send --agent "claude.custom" --bid 1000 --data '{"task": "code_review"}'

This gives you full control over when and what telemetry is sent.

Getting Started

Integrations

API Reference

Claude

Claude Code Integration

Overview

Setup

1. Install Arden CLI

2. Configure Claude Hooks

3. Test the Integration

Hook Types

Event Data

CLI Options

Troubleshooting

Manual Integration

​Claude Code Integration

​Overview

​Setup

​1. Install Arden CLI

​2. Configure Claude Hooks

​3. Test the Integration

​Hook Types

​Event Data

​CLI Options

​Troubleshooting

​Manual Integration

Claude Code Integration

Overview

Setup

1. Install Arden CLI

2. Configure Claude Hooks

3. Test the Integration

Hook Types

Event Data

CLI Options

Troubleshooting

Manual Integration