// AI에게 통째로 맡기기
이 가이드 전체를 복사해서
AI 대화창에 붙여넣으세요.
AI가 준비물부터 물어보고 목차 순서대로 같이 진행해요.
- 준비물클로드 코드
- 준비물Node.js 18 이상
- 준비물macOS 13 이상 또는 윈도우 10(1809) 이상
- 비용에이전트 데스크톱은 무료(Apache-2.0). 클로드 코드는 Pro 이상 유료 요금제 또는 Console(API) 계정이 필요해요
- 시간약 15분
// 30초 요약
- 01에이전트 데스크톱이 하는 일화면 사진 대신 앱 속 버튼 목록을 읽고 눌러요
- 02설치하고 권한 확인하기명령어 두 줄로 설치하고 쓸 수 있는 상태인지 봐요
- 03클로드 코드에 연결하기스킬이나 MCP 중 하나로 클로드가 이 도구를 쓰게 해요
- 04첫 일 맡겨 보기메모 앱에 글을 써서 저장하고 폴더에서 확인까지 시켜요
- 05내 마우스를 안 뺏기게 맡기기기본 모드와 실제 마우스를 쓰는 모드의 차이를 알아 둬요
- 06엑셀·발표 자료·폴더 정리 맡기기여러 앱을 넘나드는 일을 한 번에 시키는 프롬프트
- 07잘 안 되는 앱과 주의할 점버튼 목록을 안 내주는 앱과 보안 습관
에이전트 데스크톱이 하는 일
에이전트 데스크톱(agent-desktop)은 AI가 내 컴퓨터의 앱을 직접 다루게 해 주는 명령어 도구예요. 버셀 랩스(Vercel Labs) 깃허브 저장소에 무료(Apache-2.0)로 공개돼 있고, 2026년 11월 19일 기준 깃허브 별이 2만 5천 개를 넘었어요.
다른 컴퓨터 사용 AI는 보통 화면을 찍고 어디를 누를지 좌표를 짐작해서 클릭해요. 에이전트 데스크톱은 화면 사진을 쓰지 않아요. 운영체제가 앱마다 갖고 있는 접근성 정보(버튼·입력칸·메뉴 목록)를 읽어서 누를 수 있는 것마다 번호(ref)를 붙여 돌려줘요. 클로드는 그 번호를 골라 누르거나 글자를 넣고 목록을 다시 읽어 제대로 됐는지 확인해요.
공식 저장소의 시연이에요. 오른쪽 터미널의 AI 에이전트가 텍스트 편집기를 열어 글을 쓰고 파일 이름을 넣어 저장 버튼까지 누르는 장면이에요. 터미널에 type @e79 "gemini3_architecture.rtf"처럼 번호로 입력칸을 고르는 명령이 보여요. 이 시연은 클로드가 아니라 다른 에이전트(OpenCode)로 찍었지만, 클로드 코드에서도 같은 명령을 써요. 출처: vercel-labs/agent-desktop
에이전트 데스크톱 안에는 AI가 없어요. 생각하고 순서를 정하는 건 클로드이고, 이 도구는 클로드의 손 역할만 해요. 웹 페이지 조작은 하지 않고 데스크톱 앱만 다뤄요.
설치하고 권한 확인하기
Node.js 18 이상이 깔린 컴퓨터에서 터미널(윈도우는 PowerShell)을 열고 아래를 붙여넣으세요. 맥·윈도우·리눅스 모두 같은 명령이에요.
npm install -g agent-desktop
agent-desktop status
맥은 손이 한 번 더 가요. 터미널 앱에 '손쉬운 사용' 권한을 줘야 해요. 아래 명령을 치면 시스템 설정의 해당 화면이 열려요.
agent-desktop permissions --guide
권한이 안내 화면으로 안 열리면 시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용에 들어가 쓰고 있는 터미널 앱(터미널, iTerm2, VS Code 등)을 추가하고 켜면 돼요. 권한은 터미널 앱마다 따로 줘야 하니, 다른 터미널로 바꾸면 그 앱에도 다시 권한을 주세요.
윈도우는 따로 줄 권한이 없어요. 관리자 권한으로 실행한 앱을 다루려면 터미널도 관리자 권한으로 열어야 해요. 그러지 않으면 그 앱은 읽기만 되고 조작은 안 돼요.
성공하면
agent-desktop status결과의accessibility항목이granted로 나와요.denied면 위 권한 단계를 다시 해 주세요.
안 될 때 윈도우에서 실행이 막히면 SmartScreen이나 백신이 서명 없는 파일이라 막은 경우예요. 공식 문서는 SmartScreen 경고에서 '추가 정보 → 실행'을 고르라고 안내해요.
클로드 코드에 연결하기
연결 방법은 두 가지예요. 하나만 하면 돼요.
방법 1. 스킬로 연결하기 (공식 문서 권장)
터미널에서 아래 한 줄을 붙여넣으세요. 클로드가 에이전트 데스크톱 쓰는 법을 담은 안내서(스킬)가 설치돼요.
npx skills add https://github.com/vercel-labs/agent-desktop --skill agent-desktop
공식 문서는 도구를 업데이트하면 설치한 스킬이 옛날 판으로 남을 수 있다고 해요. 그래서 클로드 코드의 CLAUDE.md에 아래 두 문장을 붙여 두는 방법도 함께 안내해요. 이렇게 하면 클로드가 매번 지금 깔린 판의 안내서를 직접 읽어요.
Use `agent-desktop` to see and operate desktop apps. Before the first use, run
`agent-desktop skills get desktop` and `agent-desktop skills get platform`, and follow them.
방법 2. MCP 서버로 연결하기
터미널에서 아래 한 줄을 붙여넣으면 에이전트 데스크톱의 명령이 전부 클로드 코드 도구로 들어와요.
claude mcp add agent-desktop -- agent-desktop mcp
성공하면 클로드 코드에서
/mcp를 입력했을 때agent-desktop이 목록에 보여요.
첫 일 맡겨 보기
처음에는 결과를 눈으로 확인하기 쉬운 일부터 시켜 보세요. 위 시연에서 에이전트가 받은 주문(메모 앱에 글 쓰기 → 저장 → 폴더에서 확인 → 복제)을 우리말로 옮겼어요. 클로드 코드에 붙여넣고 주황색으로 표시한 부분만 바꾸세요.
agent-desktop으로 <메모장(윈도우) 또는 텍스트 편집기(맥)>를 열어서 <주제>에 대한 메모를 보기 좋게 써 줘.
다 쓰면 문서 폴더에 <파일 이름>으로 저장해 줘.
그다음 파일 탐색기(맥은 Finder)를 열어 파일이 진짜 있는지 확인하고, 그 파일을 복제해서 복제본을 열어 줘.
시작하기 전에 agent-desktop skills get desktop과 agent-desktop skills get platform을 먼저 읽어.
클로드는 앱 목록을 읽고(snapshot), 번호를 골라 누르고(click), 다시 목록을 읽어 확인하는 순서를 되풀이해요. 공식 문서는 "누르기에 성공했다는 응답이 화면이 바뀌었다는 뜻은 아니다"라며 매번 다시 읽어 확인하라고 정해 두었어요. 클로드가 같은 화면을 여러 번 읽는 건 이 때문이에요.
성공하면 문서 폴더에 파일과 복제본이 생기고, 복제본이 열린 채로 끝나요.
여기까지면 클로드가 앱 하나를 열고 저장까지 해요. 아래에는 내 마우스를 그대로 두고 맡기는 법, 엑셀·발표 자료·폴더를 한 번에 정리시키는 프롬프트, 잘 안 되는 앱 목록이 있어요.
여기부터 잠겨 있어요
이메일만 남기면
나머지가 바로 열려요
한 번 남기면 이 사이트의 모든 자료가 열려요. 무료예요.
열리는 내용내 마우스를 안 뺏기게 맡기기엑셀·발표 자료·폴더 정리 맡기기잘 안 되는 앱과 주의할 점
// 공식 출처
- agent-desktop 공식 저장소 (Vercel Labs)
- agent-desktop 공식 문서: 소개
- agent-desktop 공식 문서: 설치
- agent-desktop 공식 문서: 스킬
- agent-desktop 공식 문서: MCP로 쓰기
- agent-desktop 공식 문서: 헤디드 모드
- agent-desktop 공식 문서: 윈도우
- agent-desktop 공식 문서: macOS
- 클로드 코드 공식 문서: MCP 서버 추가
- 클로드 코드 공식 문서: 설치와 요금제
- 깃허브 이슈 #479: 워드 문서 본문이 읽히지 않는 문제
- 깃허브 이슈 #395: 윈도우에서 뒤쪽 창에 글자 넣기
- Hacker News: agent-desktop 소개 글과 사용 후기
2026년 11월 19일, agent-desktop 1.3.1·클로드 코드 기준 · 메뉴 위치나 화면은 바뀔 수 있어요.
// 이어서 볼 자료
클로드 코드 무료 플러그인 5개 설치하고 쓰는 법 (Claude-Mem·FreeLLMAPI·Claude Code Setup·EGM·21st MCP)
클로드 코드를 쓰는데 매번 처음부터 설명하고 한도가 차서 멈추는 게 막막했다면, 이 5개를 깔아 두세요. 세션 사이 기억, 무료 모델 자동 전환, 프로젝트 맞춤 자동화 추천, 코드 쓰기 전 설계 검토, 만들어진 UI 컴포넌트 검색까지 맡길 수 있어요.
읽는 데 10분
클로드로 영상 만들 때 쓰는 무료 오픈소스 TOP 5 (CosyVoice·MCP for Blender·FFmpeg·WhisperX·Remotion)
클로드에게 영상 작업을 맡기고 싶은데 목소리, 3D, 자르기, 자막, 편집에 무엇을 깔아야 할지 막막했다면, 무료 오픈소스 5개를 깔아 두세요. 내레이션은 CosyVoice, 3D 장면은 MCP for Blender, 자르기·변환은 FFmpeg, 단어별 자막은 WhisperX, 모션 그래픽 편집은 Remotion으로 클로드가 대신 처리해요.
읽는 데 11분
클로드가 영상을 만들게 하는 무료 오픈소스 3가지 (리모션 스킬스·매님·MCP for Blender 설치법)
클로드에게 영상 편집을 맡기고 싶은데 무엇을 깔아야 하는지 막막했다면, 무료 오픈소스 3가지를 설치하세요. 리모션 스킬스로 모션 그래픽 영상을, 매님으로 수식·도식이 움직이는 설명 영상을, MCP for Blender로 3D 장면을 클로드가 말 한마디로 만들어요.
읽는 데 10분
클로드 코드 핵심 개념 TOP5 세팅 예시 (MCP·Hooks·Subagents·Skills·CLAUDE.md)
클로드 코드를 제대로 세팅하고 싶은데 MCP, 훅, 서브에이전트, 스킬, CLAUDE.md가 뭔지, 어디에 넣는지 막막했다면 이 순서대로 하나씩 넣어 보세요. 파일 위치와 바로 붙여넣을 세팅 예시를 5개 모두 정리했어요.
읽는 데 10분
