Skip to main content
Automatically capture agent invocations, subagent delegations, tool calls, and token usage from the Claude Agent SDK (Claude Code as a library).

Install

Set up

Usage

Verify

Run your code and confirm the trace arrives:
  1. In the traceroot UI: Navigate to Tracing > Traces in traceroot Cloud. You should see a trace with root span ClaudeAgent.query.
  2. Via the CLI: Run traceroot traces list to inspect your recent traces from the terminal.

What gets captured

Limitations

None known.

Run the example

Clone the repo and run a complete agent end-to-end.

Python

Run the Python example

TypeScript

Run the TypeScript example

Next steps

Python SDK Reference

Explore the full Python SDK reference and instrumentation options.

TypeScript SDK Reference

Explore the full TypeScript SDK reference and configuration options.