From 9f4f48f82faa7fd9516f13d9d03a873aefda48c1 Mon Sep 17 00:00:00 2001
From: "inkeep[bot]" <257615677+inkeep[bot]@users.noreply.github.com>
Date: Tue, 21 Apr 2026 19:59:47 +0000
Subject: [PATCH] docs: Add Claude Agent SDK LLM analytics installation page
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Companion page for PostHog/posthog#53011 which added the shared
onboarding content at docs/onboarding/llm-analytics/claude-agent-sdk.tsx.

Follows the same pattern as openai-agents.mdx — imports the shared
component and wraps it with OnboardingContentWrapper and addNextStepsStep.
---
 .../installation/claude-agent-sdk.mdx         | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 contents/docs/llm-analytics/installation/claude-agent-sdk.mdx

diff --git a/contents/docs/llm-analytics/installation/claude-agent-sdk.mdx b/contents/docs/llm-analytics/installation/claude-agent-sdk.mdx
new file mode 100644
index 000000000000..50b4277647d7
--- /dev/null
+++ b/contents/docs/llm-analytics/installation/claude-agent-sdk.mdx
@@ -0,0 +1,46 @@
+---
+title: Claude Agent SDK LLM analytics installation
+platformIconName: IconAnthropic
+showStepsToc: true
+tableOfContents:
+  [
+    { url: "install-the-posthog-sdk", value: "Install the PostHog SDK", depth: 1 },
+    { url: "install-the-claude-agent-sdk", value: "Install the Claude Agent SDK", depth: 1 },
+    {
+      url: "initialize-posthog-and-run-a-query",
+      value: "Initialize PostHog and run a query",
+      depth: 1,
+    },
+    {
+      url: "reusable-configuration-with-instrument",
+      value: "Reusable configuration with instrument()",
+      depth: 1,
+    },
+    {
+      url: "tool-usage-and-multi-turn-conversations",
+      value: "Tool usage and multi-turn conversations",
+      depth: 1,
+    },
+    {
+      url: "multi-turn-conversations-with-history",
+      value: "Multi-turn conversations with history",
+      depth: 1,
+    },
+    { url: "verify-traces-and-generations", value: "Verify traces and generations", depth: 1 },
+  ]
+---
+
+<!--
+This page imports shared onboarding content from the main PostHog repo.
+Source: https://github.com/PostHog/posthog/blob/master/docs/onboarding/llm-analytics/claude-agent-sdk.tsx
+See the docs runbook for more info: https://posthog.com/handbook/docs-and-wizard/onboarding-docs
+-->
+
+import { ClaudeAgentSDKInstallation } from "onboarding/llm-analytics/claude-agent-sdk.tsx";
+import { OnboardingContentWrapper } from "components/Docs/OnboardingContentWrapper";
+import NotableGenerationProperties from "../_snippets/notable-generation-properties.mdx";
+import { addNextStepsStep } from "./_snippets/shared-helpers.tsx";
+
+<OnboardingContentWrapper snippets={{ NotableGenerationProperties }}>
+  <ClaudeAgentSDKInstallation modifySteps={addNextStepsStep} />
+</OnboardingContentWrapper>