도구 조합

Anthropic이 제공하는 도구는 함께 작동하도록 설계되었습니다. 일반적인 에이전트 패턴은 워크플로의 상호 보완적인 단계를 담당하는 도구들을 짝지어 사용합니다. 하나의 도구가 수집하거나 발견하고, 다른 도구가 처리하거나 실행합니다. 아래의 조합은 시작점일 뿐 규칙이 아닙니다. 작업에 맞게 자유롭게 조합하세요.

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



리서치 에이전트: web_search + code_execution

검색은 출처를 찾고, 코드 실행은 분석하고 종합합니다. Claude는 데이터를 검색한 다음 Python을 작성하여 처리, 표로 정리 또는 시각화합니다. 이 조합은 최신 정보와 그 정보에 대한 복잡한 연산이 모두 필요한 질문에 적합합니다. 예를 들어 "상위 5개 클라우드 제공업체의 이번 분기 실적을 비교해 줘"와 같은 질문입니다.

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "code_execution_20260521", "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을 찾아내고, 가져오기는 관련 있는 페이지의 전체 콘텐츠를 검색합니다. 이렇게 하면 모든 것을 미리 가져오는 것을 피할 수 있습니다. Claude는 검색을 실행하고, 스니펫을 검토하고, 실제로 관련성이 있어 보이는 두세 개의 결과를 선택한 다음, 그것들만 가져옵니다.

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

이 조합은 검색 스니펫으로는 완전히 담아낼 수 없는 장문 콘텐츠(문서 페이지, 기사, 사양서)에 답이 있을 때 유용합니다. 가져오기는 전체 페이지를 가져오므로 Claude가 특정 구절을 인용할 수 있습니다.



장기 실행 에이전트: memory + 모든 도구 세트

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

{
  "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
    }
  ]
}

컴퓨터 사용은 가장 범용적인 옵션이지만 모든 동작마다 스크린샷 왕복이 필요하기 때문에 가장 느리기도 합니다. 사용 사례를 충족하는 경우 더 좁은 범위의 도구를 우선적으로 사용하고, 다른 방법이 없을 때 컴퓨터 사용을 선택하세요. 샌드박스 설정에 대해서는 컴퓨터 사용 도구를 참조하세요.



다음 단계