클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

Claude Code → Braintrust 트레이싱

Claude Code 세션과 턴, 모든 툴 호출을 Braintrust에 계층형 트레이스로 자동 기록합니다.

자동화·워크플로중급★ 3,943⑂ 304AI 점수 7/10마지막 업데이트: 2026. 1. 26.

무엇을 해주나

  • SessionStart / PostToolUse / Stop / SessionEnd 네 개의 훅을 설정해 Claude Code 작업 내역을 Braintrust로 전송합니다.
  • 트레이스 구조가 세션(root) → 대화 턴 → 개별 툴 호출 형태로 계층화되어, 어떤 파일을 읽고 어떤 명령을 실행했는지 한눈에 볼 수 있습니다.
  • 필요한 환경변수(TRACE_TO_BRAINTRUST, BRAINTRUST_API_KEY, BRAINTRUST_CC_PROJECT, 디버그 플래그)와 .claude/settings.local.json 예시를 그대로 제공합니다.
  • 로그 확인, 권한 오류, jq 미설치, 상태 파일 초기화 등 트러블슈팅 명령까지 정리되어 있습니다.

이런 분께 추천

  • 이미 Braintrust를 쓰고 있거나 도입을 검토 중인 AI 엔지니어링 팀
  • 에이전트가 실제로 어떤 툴을 얼마나 호출했는지 감사·분석하고 싶은 개발자
  • 프롬프트·워크플로 개선을 위해 세션 로그를 데이터로 남기고 싶은 분

활용 예시

  1. setup.sh를 실행해 API 키와 프로젝트명을 입력하면 훅 4개가 자동 등록되고, 이후 모든 세션이 Braintrust Logs에 쌓입니다.
  2. 트레이스가 안 보일 때 tail -f ~/.claude/state/braintrust_hook.log로 훅 실행 여부를 확인하고 BRAINTRUST_CC_DEBUG="true"로 상세 로그를 켭니다.
  3. 훅 방식이 아니라 코드로 관리하고 싶다면 wrapClaudeAgentSDK를 이용한 Claude Agent SDK 연동 예시를 따라갑니다.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/parcadei/Continuous-Claude-v3/HEAD/.claude/plugins/braintrust-tracing/skills/trace-claude-code/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

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. Braintrust 계정을 만들고 설정 페이지에서 API 키를 발급받습니다.
  2. jq를 설치합니다. (macOS: brew install jq, Ubuntu: sudo apt-get install jq)
  3. 터미널에서 저장소를 받습니다: git clone https://github.com/parcadei/Continuous-Claude-v3.git
  4. 스킬 폴더를 복사합니다: mkdir -p ~/.claude/skills && cp -r Continuous-Claude-v3/.claude/plugins/braintrust-tracing/skills/trace-claude-code ~/.claude/skills/
  5. 훅 스크립트에 실행 권한을 줍니다: chmod +x ~/.claude/skills/trace-claude-code/hooks/*.sh
  6. 트레이싱을 쓸 프로젝트 디렉터리로 이동한 뒤 bash ~/.claude/skills/trace-claude-code/setup.sh를 실행하고, 안내에 따라 API 키와 프로젝트명을 입력합니다.
  7. 생성된 .claude/settings.local.json을 확인하고, API 키가 들어있으므로 .gitignore에 추가합니다.
  8. Claude Code를 새로 실행해 몇 가지 작업을 한 뒤 braintrust.dev의 해당 프로젝트 Logs에서 트레이스가 보이는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT