Skip to main content
Cascade provides auto-instrumentation for the Claude Agent SDK. A single function call translates the framework’s native events into Cascade spans with no changes to your existing agent code.

​
Setup

from cascade import init_tracing
from cascade.integrations import instrument_claude_agents

init_tracing(project="my_claude_agent")
instrument_claude_agents()

# Existing Claude Agent SDK code - no changes needed
from claude_agent_sdk import query

result = await query("Plan a trip to Tokyo")
Requires the claude-agent-sdk package:
pip install claude-agent-sdk

​
What gets traced automatically

The integration automatically captures:
  • query() function calls: top-level and client-based
  • Tool executions: MCP server tools
  • Input prompts and output text: full conversation data