Trace Claude Code sang Braintrust
Tự động gửi phiên làm việc, lượt hội thoại và mọi lệnh gọi công cụ của Claude Code lên Braintrust dưới dạng trace phân cấp.
Lập trìnhTrung cấp★ 3,883⑂ 296Điểm AI 7/10Cập nhật lần cuối: 26 thg 1, 2026
Làm được gì
Kỹ năng này cấu hình 4 hook của Claude Code (SessionStart, PostToolUse, Stop, SessionEnd) để ghi lại toàn bộ phiên lập trình lên nền tảng quan sát Braintrust.
- Phiên (span gốc): lưu session ID, thư mục làm việc
- Lượt hội thoại (span con): cặp câu hỏi của bạn → câu trả lời của Claude, đánh số thứ tự
- Lệnh gọi công cụ (span con): đầu vào/đầu ra của từng thao tác đọc file, sửa file, chạy lệnh terminal
Có script setup.sh tự động hỏi API key và tên project rồi cấu hình hook; hoặc bạn tự viết .claude/settings.local.json. Tài liệu kèm phần xử lý sự cố khá đầy đủ (log, chế độ debug, reset state).
Phù hợp với ai
- Lập trình viên muốn kiểm tra lại chính xác agent AI đã đọc file nào, chạy lệnh gì
- Trưởng nhóm kỹ thuật cần đo lường cách cả đội dùng Claude Code
- Nhóm đã dùng Braintrust cho pipeline đánh giá/log LLM
- (Lưu ý) Không phù hợp nếu bạn không có tài khoản Braintrust hoặc không được phép gửi nội dung hội thoại ra ngoài.
Ví dụ sử dụng
- Xem lại phiên refactor lớn: mở Logs trên Braintrust để thấy dòng thời gian file nào bị sửa mấy lần, lệnh test nào thất bại.
- Đào tạo nội bộ: chia sẻ trace phiên làm việc của senior để người mới học cách viết prompt và luồng dùng công cụ hiệu quả.
- Truy vết sự cố: khi một file bị xoá bất ngờ, đối chiếu trace với
tail -f ~/.claude/state/braintrust_hook.logđể tìm đúng lệnh gọi công cụ gây ra.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục .claude/plugins/braintrust-tracing/skills/trace-claude-code từ repo GitHub parcadei/Continuous-Claude-v3 vào ~/.claude/skills/trace-claude-code/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
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/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Chuẩn bị: đã cài Claude Code CLI và công cụ
jq(macOS:brew install jq, Ubuntu:sudo apt-get install jq). - Lấy API key tại braintrust.dev.
- Clone kho và sao chép kỹ năng:
git clone https://github.com/parcadei/Continuous-Claude-v3.gitmkdir -p ~/.claude/skills && cp -r Continuous-Claude-v3/.claude/plugins/braintrust-tracing/skills/trace-claude-code ~/.claude/skills/ - Cấp quyền chạy cho hook:
chmod +x ~/.claude/skills/trace-claude-code/hooks/*.sh - Vào thư mục dự án cần theo dõi và chạy:
bash ~/.claude/skills/trace-claude-code/setup.sh, nhập API key và tên project. - Nếu muốn cấu hình thủ công, tạo
.claude/settings.local.jsontheo mẫu JSON trong tài liệu và thay/path/to/hooks/bằng đường dẫn thật. - Chạy thử Claude Code vài thao tác, sau đó vào braintrust.dev → project của bạn → mục Logs để xem trace. Nếu không thấy, bật
BRAINTRUST_CC_DEBUG="true"và xem~/.claude/state/braintrust_hook.log. - Nhớ thêm
.claude/settings.local.jsonvào.gitignorevì file này chứa API key.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT