클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

Claude Code 트레이싱 (Braintrust)

Claude Code 세션·대화 턴·툴 호출을 Braintrust로 자동 전송해 계층형 트레이스로 관찰하게 해주는 스킬입니다.

개발·코딩중급★ 3,883⑂ 296AI 점수 7/10마지막 업데이트: 2026. 1. 26.

무엇을 해주나

Claude Code의 훅(SessionStart, PostToolUse, Stop, SessionEnd) 4종을 설정해 코딩 세션 전체를 Braintrust 관측 플랫폼으로 자동 전송합니다.

  • 세션(루트 스팬): 세션 ID, 작업 디렉터리 등 메타데이터 기록
  • 턴(자식 스팬): 내 질문 → Claude의 응답 쌍을 순서대로 기록
  • 툴 호출(자식 스팬): 파일 읽기/편집, 터미널 명령 등 개별 작업의 입력·출력 기록

설치 스크립트(setup.sh)로 API 키와 프로젝트 이름만 입력하면 훅 설정이 자동 완료되며, 수동으로 .claude/settings.local.json을 직접 작성할 수도 있습니다. 디버그 로그, 상태 초기화 등 문제 해결 절차도 문서에 정리되어 있습니다.

이런 분께 추천

  • AI 코딩 에이전트가 실제로 어떤 파일을 읽고 어떤 명령을 실행했는지 사후 감사하고 싶은 개발자
  • 팀 단위로 Claude Code 사용 패턴·비용·품질을 측정하려는 엔지니어링 리더
  • 이미 Braintrust로 LLM 평가·로깅 파이프라인을 운영 중인 팀
  • (주의) Braintrust 계정이 없거나 대화 내용을 외부로 보낼 수 없는 환경이라면 적합하지 않습니다.

활용 예시

  1. 리팩터링 세션 복기: 대규모 리팩터링 후 Braintrust Logs에서 어떤 파일이 몇 번 수정됐고 어떤 테스트 명령이 실패했는지 타임라인으로 확인.
  2. 팀 온보딩 자료 만들기: 시니어 개발자의 Claude Code 세션 트레이스를 공유해 좋은 프롬프트 패턴과 툴 사용 흐름을 신입에게 설명.
  3. 문제 재현: "왜 이 파일이 지워졌지?"라는 상황에서 tail -f ~/.claude/state/braintrust_hook.log와 트레이스를 대조해 원인이 된 툴 호출을 특정.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 parcadei/Continuous-Claude-v3 의 .claude/plugins/braintrust-tracing/skills/trace-claude-code 폴더를 내 ~/.claude/skills/trace-claude-code/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/parcadei/Continuous-Claude-v3.git && mkdir -p ~/.claude/skills && cp -r Continuous-Claude-v3/.claude/plugins/braintrust-tracing/skills/trace-claude-code ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 사전 준비: Claude Code CLI가 설치되어 있고, jq가 필요합니다. macOS는 brew install jq, Ubuntu는 sudo apt-get install jq로 설치하세요.
  2. braintrust.dev에서 API 키를 발급받아 복사합니다.
  3. 터미널에서 저장소를 클론하고 스킬을 복사합니다: git clone https://github.com/parcadei/Continuous-Claude-v3.git mkdir -p ~/.claude/skills && cp -r Continuous-Claude-v3/.claude/plugins/braintrust-tracing/skills/trace-claude-code ~/.claude/skills/
  4. 훅 스크립트에 실행 권한을 줍니다: chmod +x ~/.claude/skills/trace-claude-code/hooks/*.sh
  5. 트레이싱을 켜고 싶은 프로젝트 폴더로 이동한 뒤 설치 스크립트를 실행합니다: bash ~/.claude/skills/trace-claude-code/setup.sh — API 키와 프로젝트 이름을 입력하면 훅이 자동 설정됩니다.
  6. 자동 설정이 실패하면 프로젝트의 .claude/settings.local.json에 SKILL 문서의 예시 JSON을 붙여넣고 /path/to/hooks/를 실제 경로로 바꾸세요.
  7. Claude Code를 실행해 몇 가지 작업을 해본 뒤 braintrust.dev의 해당 프로젝트 → Logs에서 트레이스가 보이는지 확인합니다. 안 보이면 tail -f ~/.claude/state/braintrust_hook.log로 로그를 확인하고 BRAINTRUST_CC_DEBUG를 "true"로 켜세요.
  8. API 키가 담긴 .claude/settings.local.json은 반드시 .gitignore에 추가해 커밋되지 않게 하세요.
GitHub에서 원본 보기 ↗라이선스: MIT