도구 조합

Anthropic에서 제공하는 도구들은 함께 작동하도록 설계되었습니다. 일반적인 에이전트 패턴은 워크플로우의 상호 보완적인 단계를 다루는 도구들을 쌍으로 묶습니다. 한 도구는 정보를 수집하거나 발견하고, 다른 도구는 처리하거나 작동합니다. 아래의 조합들은 시작점이지 규칙이 아닙니다. 작업에 맞게 혼합하세요.

각 코드 조각은 tools 배열만 보여줍니다. 전체 요청 형태는 도구 호출 처리를 참조하세요.

연구 에이전트: web_search + code_execution

검색은 소스를 찾고, 코드 실행은 분석하고 종합합니다. Claude는 데이터를 검색한 다음 Python을 작성하여 처리, 표로 정리하거나 시각화합니다. 이 쌍은 최신 정보와 그 정보에 대한 중요한 계산이 모두 필요한 질문에 적합합니다. 예를 들어 "상위 5개 클라우드 제공자의 이번 분기 수익을 비교하세요"와 같은 질문입니다.

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "code_execution_20250825", "name": "code_execution" }
  ]
}

흐름은 일반적으로 검색, 실행, 그리고 첫 번째 시도에서 간격이 드러나면 선택적으로 다시 검색합니다. 코드 실행은 서버 측에서 실행되므로 관리할 클라이언트 측 샌드박스가 없습니다.

코딩 에이전트: text_editor + bash

텍스트 편집기는 파일을 읽고 수정하며, bash는 테스트와 빌드 명령을 실행합니다. 이것은 정규적인 소프트웨어 개발 루프입니다. 코드를 검사하고, 편집을 하고, 테스트를 실행하고, 반복합니다. 두 도구 모두 클라이언트에서 실행되므로 애플리케이션이 어떤 파일과 명령에 접근할 수 있는지 제어합니다.

{
  "tools": [
    { "type": "text_editor_20250728", "name": "str_replace_based_edit_tool" },
    { "type": "bash_20250124", "name": "bash" }
  ]
}

에이전트가 신뢰할 수 없는 코드에서 작동하는 경우 제한된 작업 디렉토리와 명령 허용 목록과 함께 이를 쌍으로 묶으세요. 실행 계약은 텍스트 편집기 도구와 Bash 도구를 참조하세요.

인용 후 가져오기: web_search + web_fetch

검색은 후보 URL을 표시하고, 가져오기는 관련 URL의 전체 페이지 콘텐츠를 검색합니다. 이것은 미리 모든 것을 가져오는 것을 피합니다. Claude는 검색을 실행하고, 스니펫을 검사하고, 실제로 관련성이 있어 보이는 2~3개의 결과를 선택하고, 그것들만 가져옵니다.

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "web_fetch_20260209", "name": "web_fetch" }
  ]
}

이 쌍은 답변이 검색 스니펫이 완전히 캡처할 수 없는 긴 형식의 콘텐츠(문서 페이지, 기사, 사양)에 있을 때 유용합니다. 가져오기는 전체 페이지를 가져와서 Claude가 특정 구절을 인용할 수 있게 합니다.

장기 실행 에이전트: memory + any toolset

메모리는 대화 전체에서 상태를 유지하고, 다른 도구들이 작업을 수행합니다. 이전 세션을 기억해야 하는 모든 에이전트에 메모리를 추가하세요. 예를 들어 고객의 이전 문제를 기억하는 지원 에이전트나 지난주에 내린 결정을 추적하는 프로젝트 어시스턴트입니다.

{
  "tools": [{ "type": "memory_20250818", "name": "memory" }]
}

다른 도구들을 같은 배열의 memory와 함께 추가하세요.

메모리는 나머지 도구 세트와 직교합니다. 다른 도구의 동작 방식을 변경하지 않으며, Claude가 컨텍스트 윈도우가 재설정될 때 손실될 사실을 기록하고 나중에 검색할 수 있는 장소를 제공합니다. 저장소 모델은 메모리 도구를 참조하세요.

올인원: computer_use

컴퓨터 사용 도구는 전체 데스크톱을 작동시켜 대부분의 다른 도구를 포함합니다. Claude는 스크린샷을 보고 마우스와 키보드 작업을 실행합니다. 즉, 인간이 할 수 있는 모든 애플리케이션을 구동할 수 있습니다. 더 구체적인 도구가 도달할 수 없는 임의의 GUI 상호작용이 필요한 경우 이를 사용하세요. API가 없는 레거시 소프트웨어, 시각적 검증 단계, 또는 여러 데스크톱 앱에 걸친 워크플로우입니다.

{
  "tools": [
    {
      "type": "computer_20250124",
      "name": "computer",
      "display_width_px": 1280,
      "display_height_px": 800
    }
  ]
}

컴퓨터 사용은 가장 일반적인 옵션이면서 가장 느립니다. 모든 작업이 스크린샷 왕복을 필요로 하기 때문입니다. 사용 사례를 다루는 더 좁은 도구를 선호하고, 다른 것이 맞지 않을 때 컴퓨터 사용에 도달하세요. 샌드박스 설정은 컴퓨터 사용 도구를 참조하세요.

다음 단계