Anthropic SDK

Requirements

"anthropic"
"maxim-py"

Env Variables

MAXIM_API_KEY=
MAXIM_LOG_REPO_ID=
ANTHROPIC_API_KEY=

Initialize Logger

from maxim import Maxim

logger = Maxim().logger()

Initialize MaximAnthropicClient

from anthropic import Anthropic
from maxim.logger.anthropic import MaximAnthropicClient

client = MaximAnthropicClient(client=Anthropic(api_key=ANTHROPIC_API_KEY), logger=logger)

Make LLM Calls Using MaximAnthropicClient

from anthropic import Anthropic
from maxim.logger.anthropic import MaximAnthropicClient

client = MaximAnthropicClient(client=Anthropic(api_key=ANTHROPIC_API_KEY), logger=logger)

# Create a message request
response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Write a haiku about recursion in programming."}
    ]
)

# Extract response text
response_text = response.content[0].text
print(response_text)

Maxim-specific Headers

The Anthropic instrumentation supports additional headers via the extra_headers parameter to enhance trace metadata and organization. You can use the following headers:

x-maxim-trace-id: Associate LLM calls with a specific trace ID (UUID string). All calls with the same trace ID will be grouped together in a single trace.
x-maxim-trace-tags: Add custom tags to traces as a JSON string containing key-value pairs. Useful for filtering and organizing traces.
x-maxim-generation-name: Assign a custom name to a specific generation/LLM call within a trace (string).
x-maxim-session-id: Associate traces with a specific session ID (string).

Example: Using Extra Headers

import json
from uuid import uuid4
from anthropic import Anthropic
from maxim.logger.anthropic import MaximAnthropicClient

client = MaximAnthropicClient(client=Anthropic(api_key=ANTHROPIC_API_KEY), logger=logger)

trace_id = str(uuid4())

response = client.messages.create(
    messages=[{"role": "user", "content": "Explain how AI works"}],
    model="claude-opus-4-5-20251101",
    max_tokens=1000,
    extra_headers={
        "x-maxim-trace-tags": json.dumps({
            "environment": "production",
            "feature": "ai-explanation",
            "version": "1.0"
        }),
        "x-maxim-trace-id": trace_id,
        "x-maxim-generation-name": "ai-explanation-generation"
    }
)

Advanced Use Case: Streaming Support

Initialize Maxim SDK and Anthropic Client

import os
import dotenv
from uuid import uuid4
from anthropic import Anthropic
from maxim import Maxim
from maxim.logger.anthropic import MaximAnthropicClient

# Load environment variables
dotenv.load_dotenv()
MODEL_NAME = "claude-3-5-sonnet-20241022"
ANTHROPIC_API_KEY = os.getenv("ANTHROPIC_API_KEY")

# Initialize Maxim logger
logger = Maxim().logger()

# Initialize MaximAnthropicClient
client = MaximAnthropicClient(Anthropic(api_key=ANTHROPIC_API_KEY), logger)

Make Streaming Calls

user_input = "What was the capital of France in 1800s?"
final_response = ""
response_chunks = []

with client.messages.stream(
    max_tokens=1024,
    messages=[{"role": "user", "content": user_input}],
    model=MODEL_NAME,
) as stream:
    for text_chunk in stream.text_stream:
        # Collect streamed chunks
        response_chunks.append(text_chunk)
        
        # Print the streamed text chunk
        print(text_chunk, end="", flush=True)    
    
    final_response = "".join(response_chunks)

Capture Multiple LLM Calls in One Trace

Initialize Maxim SDK and Anthropic Client

from anthropic import Anthropic
from maxim import Maxim
from maxim.logger.anthropic import MaximAnthropicClient

# Make sure MAXIM_API_KEY and MAXIM_LOG_REPO_ID are set in env variables
logger = Maxim().logger()

# Initialize MaximAnthropicClient
client = MaximAnthropicClient(client=Anthropic(api_key=ANTHROPIC_API_KEY), logger=logger)

Create a new trace externally

from uuid import uuid4

trace_id = str(uuid4())

trace = logger.trace({
    "id": trace_id,
    "name": "Trace name"
})

Make LLM calls and use this trace id

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "What was the capital of France in 1800s?"}
    ],
    extra_headers={"x-maxim-trace-id": trace_id}
)

# Extract response text
response_text = response.content[0].text
print(response_text)

Keep adding LLM calls All LLM calls with extra header x-maxim-trace-id: trace_id will add it to the declared trace.

Capture Multi-Turn Conversations

Initialize Maxim SDK and Anthropic Client

from anthropic import Anthropic
from maxim import Maxim
from maxim.logger.anthropic import MaximAnthropicClient

# Make sure MAXIM_API_KEY and MAXIM_LOG_REPO_ID are set in env variables
logger = Maxim().logger()

# Initialize MaximAnthropicClient
client = MaximAnthropicClient(client=Anthropic(api_key=ANTHROPIC_API_KEY), logger=logger)

Create a new trace externally and add it to a session

from uuid import uuid4

# use this session id to add multiple traces in one session
session_id = str(uuid4())
trace_id = str(uuid4())

trace = logger.trace({
    "id": trace_id,
    "name": "Trace name",
    "session_id": session_id
})

Make LLM calls and use this trace id

messages = [
    {"role": "user", "content": "Hello, can you help me with Python programming?"}
]

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=messages,
    extra_headers={"x-maxim-trace-id": trace_id}
)

# Extract response text
response_text = response.content[0].text
print(response_text)

# Continue the conversation - add assistant's response to messages
messages.append({"role": "assistant", "content": response_text})
messages.append({"role": "user", "content": "Can you write a simple Python function?"})

# Make another call with the same trace_id to continue the conversation
response2 = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=messages,
    extra_headers={"x-maxim-trace-id": trace_id}
)

response_text2 = response2.content[0].text
print(response_text2)

Create additional traces in the same session To add more conversations to the same session, create new traces with the same session_id:

# Create another trace in the same session
trace_id_2 = str(uuid4())

trace2 = logger.trace({
    "id": trace_id_2,
    "name": "Second conversation",
    "session_id": session_id  # Same session_id to group conversations
})

# Make calls with the new trace_id
response3 = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Tell me about machine learning"}],
    extra_headers={"x-maxim-trace-id": trace_id_2}
)

Overview

Python

Typescript

Requirements

Env Variables

Initialize Logger

Initialize MaximAnthropicClient

Make LLM Calls Using MaximAnthropicClient

Maxim-specific Headers

Example: Using Extra Headers

Advanced Use Case: Streaming Support

Initialize Maxim SDK and Anthropic Client

Make Streaming Calls

Capture Multiple LLM Calls in One Trace

Capture Multi-Turn Conversations

Resources

Anthropic integration cookbook (GitHub)

Anthropic + Maxim integration Notebook (Colab)

​Requirements

​Env Variables

​Initialize Logger

​Initialize MaximAnthropicClient

​Make LLM Calls Using MaximAnthropicClient

​Maxim-specific Headers

​Example: Using Extra Headers

​Advanced Use Case: Streaming Support

​Initialize Maxim SDK and Anthropic Client

​Make Streaming Calls

​Capture Multiple LLM Calls in One Trace

​Capture Multi-Turn Conversations

​Resources

Anthropic integration cookbook (GitHub)

Anthropic + Maxim integration Notebook (Colab)

Requirements

Env Variables

Initialize Logger

Initialize MaximAnthropicClient

Make LLM Calls Using MaximAnthropicClient

Maxim-specific Headers

Example: Using Extra Headers

Advanced Use Case: Streaming Support

Initialize Maxim SDK and Anthropic Client

Make Streaming Calls

Capture Multiple LLM Calls in One Trace

Capture Multi-Turn Conversations

Resources