langfuse-observability Plugin
Plugin Claude Code Monitoring Monitoring & ObservabilityClaude Code Customization & WorkflowThe explanation below is AI-generated. Please verify it against the sources.
This is a Claude Code plugin that traces Claude Code sessions and sends them to Langfuse for observability, debugging, and evaluation. It works by using Claude Code's hooks system (Stop and SessionEnd hooks) to read session transcripts incrementally and convert them into Langfuse traces, generations, and tool spans, according to the GitHub README. It captures Claude Code CLI sessions and Claude Code GUI Code mode sessions, but not regular Claude Desktop Chat mode conversations. Installation is via the Claude Code plugin marketplace, and configuration (API keys) is stored in the OS keychain per the README. The tool requires either uv or Python 3.10+ (the homepage mentions Python 3.9+) with the langfuse SDK (>=4.0,<5) installed.
Overview
Langfuse is described on its homepage as an open-source AI engineering platform that helps teams trace LLM applications, debug issues, evaluate quality, and monitor costs in production. This plugin is the integration that connects Claude Code to that platform.
What you can do with langfuse-observability
- Install the plugin via claude plugin marketplace add langfuse/Claude-Observability-Plugin and claude plugin install langfuse-observability@langfuse-observability
- Configure Langfuse credentials (LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY, LANGFUSE_BASE_URL, optional LANGFUSE_USER_ID) via /plugin configure or install-time --config flags
- View per-turn traces in Langfuse, each containing generation spans (one per assistant message) and nested tool spans (e.g., Read, Bash) with inputs, outputs, and timing
- Group all turns from the same Claude Code session via a shared session_id in the Langfuse Sessions tab
- Capture token usage details when present in assistant messages
- Tag traces with skill names via CC_LANGFUSE_SKILL_TAGS (default true), and optionally capture injected skill instruction text via CC_LANGFUSE_CAPTURE_SKILL_CONTENT (default false)
- Enable verbose debug logging with CC_LANGFUSE_DEBUG and control truncation length with CC_LANGFUSE_MAX_CHARS
- Disable, re-enable, reconfigure, or uninstall the plugin using claude plugin disable/enable/uninstall commands per the README
Sources
Original description (English)
Langfuse observability plugin for Claude Code — captures and exports traces, spans, and session telemetry from Claude Code to Langfuse for LLM monitoring, debugging, and evaluation
History of langfuse-observability
- Plugin Added langfuse-observability