Skip to main content
Claude Agent SDK를 사용하면 Claude 기반 에이전트 애플리케이션을 빠르게 구축할 수 있습니다. Claude 에이전트에 Weave를 통합하여 에이전트 쿼리, 모델 응답, 도구 사용, 여러 턴에 걸친 대화를 포함한 Call을 자동으로 트레이싱할 수 있습니다. Weave는 캡처한 데이터를 프로젝트의 Agents 뷰에 표시합니다.

Weave로 Claude Agent SDK 에이전트 트레이싱하기

Weave SDK는 Python용 Claude Agent SDK를 자동 패치하여 최소한의 설정으로 Claude 에이전트의 트레이스를 캡처할 수 있게 합니다.이 가이드에서는 Weave를 초기화하고 ClaudeSDKClient를 통해 MCP 도구를 사용하는 Claude 에이전트를 실행하는 방법을 설명합니다. Weave는 대화, 모델 Call, 도구 Call을 처음부터 끝까지 자동으로 트레이싱합니다.

사전 요구 사항

  • CoreWeave Forge 계정과 WANDB_API_KEY 환경 변수로 설정한 API 키.
  • ANTHROPIC_API_KEY 환경 변수로 설정한 Anthropic API 키.
  • Python 3.10 이상.

패키지 설치

개발 환경에 다음 패키지를 설치하세요. weave 패키지는 트레이스를 캡처하며, claude-agent-sdk는 에이전트 런타임을 제공합니다.

코드에서 Weave 초기화

프로젝트에 weave.init을 추가하고, CoreWeave Forge 팀 및 프로젝트 이름을 업데이트한 다음, 평소처럼 에이전트를 구축하세요. weave.init은 Claude Agent SDK의 트레이스를 자동으로 수집하고 기록하는 자동 패치 기능을 활성화합니다.다음 코드는 두 개의 MCP 수학 도구를 사용하는 Claude 에이전트를 생성하고 실행하며, Weave는 실행 중 트레이스를 수집하고 기록합니다.
스크립트가 실행되면 weave.init()이 프로젝트 링크를 출력합니다. 링크를 열어 에이전트의 쿼리, 모델 응답 및 도구 Call에 대해 캡처된 트레이스를 확인하세요.

Agents 뷰에서 에이전트 트레이스 확인하기

스크립트가 실행되면 weave.init()이 프로젝트 링크를 출력합니다. Agents 뷰를 열어 다음을 확인하세요:
  • 대화의 턴을 포함하는 세션.
  • 중첩된 chat 및 execute_tool 하위 항목이 있는 invoke_agent span으로 표시되는 각 턴.
  • 각 단계의 전체 입력, 모델, 출력, 토큰 사용량 및 도구 결과.
Weave에서 Agents 데이터를 확인하는 방법에 대한 자세한 내용은 에이전트 활동 확인하기를 참조하세요.
마지막 수정일 2026년 9월 30일