Skip to main content

​
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}
)

​
Resources

Anthropic integration cookbook (GitHub)

Anthropic + Maxim integration Notebook (Colab)