Observability for Claude Agent SDK

Overview

Claude Agent SDK is a framework for calling Claude Code from your own code. It abstracts away the underlying process management and calls to the model API.

What Laminar captures

The entire structure of the Claude Agent SDK function calls, including connect, query, and receive_messages.
LLM prompts and responses sent to the model.
Tool calls and their results.
Latencies, token counts, and token costs.

Getting started

TypeScript / JavaScript
Python

Installation

Ensure you are using @lmnr-ai/lmnr version 0.7.10 or higher.

npm install @lmnr-ai/lmnr@latest @anthropic-ai/claude-agent-sdk
# or
pnpm add @lmnr-ai/lmnr@latest @anthropic-ai/claude-agent-sdk

Set up your environment variables

Export your API keys as environment variables.

export LMNR_PROJECT_API_KEY=your-laminar-project-api-key
export ANTHROPIC_API_KEY=your-anthropic-api-key

Wrap the query function

import { query as origQuery } from '@anthropic-ai/claude-agent-sdk';
import { Laminar } from '@lmnr-ai/lmnr';

// Initialize Laminar
Laminar.initialize();

// Wrap the original query function
const query = Laminar.wrapClaudeAgentQuery(origQuery);

async function run() {
  const result = await query({
    prompt: "Scan the current directory for TODOs and create a summary markdown file."
  });

  console.log(result);
}
run();

Installation

Claude Agent SDK integration is packaged as a separate extra.

pip install 'lmnr[claude-agent-sdk]'

Set up your environment variables

Store your API keys in a .env file or export them as environment variables.

export LMNR_PROJECT_API_KEY=your-laminar-project-api-key
export ANTHROPIC_API_KEY=your-anthropic-api-key

Initialize Laminar

Initialize Laminar at the start of your application or file.

import asyncio

from claude_agent_sdk import ClaudeSDKClient
from lmnr import Laminar, observe

Laminar.initialize()

@observe()
async def main():
    async with ClaudeSDKClient() as client:
        await client.query(
            "Explain to me with examples, how memoization speeds up recursive "
            "function calls. Use the Fibonacci sequence as an example."
        )
        async for msg in client.receive_response():
            print(msg)

if __name__ == "__main__":
    asyncio.run(main())

View the traces in Laminar

Go to the Laminar dashboard, and you will see the traces for the Claude Agent SDK. Example trace:

Multi-agent visualization

When multiple Claude agents collaborate in a single run, Laminar renders each agent as a distinct branch in the trace so you can follow handoffs and parallel work. Example multi-agent trace:

Overview

Tracing

Evaluations

Datasets

Platform

Overview

What Laminar captures

Getting started

View the traces in Laminar

Multi-agent visualization

Overview

Tracing

Evaluations

Datasets

Platform

​Overview

​What Laminar captures

​Getting started

​View the traces in Laminar

​Multi-agent visualization

Overview

What Laminar captures

Getting started

View the traces in Laminar

Multi-agent visualization