Rihpig

Posted on Mar 31 • Originally published at apidog.com

Claude 코드, 이제 Mac 제어 가능: 사용법 완벽 가이드

TL;DR

이제 Claude Code가 Mac을 직접 제어할 수 있습니다. 터미널 세션에서 앱을 열고, UI를 클릭하며, 테스트를 실행하고, 결과를 스크린샷할 수 있습니다. 이 기능은 macOS Pro 및 Max 플랜 구독자를 위한 연구 미리보기입니다. 사용하려면 Claude Code에서 /mcp를 실행하고, computer-use 서버를 활성화하고, 시스템 설정에서 손쉬운 사용 및 화면 기록 권한을 부여하세요.

지금 Apidog을 사용해보세요

이제 Claude가 컴퓨터를 제어합니다

2026년 3월 23일 Anthropic에서 Claude Code의 컴퓨터 사용 기능을 공개했습니다. 이제 Claude가 코드를 작성한 후 실제로 실행하여 정상 동작 여부를 직접 확인할 수 있습니다.

기존에는 macOS 메뉴 바 앱을 만들더라도 직접 컴파일, 실행, UI 클릭 등 수동 검증이 필요했습니다. 이제 Claude가 직접 빌드, 실행, UI 상호작용, 오류 스크린샷, 버그 패치까지 터미널을 벗어나지 않고 자동 처리합니다.

이제는 "앱을 만들어 줘"가 아니라 "앱을 만들고, 정상 동작까지 확인해 줘"로 요청할 수 있습니다.

💡
API 기반 프로젝트의 경우, Claude는 CLI나 API가 없는 GUI 도구도 테스트할 수 있습니다. 이때 Apidog이 유용합니다. Claude가 앱 동작을 확인하면, Apidog에서 동일 흐름의 자동화 API 테스트 스위트를 구축해 CI에 적용할 수 있습니다.

무엇을 할 수 있나

네이티브 앱을 처음부터 끝까지 빌드하고 검증하기

주요 사용법은 다음과 같은 프롬프트로 네이티브 앱 빌드와 검증을 자동화하는 것입니다.

MenuBarStats 타겟을 빌드하고, 실행한 다음, 환경설정 창을 열고,
간격 슬라이더가 레이블을 업데이트하는지 확인합니다. 완료되면
환경설정 창을 스크린샷합니다.

Claude가 xcodebuild 실행, 앱 실행, UI 클릭, 문제 패치, 재실행까지 반복하며, 실제 동작을 검증합니다.

테스트 프레임워크 없이 UI 테스트하기

Playwright, Selenium, XCTest 등 테스트 프레임워크 없이도 다음과 같이 자연어로 흐름을 설명하면 됩니다.

앱을 열고, 온보딩 화면을 클릭하여 진행하고,
어떤 화면이 로드하는 데 1초 이상 걸리는지 알려주세요.

Claude가 앱을 직접 열고, UI를 클릭하며, 각 단계의 스크린샷과 성능 문제를 자동으로 기록합니다. Electron, macOS, iOS 시뮬레이터 모두에서 동작합니다.

시각적 및 레이아웃 버그 디버깅하기

특정 UI 버그 재현도 프롬프트 한 줄로 처리할 수 있습니다.

설정 모달이 좁은 창에서 푸터를 잘라냅니다. 앱 창 크기를
재현할 수 있을 때까지 조절하고, 잘린 상태를 스크린샷한 다음,
모달 컨테이너의 CSS를 확인합니다.

Claude가 창 크기 조정, 스크린샷, 스타일시트 분석, 패치 적용까지 자동화합니다.

GUI 전용 도구 제어하기

CLI나 API가 없는 전용 GUI 앱(디자인 툴, 하드웨어 제어판, iOS 시뮬레이터 등)도 프롬프트로 제어할 수 있습니다.

활성화 방법

컴퓨터 사용 기능은 기본 비활성입니다. 프로젝트별로 활성화할 수 있습니다.

사전 요구 사항

macOS (Windows, Linux 미지원)
Claude Code v2.1.85 이상 (claude --version으로 확인)
Pro/Max 플랜 (Team/Enterprise 미지원)
claude.ai 인증 (Bedrock, Vertex AI, Foundry 미지원)
대화형 세션 (비대화형 플래그 -p 미사용)

1단계: MCP 메뉴 열기

터미널에서 다음 명령 실행:

/mcp

서버 목록이 열리며 computer-use 서버가 비활성화 상태로 표시됩니다.

2단계: 서버 활성화

computer-use를 선택하고 활성화(Enable). 프로젝트별 1회만 설정하면 됩니다.

3단계: macOS 권한 부여

처음 사용할 때 아래 두 권한을 요청합니다.

손쉬운 사용(Accessibility): 클릭, 입력, 스크롤 허용
화면 기록(Screen Recording): 시각적 결과 확인 허용

시스템 설정에서 두 권한 모두 승인 후, 필요 시 Claude Code를 재시작하세요.

설정 완료 후 아래처럼 Claude에 GUI 작업을 요청할 수 있습니다.

앱 타겟을 빌드하고, 실행한 다음, 각 탭을 클릭하여
아무것도 충돌하지 않는지 확인합니다. 발견하는 모든 오류 상태를
스크린샷합니다.

Claude가 화면을 제어하는 방식

한 번에 한 세션만

컴퓨터 사용 기능은 한 세션에서만 잠금을 가집니다. 다른 세션에서 요청 시 잠금 소유 정보와 함께 실패 메시지가 표시됩니다.

Claude가 작업하는 동안 앱 숨기기

Claude가 제어 시작 시, 승인된 앱만 보이고 나머지는 자동으로 숨겨집니다. 터미널은 스크린샷에서 제외됩니다.

언제든지 중지

Esc 키를 누르면 즉시 Claude의 제어가 중단되고, 앱이 복원됩니다. 터미널에서 Ctrl+C도 동일하게 동작합니다.

앱별 승인

computer-use 서버 활성화 후에도, Claude가 앱에 처음 접근할 때마다 명시적 승인이 필요합니다.

제어할 앱 이름
추가 권한 (ex. 클립보드 접근)
숨겨질 앱 수

이 세션에서 허용 또는 거부를 직접 선택해야 하며, 승인은 세션 단위로 초기화됩니다.

민감 앱 경고

경고	앱
셸 접근과 동일	터미널, iTerm2, VS Code, Warp 등
모든 파일 읽기/쓰기	Finder
시스템 설정 변경	시스템 설정

위 앱은 승인 전 추가 경고가 표시됩니다. 완전 차단은 아니나, 신중하게 승인 여부를 결정하세요.

앱 제어 단계

제어 수준	앱 유형
보기 전용	브라우저, 거래 플랫폼
클릭 전용	터미널, IDE
전체 제어	기타 모든 앱

브라우저에 전체 제어가 필요하다면 Chrome용 Claude를 이용하세요.

Claude의 도구 선택 우선순위

Claude는 다음 순서로 도구를 사용합니다.

MCP 서버 (구성된 경우)
Bash 셸 명령
Chrome용 Claude (구성된 경우)
기타 불가시 컴퓨터 사용 기능

UI 클릭 자동화는 프로그래밍 인터페이스가 없는 네이티브 앱, 시뮬레이터, GUI 전용 도구에만 사용합니다.

안전 모델

컴퓨터 사용 기능은 샌드박스 Bash와 달리, 실제 컴퓨터에서 동작하며 사용자가 승인한 앱만 제어합니다.

앱별 승인: 명시적 승인 필요, 전역 접근 없음
센티넬 경고: 셸/파일/설정 접근 앱은 승인 전 플래그 표시
터미널 스크린샷 제외: Claude는 터미널 내용을 볼 수 없음
전역 이스케이프: 언제든 Esc로 중단 가능
잠금 파일: 동시 세션 제어 불가
프롬프트 주입 감지: 작업 리디렉션 시도시 플래그

처음에는 민감 정보가 없는 테스트 환경에서 기능을 익히세요.

예시 워크플로

종단간 Swift 앱 검증

MenuBarStats 타겟을 빌드하고, 실행한 다음, 환경설정 창을 열고,
간격 슬라이더가 레이블을 업데이트하는지 확인합니다. 완료되면
환경설정 창을 스크린샷합니다.

Claude의 자동 처리:

xcodebuild 실행
앱 바이너리 실행
환경설정 창 클릭
슬라이더 이동 및 레이블 확인
스크린샷 저장
실패 발생 시 소스 위치와 함께 보고

레이아웃 버그 재현

설정 모달이 좁은 창에서 푸터를 잘라냅니다. 앱 창 크기를
재현할 수 있을 때까지 조절하고, 잘린 상태를 스크린샷한 다음,
모달 컨테이너의 CSS를 확인합니다.

창 크기 조정 → 깨진 상태 캡처 → CSS 진단 및 자동 패치 → 재테스트

XCTest 없이 iOS 시뮬레이터 테스트

iOS 시뮬레이터를 열고, 앱을 실행하고, 온보딩 화면을 탭하여 진행하고,
어떤 화면이 로드하는 데 1초 이상 걸리는지 알려주세요.

마우스/키보드 입력 자동화 및 단계별 스크린샷, 별도 테스트 타겟/스크립트 없이 사용 가능

Electron 앱 온보딩 흐름

개발 모드로 데스크톱 앱을 실행하고, test@example.com을 사용하여
가입 흐름을 완료하고, 각 단계를 스크린샷합니다. 버튼을 클릭할 수 없거나
UI에 오류가 표시되는 모든 단계에 플래그를 지정합니다.

작성된 프롬프트대로 전체 가입 플로우 자동화 및 오류, 스크린샷 기록

API 테스팅과 함께 컴퓨터 사용 기능 활용하기

Claude Code의 컴퓨터 사용 기능은 Apidog과 결합해 풀스택 API 자동화에 적합합니다.

일반 워크플로:

Claude가 로컬 서버 작성 및 빌드
Claude가 앱 실행, UI 상호작용, 응답 확인
사용자가 Apidog에서 API 호출 캡처 및 자동화 테스트 구축
이후 회귀는 Apidog 자동화 테스트로 감지

이렇게 하면 사람이 직접 클릭하며 검증한 흐름을 Apidog으로 코드화, CI에 통합할 수 있습니다.

CLI와 데스크톱 앱의 차이

기능	데스크톱	CLI
활성화	설정 > 데스크톱 앱 > 일반	`/mcp` > `computer-use` 활성화
거부된 앱 목록	설정에서 구성 가능	미지원
자동 숨김 해제	선택 사항	항상 켜짐
디스패치 통합	지원	해당 없음

대부분의 개발 워크플로는 CLI 버전으로 충분합니다.

문제 해결

"다른 Claude 세션에서 컴퓨터 사용 중입니다."

다른 세션이 잠금 중입니다. 해당 세션 종료 후 재시도하세요. 충돌 시 프로세스가 종료되면 잠금이 자동 해제됩니다.

macOS 권한 프롬프트가 계속 나옴

화면 기록 권한 부여 후 Claude Code를 완전히 종료 후 재시작하세요. 그래도 반복되면 시스템 설정 > 개인 정보 보호 및 보안 > 화면 기록에서 터미널 앱 활성화 여부를 확인하세요.

`/mcp`에 `computer-use`가 보이지 않음

macOS 사용 중인지 확인
claude --version이 v2.1.85 이상인지 확인
Pro/Max 플랜인지 /status로 확인
claude.ai 인증 사용
대화형 세션에서 실행

승인 후에도 Claude가 앱을 볼 수 없음

승인 프롬프트에서 이 세션에서 허용을 반드시 클릭해야 합니다. 잘못 거부했다면 새 세션에서 재시도하세요.

자주 묻는 질문

Claude Code 버전 요구 사항

v2.1.85 이상 필요. 터미널에서 claude --version 확인, 필요시 npm install -g @anthropic-ai/claude-code로 업데이트

Windows 또는 Linux 지원 여부

아니요. 현재 macOS만 지원, 타 OS 지원 일정 미정

Amazon Bedrock, Google Vertex AI 인증 지원 여부

아니요. claude.ai 계정(Pro/Max) 인증만 지원

Team/Enterprise 플랜 지원 여부

아니요. Pro, Max 플랜만 지원

화면 기록 권한 미부여 시 동작

손쉬운 사용만 부여하면 일부 동작(클릭, 입력)은 가능하나, 시각적 결과 확인 불가. 두 권한 모두 필요

미승인 앱 접근 가능 여부

아니요. 명시적으로 승인한 앱만 제어 가능

컴퓨터 사용 권한 완전 철회 방법

/mcp에서 computer-use 비활성화, macOS 설정에서 손쉬운 사용/화면 기록 권한 해제

민감 데이터 작업 안전성

연구 미리보기 단계에서는 민감 데이터에 사용하지 마세요. 안전 가이드 참고 및 테스트 환경에서만 사용 권장

여러 세션 동시 사용 가능 여부

아니요. 한 번에 하나의 세션만 제어 권한 보유

Playwright/Selenium과 차이점

Playwright/Selenium은 스크립트, 어설션, 선택자 필요. 컴퓨터 사용 기능은 자연어 프롬프트로 모든 앱 UI 자동화 가능. 확정성은 스크립트가 높고, 탐색적·빠른 자동화는 컴퓨터 사용 기능이 유리