langsmith-tracing — хук для Claude Code: что делает и как установить
Отправляет трейсы диалогов Claude Code в LangSmith для мониторинга и отладки сессий. Срабатывает автоматически в фоне после каждого ответа модели.
npx claude-code-templates@latest --hook monitoring/langsmith-tracingЧто делает langsmith-tracing
Хук перехватывает событие Stop после каждого ответа ассистента и запускает фоновый скрипт .claude/hooks/langsmith-tracing.sh. Скрипт считывает транскрипт текущего разговора, преобразует его в формат LangSmith и отправляет в API сервиса. Все вызовы связываются по thread_id, поэтому история остаётся цельной. Системные промпты в трейсы не попадают.
Для работы скрипту требуются утилиты jq, curl и uuidgen. Без установленного jq хук завершится с ошибкой и не сможет обработать транскрипт. Логи выполнения пишутся в файл ~/.claude/state/hook.log.
Настройки задаются через переменные окружения в .claude/settings.local.json: флаг TRACE_TO_LANGSMITH=true, ключ CC_LANGSMITH_API_KEY и проект CC_LANGSMITH_PROJECT. При необходимости можно включить подробный вывод через CC_LANGSMITH_DEBUG=true.
Какие задачи решает
- отслеживать цепочки вызовов и ответы Claude Code в LangSmith
- группировать историю диалогов по идентификаторам сессий
thread_id - отлаживать выполнение фонового скрипта через
~/.claude/state/hook.log - исключать системные промпты при сборе телеметрии
Примеры запросов агенту
- Помоги найти утечку памяти в сервисе и напиши регрессионный тест
- Объясни, почему падает сборка проекта в контейнере
Как установить langsmith-tracing
1Через claude-code-templates
npx claude-code-templates@latest --hook monitoring/langsmith-tracing2Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о langsmith-tracing
Как установить langsmith-tracing в Claude Code?
Выполните команду npx claude-code-templates@latest --hook monitoring/langsmith-tracing и проверьте конфигурацию хука в .claude/settings.json.
Что делает хук langsmith-tracing?
Он перехватывает событие Stop, форматирует историю ответов Claude Code и отправляет готовый трейс в API LangSmith с сохранением контекста сессии.
Какие системные утилиты нужны для работы хука?
Требуются установленные jq, curl и uuidgen. Также необходимо прописать переменные TRACE_TO_LANGSMITH, CC_LANGSMITH_API_KEY и CC_LANGSMITH_PROJECT в файле .claude/settings.local.json.
Исходный текст
langsmith-tracing.json · MIT
{
"description": "Automatically send Claude Code conversation traces to LangSmith for monitoring and analysis. Prerequisites: jq (brew install jq on macOS or sudo apt-get install jq on Linux), curl and uuidgen (usually pre-installed), LangSmith account and API key. Configuration: Install langsmith-tracing setting (npx claude-code-templates@latest --setting telemetry/langsmith-tracing) or manually add to .claude/settings.local.json the following environment variables: TRACE_TO_LANGSMITH=true, CC_LANGSMITH_API_KEY=lsv2_pt_..., CC_LANGSMITH_PROJECT=project-name, CC_LANGSMITH_DEBUG=true (optional). How it works: Runs in background on Stop event after each Claude response, reads conversation transcript, converts to LangSmith format, sends to LangSmith API, groups by thread_id for session continuity. Debugging: Check logs at ~/.claude/state/hook.log. Privacy note: System prompts not included in traces.",
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/langsmith-tracing.sh\""
}
]
}
]
}
}
© davila7 · MIT · davila7/claude-code-templates
