Claude의 Python·TypeScript SDK에 베타 컴퓨터·브라우저 툴셋이 들어왔습니다

바뀐 내용

ClaudeDevs는 API가 Claude가 클릭하거나 입력하려는 내용을 알려 주고, SDK가 이제 루프를 실행해 동작을 드라이버로 보낸다고 썼습니다. ClaudeDevs는 그전에는 루프를 직접 작성하고 클릭과 키 입력을 명령에 대응시켰다고 말했습니다. 플랫폼 페이지는 툴 러너와 직접 작성하는 루프를 문서화합니다.

BetaAbstractBrowserToolset20260801 또는 BetaAbstractComputerToolset20260801을 서브클래스로 만들고, navigate나 left_click처럼 동작마다 메서드 하나를 둡니다. Python 가이드는 BetaAsyncAbstractBrowserToolset20260801과 BetaAsyncAbstractComputerToolset20260801도 다룹니다. 컴퓨터 퀵스타트는 이 툴셋을 computer_toolset_20260801이라고 부릅니다. 20260801 접미사는 이 페이지들에 적힌 식별자입니다. 문서는 별도의 출시일을 밝히지 않습니다. 구현하지 않고 빼 둔 멤버는 API에 disabled로 전달됩니다. Claude가 그래도 호출하면 SDK는 오류를 반환하고 실행은 계속됩니다. 요청 하나에 브라우저 인스턴스와 컴퓨터 인스턴스를 함께 넣을 수 있습니다. 각 호출은 toolset_name으로 browser 또는 computer를 담고, 실패하면 그 턴에서 같은 툴셋의 나머지 호출을 건너뜁니다. 그래서 컴퓨터 호출이 실패해도 그 턴의 브라우저 호출은 계속 실행됩니다.

ClaudeDevs는 Browser Use, Browserbase, E2B, Daytona의 드라이버나, 퀵스타트 예제로 만든 자체 코드를 거론합니다. 문서는 Browser Use, Browserbase, E2B가 자체 연동을 공개한다고 말합니다. Daytona는 ClaudeDevs 게시물에 나옵니다.

• X의 ClaudeDevs
• SDK 툴셋으로 하는 브라우저·컴퓨터 사용

대상

브라우저나 데스크톱 드라이버를 직접 제공하는, 베타 Python·TypeScript API SDK 호출자를 위한 것입니다. 호출하는 쪽이 브라우저나 데스크톱, 드라이버, URL 정책을 준비합니다.

컴퓨터 퀵스타트는 Python의 anthropic.tools.computer 또는 TypeScript의 @anthropic-ai/sdk/helpers/beta/toolsets가 있는 SDK 빌드, Python 3.10+ 또는 Node.js 20+, 그리고 모델을 실행할 때의 ANTHROPIC_API_KEY를 전제로 합니다. 패키지 버전은 적지 않습니다. MODEL 변수의 기본값은 claude-sonnet-5-5입니다. 플랫폼 페이지의 샘플은 claude-opus-5-5를 넘깁니다. 둘 다 샘플 문자열이며, 페이지는 더 넓은 모델 목록을 주지 않습니다. Claude Code changelog는 이 클래스들을 설명하지 않습니다.

• Claude Code changelog

시험 방법

컴퓨터 퀵스타트는 Python과 TypeScript로 된 수백 줄짜리 VNC 드라이버(RFB 프로토콜)입니다. README는 인터페이스를 보여 주는 코드이며 프로덕션 코드가 아니라고 말합니다. localhost의 비밀번호 없는 서버와 1920×1200을 넘지 않는 화면을 씁니다. 샘플 명령은 Xvnc :1 -geometry 1280x800 -depth 24 -SecurityTypes None -localhost -rfbport 5900입니다. 컨테이너에서는 -p 127.0.0.1:5900:5900만 게시합니다. VNC_HOST의 기본값은 127.0.0.1이고 VNC_PORT의 기본값은 5900입니다. x11vnc -display :0 -nopw -localhost -forever도 동작합니다. 화면을 폴링하므로 입력 직후 스크린샷은 아직 갱신되지 않았을 수 있습니다. 샌드박스 안의 버려도 되는 데스크톱을 씁니다. 화면에 있는 내용이 다음 동작을 이끌고, 포커스가 있는 터미널은 모델이 입력한 것을 그대로 실행합니다.

python run.py "Open a terminal, run date, and tell me today's date and time zone"은 그 명령줄 전체를 작업으로 보냅니다. TypeScript는 같은 문장을 붙인 npm run start --입니다. run.ts는 옵션을 읽지 않으므로 --help도 모델로 갑니다. run.py는 --help에 스스로 답합니다. 스크린샷이 아닌 각 동작 전에 run은 호출을 보여 주고, y로 답할 때만 실행합니다. python exercise.py와 npm run exercise는 VNC 서버에 연결해, 모델이 보낼 호출을 스크립트로 보냅니다. API 키는 필요 없습니다. 이들의 confirm은 모든 호출을 승인합니다.

예제는 screenshot, left_click, right_click, double_click, triple_click, mouse_move, scroll, type, key, wait를 구현합니다. zoom, left_click_drag, left_mouse_down, left_mouse_up, middle_click, hold_key, cursor_position은 빼 둡니다. 같은 제외 부분은 스케일링, VNC 비밀번호와 RFB 3.7보다 오래된 서버, Raw가 아닌 인코딩, 드라이버가 연결된 동안 크기가 바뀌는 화면, 그리고 예제가 소문자 a로 입력하는 shift+a도 다룹니다. wait의 상한과, 서버가 응답을 멈췄을 때의 재연결도 다룹니다. README는 프로덕션 드라이버에 그 목록의 대부분이 필요하다고 말합니다. 플랫폼 페이지는 컴퓨터 동작을 17개로 집계하고, 다섯 개를 구현한 샘플 드라이버를 보여 줍니다.

이 예제는 크기를 바꾸지 않은 Raw 스크린샷을 보내며, 1280×800에서 약 4MB입니다. 모델이 요청한 wait 시간만큼 잠듭니다. 어느 SDK도 duration, 반복 횟수, scroll_amount를 제한하지 않으며, SDK는 이미지를 리사이즈하지 않습니다. 요청 하나가 이미지를 20장보다 많이 담으면, 페이지는 이미지마다 더 엄격한 한도를 가리키지만 그 숫자는 적지 않습니다.

플랫폼 퀵스타트는 같은 페이지의 브라우저 경로입니다. BetaAbstractBrowserToolset20260801을 서브클래스로 만들고 navigate, screenshot, left_click, _browser_state를 구현한 뒤 URL 정책을 넘깁니다. 샘플 작업은 툴 러너에게 example.com을 열고 페이지 제목을 보고하라고 합니다. 페이지는 그 정책을 예제라고 부르며, 정책이 마련되기 전까지는 버려도 되는 브라우저를 쓰라고 합니다. 같은 페이지는 claude-quickstarts에 있는 Python과 TypeScript의 최소 예제가 Chrome DevTools Protocol(CDP)로 Chromium을 제어한다고 설명합니다. 그 예제는 프로덕션 코드가 아닙니다.

브라우저 툴셋에서 javascript_exec와 file_upload는 기본으로 꺼져 있습니다. confirm 호출 가능 객체 없이 둘 중 하나를 켜면 구성 오류가 발생합니다. TypeScript에서 confirm: null은 오류를 내지 않고, SDK는 모든 브라우저 호출을 거부합니다. 파일 정책이 없으면 경로나 문서 ID를 지정한 업로드는 모두 거부됩니다. URL 정책이 없으면 SDK는 URL을 검사하지 않고, API도 Claude가 여는 URL을 걸러 내지 않습니다. 정책이 보는 것은 navigate 호출뿐입니다. Anthropic의 프롬프트 인젝션 분류기는 현재 Amazon Bedrock으로 보낸 브라우저 툴셋 요청에서는 실행되지 않습니다.

컴퓨터 툴셋에서 type, key, hold_key를 구현하는 드라이버에는 confirm 호출 가능 객체가 필요하거나, configs로 그 도구들을 꺼야 합니다. 그렇지 않으면 생성자가 예외를 일으킵니다. SDK는 누구에게도 묻지 않습니다. confirm이 없으면 구현된 모든 호출을 실행하며, 여기에는 모든 클릭이 포함됩니다. 구현하는 컴퓨터 도구는 모두 기본으로 켜져 있습니다.

• 컴퓨터 툴셋 퀵스타트
• SDK 툴셋 문서

아직 열린 점

게시물과 이 페이지들은 가격, 할당량, 플랜 요건, 패키지 버전, 정식 출시일을 밝히지 않습니다. claude-sonnet-5-5와 claude-opus-5-5를 넘는 모델 지원은 적혀 있지 않습니다. Daytona는 ClaudeDevs의 언급으로 남습니다. 툴셋 페이지는 컴퓨터 동작을 17개로 집계하고, 전체 목록은 별도의 동작 레퍼런스를 가리킵니다. Chrome DevTools Protocol 퀵스타트도 인용합니다.