AI 에이전트가 내 컴퓨터의 실제 앱을 클릭 · 타이핑 · 화면 읽기로 다루게 해 주는 실행 도구(윈도우 · 맥 · 리눅스)
Cua Driver
에이전트가 데스크톱 앱과 브라우저를 살펴보고 조작하게 하는 도구입니다. 판단은 연결한 에이전트의 모델이 하고, Cua Driver 는 실제 앱에서 누르고 · 입력하고 · 화면 상태를 읽어 돌려줍니다. 앱과 운영체제가 허락하는 곳에서는 뒤에서 입력을 보내 내 마우스 · 키보드 초점 · 작업 중인 창을 건드리지 않고, 일부 앱 · 상황은 앞 화면이 필요합니다(공식 안내). 연결은 CLI · MCP · 스킬로 하며, 클로드 코드 · 코덱스 · 커서 · 오픈클로 등 연결 방법이 공식 문서에 있습니다.
- 가격
- 무료 · 오픈소스
- 라이선스
- MIT
- GitHub 별
- 31,417 2026-11-01
공식 설치
irm https://cua.ai/driver/install.ps1 | iex
윈도우 PowerShell 에 붙여 넣는 공식 설치 명령입니다. 맥 · 리눅스는 터미널에 /bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)" 를 넣습니다.
cua-driver autostart kick
윈도우에서 드라이버를 지금 켭니다. 등록이 안 됐으면 다른 터미널에서 cua-driver serve 를 켜 둡니다. 맥은 대신 cua-driver permissions grant 로 손쉬운 사용 · 화면 기록 권한을 켜고, 리눅스는 cua-driver serve 를 켜 둡니다.
cua-driver status
'Cua Driver daemon is running' 이 나오면 켜진 것입니다. 이어서 cua-driver doctor 로 환경을 점검하고(경고까지 읽기), cua-driver call list_apps 로 내 앱 목록이 보이는지 확인합니다.
cua-driver skills install
클로드 코드에 Cua Driver 스킬을 넣습니다. cua-driver skills status 로 확인한 뒤 클로드 코드를 새로 켭니다. 스킬 대신 MCP 로 붙이려면 cua-driver mcp-config --client claude 가 찍어 주는 명령을 그대로 돌립니다(코덱스는 --client codex).
막히는 자리
- cua-driver call list_apps 가 빈 목록이면 드라이버가 화면에 닿지 못한 것입니다. 그 화면(데스크톱 세션)에서 계산기를 열고 다시 해 보고, cua-driver doctor 가 알려 주는 권한 · 화면 문제를 먼저 고칩니다.
- 맥은 권한 창에 '허용'이 아니라 '시스템 설정 열기'만 나옵니다. 시스템 설정에서 CuaDriver 의 손쉬운 사용 · 화면 및 시스템 오디오 기록 스위치를 직접 켜야 하고, 켠 뒤 다시 시작하라고 하면 받아들입니다. cua-driver permissions status 로 둘 다 켜졌는지 봅니다.
- 끝이 0 으로 끝났다고 준비된 게 아닙니다. cua-driver doctor 결과는 경고까지 다 읽습니다(공식 안내).
- 뒤에서 조작은 앱과 운영체제가 허락하는 곳에서만 됩니다. 앞 화면 입력만 받는 앱, 앱을 처음 켤 때, 리눅스 웨이랜드 일부는 창이 앞으로 나올 수 있습니다.
- 버튼 정보가 안 잡히는 화면에서 위치를 찾게 하려면 퍼셉션 확장을 따로 깝니다. 공식 릴리스(cua-perception-v0.2.1)에서 내 운영체제의 .catalog.json 과 .tar.gz 를 같은 폴더에 받은 뒤 cua-driver extension inspect cua-perception --catalog <받은 catalog.json> → cua-driver extension install cua-perception --catalog <받은 catalog.json> → cua-driver extension status cua-perception 순서로 합니다. 공개 빌드는 맥 arm64 · 윈도우 x64 · 리눅스 x64 입니다.