The Infinium Claude Code Connector automatically captures your Claude Code sessions and sends structured traces to the Infinium platform, where Maestro — our behavioral intelligence engine — analyzes and scores agent performance.

No code changes required. Install the connector, run the setup wizard, and every Claude Code session is traced automatically.

Core Concept

Claude Code does work. The connector captures what happened. Maestro evaluates how well it went.

The connector hooks into Claude Code’s event system and records facts — prompts, tool calls, errors, durations, subagent activity — then sends them to Infinium as structured traces. Maestro interprets the trace and scores performance without the agent ever evaluating itself.

How It Works

Claude Code Session
    │
    ├── SessionStart        ← Hook fires
    ├── UserPromptSubmit    ← Captures prompt
    ├── PreToolUse          ← Tracks tool call
    ├── PostToolUse         ← Captures result
    ├── Stop                ← Turn complete → sends trace
    │
    ▼
Infinium Connector
    │
    ├── Aggregates events into structured turns
    ├── Builds: TaskData (steps, errors, tools, durations)
    ├── Sends: POST /agents/{id}/trace
    │
    ▼
Infinium Platform
    │
    └── Maestro evaluates trace quality and scores performance

Features

• Zero-Config Tracing — Hooks install automatically, no code changes needed
• Per-Turn Traces — Each prompt-response cycle sends a trace on completion
• Tool Call Tracking — Captures every tool invocation with input, output, duration, and errors
• Subagent Awareness — Tracks Claude Code subagent/cowork activity
• Secure Credentials — Agent secret stored in OS keyring (Windows Credential Manager, macOS Keychain, Linux Secret Service)
• Per-Project Agents — Different projects can trace to different Infinium agents
• Pause & Resume — Temporarily disable tracing without reconfiguring
• Failed Trace Retry — Automatic recovery from network failures
• Local History — View recently sent traces without leaving the terminal

Quick Links

Guide	Description
Getting Started	Install, setup wizard, verify connection
Configuration	Global vs. project scope, credentials, environment variables
Commands	Full CLI reference for all commands

Reference

Reference	Description
Traced Events	What data is captured and how it maps to traces
Troubleshooting	Common issues and how to resolve them

Package Info

• PyPI: infinium-claude-code-connector
• Python: >= 3.9
• Dependencies: infinium-o2, click, keyring
• License: MIT