Anthropic

​

Install

pip install trulayer anthropic

npm install @trulayer/sdk @anthropic-ai/sdk

​

Instrument

import os
from anthropic import Anthropic
import trulayer

trulayer.init(api_key=os.environ["TRULAYER_API_KEY"], project_name="my-app")

client = Anthropic()
trulayer.instrument_anthropic(client)

import Anthropic from "@anthropic-ai/sdk";
import { TruLayer, instrumentAnthropic } from "@trulayer/sdk";

const tl = new TruLayer({
  apiKey: process.env.TRULAYER_API_KEY!,
  projectName: "my-app",
});

const anthropic = instrumentAnthropic(new Anthropic(), tl);

​

What gets captured

• input — the full messages array and system prompt
• output — the response content blocks (text + tool_use)
• model
• prompt_tokens → Anthropic’s input_tokens
• completion_tokens → Anthropic’s output_tokens
• cache_creation_input_tokens, cache_read_input_tokens → attached as metadata when prompt caching is in use
• stop_reason — attached as metadata (end_turn, tool_use, max_tokens)
• latency_ms

​

Streaming

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hi"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="")
# span closes when the `with` block exits with final token counts

​

Tool use

with trulayer.current_trace().span("tool:get_weather", span_type="tool") as span:
    span.set_input(tool_input)
    result = get_weather(**tool_input)
    span.set_output(result)

​

Prompt caching

curl "https://api.trulayer.ai/v1/metrics?project_id=my-app&from=...&filters[model]=claude-sonnet-4-6" \
  -H "Authorization: Bearer $TRULAYER_API_KEY"

​

Disabling

trulayer.uninstrument_anthropic(client)

​

Known gotchas

• Extended thinking — thinking content is captured as part of the span output (content[].thinking). It’ll show up in trace detail views alongside the visible response.
• Batch API (messages.batches) — not auto-instrumented. Wrap batch submissions manually with trace() if you want observability.
• Vertex and Bedrock — use the respective Anthropic SDK client (AnthropicVertex, AnthropicBedrock) and the same instrument_anthropic() call.