도구 참조

이 페이지는 Anthropic이 제공하는 도구와 모든 도구 정의에 설정할 수 있는 선택적 속성에 대한 참조입니다. 도구 사용에 대한 개념적 소개는 Claude와 함께하는 도구 사용을 참조하세요. 애플리케이션에서 도구 사용을 구현하는 방법에 대한 안내는 도구 정의하기를 참조하세요.



Anthropic 제공 도구

Anthropic은 두 가지 종류의 도구를 제공합니다. Anthropic의 인프라에서 실행되는 서버 도구와 Anthropic이 스키마를 정의하지만 애플리케이션이 실행을 처리하는 클라이언트 도구입니다. 두 종류 모두 사용자 정의 도구와 함께 요청의 tools 배열에 나타납니다.

모델 호환성은 각 도구의 페이지를 참조하세요. 지원되는 모델은 도구 및 도구 버전에 따라 다릅니다.



도구 버전 관리

대부분의 Anthropic 제공 도구는 type 문자열에 _YYYYMMDD 접미사를 포함합니다. 도구의 동작, 스키마 또는 모델 지원이 변경되면 새 버전이 출시됩니다. 기존 통합이 계속 작동하도록 이전 버전은 계속 사용할 수 있습니다.

도구에 여러 활성 버전이 있는 경우, 버전 간의 관계는 다양합니다.

• 기능 기반: web_search_20260209 및 web_fetch_20260209는 이전 버전에 동적 콘텐츠 필터링을 추가합니다. web_fetch_20260309는 캐시 우회 옵션을 추가합니다. web_search_20260318 및 web_fetch_20260318은 응답 포함 제어를 추가합니다. code_execution_20260120은 샌드박스 내에서 프로그래밍 방식 도구 호출을 추가합니다. code_execution_20260521은 도구 설명에 셀별 시간 제한을 공개합니다. 각 경우에 새 버전과 이전 버전 모두 현재 버전이며, 어느 것을 사용할지는 새 기능이 필요한지 여부에 따라 달라집니다.
• 모델 기반: text_editor_20250728은 Claude 4 모델용이고 text_editor_20250124는 이전 모델용입니다. 사용하는 버전은 대상 모델에 따라 달라집니다.
• 버전이 아닌 변형: tool_search_tool_regex_20251119 및 tool_search_tool_bm25_20251119는 함께 출시된 두 가지 검색 알고리즘입니다. 어느 것도 다른 것을 대체하지 않습니다.
• 레거시: code_execution_20250522는 Python만 지원합니다. code_execution_20250825는 Bash 및 파일 작업을 추가합니다.

mcp_toolset 타입은 날짜 버전이 지정되지 않으며, 대신 anthropic-beta 헤더에서 버전 관리가 수행됩니다.



도구 정의 속성

사용자 정의 도구를 포함하여 tools 배열의 모든 도구는 도구가 로드되는 방식, 호출할 수 있는 주체, 입력이 검증되는 방식을 제어하는 선택적 속성을 허용합니다. 이러한 속성은 조합할 수 있습니다. 동일한 도구에 defer_loading, cache_control, strict를 모두 설정할 수 있습니다.



allowed_callers 값

allowed_callers는 다음의 조합을 허용하는 배열입니다.

"code_execution_20260120"과 "code_execution_20260521"은 모두 allowed_callers에서 허용되며 서로 교환 가능합니다. 두 코드 실행 도구 버전 중 하나를 사용하는 요청은 두 호출자 중 하나를 나열하는 도구를 충족합니다. 응답 블록은 요청에서 선언한 버전과 관계없이 항상 호출자를 code_execution_20260120으로 태그합니다.

배열에서 "direct"를 생략하면(예: "allowed_callers": ["code_execution_20260120"]) Claude가 코드 실행 내에서만 도구를 호출하도록 안내합니다. 응답의 tool_use 블록에는 어떤 호출자가 도구를 호출했는지 식별하는 caller 필드가 포함됩니다. caller 응답 형태 및 오류 동작을 포함한 전체 내용은 프로그래밍 방식 도구 호출을 참조하세요.



defer_loading과 프롬프트 캐싱

defer_loading: true가 설정된 도구는 캐시 키가 계산되기 전에 렌더링된 도구 섹션에서 제거됩니다. 이러한 도구는 시스템 프롬프트 접두사에 전혀 나타나지 않습니다. 도구 검색이 지연된 도구를 발견하고 해당 도구에 대한 tool_reference를 반환하면, 도구의 전체 정의가 접두사가 아닌 대화 본문의 해당 지점에 인라인으로 확장됩니다.

즉, defer_loading: true는 프롬프트 캐시를 보존합니다. 기존 캐시 항목을 무효화하지 않고 요청에 지연된 도구를 추가할 수 있으며, 도구가 발견된 턴과 호출된 턴 전반에 걸쳐 캐시가 유효하게 유지됩니다.

defer_loading을 cache_control 중단점과 결합하는 방법은 도구 검색 도구 프롬프트 캐싱 안내를 참조하세요.