도구 조합

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을 찾아내고, 가져오기(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와 함께 다른 도구들을 추가하세요.

메모리는 다른 도구들과 독립적입니다. 다른 도구들의 동작 방식을 바꾸지 않으며, "context window"(컨텍스트 윈도우)가 초기화될 때 사라질 사실들을 Claude가 기록해 두고 나중에 다시 불러올 수 있는 공간을 제공합니다. 저장 모델에 대해서는 메모리 도구를 참조하세요.

올인원: computer_use

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

{
  "tools": [{ "type": "computer_toolset_20260801" }]
}

툴셋 항목은 name이나 디스플레이 크기를 받지 않습니다. 좌표는 여러분이 반환하는 스크린샷의 픽셀 공간으로 표현되며, 항목의 configs 필드를 통해 개별 동작을 끌 수 있습니다.

컴퓨터 사용은 가장 범용적인 옵션이면서 가장 느린 옵션이기도 합니다. Claude가 일반적으로 각 동작 묶음 이후에 새로운 스크린샷을 필요로 하기 때문입니다. 사용 사례를 충족한다면 더 좁은 범위의 도구를 우선 사용하고, 다른 어떤 것도 맞지 않을 때 컴퓨터 사용을 선택하세요. 작업이 웹 브라우저 안에서만 이루어진다면 다음 섹션의 브라우저 에이전트 패턴을 사용하세요. 샌드박스 설정에 대해서는 컴퓨터 사용 도구를 참조하세요.

브라우저 에이전트: browser_use

전체 작업이 웹페이지 안에서 이루어지는 경우(양식 작성, 페이지 콘텐츠 읽기, 여러 탭에 걸친 작업), 브라우저 사용 도구가 컴퓨터 사용보다 더 적합합니다. 애플리케이션은 자신이 제어하는 브라우저를 구동하고 스크린샷이나 페이지 상태를 반환합니다. Claude는 클릭과 타이핑과 더불어 read_page, find, form_input, get_page_text와 같은 페이지 인식 멤버 도구를 호출하므로, 픽셀 좌표뿐만 아니라 요소 참조에 대해서도 동작할 수 있습니다.

{
  "tools": [{ "type": "browser_toolset_20260801" }]
}

컴퓨터 사용 툴셋과 마찬가지로 이 항목은 name을 받지 않으며, configs 필드를 통해 개별 멤버 도구를 끌 수 있습니다. 실행 계약에 대해서는 브라우저 사용 도구를 참조하세요.

다음 단계