> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scorecard.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Claude Agent SDK Tracing
> Trace your Claude Agent SDK applications with Scorecard.
export const DarkLightImage = ({lightSrc, caption, alt, darkSrc = null, width = "1000"}) => {
const getAbsoluteUrl = src => {
if (src.startsWith('http://') || src.startsWith('https://')) {
return src;
}
const currentUrl = typeof window !== 'undefined' ? window.location.origin : '';
if (currentUrl.includes('.mintlify.app')) {
const subdomain = currentUrl.split('.')[0].replace('https://', '');
return `https://mintlify.s3.us-west-1.amazonaws.com/${subdomain}${src.startsWith('/') ? '' : '/'}${src}`;
} else if (currentUrl === 'https://docs.scorecard.io') {
return `https://mintlify.s3.us-west-1.amazonaws.com/scorecard-d65b5e8a${src.startsWith('/') ? '' : '/'}${src}`;
} else {
return `${currentUrl}${src.startsWith('/') ? '' : '/'}${src}`;
}
};
const content = <>
})
;
if (caption) {
return {content};
} else {
return content;
}
};
The Claude Agent SDK is Anthropic's framework for building AI agents that can reason, use tools, and complete multi-step tasks. It includes built-in support for OpenTelemetry tracing, making it easy to capture detailed telemetry from your agent workflows.
This quickstart shows how to send traces from your Claude Agent SDK (Python v0.1.18+, TypeScript v0.1.71+) applications to Scorecard for observability, debugging, and evaluation.
**Using the standard Anthropic SDK?** Check out the general [Tracing Quickstart](/intro/tracing-quickstart) for the proxy method that works with any Anthropic client.
## Steps
Configure the OpenTelemetry exporter to send traces to Scorecard. You'll need your Scorecard API key from [Settings](https://app.scorecard.io/settings).
```bash theme={null}
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer "
export ENABLE_BETA_TRACING_DETAILED=1
export BETA_TRACING_ENDPOINT="https://tracing.scorecard.io/otel"
export OTEL_LOG_USER_PROMPTS=1
export OTEL_LOG_TOOL_DETAILS=1
export OTEL_LOG_TOOL_CONTENT=1
export OTEL_RESOURCE_ATTRIBUTES="scorecard.project_id="
```
Replace `` with your actual Scorecard API key (starts with `ak_`), and `` with the project you want traces to land in.
If the project ID is wrong or invalid, traces will be sent to the **oldest project** in your organization.
With the environment variables configured, run your Claude Agent SDK application. All agent activity is automatically traced.
```python title="example.py" [expandable] theme={null}
import anyio
from claude_agent_sdk import (
AssistantMessage,
TextBlock,
query,
)
async def main():
async for message in query(prompt="What is 2 + 2?"):
if isinstance(message, AssistantMessage):
for block in message.content:
if isinstance(block, TextBlock):
print(f"Claude: {block.text}")
anyio.run(main)
```
Navigate to the [**Records**](/features/records) page in [Scorecard](https://app.scorecard.io) to see your agent traces. Click any record to open its trace detail panel, which breaks the trace into four tabs: **Conversation**, **Timeline**, **Chat**, and **Debug**.
The **Conversation** tab shows a chat-like replay of user messages, assistant responses, and tool calls.
The **Timeline** tab shows a Gantt chart-style breakdown of every span, so you can see how LLM calls and tool executions overlap and how long each takes.
The **Chat** tab lets you ask questions about the trace in natural language—what happened, why a step failed, or how it performed—and compare records side by side.
The **Debug** tab pairs the full span tree with a trace overview—duration, cost, tokens, and model—plus the raw span data for deeper inspection.
## Anatomy of a trace
Explore how a Claude Agent SDK trace is structured—spans, tool calls, model usage, and metadata—in this interactive demo:
## Next Steps
Learn about advanced tracing patterns and trace grouping
Create custom metrics to evaluate agent performance