techlist.io
KR EN
github

입문자를 위한 GitHub Copilot CLI: GitHub Copilot CLI 시작하기 (새 탭에서 열림)

mcpgithub-copilot-clinode.jsnpmcommand-line-interfaceai-coding-assistantcloud-agent

GitHub Copilot CLI는 에이전트형 AI를 터미널에 통합해 코드 작성, 테스트 실행, 오류 수정 등을 지원하는 도구다. 이 글은 npm을 통한 설치부터 GitHub 인증, 폴더 권한 설정, 첫 프롬프트 실행까지의 시작 과정을 소개한다. 또한 프로젝트 분석, 엔드포인트 생성, Copilot Cloud Agent로 작업 위임 같은 활용 사례를 설명한다.

GitHub Copilot CLI란?

  • Copilot의 에이전트 기능을 명령줄 환경에서 사용할 수 있게 해주는 도구다.
  • 저장소 전체 맥락을 바탕으로 파일을 탐색하고 코드를 작성할 수 있다.
  • 코드 빌드와 테스트 실행을 자율적으로 수행하며, 오류를 발견하면 스스로 수정할 수 있다.
  • 사용자는 작업을 요청한 뒤 결과를 검토하고 추가 변경을 지시할 수 있어, 다른 도구로 전환하지 않고 개발 흐름을 유지할 수 있다.
  • CLI에서 Copilot Cloud Agent에 작업을 위임하는 것도 가능하다.

설치 방법

Node.js가 설치되어 있다면 npm으로 전역 설치할 수 있다.

npm install -g @github/copilot
  • Windows에서는 WinGet, macOS에서는 Homebrew 등 패키지 관리자를 사용할 수도 있다.
  • 패키지 관리자별 정확한 설치 명령은 해당 도구의 문서를 확인해야 한다.

최초 실행과 인증

설치가 끝나면 터미널에서 Copilot 명령으로 실행한다.

Copilot

처음 사용하는 경우 /login 명령으로 GitHub 계정에 로그인한다.

/login

로그인 과정에서 다음 작업이 수행된다.

  • Copilot 클라이언트와 GitHub Copilot 계정을 연결한다.
  • GitHub 리소스에 접근할 수 있도록 읽기 전용 GitHub MCP 서버를 연결한다.

폴더 권한 설정

Copilot이 프로젝트를 분석하거나 파일을 수정하려면 해당 폴더에 대한 접근 권한을 부여해야 한다.

  • 현재 세션에서만 권한을 허용할 수 있다.
  • 같은 프로젝트에서 반복적으로 사용할 경우 권한 설정을 저장할 수 있다.
  • 파일을 생성하거나 수정하는 작업에서는 Copilot이 별도로 사용자 승인을 요청할 수 있다.
  • 권한을 부여한 뒤 자연어로 프로젝트 분석, 코드 작성, 테스트 등의 작업을 요청할 수 있다.

프로젝트 분석과 코드 생성

Copilot CLI는 저장소의 파일과 문서를 직접 탐색해 프로젝트 구조와 개발 관례를 파악한다.

예를 들어 다음과 같이 요청할 수 있다.

Give me an overview of this project
  • 주요 파일과 프로젝트 구성을 확인한 뒤 개요를 제공한다.
  • 새 기능을 요청하면 기존 문서와 코드 예제를 참고해 프로젝트 스타일에 맞추려 한다.
  • 예를 들어 카테고리 전체를 반환하는 새 엔드포인트를 추가하도록 요청할 수 있다.
Let’s add a new endpoint to return all categories
  • 파일 생성이나 변경 전에는 필요한 권한을 요청한다.

Copilot Cloud Agent로 작업 위임

명확하게 정의된 작업은 CLI에서 Copilot Cloud Agent에 넘길 수 있다.

/delegate Let’s deal with issue #14 to add the rest of the CRUD endpoints to games

위임하면 Copilot이 다음 작업을 수행한다.

  • 현재 CLI 세션의 컨텍스트를 유지한다.
  • 새 브랜치를 생성한다.
  • 초안 상태의 Pull Request를 연다.
  • 백그라운드에서 요청된 변경 작업을 진행한다.
  • 작업 완료 후 사용자가 결과를 검토하도록 한다.

이후 학습할 기능

이 글은 입문 시리즈의 첫 번째 내용으로, 다음 주제들이 후속 글에서 다뤄질 예정이라고 안내한다.

  • 대화형 모드와 비대화형 모드 비교
  • -p 플래그를 이용한 빠른 요약
  • Copilot CLI의 슬래시 명령
  • MCP 서버 연동
  • CLI 사용법과 모범 사례

Copilot CLI는 터미널을 떠나지 않고 프로젝트를 이해하고 코드를 수정할 수 있게 해주는 도구다. 처음에는 작은 프로젝트 개요나 단순한 기능 추가부터 사용하고, 파일 변경과 권한 요청 결과를 직접 검토하면서 점차 작업 위임 범위를 넓히는 것이 좋다.