Trace Claude Code sang Braintrust
Tự động ghi session, lượt hội thoại và mọi tool call của Claude Code thành trace phân cấp trên Braintrust.
Tự động hóaTrung cấp★ 3,945⑂ 303Điểm AI 7/10Cập nhật lần cuối: 26 thg 1, 2026
Làm được gì
- Cấu hình 4 hook (SessionStart, PostToolUse, Stop, SessionEnd) để gửi toàn bộ hoạt động của Claude Code lên Braintrust.
- Trace được tổ chức phân cấp: session (gốc) → từng lượt hội thoại → từng tool call, thấy rõ đã đọc file nào, chạy lệnh nào.
- Cung cấp sẵn mẫu
.claude/settings.local.jsonvà bảng biến môi trường (TRACE_TO_BRAINTRUST,BRAINTRUST_API_KEY,BRAINTRUST_CC_PROJECT, chế độ debug). - Có mục khắc phục sự cố: xem log hook, lỗi quyền, thiếu
jq, reset file state.
Phù hợp với ai
- Nhóm kỹ thuật AI đang dùng hoặc muốn thử nền tảng quan sát Braintrust.
- Lập trình viên cần kiểm toán, phân tích xem agent gọi công cụ nào và bao nhiêu lần.
- Người muốn lưu lịch sử phiên làm việc thành dữ liệu để tối ưu prompt và quy trình.
Ví dụ sử dụng
- Chạy
setup.shtrong thư mục dự án, nhập API key và tên project — hook được đăng ký tự động và mọi phiên sau đó xuất hiện trong Logs. - Khi không thấy trace, theo dõi
tail -f ~/.claude/state/braintrust_hook.logvà bậtBRAINTRUST_CC_DEBUG="true"để xem log chi tiết. - Nếu muốn tích hợp bằng code thay vì hook, dùng ví dụ
wrapClaudeAgentSDKvới Claude Agent SDK.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/parcadei/Continuous-Claude-v3/HEAD/.claude/plugins/braintrust-tracing/skills/trace-claude-code/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
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.
- Tạo tài khoản Braintrust và lấy API key trong trang cài đặt.
- Cài
jq: macOS dùngbrew install jq, Ubuntu/Debian dùngsudo apt-get install jq. - Clone repo:
git clone https://github.com/parcadei/Continuous-Claude-v3.git - Sao chép skill:
mkdir -p ~/.claude/skills && cp -r Continuous-Claude-v3/.claude/plugins/braintrust-tracing/skills/trace-claude-code ~/.claude/skills/ - Cấp quyền thực thi cho hook:
chmod +x ~/.claude/skills/trace-claude-code/hooks/*.sh - Vào thư mục dự án cần trace rồi chạy
bash ~/.claude/skills/trace-claude-code/setup.shvà nhập API key, tên project. - Kiểm tra file
.claude/settings.local.jsonvừa tạo và thêm nó vào.gitignorevì có chứa API key. - Mở lại Claude Code, làm vài tác vụ, sau đó vào braintrust.dev → project của bạn → Logs để xem trace.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT