Claude Code Computer Use Mac 권한 설정 가이드

macOS 설정 가이드

Claude Code에서 computer-use MCP 쓰려면 맥 권한을 이렇게 켜세요

Claude Code가 화면을 보고 클릭·타이핑까지 하게 해주는 computer-use 기능은 macOS 자체의 손쉬운 사용과 화면 기록 권한이 있어야 동작합니다. 둘 다 터미널 앱 기준으로 한 번만 설정해두면 이후 세션에서는 다시 안 물어봐요.

핵심 요약

• 필요한 권한은 두 가지: 손쉬운 사용(클릭·키보드 조작), 화면 기록(화면 캡처)
• 권한을 켜는 대상은 Claude Code를 실제로 띄우고 있는 터미널 앱 (Terminal.app / iTerm2 / VS Code 등, 쓰는 게 다르면 그 앱)
• 토글을 켠 다음에는 앱을 완전히 재시작해야 반영됩니다 (창만 닫는 걸로는 안 됨)

1

Claude Code에서 권한 요청을 한 번 트리거하기

computer-use 관련 동작을 한 번 시도하면 macOS가 알아서 팝업을 띄웁니다

별도로 설정 화면부터 찾아갈 필요 없이, Claude Code한테 화면을 보거나 조작하는 걸 한 번 시켜보세요. macOS가 "이 앱이 화면을 기록하려고 합니다" 같은 권한 팝업을 띄우면서 시스템 설정에 자동으로 항목이 추가되는 경우가 많아요.

2

손쉬운 사용 권한 켜기

시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용

클릭과 키 입력을 대신 보내려면 이 권한이 필요합니다. 목록에서 터미널 앱을 켜주세요.

손쉬운 사용 목록에 터미널이 이미 보이면 토글만 켜면 되고, 안 보이면 다음 단계처럼 + 버튼으로 추가합니다.

3

화면 기록 권한 켜기

시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 녹음

스크린샷을 찍으려면 이 권한도 따로 필요합니다. 손쉬운 사용에 이미 추가했다고 자동으로 같이 켜지지 않는 게 함정이에요.

토글이 이미 파란색이면 켜진 상태. 목록 자체가 비어 있다면 아래 트러블슈팅을 보세요.

4

터미널 앱을 완전히 재시작

창 닫기 ≠ 재시작

토글을 켜면 macOS가 지금 종료(Quit Now) 버튼을 보여줍니다. 이걸 눌러서 앱을 완전히 종료했다가 다시 열어야 권한이 실제로 적용돼요. 창만 닫으면 프로세스가 살아 있어서 반영되지 않습니다.

5

Claude Code 세션에서 다시 시도

재시작 후 새 세션에서 접근 요청

터미널을 다시 열고 Claude Code 세션을 새로 시작한 다음, computer-use 쪽에서 접근 요청을 다시 시도하면 이제 화면을 보고 조작할 수 있어야 합니다.

트러블슈팅 — 목록에 터미널이 아예 안 보일 때

화면 기록 목록은 종종 비어 있는 채로 시작합니다. 이럴 땐 + 버튼으로 직접 추가하세요.

• 목록 하단(또는 우측 상단)의 + 버튼 클릭
• Cmd + Shift + G로 경로 입력창을 열고 아래 경로 입력

/Applications/Utilities/Terminal.app · iTerm2라면 /Applications/iTerm.app

추가 후에도 안 보이면, 1단계처럼 Claude Code에서 접근 요청을 한 번 더 트리거해서 macOS 팝업을 띄우는 쪽이 더 확실하게 먹힐 때도 있습니다.

---

정리 체크리스트

• 손쉬운 사용에 터미널 앱 추가 + 토글 ON
• 화면 기록에 터미널 앱 추가 + 토글 ON
• 지금 종료(Quit Now)로 앱 완전히 재시작
• 새 Claude Code 세션에서 접근 요청 재시도

쓰는 터미널 앱이 Terminal.app이 아니라 iTerm2, VS Code 통합 터미널, Warp 같은 다른 앱이라면 두 권한 모두 그 앱 기준으로 추가해야 합니다 — Claude Code를 실제로 띄우고 있는 프로세스가 기준이에요.