# langfuse-observability

Плагин отправляет телеметрию сессий Claude Code в Langfuse: промпты, вызовы инструментов, токены и стоимость. Помогает разбирать работу агента и оценивать ответы.

- плагин · `type=plugin` · Claude Code · ★ 29
- Автор: Langfuse
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/langfuse/claude-observability-plugin
- Обновлён: 2026-10-06
- HTML: https://affpapa.org/nevibecode/plugins/langfuse-observability

## Что делает

Плагин записывает в Langfuse промпты пользователя, шаги агента, генерации модели с расходом токенов и стоимостью, вызовы инструментов, скиллы и субагентов. Он также передаёт блоки рассуждений и вставленные или возвращённые изображения. Эти данные можно использовать для мониторинга, отладки и оценки работы LLM.

Трассировка работает для CLI `claude` и настольного приложения Claude Code в режиме Code. В режиме Chat приложение Claude Desktop не запускает хуки Claude Code, поэтому сессии там не отслеживаются. После установки перезапустите Claude Code, чтобы загрузился хук.

Для работы нужен `uv` в `PATH`; без него потребуется Python 3.10+ как `python3` и установленный пакет `langfuse>=4.7,<5`. Настройте ключи через `/plugin configure langfuse-observability@langfuse-observability`: обязательны `LANGFUSE_PUBLIC_KEY` и `LANGFUSE_SECRET_KEY`. Секретный ключ хранится в системном хранилище ключей, а без `LANGFUSE_BASE_URL` используется `https://cloud.langfuse.com`. Без подходящей среды выполнения хук завершится, поэтому проверьте `PATH` приложения, которое запускает Claude Code.

## Установка

### Claude Code (родная платформа)

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin install langfuse-observability@claude-plugins-official
```
В чате агента (не в терминале):
```text
/plugin marketplace add anthropics/claude-plugins-official
```

## Когда брать
- отправлять телеметрию сессий Claude Code в Langfuse
- отслеживать токены и стоимость генераций модели
- разбирать вызовы инструментов и действия субагентов
- проверять, какие промпты и изображения попали в трассировку

## Примеры запросов агенту
- Настрой ключи Langfuse для этого проекта через `/plugin configure langfuse-observability@langfuse-observability`.
- Покажи, как проверить трассировку последнего сообщения в Langfuse. Отправь это сообщение для записи в трассу.

## Похожие
- [next-ai-drawio](https://affpapa.org/nevibecode/plugins/next-ai-drawio.md) — плагин · ★ 36427
- [terraform](https://affpapa.org/nevibecode/plugins/terraform.md) — плагин · ★ 44770
- [mcp-tunnels](https://affpapa.org/nevibecode/plugins/mcp-tunnels.md) — плагин · ★ 44770
- [gitlab](https://affpapa.org/nevibecode/plugins/gitlab.md) — плагин · ★ 44770
- [google-cloud-developer](https://affpapa.org/nevibecode/plugins/google-cloud-developer.md) — плагин · ★ 21606
- [desktop-commander](https://affpapa.org/nevibecode/plugins/desktop-commander.md) — плагин · ★ 10134

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md