메인 콘텐츠로 건너뛰기
Claude Agent SDK는 Claude로 에이전트 애플리케이션을 구축할 수 있도록 Anthropic에서 제공하는 Python SDK입니다. weave.init()를 호출하면 W&B Weave가 Claude Agent SDK call을 자동으로 트레이스하여 쿼리, 도구 사용, 멀티턴 대화를 캡처합니다. 이 가이드에서는 Weave로 Claude Agent SDK 애플리케이션을 계측하여 Weave UI에서 모든 쿼리, 도구 호출, 대화 턴을 확인하는 방법을 보여드립니다. 이 문서는 맞춤형 트레이싱 코드를 작성하지 않고도 종단 간 관측성을 확보하려는 Claude 기반 에이전트 개발자를 위한 것입니다.

사전 요구 사항

코드 예제를 실행하기 전에 Weave가 인증하고 트레이스를 프로젝트로 라우팅할 수 있도록 다음 설정을 완료하세요:
  • weave.init() 호출에서 your-team-name을 담당 W&B 팀 이름으로 바꾸세요.
  • 환경 변수에 WANDB_API_KEYANTHROPIC_API_KEY를 설정하세요. W&B API 키에 대한 자세한 내용은 API 키를 참조하세요.

설치

환경에서 Weave와 Claude Agent SDK를 모두 사용할 수 있도록 pip를 사용해 필요한 의존성을 설치합니다:

시작하기

이 섹션에서는 Weave가 단일 run에서 Claude Agent SDK의 다양한 사용 패턴을 어떻게 트레이스하는지 보여 주는 전체 예시를 살펴봅니다. Claude Agent SDK를 사용하기 전에 weave.init()를 호출하면 Weave가 SDK를 자동으로 패치하고 모든 쿼리를 트레이스합니다. 다음 예시에서는 세 가지 기능을 보여 줍니다.
  • query() 함수를 사용한 간단한 단발성 쿼리로, 모델 응답과 비용을 포함합니다.
  • ClaudeSDKClient를 사용한 MCP 도구 사용. Claude Agent SDK는 인프로세스 MCP 서버를 통해 맞춤형 도구를 지원합니다.
    • Weave는 에이전트 쿼리와 함께 도구 정의, 도구 호출, 결과를 트레이스합니다.
    • MCP 데모에서는 두 개의 MCP 도구를 정의하고, 이를 사용하는 쿼리를 실행합니다.
  • weave.thread()가 단일 트레이스로 묶는 멀티턴 대화. Weave는 각 턴을 스레드의 하위 항목으로 캡처하므로, Weave UI에서 전체 대화 흐름을 확인할 수 있습니다.

트레이스 보기

예제를 실행한 후에는 Weave가 프로젝트에 일련의 트레이스를 기록하며, 이를 사용해 에이전트의 동작을 디버그하고 분석할 수 있습니다. 예제를 실행하면 Weave가 Weave 대시보드로 연결되는 링크를 출력합니다. 링크를 열어 쿼리 입력, 모델 응답, 도구 호출, 대화 스레드를 포함한 트레이스를 확인하세요.