cc-control

Claude Code에 눈 + 손을 달아주는 앱

Claude Code가 화면을 보고 마우스·키보드를 조작 — 당신은 실시간으로 지켜보고 언제든 정지

macOS 11+ (Apple Silicon) · Claude Code 필요 · 무료 · v1.3 · 🎛️ 클릭통과 팝업·한/영 무관 입력·매크로·대상앱 자동포커스

SHA-256 afdd3d4ec0a69e96ef6a1147ed3cd2e52021384c7a49c728a4fd5ae0a4754624

받은 파일 검증: shasum -a 256 ~/Downloads/cc-control.dmg 결과가 위와 같아야 정상입니다.

무엇을 하나요

👁️

화면을 봅니다Claude Code가 스크린샷으로 현재 화면을 인식합니다.

🖱️

사람처럼 조작합니다마우스·키보드 조작. 입력은 한/영 상태와 무관하게 그대로(붙여넣기 방식) 들어가고, 반복 작업은 매크로로 스샷 없이 빠르게.

🛡️

클릭 통과 컨트롤 팝업항상 위·모든 화면에 뜨는 작은 팝업. 제어 중엔 클릭이 통과돼 Claude 클릭이 이 창을 뚫고 밑의 앱에 갑니다. [활성화]로 켜고 [정지]로 차단(급하면 채팅에 '멈춰').

🔑

API 키 불필요별도 키 없이, 당신이 쓰는 Claude Code의 클로드가 판단해서 제어합니다.

다운로드한 cc-control.dmg 를 엽니다
미서명 앱이라 경고가 뜨면 — 아래 "열리지 않을 때"를 참고하세요.
cc-control.app 을 응용 프로그램으로 드래그
dmg 안의 앱을 Applications 폴더로 끌어다 놓습니다.
dmg 안 등록.command 더블클릭
Claude Code에 자동 등록되고, 권한 설정 창이 열립니다.
권한 2개 허용 (아래 참고)
화면 기록 + 손쉬운 사용을 켠 뒤, 터미널/Claude 앱을 완전 종료 후 재실행.
Claude Code를 새로 켜기
오른쪽 위에 컨트롤 창이 뜹니다. [활성화]를 눌러야 제어가 시작되고, [정지]로 언제든 막을 수 있습니다.

시스템 설정 → 개인정보 보호 및 보안 에서, Claude Code를 실행하는 앱(보통 터미널)에 아래 2개를 허용:

🖥️

화면 기록 (Screen Recording) — 화면을 보기 위해

⌨️

손쉬운 사용 (Accessibility) — 마우스·키보드 제어를 위해

🤖

자동화 (Automation) — 대상 앱을 앞으로 가져올 때 (허용 창이 뜨면 허용)

중요: 권한을 준 뒤에는 해당 앱을 완전히 종료했다가 다시 실행해야 적용됩니다.

Apple 개발자 서명이 없어서 처음엔 Gatekeeper가 막습니다. 두 가지 중 하나:

· 우클릭 → 열기 → 경고창에서 다시 열기 (한 번만 하면 됨)
· 또는 시스템 설정 → 개인정보 보호 및 보안 아래쪽 "확인 없이 열기" 클릭

등록.command 대신 터미널에서 직접:

claude mcp add cc-control --scope user -- /Applications/cc-control.app/Contents/MacOS/cc-control

제거: claude mcp remove cc-control -s user