웹 검색: 신뢰할 수 있는 사이트에서 얻는 답변

이 영상의 데모는 2026년 9월에 녹화되었습니다. Claude Sonnet 5(claude-sonnet-5)에서 실행되었습니다. 최신 모델에서는 결과가 다를 수 있습니다.

Claude는 학습 과정에서 익힌 내용을 바탕으로 답변하기 때문에, 그보다 더 최신인 내용이나 애초에 학습된 적이 없는 내용은 알지 못합니다. 이러한 최신 정보가 필요한 질문이 나오면, 누군가는 그 내용을 직접 찾아봐야 하고, 그 수고는 사용자의 몫이 됩니다.

웹 검색 도구를 사용하면 Claude가 이 수고를 직접 해결합니다. 요청을 처리하는 동안 웹을 검색하고, 검색한 내용을 바탕으로 답변합니다.

Meridian의 제안서 중 하나는 네 가지 캐나다 엔지니어링 표준을 조항별로 인용하며, 참조 내용이 하나라도 틀리면 Meridian은 전문직 배상 책임을 집니다. 그래서 제안서를 발송하기 전, Meridian은 각 참조 내용을 공식 출처와 대조해 확인하고자 합니다.

요청에 도구 추가하기

웹 검색은 서버 도구입니다. Anthropic의 인프라에서 실행되므로, 이를 위한 핸들러를 작성하거나 tool_result를 반환할 필요가 없습니다.

도구를 추가하려면 tools 목록에 항목 하나만 추가하면 됩니다. 이 항목의 type은 도구의 버전을 지정하며, Meridian은 이를 web_search_20260209로 설정합니다. name은 항상 web_search입니다. 도구 참조 문서에서 현재 버전을 확인할 수 있으므로, type 값은 그곳에서 복사하세요.

Claude 4.6 이상 모델에서는 web_search_20260209 및 이후 버전이 기본적으로 동적 필터링을 사용합니다. Claude는 검색 결과를 필터링하는 코드를 실행하므로, 관련성 있는 콘텐츠만 컨텍스트 창에 도달합니다.

Claude는 보통 한 번의 요청 안에서 모든 검색을 마칩니다. 사용자의 코드는 해당 요청을 보내고 완성된 답변을 받습니다.

API는 시간이 오래 걸리는 턴을 일시 중지하고 stop_reason으로 pause_turn을 반환할 수 있습니다. 이 경우, 응답 내용을 동일한 tools와 함께 assistant 메시지로 다시 보내면 Claude가 작업을 이어갑니다.

각 검색은 토큰 비용과 별도로 과금됩니다. 모든 클라우드 플랫폼이 웹 검색을 지원하는 것은 아닙니다.

Claude가 사용할 수 있는 사이트 지정하기

지금까지는 요청에 Claude가 검색할 수 있는 사이트를 제한하는 내용이 없었는데, 이는 Meridian에게 문제가 됩니다. 열린 웹에는 포럼 게시글과 리셀러 사이트가 넘쳐나지만, Meridian은 공식 출처만을 신뢰할 수 있습니다.

그래서 검색할 수 있는 범위를 직접 지정해야 합니다. allowed_domains는 도구 항목의 또 다른 필드로, 검색 결과를 지정한 사이트로 제한합니다. Meridian은 네 개의 사이트를 지정합니다. 두 곳은 이러한 표준을 발행하고 인증하는 기관인 csagroup.org와 cwbgroup.org입니다. 두 곳은 정부 사이트인 ontario.ca와 canada.ca입니다.

allowed_domains는 목록을 받습니다. 각 항목을 https:// 없이 순수 도메인 형식으로 작성하면, 해당 도메인의 하위 도메인도 포함됩니다.

답변과 출처 읽기

Claude의 답변은 여러 개의 text 블록으로 나뉘어 도착할 수 있으며, 그 사이사이에 검색이 진행됩니다. 따라서 전체 답변을 얻으려면 모든 text 블록을 이어 붙여야 합니다.

각 검색은 응답에 web_search_tool_result 블록도 추가합니다. 이 블록에는 검색이 반환한 결과 목록이 담겨 있으며, 각 결과에는 title과 url이 있습니다.

Meridian의 네 가지 참조 중, Claude는 두 개는 정확하고, 세 번째는 하위 조항 번호를 제외하면 정확하며, 네 번째는 틀렸다는 것을 확인했습니다.

프로그램으로 통합하기

Meridian의 프로그램은 이러한 단계들을 하나로 통합합니다. 프로그램에서 excerpt는 제안서의 해당 구절을 담고 있고, QUESTION은 Meridian의 질문을 담고 있습니다.

핵심 요약

• 웹 검색은 서버 도구이므로, tools에 항목 하나만 추가하면 되고 핸들러를 작성할 필요가 없습니다. Claude는 보통 한 번의 요청 안에서 모든 검색을 마칩니다.
• allowed_domains는 검색 결과를 지정한 사이트로 제한합니다.
• Claude 4.6 이상 모델에서는 web_search_20260209 및 이후 버전에서 동적 필터링이 기본적으로 켜져 있어, 관련성 있는 콘텐츠만 컨텍스트 창에 도달합니다.