LangSmith Tracing for Claude Code — плагин
Плагин LangSmith отправляет разговоры Claude Code в LangSmith, чтобы видеть вызовы модели, инструментов и субагентов
- 73 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- После включения отправляет сообщения, вызовы инструментов и их содержимое в облачный LangSmith, вырезание секретов не гарантия
- Читает метаданные git (репозиторий, ветка, коммит, автор) и хранит ключ API или сессию входа в вашем профиле
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/langsmith-tracing-for-claude-codeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- После включения отправляет сообщения, вызовы инструментов и их содержимое в облачный LangSmith, вырезание секретов не гарантия
- Читает метаданные git (репозиторий, ветка, коммит, автор) и хранит ключ API или сессию входа в вашем профиле
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин записывает работу Claude Code в LangSmith как трассу. Каждый вызов модели попадает туда с историей беседы, ответом, названием модели, провайдером и числом токенов. Вызовы инструментов сохраняются с входом и выходом, вызовы скиллов с названием запущенного скилла, субагенты показываются вложенными в ход, который их запустил. Если инструмент трогает файл в git-репозитории, запись помечается именем репозитория, веткой, коммитом и автором. Субагент выгружается после завершения, отмененный теряет свои шаги. Трассировка по умолчанию выключена. Ее включает команда `/langsmith-tracing:setup [project] [url]` или файл `~/.claude/langsmith.json`, в который пишут `enabled` и `project` либо `agent_id`. Вход в LangSmith идет через `langsmith auth login` или ключ `api_key`; при нескольких вариантах сначала берется ключ плагина, затем вход CLI, затем общий `LANGSMITH_API_KEY`. Команда `/langsmith-tracing:trace` выдает ссылку на трассу текущего разговора. Для приватности есть `/langsmith-tracing:mute` и `unmute`: у замолчанного хода остается структура, а текста нет. Параметр `defaultMuted` глушит все разговоры сразу. Секреты вырезаются перед отправкой, пока `redact` не выключен: ключи API, JWT, блоки PEM и типовые учетные данные. Администраторы задают настройки обязательным файлом `~/.langsmith-plugins/managed.json`, а режим `strict_auth` отказывает в запросах, пока вход не заработает.
Для кого. Командам, которые строят на LangChain и LangSmith и хотят видеть в трассах, что на самом деле делал Claude Code, и администраторам, раздающим плагин по организации.
Подходит, если
- Агент сделал неожиданную правку, и нужно разобрать по трассе, какие вызовы модели и инструментов к ней привели
- Команда хочет собирать трассы всех сессий Claude Code в одном проекте LangSmith для анализа
- Администратору нужно включить трассировку для всех и закрепить проект и рабочее пространство через MDM
- Часть разговоров содержит чувствительные данные, и их нужно заглушить командой `/langsmith-tracing:mute`
Не подходит, если
- Данные не должны покидать машину: включенная трассировка выгружает сообщения, входы и выходы инструментов
- Нет аккаунта LangSmith: плагину нужен вход или ключ
- Нужна трассировка внутри самого Claude Code без внешнего сервиса: плагин пишет в LangSmith
Пример запроса к агенту
Установи плагин LangSmith, включи трассировку в проект claude-code и дай ссылку на трассу этого разговораОграничения
- На Windows и Linux нужен Node.js 20 или новее. На Mac плагин приносит собственную сборку, Node остается запасным путем.
- При включенной трассировке в LangSmith уходят сообщения, входы и выходы инструментов и метаданные. Вырезание секретов не гарантия, при сомнениях оставьте трассировку выключенной.
- Заглушение действует со следующего хода и не удаляет уже загруженное.
- Клонированный репозиторий может сам включить трассировку через `.claude/langsmith.json`, поэтому настройки чужих репозиториев нужно проверять.
Как отключить. Выключите трассировку параметром `enabled`: `false` в `~/.claude/langsmith.json` или переменной `TRACE_TO_LANGSMITH=false`. Полностью плагин снимается командой `/plugin` в Claude Code или командой claude plugin `uninstall` langsmith-tracing@langsmith-claude-code-plugins. Загруженные трассы остаются в LangSmith и удаляются там.
Частые вопросы
Как поставить плагин LangSmith для Claude Code?
В Claude Code выполните `/plugin marketplace add langchain-ai/langsmith-claude-code-plugins`, затем `/plugin install langsmith-tracing@langsmith-claude-code-plugins` и `/reload-plugins`. Автообновление для этого маркетплейса по умолчанию выключено.
Как включить трассировку?
Выполните `/langsmith-tracing:setup` с названием проекта или адресом LangSmith либо задайте `{ "enabled": true, "project": "shared-claude" }` в `~/.claude/langsmith.json`. Без настройки трассы идут в проект `claude-code`.
Что попадает в LangSmith?
Сообщения, входы и выходы инструментов, метаданные, число токенов и структура субагентов. Секреты вырезаются перед отправкой, если не выключен `redact`. Заглушенные ходы выгружают только структуру.
Как скрыть разговор с чувствительными данными?
Выполните `/langsmith-tracing:mute` и дождитесь подтверждения, прежде чем отправлять чувствительный текст. Команда `/langsmith-tracing:unmute` возвращает выгрузку. Параметр `defaultMuted` глушит все разговоры по умолчанию.
Как организации включить трассировку для всех?
Установить плагин через управляемые настройки Claude Code и положить файл `~/.langsmith-plugins/managed.json` на каждую машину, обычно средством MDM вроде Jamf, Kandji или Intune. Файл должен принадлежать `root` и быть закрыт для записи другим.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныТерминальная панель для Claude Code и Codex: дерево агентов с живым статусом, лентой вызовов и запасом контекста.
CLI-трассировка сессий Claude Code, Cursor и Codex через OpenTelemetry: что агент реально делал и сколько это стоило
Claude Watch рисует на localhost карту логики проекта, показывает вызовы Claude Code в реальном времени и отвечает на вопросы
Маркетплейс плагинов Claude Code от shokai: второе мнение Codex, ревью PR, обход репозитория на уязвимости, режим фабрики.
Прозрачная обертка для Claude Code и Codex: локальный шлюз пишет события запуска и траектории без правок агента.
Локальный прокси между Claude Code и Anthropic: чинит сбои промпт-кэша, стабилизирует префикс запроса и показывает расход квоты в строке состояния
Коротко о README
Страница проекта подает плагин как способ отправлять разговоры Claude Code в LangSmith, чтобы видеть действия агента. Перечислены требования, установка для себя и для организации, управляемый файл настроек с проверкой прав и три способа входа. Затем идут включение трассировки, содержимое трасс, скрытие разговоров, разбор частых проблем, раздел о приватности и таблица настроек с переменными окружения.