TL;DR
이제 Claude Code가 Mac을 제어할 수 있습니다. Claude Code는 코드를 작성한 터미널 세션에서 바로 앱을 열고, UI를 클릭하고, 테스트를 실행하고, 결과를 스크린샷합니다. 이는 macOS Pro 및 Max 플랜 구독자를 위한 연구 미리보기입니다. Claude Code에서 /mcp를 실행하고, computer-use 서버를 켜고, 시스템 설정에서 손쉬운 사용 및 화면 기록 권한을 부여하여 활성화할 수 있습니다.
이제 Claude가 컴퓨터를 사용할 수 있습니다
Anthropic은 2026년 3월 23일에 Claude Code의 컴퓨터 사용 기능을 발표했습니다. 핵심 아이디어는 간단합니다. Claude가 코드를 작성한 다음, 사용자가 하는 것과 동일한 방식으로 코드를 실제로 실행하여 작동하는지 확인하는 것입니다.
이전에는 Claude가 macOS 메뉴 바 앱을 작성할 수 있었지만, 작동하는지 확인하려면 직접 컴파일하고 실행하며 UI를 클릭해야 했습니다. 이제 Claude가 이 모든 루프를 수행합니다. 터미널을 떠나지 않고도 컴파일, 실행, 모든 컨트롤과의 상호 작용, 오류 상태 스크린샷, 발견된 문제 패치를 처리합니다.
이것은 Claude에게 전달하는 작업 단위를 바꿉니다. 이전에는 "이 앱을 만들어 줘."였다면, 이제는 "이 앱을 만들고 제대로 작동하는지 확인해 줘."입니다.
무엇을 할 수 있나요
네이티브 앱을 처음부터 끝까지 빌드하고 검증하기
이것이 주요 사용 사례입니다. 다음과 같은 프롬프트를 작성합니다:
MenuBarStats 타겟을 빌드하고, 실행한 다음, 환경설정 창을 열고,
간격 슬라이더가 레이블을 업데이트하는지 확인합니다. 완료되면
환경설정 창을 스크린샷합니다.
Claude는 xcodebuild를 실행하고, 바이너리를 시작하고, 환경설정 패널과 상호 작용하며, 발견한 내용을 보고합니다. 슬라이더가 고장 나면 관련 코드를 읽고, 패치하고, 다시 테스트합니다. "잘 작동하는 것 같다"는 초안이 아닌, 검증된 빌드를 얻게 됩니다.
테스트 프레임워크 없이 UI 테스트하기
새 프로젝트를 위해 Playwright, Selenium 또는 XCTest를 설정하는 대신, 흐름을 일반 텍스트로 설명합니다:
앱을 열고, 온보딩 화면을 클릭하여 진행하고,
어떤 화면이 로드하는 데 1초 이상 걸리는지 알려주세요.
Claude는 앱을 열고, 가입 과정을 클릭하여 진행하고, 각 단계를 스크린샷하고, 느린 전환을 표시합니다. 설정할 테스트 하네스도 없고, 유지 보수할 깨지기 쉬운 셀렉터도 없습니다. 이는 Electron 앱, 네이티브 macOS 앱, iOS 시뮬레이터 흐름에 모두 작동합니다.
시각적 및 레이아웃 버그 디버깅하기
특정 창 크기에서만 나타나는 CSS 버그는 수동으로 재현하기 번거롭습니다. 컴퓨터 사용 기능을 이용하면:
설정 모달이 좁은 창에서 푸터를 잘라냅니다. 앱 창 크기를
재현할 수 있을 때까지 조절하고, 잘린 상태를 스크린샷한 다음,
모달 컨테이너의 CSS를 확인합니다.
Claude는 창 크기를 조절하고, 깨진 상태를 캡처하고, 스타일시트를 읽고, 레이아웃을 패치합니다. 사용자가 보는 것을 Claude도 봅니다. 설명에 의존하여 추측할 필요가 없습니다.
GUI 전용 도구 제어하기
일부 도구에는 CLI나 API가 없습니다. 디자인 소프트웨어, 하드웨어 제어판, 독점 기업 앱, iOS 시뮬레이터 등이 그렇습니다. 컴퓨터 사용 기능은 Claude에게 이 모든 것에 대한 접근 권한을 부여합니다. 터미널에서 필요한 것을 설명하면 Claude가 상호 작용을 처리합니다.
활성화 방법
컴퓨터 사용 기능은 기본적으로 꺼져 있습니다. 프로젝트별로 활성화하는 computer-use라는 내장 MCP 서버로 제공됩니다.
시작하기 전에 요구 사항:
- macOS (Windows 또는 Linux에서는 사용 불가)
- Claude Code v2.1.85 이상 (
claude --version으로 확인) - Pro 또는 Max 플랜 (Team 또는 Enterprise 플랜에서는 사용 불가)
- claude.ai를 통한 인증 (Amazon Bedrock, Google Vertex AI, Microsoft Foundry를 통한 인증에서는 사용 불가)
- 대화형 세션 (
-p비대화형 플래그는 비활성화함)
1단계: MCP 메뉴 열기
활성 Claude Code 세션에서 다음을 실행합니다:
/mcp
이것은 서버 목록을 엽니다. computer-use를 찾습니다. 비활성화됨으로 표시됩니다.
2단계: 서버 활성화
computer-use를 선택하고 활성화(Enable)를 선택합니다. 이 설정은 프로젝트별로 유지됩니다. 컴퓨터 사용을 원하는 각 프로젝트에 대해 한 번만 수행하면 됩니다.
3단계: macOS 권한 부여
Claude가 화면을 처음 제어하려고 할 때 두 가지 권한 프롬프트가 나타납니다:
- 손쉬운 사용(Accessibility): Claude가 클릭, 입력, 스크롤할 수 있도록 허용합니다.
- 화면 기록(Screen Recording): Claude가 화면에 있는 것을 볼 수 있도록 허용합니다.
프롬프트에는 관련 시스템 설정 패널로 직접 연결되는 링크가 포함되어 있습니다. 두 권한을 모두 부여하십시오. 화면 기록 권한을 부여한 후, 권한을 적용하려면 Claude Code를 다시 시작해야 할 수 있습니다.
설정 후, Claude에게 GUI가 필요한 작업을 요청합니다:
앱 타겟을 빌드하고, 실행한 다음, 각 탭을 클릭하여
아무것도 충돌하지 않는지 확인합니다. 발견하는 모든 오류 상태를
스크린샷합니다.
Claude가 화면에서 작동하는 방식
한 번에 한 세션만
컴퓨터 사용 기능은 활성 상태일 때 컴퓨터 전체에 대한 잠금을 유지합니다. 다른 Claude Code 세션에서 컴퓨터 사용 기능을 실행 중인 경우, 새 요청은 어떤 세션이 잠금을 보유하고 있는지 알려주는 메시지와 함께 실패합니다. 해당 세션을 먼저 완료하거나 종료하십시오.
Claude가 작업하는 동안 앱 숨기기
Claude가 제어권을 잡으면 다른 보이는 앱이 숨겨져 Claude가 승인한 앱과만 상호 작용합니다. 터미널은 계속 표시되며 스크린샷에서 제외되므로 Claude는 화면에서 자신의 프롬프트를 볼 수 없습니다.
Claude가 차례를 마치면 숨겨진 앱은 자동으로 복원됩니다.
언제든지 중지
Claude가 잠금을 획득하면 macOS 알림 "Claude가 컴퓨터를 사용 중입니다 - 중지하려면 Esc를 누르세요."가 나타납니다. 즉시 중단하려면 어디서든 Esc 키를 누르십시오. Claude는 잠금을 해제하고 앱을 숨김 해제하며 제어권을 사용자에게 반환합니다. 터미널에서 Ctrl+C도 동일하게 작동합니다.
앱별 승인
computer-use 서버를 활성화한다고 해서 Claude가 모든 앱에 접근할 수 있는 것은 아닙니다. Claude가 세션에서 특정 앱을 처음 필요로 할 때, 터미널 프롬프트에 다음이 표시됩니다:
- Claude가 제어하려는 앱
- 요청된 추가 권한 (클립보드 접근 등)
- Claude가 작업하는 동안 숨겨질 다른 앱 수
이 세션에서 허용(Allow for this session) 또는 거부(Deny)를 선택하십시오. 승인은 해당 세션 동안만 유효합니다. 다음 세션에서는 다시 승인해야 합니다.
세 가지 범주의 앱은 승인하기 전에 추가 경고를 표시합니다:
| 경고 | 앱 |
|---|---|
| 셸 접근과 동일 | 터미널, iTerm2, VS Code, Warp, 기타 터미널 및 IDE |
| 모든 파일을 읽거나 쓸 수 있음 | Finder |
| 시스템 설정을 변경할 수 있음 | 시스템 설정 |
이러한 앱이 완전히 차단되는 것은 아닙니다. 경고는 해당 작업에 그러한 수준의 접근이 필요한지 사용자가 판단하도록 하는 신호입니다.
앱 제어 단계
Claude의 제어 수준은 앱 카테고리에 따라 다릅니다:
| 제어 수준 | 앱 유형 |
|---|---|
| 보기 전용 | 브라우저, 거래 플랫폼 |
| 클릭 전용 | 터미널, IDE |
| 전체 제어 | 모든 다른 앱 |
브라우저는 계정 및 데이터에 대한 광범위한 접근 권한을 가지고 있으므로 보기 전용입니다. 전체 브라우저 자동화가 필요한 경우, 대신 Chrome용 Claude를 사용하십시오.
Claude가 언제 컴퓨터 사용 기능을 사용할지 결정하는 방법
컴퓨터 사용 기능은 Claude의 최후의 수단이지 첫 번째 선택이 아닙니다. Claude는 사용 가능한 가장 정확한 도구를 선택합니다:
- 서비스에 대한 MCP 서버 (구성된 경우)
- 셸 명령에 대한 Bash
- 브라우저 작업에 대한 Chrome용 Claude (구성된 경우)
- 다른 방법으로 대상에 도달할 수 없을 때 컴퓨터 사용
화면 제어는 프로그래밍 인터페이스가 없는 것들을 위해 예약되어 있습니다: 네이티브 데스크톱 앱, 시뮬레이터, GUI 전용 도구. Claude에게 "테스트 실행"을 요청할 때, Claude는 UI 버튼을 클릭하는 대신 Bash를 통해 npm test를 사용합니다.
안전 모델
실제 데스크톱에서 컴퓨터 사용 기능을 사용하는 것은 Claude의 샌드박스 Bash 도구와 다릅니다. Bash 도구는 파일 시스템 및 네트워크 접근을 제한하는 격리된 환경에서 실행됩니다. 컴퓨터 사용 기능은 사용자가 승인한 모든 것에 접근할 수 있는 실제 컴퓨터에서 실행됩니다.
Anthropic은 여러 안전 장치를 내장했습니다:
앱별 승인. Claude는 현재 세션에서 명시적으로 허용한 앱만 제어할 수 있습니다. 컴퓨터에 대한 포괄적인 접근 권한은 없습니다.
센티넬 경고. 셸 접근, 파일 시스템 접근 또는 시스템 설정 변경 권한을 부여하는 앱은 승인하기 전에 플래그가 지정됩니다. 사용자는 무엇을 부여하는지 알고 있습니다.
스크린샷에서 터미널 제외. Claude는 스크린샷에서 터미널 창을 볼 수 없으므로, 화면의 프롬프트가 모델로 다시 피드백될 수 없습니다.
전역 이스케이프. Esc 키는 어디서든 컴퓨터 사용 기능을 중단합니다. 이 키 입력은 Claude Code에 의해 소비되므로 프롬프트 주입 공격이 이를 사용하여 대화 상자를 닫을 수 없습니다.
잠금 파일. 한 번에 하나의 세션만 컴퓨터를 제어합니다. 동시 접근은 없습니다.
프롬프트 주입 감지. Claude는 각 작업을 확인하고, 동작을 리디렉션하려는 시도로 보이는 화면 콘텐츠에 플래그를 지정합니다.
Anthropic의 자체 지침: 컴퓨터 사용 기능이 컴퓨터에서 어떻게 작동하는지 익숙해질 때까지 민감한 정보가 포함된 작업에는 컴퓨터 사용 기능을 사용하지 마십시오. 격리된 테스트 환경이나 샌드박스 앱으로 시작하십시오.
예시 워크플로
종단간 Swift 앱 검증
macOS 또는 iOS 앱을 변경한 후, Claude에게 한 번에 컴파일하고 테스트하도록 합니다:
MenuBarStats 타겟을 빌드하고, 실행한 다음, 환경설정 창을 열고,
간격 슬라이더가 레이블을 업데이트하는지 확인합니다. 완료되면
환경설정 창을 스크린샷합니다.
Claude가 하는 일:
- 컴파일을 위해
xcodebuild실행 - 결과 바이너리 실행
- 환경설정 창을 열기 위해 클릭
- 슬라이더를 이동하고 레이블 확인
- 결과 스크린샷
- 관련 소스 위치와 함께 모든 실패 보고
레이아웃 버그 재현하기
설정 모달이 좁은 창에서 푸터를 잘라냅니다. 앱 창 크기를
재현할 수 있을 때까지 조절하고, 잘린 상태를 스크린샷한 다음,
모달 컨테이너의 CSS를 확인합니다.
Claude는 창 크기를 점진적으로 조절하고, 깨진 상태를 캡처하고, modal.css를 읽고, 오버플로 문제를 식별하고, 수정을 적용하고, 다시 테스트합니다.
XCTest 없이 iOS 시뮬레이터 테스트하기
iOS 시뮬레이터를 열고, 앱을 실행하고, 온보딩 화면을 탭하여 진행하고,
어떤 화면이 로드하는 데 1초 이상 걸리는지 알려주세요.
Claude는 마치 마우스와 키보드를 사용하는 것처럼 시뮬레이터를 제어합니다. XCTest 설정, UI 테스트 타겟, Instruments 구성이 필요 없습니다.
Electron 앱 온보딩 흐름
개발 모드로 데스크톱 앱을 실행하고, test@example.com을 사용하여
가입 흐름을 완료하고, 각 단계를 스크린샷합니다. 버튼을 클릭할 수 없거나
UI에 오류가 표시되는 모든 단계에 플래그를 지정합니다.
Claude는 앱을 열고, 양식 필드를 채우고, 각 화면을 클릭하여 진행하고, 모든 실패가 기록된 전체 흐름의 스크린샷 로그를 생성합니다.
API 테스팅과 함께 컴퓨터 사용 기능 활용하기
Claude Code의 컴퓨터 사용 기능은 Apidog과 함께 사용하여 풀스택 API 검증에 효과적입니다.
일반적인 워크플로:
- Claude가 로컬 서버를 작성하고 빌드합니다.
- Claude는 컴퓨터 사용 기능을 사용하여 앱을 열고, 사용자 동작을 트리거하고, UI 응답을 확인합니다.
- 사용자는 Apidog에서 기본 API 호출을 캡처하고, 동일한 요청을 프로그래밍 방식으로 검증하는 테스트를 구축합니다.
- 미래의 회귀는 수동으로 UI 흐름을 실행하는 것이 아니라 자동화된 Apidog 테스트에 의해 감지됩니다.
이 조합은 인간이 읽을 수 있는 종단간 검증(Claude가 앱을 클릭하며 진행하는 방식)과 CI에서 실행되는 프로그래밍 방식의 API 테스트를 모두 제공합니다. 컴퓨터 사용 통과는 정상적인 경로를 확인하고, Apidog 테스트는 향후 이를 보호합니다.
CLI와 데스크톱 앱의 차이점
CLI와 데스크톱은 동일한 컴퓨터 사용 엔진을 공유합니다. 현재 몇 가지 설정은 데스크톱 전용입니다:
| 기능 | 데스크톱 | CLI |
|---|---|---|
| 활성화 | 설정 > 데스크톱 앱 > 일반 | /mcp > computer-use 활성화 |
| 거부된 앱 목록 | 설정에서 구성 가능 | 아직 사용 불가 |
| 자동 숨김 해제 토글 | 선택 사항 | 항상 켜짐 |
| 디스패치 통합 | 예 | 해당 없음 |
대부분의 개발 워크플로에서는 CLI 버전이 필요한 모든 것을 다룹니다.
문제 해결
"다른 Claude 세션에서 컴퓨터 사용 중입니다."
다른 Claude Code 세션이 컴퓨터 잠금을 보유하고 있습니다. 해당 세션을 종료하십시오. 충돌한 경우, Claude Code가 프로세스가 사라졌음을 감지하면 잠금은 자동으로 해제됩니다.
macOS 권한 프롬프트가 계속 다시 나타납니다
macOS는 화면 기록 권한을 부여한 후 프로세스 재시작을 요구할 수 있습니다. Claude Code를 완전히 종료하고 새 세션을 시작하십시오. 프롬프트가 계속 나타나면 시스템 설정 > 개인 정보 보호 및 보안 > 화면 기록을 열고 터미널 에뮬레이터가 목록에 있고 활성화되어 있는지 확인하십시오.
/mcp에 computer-use가 나타나지 않습니다
다음 각 사항을 확인하십시오:
- macOS를 사용 중입니다 (Linux 또는 Windows 아님)
claude --version이 v2.1.85 이상을 보여줍니다- Pro 또는 Max 플랜을 사용 중입니다 (
/status를 실행하여 확인) - Amazon Bedrock 또는 Google Vertex AI와 같은 타사 제공업체가 아닌 claude.ai를 통해 인증되었습니다
- 대화형 세션에 있습니다 (
-p를 사용하지 않음)
승인한 후에도 Claude가 앱을 볼 수 없습니다
앱별 승인 프롬프트가 나타날 때 단순히 닫는 것이 아니라 이 세션에서 허용(Allow for this session)을 클릭했는지 확인하십시오. 실수로 앱을 거부했다면 세션을 종료하고 새 세션을 시작하십시오. 승인 및 거부는 각 세션마다 재설정됩니다.
자주 묻는 질문
어떤 Claude Code 버전이 필요한가요?
v2.1.85 버전 이상. 터미널에서 claude --version으로 버전을 확인하십시오. 필요한 경우 npm install -g @anthropic-ai/claude-code로 업데이트하십시오.
Windows 또는 Linux에서 작동하나요?
아니요. 컴퓨터 사용 기능은 현재 연구 미리보기 단계에서는 macOS 전용입니다. Anthropic은 Windows 또는 Linux 지원에 대한 일정을 발표하지 않았습니다.
Amazon Bedrock 또는 Google Vertex AI를 통해 Claude에 접근하는 경우 컴퓨터 사용 기능을 사용할 수 있나요?
아니요. 컴퓨터 사용 기능은 claude.ai 계정(Pro 또는 Max)을 통한 인증이 필요합니다. 타사 제공업체는 이 기능을 지원하지 않습니다. 별도의 claude.ai 구독이 필요합니다.
Team 또는 Enterprise 플랜에서 사용할 수 있나요?
아니요. 연구 미리보기 기간 동안에는 Pro 및 Max 플랜에서만 사용할 수 있습니다.
화면 기록 권한을 부여하지 않으면 어떻게 되나요?
손쉬운 사용 권한이 부여되면 Claude는 여전히 일부 동작(클릭, 입력)을 수행할 수 있지만, 화면 기록 없이는 시각적 결과를 확인할 수 없습니다. 대부분의 유용한 워크플로는 두 가지 권한 모두 필요합니다.
Claude가 제가 승인하지 않은 앱에 접근할 수 있나요?
아니요. Claude는 현재 세션에서 명시적으로 승인한 앱만 제어할 수 있습니다. 각 앱을 처음 필요로 할 때 승인 프롬프트가 나타납니다.
컴퓨터 사용 접근 권한을 완전히 철회하려면 어떻게 해야 하나요?
Claude Code에서 /mcp로 이동하여 computer-use 서버를 비활성화하십시오. macOS 권한을 제거하려면 시스템 설정 > 개인 정보 보호 및 보안을 열고 손쉬운 사용 및 화면 기록 목록에서 터미널 앱을 제거하십시오.
민감한 데이터 작업을 위해 컴퓨터 사용 기능을 사용하는 것이 안전한가요?
Anthropic은 연구 미리보기 기간 동안 민감한 데이터에 사용하는 것을 권장하지 않습니다. 격리된 테스트 환경과 개인 정보가 포함되지 않은 앱으로 시작하십시오. 자격 증명, 개인 데이터 또는 프로덕션 시스템과 관련된 워크플로에 사용하기 전에 컴퓨터 사용 안전 가이드를 검토하십시오.
여러 Claude Code 세션에서 동시에 컴퓨터 사용 기능을 사용할 수 있나요?
아니요. 컴퓨터 사용 기능은 컴퓨터 전체 잠금을 보유합니다. 한 번에 하나의 세션만 화면을 제어할 수 있습니다. 다른 세션이 잠금을 보유하고 있으면 세션 세부 정보와 함께 오류 메시지가 표시됩니다.
이것은 Playwright 또는 Selenium을 실행하는 것과 어떻게 다른가요?
Playwright 및 Selenium은 선택기, 어설션 및 구성을 사용하여 테스트 스크립트를 작성해야 합니다. 컴퓨터 사용 기능은 Claude가 테스트 하네스 설정 없이 자연어를 통해 모든 앱과 상호 작용할 수 있도록 합니다. 장단점이 있습니다: 스크립트화된 테스트는 확정적이지만, 컴퓨터 사용 기능은 Claude의 판단에 의존합니다. 프로덕션 회귀 스위트에는 Playwright가 더 나은 선택입니다. 탐색적 테스트, 빠른 UI 검증 또는 코드로 자동화할 수 없는 앱의 경우, 컴퓨터 사용 기능이 더 빠르게 실행됩니다.