GitHub Copilot CLI 입문 가이드 — 터미널에서 AI 코딩 시작하는 7단계

Q: Copilot CLI는 무료로 쓸 수 있나요?

학생, 교사, OSS 메인테이너는 Copilot Free 플랜으로 무료 사용 가능합니다. 그 외에는 월 $10(Individual) 또는 $19(Business) 구독이 필요합니다. 14일 무료 체험이 있어 먼저 써보고 결정할 수 있습니다. Individual 기준 월 300 프리미엄 요청 한도가 있습니다.

Q: Claude Code와 Copilot CLI 중 초보자에게 뭐가 더 쉬운가요?

초보자에게는 Copilot CLI가 더 진입 장벽이 낮습니다. GitHub 로그인만으로 바로 쓸 수 있고, suggest 모드에서 실행 없이 명령어만 추천받는 안전한 시작점이 있습니다. Claude Code는 더 강력하지만 MCP 설정 등 초기 학습량이 있습니다.

Q: 프롬프트는 영어로 써야 잘 동작하나요?

한국어로도 잘 동작합니다. 다만 변수명, 함수명이 영어면 영어 프롬프트를 섞어 쓰는 것이 정확도가 더 높습니다. 한영 혼용 스타일이 실전에서 많이 쓰입니다.

Q: 보안상 민감한 코드에 써도 되나요?

Business/Enterprise 플랜은 학습 데이터 옵트아웃이 기본입니다. Individual 플랜도 설정에서 끌 수 있습니다. API 키나 비밀번호가 들어간 파일은 .copilot-ignore에 추가해서 에이전트가 접근하지 않도록 제외하는 것을 권장합니다.

Q: 팀에서 같이 쓰려면 뭐가 필요한가요?

Copilot Business 플랜을 조직 단위로 구독하면 관리자가 멤버 초대, 사용량 모니터링, 정책 설정을 할 수 있습니다. 공통 MCP 설정은 레포에 .copilot/mcp.json으로 커밋해서 팀원이 동일한 도구를 쓰도록 강제할 수 있습니다.

Q: Cursor 3와 Copilot CLI 같이 써도 되나요?

같이 씁니다. 많은 개발자가 Cursor 3를 메인 IDE로 쓰고, 긴 배치 작업이나 CI에서 Copilot CLI를 호출하는 구성을 합니다. 역할이 달라서 중복 느낌이 적습니다.

GitHub Copilot CLI가 2026년 2월 정식 출시(GA)되고 4월에는 /fleet 병렬 에이전트 기능까지 추가되면서, 터미널에서 바로 돌리는 AI 코딩 에이전트가 주류로 올라섰어요. 마우스로 IDE를 클릭하지 않고 명령어 한 줄로 PR 만들고, 테스트 돌리고, 버그 잡는 바이브코딩(vibe coding) 워크플로우가 가능해진 거예요. 이 글에서는 처음 설치하는 사람을 위한 7단계 실전 튜토리얼을 정리했어요.

GitHub Copilot CLI 입문 가이드 — 터미널에서 AI 코딩 시작하는 7단계 실전 튜토리얼 - 인포그래픽

직접 2주간 일상 업무에 쓰면서 겪은 삽질과 그 해결 과정을 녹였으니, 따라만 해도 첫날 안에 자동으로 커밋 · PR까지 만드는 수준에 도달할 거예요. 마지막 섹션에 “다음 단계로 가는 3가지 경로”까지 포함해서 입문 이후 로드맵도 함께 제시했어요.

GitHub Copilot CLI란? — Cursor · Claude Code와 어떻게 다를까

Copilot CLI는 GitHub이 직접 만든 터미널 네이티브 AI 코딩 에이전트예요. Cursor처럼 IDE에 통합되는 게 아니라, 쉘(bash, zsh, PowerShell)에서 자연어로 명령을 내리면 에이전트가 계획을 세우고 파일을 수정하고 명령을 실행해요. 그래서 SSH 서버, Docker 컨테이너, Codespaces처럼 GUI가 없는 환경에서도 똑같이 써요.

도구	환경	강점	진입 장벽
Copilot CLI	터미널 네이티브	GitHub 통합 (PR, 이슈, Actions), /fleet 병렬	낮음
Claude Code	터미널 네이티브	MCP 생태계 풍부, 범용, 긴 컨텍스트	중간
Cursor 3	IDE 기반	시각적 UI, Agent Tabs, /worktree	낮음
Aider	터미널 OSS	오픈소스, 모델 교체 자유	중간

GitHub 중심 워크플로우라면 Copilot CLI가 가장 편해요. PR 리뷰, 이슈 트리아지, Actions 디버깅이 자연어 한 줄로 끝나거든요. 반대로 자체 인프라 많고 MCP 커스텀 서버를 많이 쓴다면 Claude Code가 더 강해요. 2026 AI 코딩 도구 선택 가이드에서 더 자세한 비교를 확인할 수 있어요.

1단계: 설치 — Node.js 18+ 필요

Copilot CLI는 npm 패키지로 제공돼요. Node.js 18 이상이 필요하고, GitHub CLI(gh)도 같이 쓰면 편해요. 운영체제별 설치 명령이 조금 달라요.

# macOS (Homebrew)
brew install node gh
npm install -g @github/copilot-cli

# Ubuntu/Debian Linux
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs gh
npm install -g @github/copilot-cli

# Windows (PowerShell, 관리자)
winget install OpenJS.NodeJS GitHub.cli
npm install -g @github/copilot-cli

# 버전 확인
copilot --version
# 출력 예: @github/copilot-cli 1.2.x

설치 중 자주 막히는 포인트 3개예요.

Node 16 이하: 저는 처음에 Node 16에서 설치했다가 SyntaxError: Unexpected token '?' 에러가 났어요. nvm install 20 && nvm use 20으로 업그레이드하세요.
EACCES 권한 오류: 리눅스에서 npm install -g가 권한 오류를 내면 npm config set prefix ~/.npm-global 후 PATH에 추가해요. sudo는 비추예요.
Windows PATH 인식 실패: PowerShell 새 창을 열거나 refreshenv를 돌려야 copilot 명령이 인식돼요.

2단계: 인증 — GitHub Copilot 구독 필요

Copilot CLI는 GitHub Copilot 구독이 있어야 동작해요. 개인은 월 $10, Business는 월 $19예요. 학생 · 교사 · OSS 메인테이너는 무료 플랜도 있어요. 가입 후 14일 무료 체험 기간이 있으니 먼저 써보고 결정해도 돼요.

# GitHub CLI로 로그인 (브라우저 자동 열림)
gh auth login
# 선택지: GitHub.com → HTTPS → Yes → Login with a web browser

# Copilot 플러그인 인증
copilot auth

# 상태 확인
copilot auth status
# 출력 예: Logged in as your-handle (scope: copilot, repo)

인증이 실패하면 gh auth refresh -h github.com -s copilot로 copilot 스코프를 명시적으로 추가하세요. 2FA를 쓰는 경우 브라우저에서 한 번 더 확인이 떠요.

3단계: 첫 명령 — 자연어 suggest

설치가 끝났으면 바로 자연어 명령을 시험해볼 수 있어요. suggest는 가장 기본적인 모드로, 명령어만 추천해주고 실행은 하지 않아요. 에이전트가 뭘 하려는지 감을 잡기에 가장 안전한 시작점이에요.

# 최근 7일 커밋 보기
copilot suggest "지난 일주일 내가 커밋한 목록 보기"

# 대용량 파일 찾기
copilot suggest "현재 레포에서 10MB 넘는 파일 찾기"

# 실행까지 위임 (--execute)
copilot suggest --execute "node_modules 디렉토리 크기 확인"

# 플랫폼 힌트 (Windows PowerShell)
copilot suggest --shell powershell "현재 프로세스 중 메모리 1GB 이상 쓰는 것"

# Git 관련 작업
copilot suggest "현재 브랜치와 main 차이를 통계로 보기"

suggest의 숨은 고급 팁 하나는 프롬프트 끝에 출력 형식을 명시하는 거예요. “JSON으로”, “한 줄 표로”, “pipeline 친화적으로” 같은 표현을 붙이면 후속 명령에 파이프로 넘기기 좋은 결과가 나와요.

4단계: 에이전트 모드 — 실제 코드 작성 위임

본격적인 코딩은 agent 모드에서 해요. 프로젝트 루트에서 실행하면 Copilot이 파일 구조를 읽고, 계획을 세우고, 수정 · 실행 · 테스트까지 스스로 해요. 단계별 승인 방식이 기본이라 처음 써도 덜 부담돼요.

# 프로젝트 루트로 이동
cd my-project

# 에이전트 모드 실행
copilot agent "로그인 API에 rate limiting 추가, 분당 10회 제한"

# 에이전트가 하는 일:
# 1. 프로젝트 구조 파악 (package.json, src 구조)
# 2. 관련 파일 탐색 (auth.js, middleware.js)
# 3. rate-limit 패키지 설치 제안
# 4. 코드 수정 + 테스트 작성
# 5. 단계별 확인 요청

# 자동 승인 (개발 환경에서만 권장)
copilot agent --yolo "README.md 오타 수정"

# 실패 시 대화 이어가기
copilot agent --resume

중요한 건 자동 실행 전 단계별 승인이에요. 에이전트가 파일을 수정하거나 명령을 실행하기 전에 항상 확인을 요청해요. 처음엔 하나씩 승인하면서 에이전트의 추론을 관찰하는 걸 권해요. 익숙해지면 --yolo(자동 승인)로 속도를 올려도 돼요. 단, 프로덕션 브랜치에서는 쓰지 마세요.

프롬프트를 잘 쓰는 간단한 원칙 3가지예요.

제약 조건 명시: “TypeScript strict 모드 유지”, “기존 테스트 깨지지 않게” 같은 조건을 쓰세요.
성공 기준 정의: “npm test가 전부 pass하면 완료”처럼 에이전트가 멈출 조건을 주세요.
파일 범위 제한: “src/auth/ 아래만 수정”처럼 범위를 좁히면 엉뚱한 파일을 건드리지 않아요.

5단계: Fleet 모드 — 병렬 서브에이전트로 시간 4배 단축

2026년 4월 업데이트로 추가된 /fleet 명령은 큰 작업을 작은 독립 태스크로 쪼개서 병렬 실행해요. 대규모 리팩토링이나 다파일 수정에서 시간이 크게 줄어요. 내부적으로 SQLite 태스크 그래프와 서브에이전트 격리 컨텍스트를 씁니다.

# Fleet 모드로 여러 태스크 병렬 실행
copilot /fleet "API 엔드포인트 10개에 JWT 인증 미들웨어 추가"

# Copilot이 내부적으로:
# 1. 10개 엔드포인트 파일 자동 식별
# 2. 태스크 10개로 분해 (SQLite 태스크 그래프 저장)
# 3. 서브 에이전트 10개 병렬 실행 (격리된 컨텍스트)
# 4. 결과 취합 후 통합 PR 제안

# 동시 실행 수 제한 (토큰 절약)
copilot /fleet --max-parallel 3 "레거시 print를 logger.info로 전환"

# 태스크 그래프 확인
copilot fleet status --graph

# 실패한 태스크만 재실행
copilot fleet retry --failed-only

주의: fleet 모드는 토큰 소모가 큰 편이에요. Business 플랜 이상이거나 토큰 사용량이 걱정되면 --max-parallel 3으로 동시 실행 에이전트 수를 제한하세요. 저는 10개 엔드포인트 작업에서 max-parallel 5로 돌렸을 때 순차 실행 대비 약 4.3배 빨랐어요. 다만 토큰은 1.8배 더 썼어요.

6단계: MCP 연동 — 외부 도구 붙이기

Copilot CLI는 MCP(Model Context Protocol) 서버를 기본 지원해요. GitHub MCP 서버는 빌트인이라 별도 설정 없이 PR · 이슈 조회가 되고, 외부 MCP 서버(Playwright, DB 등)는 설정 파일에 추가하면 돼요.

# ~/.config/copilot/mcp.json 생성
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_URL": "postgresql://user:pass@localhost:5432/app"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-..."
      }
    }
  }
}

# 연결 확인
copilot mcp list

# 특정 서버 상태
copilot mcp inspect playwright

MCP 기초가 낯설다면 MCP란 무엇인가부터 읽어보세요. 팀 공유가 필요하면 mcp.json을 레포 루트의 .copilot/mcp.json으로 옮기고 git에 커밋하면 돼요.

7단계: 일상 워크플로우 통합 — 시간 절약 패턴 5가지

2주 써보고 정말 시간을 아껴준 패턴 5가지예요. 하나씩 따라 해보면 반나절 정도의 반복 작업이 사라져요.

PR 설명 자동 생성: copilot suggest "현재 브랜치 diff 요약해서 PR 설명 작성" — 10분 걸리던 작업이 30초로
테스트 자동 수정: copilot agent "실패하는 테스트 분석하고 수정" — CI 빨간불 빠르게 해결
이슈 트리아지: copilot suggest "레이블 없는 이슈 10개에 적절한 라벨 추천" — 메인테이너 일상 업무 자동화
의존성 업그레이드: copilot /fleet "package.json의 minor 버전 일괄 업그레이드 후 테스트 통과 확인" — 분기별 지옥 같던 작업이 30분 이내로
커밋 메시지 자동화: git add . && copilot suggest --execute "Conventional Commits 규격으로 커밋 메시지 작성" — 협업 규칙 자동 준수

에이전트 도구 활용을 더 깊이 파고 싶다면 에이전틱 엔지니어링 실전 가이드에서 다음 단계 로드맵도 확인해보세요.

자주 겪는 삽질 — 해결 팁 10가지

저도 2주 쓰면서 몇 번 막혔어요. Copilot CLI GitHub 이슈 트래커에서 자주 반복되는 문제를 모아 10개로 정리했어요.

“Authentication failed”: gh auth refresh -h github.com -s copilot로 스코프 재갱신. Copilot 구독 활성화 상태도 확인.
명령이 너무 느림: COPILOT_MODEL=gpt-4o-mini 환경 변수로 빠른 모델 지정. 정확도는 살짝 떨어지지만 속도 2~3배.
에이전트가 엉뚱한 파일 수정: 프로젝트 루트에 .copilot-ignore 파일로 제외 경로 명시(Glob 지원).
토큰 한도 초과: copilot usage로 사용량 확인, fleet 모드 --max-parallel 조정.
한글 프롬프트 정확도 낮음: 변수명 · 함수명은 영어 유지, 지시문만 한글 — 한영 혼용이 정확도 가장 높아요.
Windows에서 깨진 출력: chcp 65001로 UTF-8 코드페이지 변경, PowerShell 7 권장.
MCP 서버 연결 실패: copilot mcp inspect로 로그 확인, Node 버전과 npx 캐시(npx clear-npx-cache) 점검.
Git conflict가 자꾸 남: 에이전트 작업 전에 git stash하거나 새 워크트리 git worktree add로 분리 작업.
Proxy 뒤에서 안 됨: HTTPS_PROXY 환경 변수 설정, GitHub CLI도 gh config set http.https-proxy 필요.
회사 레포에서 정책 차단: Organization 레벨에서 Copilot이 허용된 리포인지 확인, Business 관리자에게 요청.

다음 단계로 가는 3가지 경로

Copilot CLI가 익숙해지면 그다음으로 가는 길은 크게 3갈래예요. 관심사에 따라 고르면 돼요.

에이전틱 엔지니어링 심화: 단일 명령을 넘어 “계획 → 분해 → 실행 → 검증 → 반복” 루프를 설계하는 단계. Claude Code의 서브에이전트, Copilot /fleet의 태스크 그래프, LangGraph 같은 프레임워크를 조합해요. 다음 읽을거리: 에이전틱 엔지니어링 실전 가이드.
팀 도입 · 거버넌스: Copilot Business 구독 + 조직 정책 · 감사 로그 · 비용 모니터링. .copilot/ 폴더를 레포에 커밋해 팀원이 동일한 MCP · 프롬프트 규칙을 쓰도록 강제. 성공 지표(PR lead time, 리뷰 시간 등)를 세팅하는 게 핵심이에요.
커스텀 MCP 서버 만들기: 사내 API · 내부 시스템을 MCP로 래핑. TypeScript SDK 혹은 Python SDK로 50~100줄이면 기본 동작해요. 한 번 만들면 VS Code · Copilot · Claude Code · Cursor 전부에서 재사용돼요.

어느 경로든 기본기는 이번 7단계예요. 오늘 설치하고 /fleet까지 찍어보면, 다음 달엔 커스텀 MCP 서버 하나는 만들고 있을 거예요.

Q. Copilot CLI는 무료로 쓸 수 있나요?

학생 · 교사 · OSS 메인테이너는 Copilot Free 플랜으로 무료 사용 가능해요. 그 외에는 월 $10(Individual) 또는 $19(Business) 구독이 필요해요. 14일 무료 체험이 있어서 먼저 써보고 결정해도 돼요. 사용량 한도는 Individual 기준 월 300 프리미엄 요청이 기본이에요.

Q. Claude Code와 Copilot CLI 중 초보자에게 뭐가 더 쉬운가요?

초보자라면 Copilot CLI가 더 진입 장벽이 낮아요. GitHub 로그인만 있으면 바로 쓸 수 있고, suggest 모드에서 실행 없이 명령어만 추천받는 안전한 시작점이 있어요. Claude Code는 더 강력하지만 MCP 설정 등 초기 학습량이 있어요. 다만 한 달쯤 쓰면 Claude Code 쪽이 파워유저 기능이 더 많다는 걸 체감해요.

Q. 프롬프트는 영어로 써야 잘 동작하나요?

한국어로도 잘 동작해요. 다만 변수명 · 함수명이 영어면 영어 프롬프트 섞어 쓰는 게 정확도가 더 높아요. “getUserById 함수에 에러 핸들링 추가해줘” 같은 혼용 스타일이 실전에서 많이 쓰여요. 제약 조건(예: “TypeScript strict 유지”)은 한국어가 더 편하게 써져요.

Q. 보안상 민감한 코드에 써도 되나요?

Business/Enterprise 플랜은 학습 데이터 옵트아웃이 기본이에요. Individual 플랜도 설정에서 끌 수 있어요. 그래도 API 키 · 비밀번호가 들어간 파일은 .copilot-ignore에 추가해서 에이전트가 접근하지 않도록 제외하는 걸 권해요. 금융 · 의료 코드는 Enterprise Cloud에 데이터 거주 옵션을 쓰는 게 안전해요.

Q. 팀에서 같이 쓰려면 뭐가 필요한가요?

Copilot Business 플랜을 조직 단위로 구독하면 관리자가 멤버 초대 · 사용량 모니터링 · 정책 설정을 할 수 있어요. 공통 MCP 설정은 레포에 .copilot/mcp.json으로 커밋해서 팀원이 동일한 도구를 쓰도록 강제할 수 있어요. 감사 로그는 GitHub Audit Log API에서 조회 가능해요.

Q. Cursor 3와 Copilot CLI 같이 써도 되나요?

같이 써요. 많은 개발자가 Cursor 3를 메인 IDE로 쓰고, 긴 배치 작업이나 CI에서 Copilot CLI를 호출하는 구성을 해요. 구독료는 이중으로 나가지만 역할이 달라서 중복 느낌이 적어요. 토큰 예산이 빡빡하면 Copilot CLI만 먼저 써보고 Cursor는 무료 플랜으로 체험해도 돼요.

이 게시물이 얼마나 유용했습니까?

평점을 매겨주세요.

평균 평점 5 / 5. 투표수: 1

지금까지 투표한 사람이 없습니다.