muaco Tech Note

GitHub Copilotgithub.blog

GitHub Copilot computer use 설정법CLI와 앱에서 데스크톱 앱 맡기기

GitHub Copilot의 computer use를 켜고 권한을 준 뒤, 데스크톱 앱 작업을 Copilot에게 맡기는 방법까지 차례로 따라 합니다.

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

이 글을 끝까지 따라 하면 GitHub Copilot이 내 컴퓨터의 데스크톱 앱을 직접 조작합니다. 화면을 읽고 버튼을 누르고 글자를 입력하는 일을 맡길 수 있습니다.

이 기능의 이름이 computer use입니다. 2026년 10월 1일에 공개 미리보기(정식 출시 전 시험판)로 나왔고 내용이 바뀔 수 있습니다.

쓰는 곳은 두 군데입니다. 터미널에서 쓰는 Copilot CLI, 그리고 창으로 띄우는 GitHub Copilot 앱입니다. 두 방법을 모두 다룹니다.

시작 전에 갖춰야 할 준비물

여기서 하나라도 빠지면 아래 단계가 막힙니다. 먼저 확인해 보세요.

  • 운영체제: macOS 또는 Windows입니다. 공식 문서에 Linux는 지원 대상으로 나와 있지 않습니다.
  • GitHub Copilot 구독: 활성 상태인 구독이 있어야 합니다. computer use가 어느 요금제에서 되는지는 문서에 나와 있지 않습니다.
  • 회사 계정이라면 관리자 설정: 조직 관리자가 이 기능을 꺼 두면 내 컴퓨터에서 켜도 쓸 수 없습니다. Copilot CLI 자체를 막아 둔 회사도 있습니다.
  • CLI로 쓸 경우: npm으로 설치하려면 Node.js 22 이상이 필요합니다. Windows는 PowerShell 6 이상이 있어야 합니다.

CLI는 터미널에 명령을 쳐서 쓰는 방식입니다. 검은 창이 낯설다면 아래에 나오는 앱 쪽 방법이 더 편합니다.

따라 하기: 켜고 맡기기

준비: Copilot CLI 설치와 로그인

앱만 쓸 생각이라면 이 묶음은 건너뛰어도 됩니다.

따라 하기
  1. 터미널을 열고 설치 명령 하나를 입력합니다. Windows는 winget install GitHub.Copilot, macOS는 brew install --cask copilot-cli입니다. macOS에서 Homebrew가 없다면 설치 스크립트 curl -fsSL https://gh.io/copilot-install | bash를 써도 됩니다. Node.js가 있다면 어디서나 npm install -g @github/copilot도 됩니다.
  2. copilot을 입력해 실행합니다. 입력 대기 화면이 뜨면 설치가 끝난 상태입니다.
  3. 처음 실행이라면 /login을 입력하고 화면 안내대로 GitHub 계정에 로그인합니다. 로그인은 처음 한 번만 하면 됩니다.
  4. 현재 폴더를 믿어도 되는지 묻는 질문이 나오면 확인합니다. 이 폴더의 파일을 AI가 다뤄도 되는지 내가 직접 승인하는 절차입니다.

설정: computer use 켜기

computer use는 처음에 꺼져 있습니다. 직접 켜야 Copilot이 앱을 만질 수 있습니다.

따라 하기
  1. CLI에서는 /computer show로 지금 켜져 있는지 먼저 봅니다. 상태를 알아야 다음 단계에서 무엇이 바뀌었는지 압니다.
  2. 이어서 /computer on을 입력합니다. macOS라면 CLI가 필요한 권한을 차례로 안내합니다.
  3. 앱에서는 설정(Settings)을 열고 Computer Use 항목으로 갑니다. Enable Computer Use를 켭니다. 앱의 입력창에 /computer on을 쳐도 결과는 같습니다.
  4. macOS에서는 손쉬운 사용(Accessibility)과 화면 기록(Screen Recording) 권한을 허락합니다. 앞의 권한은 버튼을 누르는 데, 뒤의 권한은 창을 들여다보는 데 쓰입니다. 두 권한이 모두 Granted로 보이면 됩니다.

확인: 첫 작업 맡기기

따라 하기
  1. 원하는 결과, 쓸 앱, 지킬 조건을 함께 적어 요청합니다. 문서가 드는 예는 "Open APP_NAME and summarize the status information shown in the main window. Do not change any values or submit any forms."입니다. APP_NAME 자리에 실제 앱 이름을 넣으면 됩니다.
  2. Copilot이 앱을 만져도 되는지 물으면 Allow를 고릅니다. 이번 세션에만 허락하는 선택입니다. 처음에는 이쪽이 안전합니다.
  3. 민감한 정보를 다루는 앱이라면 Always allow를 고르지 마세요. 이 선택은 컴퓨터에 저장되어 다음 세션에도, CLI와 앱 양쪽에도 적용됩니다.
  4. 앱 창이 저절로 움직이고 요약이 돌아오면 성공입니다. 엉뚱하게 움직이면 바로 멈추세요. CLI는 Esc를 두 번, 앱은 Stop을 누르거나 Esc를 누릅니다.
  5. 다 쓴 뒤 끄려면 /computer off를 입력합니다. 앱에서는 설정의 Computer Use를 꺼도 됩니다.

요청은 결과와 조건을 함께

심부름을 맡길 때를 떠올려 보세요. "마트 다녀와"보다 "우유 두 개, 만 원 넘으면 사지 말고"가 낫습니다. Copilot도 마찬가지입니다.

문서는 원하는 결과, 관련된 앱, 지켜야 할 제약을 함께 쓰라고 권합니다. 알림을 요약하거나 발표 자료 내용을 고치는 일, 앱 사이로 정보를 옮기는 일이 예로 나옵니다.

특히 쓸모 있는 자리는 오래된 업무 프로그램입니다. API나 명령줄 기능이 없어 화면으로만 다룰 수 있는 프로그램이 여기에 해당합니다.

"아무것도 바꾸지 말 것", "제출 버튼은 누르지 말 것" 같은 금지 조건은 꼭 넣으세요. 문서도 모호한 지시나 예상 못 한 화면 내용이 의도하지 않은 동작을 부를 수 있다고 경고합니다.

여기서 막히기 쉬운 곳

켰는데 Copilot이 앱을 못 만집니다

보이는 증상: /computer on을 했는데 앱 조작이 시작되지 않습니다.

이유: 내 계정에서 기능이 열리지 않았거나, 내 컴퓨터에서 직접 돌리는 세션이 아니거나, 조직 정책이 막았을 수 있습니다. 문서의 문제 해결 안내는 computer-use 플러그인과 MCP 서버(AI에게 도구를 이어 주는 연결 장치)가 켜져 있는지도 확인하라고 합니다.

할 일: 먼저 CLI에서 /computer show를 입력합니다. 계정에서 기능을 쓸 수 있는지, 플러그인과 MCP 서버가 켜졌는지 한 번에 보여 줍니다. 그다음 /plugin으로 computer-use 플러그인을, /mcp list로 MCP 서버 연결을 확인하세요. 회사 계정이면 관리자에게 정책을 물어봅니다.

macOS에서 화면을 못 읽거나 클릭을 못 합니다

보이는 증상: 창 내용을 인식하지 못하거나 버튼이 눌리지 않습니다.

이유: 손쉬운 사용 권한이 없으면 컨트롤을 누르지 못합니다. 화면 기록 권한이 없으면 창 모습을 보지 못합니다.

할 일: 시스템 설정에서 두 권한이 모두 허락됐는지 봅니다. 앱 설정의 Computer Use에서 두 항목이 Granted로 표시되면 정상입니다.

엉뚱한 버튼을 누릅니다

보이는 증상: 다른 컨트롤을 고르거나 글자를 잘못 입력합니다.

이유: 문서가 밝힌 한계입니다. 특이하게 만든 컨트롤이나 계속 바뀌는 화면은 다루기 어렵습니다. 타이밍이나 창 상태가 달라지면 결과도 달라집니다.

할 일: 즉시 멈춥니다. CLI는 Esc를 두 번, 앱은 Stop이나 Esc를 누르세요. 요청을 더 작게 나누고 대상 창을 하나만 띄운 채 다시 해 보세요.

Always allow를 취소하고 싶습니다

보이는 증상: 예전에 항상 허용한 앱이 묻지도 않고 조작됩니다.

이유: Always allow는 컴퓨터에 저장되어 CLI와 앱 양쪽에 적용됩니다.

할 일: 앱에서 Settings, Computer Use, Always allowed apps 순서로 들어가 해당 앱을 지웁니다. 다만 이미 돌고 있는 세션의 허락은 거둬지지 않습니다. 진행 중인 세션은 따로 닫아 주세요.

여기서 한 걸음 더

처음에는 읽기만 하는 일부터 맡겨 보세요. 상태 요약이나 알림 정리처럼 아무것도 바꾸지 않는 요청이 안전합니다.

손에 익으면 입력과 옮겨 적기로 넓혀 갑니다. 공개 미리보기라 화면과 명령이 바뀔 수 있으니, 막히면 아래 공식 문서를 다시 확인하세요.

이상으로 글 마치겠습니다.

출처

#GitHub Copilot#computer use#Copilot CLI#데스크톱 자동화#AI 에이전트#설정#macOS#Windows

같은 분류의 글