// 자료 — 클로드 · 자동화 · 에이전트 · 2026.11.19

클로드에게 내 컴퓨터 일을 맡기는 법, 에이전트 데스크톱 설치·활용

클로드가 채팅창에서 말로만 알려 주고 클릭은 결국 내가 해야 해서 답답했다면, 무료 도구 에이전트 데스크톱을 클로드 코드에 붙이세요. 클로드가 앱을 직접 열고 버튼을 누르고 글자를 넣어 일을 끝내요.

읽는 데 9분 · 2026년 11월 19일, agent-desktop 1.3.1·클로드 코드 기준

// AI에게 통째로 맡기기

이 가이드 전체를 복사해서
AI 대화창에 붙여넣으세요.

AI가 준비물부터 물어보고 목차 순서대로 같이 진행해요.

// 시작 전 체크

// 30초 요약

  1. 01
    에이전트 데스크톱이 하는 일화면 사진 대신 앱 속 버튼 목록을 읽고 눌러요
  2. 02
    설치하고 권한 확인하기명령어 두 줄로 설치하고 쓸 수 있는 상태인지 봐요
  3. 03
    클로드 코드에 연결하기스킬이나 MCP 중 하나로 클로드가 이 도구를 쓰게 해요
  4. 04
    첫 일 맡겨 보기메모 앱에 글을 써서 저장하고 폴더에서 확인까지 시켜요
  5. 05
    내 마우스를 안 뺏기게 맡기기기본 모드와 실제 마우스를 쓰는 모드의 차이를 알아 둬요
  6. 06
    엑셀·발표 자료·폴더 정리 맡기기여러 앱을 넘나드는 일을 한 번에 시키는 프롬프트
  7. 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), 다시 목록을 읽어 확인하는 순서를 되풀이해요. 공식 문서는 "누르기에 성공했다는 응답이 화면이 바뀌었다는 뜻은 아니다"라며 매번 다시 읽어 확인하라고 정해 두었어요. 클로드가 같은 화면을 여러 번 읽는 건 이 때문이에요.

성공하면 문서 폴더에 파일과 복제본이 생기고, 복제본이 열린 채로 끝나요.

여기까지면 클로드가 앱 하나를 열고 저장까지 해요. 아래에는 내 마우스를 그대로 두고 맡기는 법, 엑셀·발표 자료·폴더를 한 번에 정리시키는 프롬프트, 잘 안 되는 앱 목록이 있어요.

여기부터 잠겨 있어요

이메일만 남기면
나머지가 바로 열려요

한 번 남기면 이 사이트의 모든 자료가 열려요. 무료예요.

// 이메일 남기기

열리는 내용내 마우스를 안 뺏기게 맡기기엑셀·발표 자료·폴더 정리 맡기기잘 안 되는 앱과 주의할 점

2026년 11월 19일, agent-desktop 1.3.1·클로드 코드 기준 · 메뉴 위치나 화면은 바뀔 수 있어요.

// 이어서 볼 자료

// 클로드 · 플러그인 · 코딩 · 자동화2026.11.20

클로드 코드 무료 플러그인 5개 설치하고 쓰는 법 (Claude-Mem·FreeLLMAPI·Claude Code Setup·EGM·21st MCP)

클로드 코드를 쓰는데 매번 처음부터 설명하고 한도가 차서 멈추는 게 막막했다면, 이 5개를 깔아 두세요. 세션 사이 기억, 무료 모델 자동 전환, 프로젝트 맞춤 자동화 추천, 코드 쓰기 전 설계 검토, 만들어진 UI 컴포넌트 검색까지 맡길 수 있어요.

읽는 데 10분

// 클로드 · 영상 편집 · 자동화2026.11.20

클로드로 영상 만들 때 쓰는 무료 오픈소스 TOP 5 (CosyVoice·MCP for Blender·FFmpeg·WhisperX·Remotion)

클로드에게 영상 작업을 맡기고 싶은데 목소리, 3D, 자르기, 자막, 편집에 무엇을 깔아야 할지 막막했다면, 무료 오픈소스 5개를 깔아 두세요. 내레이션은 CosyVoice, 3D 장면은 MCP for Blender, 자르기·변환은 FFmpeg, 단어별 자막은 WhisperX, 모션 그래픽 편집은 Remotion으로 클로드가 대신 처리해요.

읽는 데 11분

// 클로드 · 영상 편집 · 자동화2026.11.19

클로드가 영상을 만들게 하는 무료 오픈소스 3가지 (리모션 스킬스·매님·MCP for Blender 설치법)

클로드에게 영상 편집을 맡기고 싶은데 무엇을 깔아야 하는지 막막했다면, 무료 오픈소스 3가지를 설치하세요. 리모션 스킬스로 모션 그래픽 영상을, 매님으로 수식·도식이 움직이는 설명 영상을, MCP for Blender로 3D 장면을 클로드가 말 한마디로 만들어요.

읽는 데 10분

// 클로드 · 자동화 · 업무팁 · 코딩2026.11.15

클로드 코드 핵심 개념 TOP5 세팅 예시 (MCP·Hooks·Subagents·Skills·CLAUDE.md)

클로드 코드를 제대로 세팅하고 싶은데 MCP, 훅, 서브에이전트, 스킬, CLAUDE.md가 뭔지, 어디에 넣는지 막막했다면 이 순서대로 하나씩 넣어 보세요. 파일 위치와 바로 붙여넣을 세팅 예시를 5개 모두 정리했어요.

읽는 데 10분

// AI에게 통째로 맡기기

이메일을 남기면
바로 복사돼요

가이드 전체가 복사되고, 이 사이트의 모든 자료도 함께 열려요.