Claude Computer Use 가이드: API, Cowork, Claude Code 중 무엇을 써야 하나

지금의 Claude Computer Use는 두 가지 다른 실행 계약을 가리킵니다. API 쪽에서 Anthropic이 빌더에게 제공하는 것은 스크린샷, 마우스 동작, 키보드 입력, 데스크톱 자동화를 자신이 관리하는 샌드박스 안에서 돌리는 beta 도구입니다. 제품 쪽에서 Cowork와 Claude Code는 Claude가 당신의 컴퓨터에서 일하도록 맡기는 경로를 뜻하고, Anthropic의 데스크톱 제품이 세션을 운영하는 동안 어떤 접근과 승인, 에스컬레이션을 허용할지는 당신이 정합니다.

가장 짧고 정확한 답은 이렇습니다. 제품 안에 자동화를 넣고 싶다면 API 경로를 쓰고, 내 컴퓨터에서 Claude에게 일을 맡기고 싶다면 Cowork나 Claude Code를 써야 합니다. 중요한 질문은 "Claude가 클릭할 수 있나?"가 아니라 "실행 환경을 누가 소유하고, 도구 루프를 누가 가지며, 어떤 권한과 보존 경계를 받아들일 것인가?"입니다.

“

근거 메모: 이 글은 Anthropic의 현재 computer use API 문서, Cowork 도움말, Cowork 제품 페이지, computer use 개인정보 처리 안내를 2026년 3월 28일 기준으로 확인한 내용에 기반합니다.

TL;DR

• Anthropic API computer use는 빌더용입니다. beta 도구를 켜고, 자신이 제어하는 VM이나 컨테이너 안에서 Claude를 돌리고, 실제 동작을 실행한 뒤 tool_result를 다시 모델에 돌려줍니다.
• Cowork와 Claude Code는 내 컴퓨터에서 Claude에게 일을 맡기고 싶은 사람을 위한 경로입니다. Anthropic의 데스크톱 제품이 세션을 오케스트레이션하고, 사용자는 폴더, 커넥터, 승인, 그리고 파일/브라우저 경로에서 화면 조작으로 올라갈지 여부를 통제합니다.
• 가장 빨리 써보려면 API 쪽은 Anthropic의 reference implementation에서 시작하고, 데스크톱 쪽은 Claude Desktop -> Cowork에서 시작하는 것이 가장 안전합니다.
• 이 두 경로는 설정, 권한, 데이터 보존에 대해 하나의 공통 계약을 공유하지 않습니다. 각각 따로 봐야 합니다.
• 기본 안전 원칙은 커넥터 또는 로컬 파일 우선 -> 브라우저 -> 화면 조작입니다.
• 민감한 계정, 결제, 동의 플로우, 완벽한 정확도가 필요한 작업은 어느 경로를 쓰더라도 사람이 최종 확인을 유지해야 합니다.

Claude Computer Use는 지금 무엇을 뜻하나

처음 이 표현이 주목받기 시작했을 때는, 주로 하나의 개발자 기능을 가리켰습니다. Anthropic이 Claude에게 스크린샷을 보고 마우스와 키보드 조작을 호출할 수 있게 해 주고, 제어된 데스크톱 환경 안에서 작업을 진행시키는 이야기였습니다. 에이전트 제품을 만드는 사람에게는 지금도 그 경로가 핵심입니다.

혼란이 커진 이유는 Anthropic이 같은 계열의 기능을 Cowork와 Code의 제품 서사에도 확장했기 때문입니다. 현재 Cowork 제품 페이지에는 Claude가 스마트폰과 데스크톱을 오가며 같은 대화를 이어 가고, 커넥터를 쓰고, Chrome으로 웹 작업을 하고, 직접 통합이 없을 때는 컴퓨터를 사용할 수 있다고 적혀 있습니다. 도움말 페이지는 이를 더 실무적으로 설명합니다. Cowork는 Claude Desktop 안에서 동작하고, 사용자의 컴퓨터 위에서 일을 수행하며, 작업 중간에도 사용자가 개입할 수 있습니다. 즉, 같은 표현이 지금은 서로 다른 두 실행 모델을 함께 가리키고 있습니다.

이 겹침은 꽤 실무적인 오판을 만듭니다. 빌더는 API 쪽에서 Anthropic이 어디까지 대신 관리해 주는지 과대평가하기 쉽고, 데스크톱 사용자는 자기 컴퓨터에서 권한 설정, 범위 통제, 승인이 얼마나 중요한지 과소평가하기 쉽습니다. 이 주제를 가장 안정적으로 이해하는 방법은 실행 환경의 소유자를 기준으로 나누는 것입니다. 당신의 앱이 tool_use를 받아서 동작을 실행하고 결과를 돌려준다면 API 경로입니다. Anthropic의 데스크톱 제품이 당신의 컴퓨터 위에서 세션을 돌린다면 Cowork 또는 Claude Code 경로입니다.

또 하나 미리 분리해 둬야 할 점이 있습니다. 브라우저 사용과 완전한 컴퓨터 사용은 같은 것이 아닙니다. Anthropic의 Cowork 페이지는 꽤 좋은 우선순위를 이미 제시하고 있습니다. 커넥터로 풀 수 있으면 커넥터, Chrome에서 끝낼 수 있으면 브라우저, 직접 통합이 없을 때만 화면 조작. 이 순서는 "Claude가 컴퓨터를 쓸 수 있다"는 큰 문장보다 훨씬 실용적입니다.

경로 1: Anthropic API의 컴퓨터 사용 도구

제품 자동화를 만들거나, 내부 에이전트를 구축하거나, 사람처럼 GUI를 다뤄야 하는 워크플로를 만들고 싶다면 봐야 할 것은 이 API 경로입니다. Anthropic의 현재 문서에서 computer use는 스크린샷 캡처, 마우스 제어, 키보드 입력, 일반적인 데스크톱 자동화를 제공하는 beta 도구로 설명됩니다. 여기서 가장 중요한 부분은 "Claude가 클릭할 수 있다"가 아니라 계약의 형태입니다. Claude가 tool call을 내리고, 당신의 애플리케이션이 VM 또는 컨테이너 안에서 실제 동작을 수행한 다음, tool_result를 반환하며 그 루프를 완료 시점까지 반복합니다.

바로 이 "루프를 소유하는 것은 당신"이라는 점이 모든 것을 바꿉니다. Anthropic이 대신 당신의 머신을 원격으로 조작해 주는 것이 아닙니다. 시스템 통합자는 당신입니다. 화면을 어떻게 구성할지, 스크린샷을 어떻게 찍을지, 고해상도에서 좌표를 어떻게 변환할지, 클릭과 키 입력을 어떻게 실제로 실행할지, 그리고 어떤 제약으로 모델을 경계 안에 가둘지를 당신이 정해야 합니다. API 측의 computer use는 마법 스위치를 켜는 기능이 아니라, 도구 계약을 실제 실행 환경에 연결하는 작업입니다.

현재 beta 헤더도 이것이 어디까지나 도구 계약임을 보여줍니다. Anthropic은 지금 다음을 안내합니다.

• computer-use-2025-11-24: Claude Opus 4.6, Claude Sonnet 4.6, Claude Opus 4.5용
• computer-use-2025-01-24: Sonnet 4.5, Haiku 4.5, Opus 4.1, Sonnet 4, Opus 4, 그리고 폐기 예정인 Sonnet 3.7용

최소한의 요청 뼈대는 이렇게 생깁니다.

bash
curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: computer-use-2025-11-24" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "tools": [
      {
        "type": "computer_20251124",
        "name": "computer",
        "display_width_px": 1024,
        "display_height_px": 768,
        "display_number": 1
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "Open the browser and summarize the dashboard."
      }
    ]
  }'

이 예시가 중요한 이유는 "바로 쓸 수 있는 만능 자율성"을 보여주기 때문이 아니라, 실제 기능의 성격을 드러내기 때문입니다. 어떤 beta 계약을 쓸지, 어떤 도구 타입을 쓸지, 어떤 화면을 전제로 할지를 당신이 명시해야 합니다. 그리고 진짜 어려운 부분은 그 요청 자체가 아니라, 그 바깥의 실행 환경입니다.

이 경로가 가장 강한 곳은 정말로 UI밖에 없는 경우입니다. 오래된 엔터프라이즈 소프트웨어, 깔끔한 API가 없는 내부 도구, RPA형 브라우저 작업, end-to-end 테스트 등은 합리적인 사용 사례입니다. 반대로 이미 API, CLI, webhook, DB 쿼리 같은 더 직접적인 인터페이스가 있다면, 화면 자동화는 대개 더 나쁜 설계입니다. computer use가 나쁜 것이 아니라, 더 직접적인 기계 인터페이스가 있는데도 가장 부서지기 쉬운 층을 택하는 셈이기 때문입니다.

비용 구조도 같은 메시지를 줍니다. Anthropic의 현재 문서는 computer use beta가 466-499개의 system prompt tokens를 추가하고, Claude 4.x 계열에서는 735개의 도구 정의 입력 토큰이 더 필요하다고 설명합니다. 여기에 스크린샷의 vision 비용과 tool result 비용도 붙습니다. 즉, 화면 수준 자동화에는 시각적 컨텍스트를 유지하기 위한 고유한 오버헤드가 있습니다. UI가 정말 유일한 진입점일 때는 감수할 만하지만, 그렇지 않다면 비싼 우회로입니다.

여기서 진짜 중요한 것은 안전 가이드입니다. Anthropic은 전용 VM 또는 컨테이너, 최소 권한, 도메인 제한, 의미 있는 동작에 대한 인간 확인을 권장합니다. 웹 페이지와 이미지에서 오는 prompt injection 위험도 명시합니다. 이것은 형식적인 경고문이 아니라 computer use의 본질입니다. 모델이 화면을 읽고 그 위의 단서에 따라 행동을 정하는 순간, 그 환경은 항상 잠재적인 적대 입력으로 봐야 합니다.

또 하나 놓치기 쉬운 구현 이슈가 좌표 스케일링입니다. Anthropic의 현재 docs는 모델이 분석하는 이미지 크기와 실제로 클릭이 실행되는 화면 좌표가 다를 수 있다고 설명합니다. 직접 리사이즈와 역변환을 하지 않으면, 추론은 맞아도 클릭이 빗나갈 수 있습니다. 이 역시 API 경로가 "기능에 흥미 있는 사람"이 아니라 "구현 책임을 질 수 있는 사람"에게 맞는 이유입니다.

경로 2: 내 컴퓨터에서 Cowork와 Claude Code 사용하기

많은 사람들이 "Claude에게 컴퓨터를 쓰게 하고 싶다"고 말할 때 실제로 원하는 것은 이 데스크톱 제품 경로입니다. 여기서 중요한 차이는, 당신이 자신의 제품에 도구 루프를 심는 것이 아니라, Anthropic의 데스크톱 환경을 이용해 자신의 컴퓨터 위 작업을 Claude에게 위임한다는 점입니다. 현재 Cowork 도움말은 Cowork에 Claude Desktop이 필요하고, macOS와 Windows를 지원하며, 웹이나 모바일 단독 실행면은 아니라고 설명합니다. 작업이 진행되는 동안 데스크톱 앱은 열려 있어야 합니다.

이 시점에서 이미 API와는 전혀 다른 성격이 됩니다. API는 통합 계약이고, Cowork는 제품 워크플로입니다. Anthropic은 이를 "작업을 넘기고 결과물을 받는" 방향으로 설명합니다. 데스크톱 앱은 사용자가 공유한 폴더와 커넥터, 로컬 파일을 다룰 수 있고, 더 긴 작업도 진행할 수 있습니다. 같은 도움말 페이지는 작업이 데스크톱에서 돌아가는 동안 휴대폰으로 Claude에게 계속 메시지를 보낼 수 있다고도 말합니다. 이는 API가 주는 편의성과는 다른 종류의 편의성입니다. API에서는 런타임을 만들지만, 여기서는 제품 안에서 조향합니다.

Cowork 제품 페이지에는 2차 설명에서 자주 빠지는 중요한 힌트도 있습니다. Claude는 먼저 커넥터, 다음으로 Chrome, 마지막으로 화면을 고릅니다. 즉 Anthropic 자신의 문맥에서도 화면 조작은 1순위가 아니라 마지막 수단입니다. 이 순서를 먼저 이해하면 "Claude가 당신의 컴퓨터를 사용할 수 있다"는 크고 강한 표현에 덜 흔들리게 됩니다.

Anthropic의 가용성 표현도 꽤 조심스럽습니다. 도움말은 Cowork 전체를 macOS와 Windows용 Claude Desktop의 유료 플랜 기능으로 설명합니다. 반면 제품 페이지의 더 강한 문장, 즉 "Anything you can do on your computer, Claude can do"는 현재 Available on macOS라고 표시되어 있습니다. 여기서 가장 안전한 태도는 둘을 억지로 같은 범위로 뭉개지 않는 것입니다. 문서가 실제로 말하는 수준까지만 말해야 합니다. Cowork라는 데스크톱 작업면은 더 넓고, 명시적인 computer-use 표시는 현재 macOS에 연결되어 있다는 해석이 가장 안전합니다.

또한 Anthropic은 같은 제품 페이지에서 persistent conversation과 computer use update가 Cowork와 Code 모두에 걸친다고 말합니다. 다만 현재 가장 구체적인 공개 운영 절차는 Code보다 Cowork 쪽에 더 잘 문서화되어 있습니다. 따라서 실무적으로는 Code를 같은 계열의 관련 surface로 이해하되, 실제 시작 경로는 Cowork 문서를 기준으로 삼는 편이 더 안전합니다.

권한 경계도 이쪽은 훨씬 제품적입니다. Cowork 도움말은 파일을 영구 삭제하기 전 사용자의 명시적 허가가 필요하다고 말합니다. 제품 페이지는 Claude가 먼저 계획을 보여주고 승인을 기다리며, 접근 가능한 폴더와 커넥터를 사용자가 정한다고 설명합니다. 이는 샌드박스와 승인 로직을 직접 설계해야 하는 API 경로와 완전히 다릅니다. 데스크톱 경로는 저수준 자동화 툴이라기보다, 권한 경계를 갖춘 위임 UI에 가깝습니다.

많은 비개발 작업에서는 오히려 이쪽이 더 맞습니다. Downloads 정리, 노트에서 보고서 초안 만들기, 영수증 스크린샷을 표로 정리하기, 반복 요약 만들기 같은 일은 API computer use보다 Cowork에 더 가깝습니다. 코딩 주변 작업에서도 질문은 같아야 합니다. 정말 프로그래머블한 agent runtime이 필요한가, 아니면 내 컴퓨터 위에서 Claude에게 일을 시키고 내가 감독하면 충분한가. 후자라면 Cowork나 Claude Code가 자연스러운 출발점입니다.

플랜과 접근 조건이 궁금하다면 Claude Code 가격 가이드를 같이 보는 것이 좋습니다. 그리고 넓은 의미의 computer use가 아니라, 코드 작업에서의 더 안전한 장시간 자율성이 궁금한 것이라면 Claude Code Auto mode 해설이 더 직접적으로 도움이 될 수 있습니다.

각 경로에서 가장 빠른 시작 방법

생태계를 전부 이해한 뒤에 시작하고 싶지 않다면, 먼저 이렇게 접근하면 됩니다.

API 경로에서는 Anthropic의 reference implementation에서 출발하는 것이 가장 안전합니다. 처음부터 생짜 "클릭 실행기"를 직접 쓰지 마세요. 현재 beta 헤더를 넣고, 전용 VM 또는 컨테이너 안에 환경을 세우고, computer tool과 사용자 프롬프트를 Claude에 전달하고, 반환된 동작을 실행한 뒤 tool_result를 다시 돌려주는 루프를 만드세요. 핵심은 첫 API 호출이 아니라 그 바깥의 격리 경계입니다.

데스크톱 경로에서는 Claude Desktop을 열고 Cowork로 전환한 뒤, Claude가 접근할 작업 폴더 또는 파일을 선택하고, 원하는 산출물을 설명하고, Claude가 보여주는 계획을 확인한 후 실행하면 됩니다. 작업이 진행되는 동안에는 데스크톱 앱을 열어 두어야 합니다. 중간에 스마트폰으로 지시를 보태고 싶다면 Anthropic이 문서화한 모바일 이어쓰기 흐름을 쓰면 되지만, 실제 실행은 여전히 데스크톱 앱에 묶여 있습니다.

어떤 경로를 골라야 하나

에이전트 기능을 자신의 제품에 넣고 싶다면 API.
내 컴퓨터 위의 일을 Claude에게 맡기고 싶다면 Cowork 또는 Claude Code. 조금 더 실무적으로 풀면 이렇습니다.

가장 쓸모 있는 정리는 이것입니다. API 경로는 도구를 만드는 사람을 위한 것이고, 데스크톱 경로는 일을 위임하는 사람을 위한 것입니다. 중요한 것은 기능을 더 크게 들리게 만드는 것이 아니라 실행 환경의 소유자를 먼저 분리하는 일입니다. 그래야 위험, 설정 비용, 승인 흐름, 적합한 작업을 따로 판단할 수 있습니다.

프라이버시와 보존은 surface별로 봐야 한다

이 부분은 특히 쉽게 과장되거나 단순화됩니다. Anthropic의 현재 공개 자료는 computer use의 모든 surface를 하나의 문장으로 완벽하게 설명하는 단일 보존 규칙을 제시하지 않습니다.

API 쪽 문서는 이 기능을 client-side tool로 설명하고, ZDR 계약이 있는 조직에서는 응답 후 보관하지 않는 방식으로 처리할 수 있다고 씁니다. 하지만 commercial products용 privacy article은 스크린샷이 별도 조건이 없으면 backend에서 30일 안에 자동 삭제된다고 설명합니다. 반면 Cowork 제품 페이지는 작업 기록이 기본적으로 로컬에 저장된다고 강조합니다.

여기서 내려야 할 결론은 "Anthropic이 모순된다"가 아닙니다. 더 정확한 결론은 computer use가 이미 여러 surface에 걸쳐 있다는 것입니다. 개발자라면 retention을 구현 계약의 일부로 보고, 자신이 실제로 쓰는 플랜과 모드의 문서를 읽어야 합니다. 데스크톱 사용자라면 로컬 기록, 권한, 제품 경계를 중심으로 이해해야 합니다. 특정 surface의 한 문장을 다른 surface에 그대로 가져와 "보편 규칙"처럼 말하는 것이야말로 피해야 할 일입니다.

언제 full computer control을 쓰지 말아야 하나

Anthropic의 현재 제품 표현에서 바로 끌어낼 수 있는 실무 규칙은 단순합니다. 문제를 해결할 수 있는 가장 낮은 제어 수준을 사용하라. 커넥터로 해결되면 커넥터, 로컬 파일만으로 충분하면 파일, 웹 조사나 폼 작업이면 Chrome, 직접 통합도 더 좁은 브라우저 경로도 없을 때만 화면 조작. 이 순서를 지키는 것만으로도 불필요한 위험과 불안정성을 크게 줄일 수 있습니다.

이것은 안전뿐 아니라 신뢰성의 문제이기도 합니다. 커넥터와 파일 접근은 범위를 제한하기 쉽고, 감사하기 쉽고, UI 변화에 덜 깨집니다. 브라우저 작업은 API보다 취약할 수 있지만, 전체 데스크톱 제어보다는 훨씬 좁습니다. 화면 자동화는 가장 강력하고 가장 추론하기 어려운 층입니다. 그러니 마지막 단계여야지 출발점이 되어서는 안 됩니다.

또한 "Claude가 할 수 있다"와 "Claude에게 맡겨야 한다"는 전혀 다른 문장입니다. Anthropic은 현재 docs에서 의미 있는 결과를 낳는 행동에는 사람 확인을 요구합니다. 이 기준이 맞습니다. 쿠키 동의, 결제, 계약 승낙, 파괴적 삭제, 민감 계정 접근, 완벽한 정밀도가 필요한 작업은 사람 주도로 남겨두는 것이 맞습니다. 데모가 잘 된다고 해서 운영 책임까지 맡길 수 있다는 뜻은 아닙니다.

이미 더 좋은 기계 인터페이스가 있는 작업도 마찬가지입니다. API, CSV 내보내기, SQL, webhook가 이미 있는데 굳이 화면을 읽고 클릭하게 만든다면, 그것은 computer use의 가치를 살리는 것이 아니라 가장 깨지기 쉬운 층을 택하는 것입니다. computer use가 진짜로 빛나는 곳은 소프트웨어가 여전히 "사람을 위한 모양"으로만 존재하는 곳입니다.

FAQ

Claude Computer Use는 Anthropic API 도구만 뜻하나요?

아닙니다. 개발자에게는 API 도구가 핵심 의미이지만, Anthropic의 현재 Cowork와 Code 페이지도 유사한 능력을 데스크톱 작업 흐름의 일부로 다룹니다. 즉 지금 이 표현은 하나의 surface만 가리키지 않습니다.

도구 루프를 직접 구현해야 하나요?

API 경로에서는 그렇습니다. Anthropic의 현재 문서는 tool call 추출, VM 또는 컨테이너 안에서의 실행, tool_result 반환을 당신의 앱이 하는 구조를 전제로 합니다. 데스크톱 경로에서는 Anthropic의 제품이 이 오케스트레이션을 맡습니다.

Cowork는 웹에서 돌아가나요? 스마트폰만으로 실행되나요?

아니요. 현재 도움말에 따르면 Cowork는 Claude Desktop이 필요하고 macOS 또는 Windows에서 동작하며, 웹이나 모바일 단독 실행면이 아닙니다. 스마트폰으로 이어서 메시지를 보낼 수는 있지만, 실제 실행은 데스크톱 앱에 묶여 있습니다.

Cowork를 쓸 수 있다면 완전한 computer use도 같은 조건으로 된다고 봐도 되나요?

그렇게 가정하지 않는 편이 안전합니다. 도움말은 Cowork를 넓게 설명하지만, 제품 페이지의 보다 명시적인 computer-use 표현은 현재 Available on macOS입니다. 더 구체적인 쪽을 기준으로 보는 것이 무난합니다.

API 경로는 비싼가요?

일반 텍스트 호출보다 확실히 더 비쌉니다. 단순히 모델이 강해서가 아니라, 도구 오버헤드와 스크린샷 비용이 붙기 때문입니다. Anthropic은 현재 466-499의 beta system prompt tokens, Claude 4.x에서의 735 도구 정의 토큰, 그리고 스크린샷/도구 결과 추가 비용을 명시합니다. 그래서 이 경로는 정말로 UI 자동화가 필요한 곳에만 쓰는 것이 맞습니다.

Anthropic은 스크린샷을 저장하나요?

이 질문은 surface별로 답해야 합니다. API docs는 ZDR 맥락을 설명하고, commercial products용 privacy article은 기본 30일 삭제를 설명하며, Cowork는 로컬 기록을 강조합니다. 이 이슈가 중요하다면, 실제로 사용하는 surface와 계약 조건의 문서를 직접 확인해야 합니다.

진짜 중요한 질문은 "Claude가 클릭할 수 있나"가 아니다

Claude는 클릭할 수 있습니다. 그 자체는 더 이상 핵심 포인트가 아닙니다.

진짜 중요한 질문은 당신이 어떤 시스템을 만들고 있는지, 어디까지의 제어권을 Claude에게 넘길 것인지입니다. 제품을 만들고 있다면 API 도구를 실제 자동화 runtime으로 다루고, 진짜 샌드박스와 승인 경계 안에 넣어야 합니다. 내 컴퓨터에서 Claude에게 일을 맡기고 싶다면 Cowork나 Claude Code를 쓰고, Anthropic의 데스크톱 제품이 세션을 운영하도록 두되, 폴더, 커넥터, 중요한 승인은 직접 관리해야 합니다.

이렇게 다시 보면 Claude Computer Use는 모호한 마법 약속이 아니라 구체적인 라우팅 판단이 됩니다. 그리고 그 판단을 얼마나 정확하게 하느냐가, 실용적인 자동화와 멋있지만 불안정한 데모를 가르는 기준이 됩니다.