Anthropic API: 코드 실행 도구 새 버전에 90초 제한 명시, 웹 도구에 response_inclusion 파라미터 추가

Anthropic은 2026년 6월 11일 에이전틱(agentic) 파이프라인에서 널리 사용되는 세 가지 API 도구에 대한 소규모이지만 기술적으로 의미 있는 업데이트를 발표했습니다. 이번 변경은 프로덕션 환경에서 발생하는 두 가지 문제에 초점을 맞췄습니다. 코드 실행 시 예상치 못한 시간 초과 오류와 긴 다단계 세션에서의 과도한 토큰 비용입니다.

코드 실행 도구: Claude가 이제 90초 제한을 인지

코드 실행 도구의 새 버전은 **code_execution_20260521**으로 명명됩니다. 핵심 변경 사항은 단순해 보이지만 중요합니다. API 인터페이스의 도구 설명에 이제 각 셀의 실행 시간 제한이 90초라는 내용이 명시됩니다.

왜 실질적으로 중요한가?

이전 버전에서도 이 제한은 존재했지만, Claude는 도구 컨텍스트에서 이에 대한 공식 정보를 갖고 있지 않았습니다. 결과적으로 에이전트가 장시간 계산 — 예를 들어, 대규모 데이터셋 반복, 복잡한 수치 시뮬레이션, ML 평가 — 을 실행하면 셀이 단순히 시간 초과되고 에이전트는 명확한 이유 없이 오류를 받았습니다.

새 버전에서 Claude는 도구 설명을 받는 순간부터 제한 사항을 인지합니다. 이를 계획에 활용할 수 있습니다. 시간 프레임 내에 맞는 더 작은 세그먼트로 작업을 나누거나, 다른 접근 방식이 필요한지 판단하거나, 계산이 단일 실행으로는 너무 오래 걸린다고 사용자에게 선제적으로 알릴 수 있습니다.

베타 헤더는 필요하지 않습니다. 변경 사항은 새 버전의 도구를 사용하는 모든 프로덕션 환경에서 즉시 적용됩니다.

새 response_inclusion 파라미터가 토큰을 절약하는 방법

**web_search_20260318**과 web_fetch_20260318 — 웹 검색 및 URL 콘텐츠 가져오기 도구의 새 버전 — 에는 공통 파라미터 **response_inclusion**이 도입됩니다.

메커니즘

일반적인 에이전틱 파이프라인에서 에이전트는 web_search를 호출하고, 결과를 받아 분석한 뒤 다음 단계로 진행합니다. 기본 동작에서는 소비된 결과 블록(consumed result blocks)이 API 응답에 그대로 남아 클라이언트에 반환되는 토큰으로 집계됩니다. 웹 호출이 많은 긴 세션에서는 이것이 상당한 비용으로 쌓입니다.

response_inclusion 파라미터를 사용하면 개발자가 소비된 블록을 API 응답에서 제외할 수 있습니다 — Claude는 이미 이를 읽고 활용했으므로, 출력 토큰으로 반환되어 청구될 이유가 없습니다.

누구에게 관련 있는가?

이 변경은 다음에 특히 유용합니다.

• 단일 세션에서 수십 개의 웹 검색과 가져오기를 실행하는 리서치 에이전트
• 웹 가져오기와 내부 지식 기반을 결합하는 RAG(Retrieval-Augmented Generation) 파이프라인
• 웹 소스를 주기적으로 확인하고 종합하는 모니터링 에이전트

절감 효과는 결과 크기와 단계 수에 따라 다르지만, 웹 호출이 많은 긴 에이전틱 세션에서는 그 차이가 상당할 수 있습니다.

베타 헤더는 여기서도 필요하지 않습니다. 두 도구 모두 프로덕션 사용을 위해 즉시 이용 가능합니다.

맥락: 작은 변경, 구체적인 효과

이 세 가지 업데이트는 새로운 기능을 도입하지 않습니다 — Claude는 이전에도 웹을 검색하고 코드를 실행할 수 있었습니다. 이는 개발자들이 프로덕션에서 보고한 구체적인 문제점을 해결하는 엔지니어링 개선입니다. 시간 제한으로 인한 예상치 못한 오류와 에이전틱 루프에서의 불필요하게 높은 토큰 비용이 그것입니다.

이 두 가지 변경의 조합 — 코드 실행 제한에 대한 향상된 자기 인식과 웹 호출의 감소된 오버헤드 — 은 장기적이고 자율적인 에이전틱 환경을 구축하는 개발자들을 직접 겨냥합니다. 이런 환경에서는 불필요한 토큰 하나, 예방할 수 있었던 오류 하나가 실제 비용을 의미합니다.